### Local EDGAR Project Development Setup

Source: https://github.com/bellingcat/edgar/blob/main/README.md

This snippet provides the necessary bash commands to set up the EDGAR project for local development. It includes cloning the repository, navigating into the project directory, installing Poetry, and managing project dependencies and pre-commit hooks.

```bash
# Clone the repository
git clone https://github.com/bellingcat/EDGAR.git

# Change directory to the project folder
cd EDGAR
```

```bash
# Install Poetry if you haven't already
pip install poetry

# Install dependencies
poetry install

# Set up pre-commit hooks to keep your code formatted
poetry run pre-commit install
```

--------------------------------

### Install EDGAR Tool Dependencies

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This cell installs the `edgar_tool` library and imports necessary modules for data handling and display in a Google Colab environment. It only needs to be run once.

```python
# @markdown ⬅️ Please run this cell first in order to install `edgar_tool`. You only need to run this once.
%pip install edgar_tool

from contextlib import redirect_stdout
from datetime import datetime

from google.colab import data_table, files
from IPython.display import display
from ipywidgets import widgets
import pandas as pd

from edgar_tool import SearchParams, search, Location
```

--------------------------------

### Install EDGAR CLI Tool

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Install the EDGAR command-line interface directly from the official PyPI release using pip. This provides access to the tool's functionalities for searching and retrieving SEC data.

```bash
pip install edgar-tool
```

--------------------------------

### EDGAR RSS Feed Monitoring Command Examples

Source: https://github.com/bellingcat/edgar/blob/main/README.md

These examples demonstrate how to use the `edgar rss` subcommand to monitor SEC filings via RSS feeds. They cover displaying help, basic one-off usage with CSV export, and periodic monitoring with JSON/JSONL output for specified tickers.

```bash
# Display help message describing all supported arguments along with their usage
edgar rss --help

# Basic one-off usage with export to CSV
edgar rss GOOG --output rss_feed.csv

# Periodic usage specifying 10 minutes interval duration, with export to JSON
edgar rss AAPL GOOG MSFT --output rss_feed.json --every-n-mins 10

# Same example as above, using aliases and exporting to JSONLines (.jsonl)
edgar rss AAPL GOOG MSFT -o rss_feed.jsonl -e 10
```

--------------------------------

### Example of activating Poetry shell and running pytest

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Illustrates a real terminal session where `pytest` initially fails because it's not found in the system's PATH. The user then activates the Poetry shell (`poetry shell`), and subsequently, `pytest` runs successfully within the activated virtual environment, displaying the test results.

```console
@edgar-dev ➜ /workspaces/EDGAR (main) $ pytest
bash: pytest: command not found

@edgar-dev ➜ /workspaces/EDGAR (main) $ poetry shell
Spawning shell within /home/vscode/.cache/pypoetry/virtualenvs/edgar-tool-vrvn8V2D-py3.12
(edgar-tool-py3.12) @edgar-dev ➜ /workspaces/EDGAR (main) $ pytest
================= test session starts ==================
platform linux -- Python 3.12.4, pytest-8.3.1, pluggy-1.5.0
rootdir: /workspaces/EDGAR
configfile: pyproject.toml
collected 1 item

tests/test_cli.py .                              [100%]

================== 1 passed in 0.20s ===================
(edgar-tool-py3.12) @edgar-dev ➜ /workspaces/EDGAR (main) $
```

--------------------------------

### Install EDGAR CLI Autocompletion

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Enable shell autocompletion for the EDGAR CLI tool. This feature is highly recommended as it simplifies command input by allowing users to type partial commands and use the tab key to complete them.

```bash
edgar --install-completion
```

--------------------------------

### Text Search by Country of Incorporation

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Searches for 'oil' and filters results to entities incorporated in a specific country, using ISO 3166-1 alpha-3 codes (e.g., EGY for Egypt). This example shows both long and short flag usage.

```shell
edgar text-search oil --incorporated-in EGY
# or
edgar text-search oil -ii EGY
```

--------------------------------

### EDGAR Project Development Utility Commands

Source: https://github.com/bellingcat/edgar/blob/main/README.md

This section lists essential commands for developers working on the EDGAR project. It includes commands to run the tool from the Poetry environment and to execute unit tests, facilitating development and testing workflows.

```bash
# Run the tool
poetry run edgar-tool --help

# Run unit tests using your Poetry environment's Python interpreter
poetry run pytest
```

--------------------------------

### Activate Poetry shell and run commands directly

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Demonstrates how to activate Poetry's virtual environment shell using `poetry shell`, allowing direct execution of project-specific commands like `edgar-tool`, `pytest`, and `tox` without the `poetry run` prefix. This simplifies command line interaction within the project context.

```bash
poetry shell

edgar-tool --help

pytest

tox run-parallel
```

--------------------------------

### EDGAR Tool Global Command-Line Arguments

Source: https://github.com/bellingcat/edgar/blob/main/README.md

This section details the global command-line arguments available for the EDGAR tool, used to specify search criteria such as incorporation location, maximum results, and to display help messages. These arguments apply across various EDGAR subcommands.

```APIDOC
-ii, --incorporated-in [AL|AK|AZ|AR|CA|CO|CT|DE|DC|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY|AB|BC|CAN|MB|NB|NL|NS|ON|PE|QC|SK|YT|AFG|ALA|ALB|DZA|ASM|AND|AGO|AIA|ATA|ATG|ARG|ARM|ABW|AUS|AUT|AZE|BHS|BHR|BGD|BRB|BLR|BEL|BLZ|BEN|BMU|BTN|BOL|BIH|BWA|BVT|BRA|IOT|BRN|BGR|BFA|BDI|KHM|CMR|CPV|CYM|CAF|TCD|CHL|CHN|CXR|CCK|COL|COM|COG|COD|COK|CRI|CIV|HRV|CUB|CYP|CZE|DNK|DJI|DMA|DOM|ECU|EGY|SLV|GNQ|ERI|EST|ETH|FLK|FRO|FJI|FIN|FRA|GUF|PYF|ATF|GAB|GMB|GEO|DEU|GHA|GIB|GRC|GRL|GRD|GLP|GUM|GTM|GGY|GIN|GNB|GUY|HTI|HMD|VAT|HND|HKG|HUN|ISL|IND|IDN|IRN|IRQ|IRL|IMN|ISR|ITA|JAM|JPN|JEY|JOR|KAZ|KEN|KIR|PRK|KOR|KWT|KGZ|LAO|LVA|LBN|LSO|LBR|LBY|LIE|LTU|LUX|MAC|MKD|MDG|MWI|MYS|MDV|MLI|MLT|MHL|MTQ|MRT|MUS|MYT|MEX|FSM|MDA|MCO|MNG|MNE|MSR|MAR|MOZ|MMR|NAM|NRU|NPL|NLD|ANT|NCL|NZL|NIC|NER|NGA|NIU|NFK|MNP|NOR|OMN|PAK|PLW|PSE|PAN|PNG|PRY|PER|PHL|PCN|POL|PRT|PRI|QAT|REU|ROU|RUS|RWA|BLM|SHN|KNA|LCA|MAF|SPM|VCT|WSM|SMR|STP|SAU|SEN|SRB|SYC|SLE|SGP|SVK|SVN|SLB|SOM|ZAF|SGS|ESP|LKA|SDN|SUR|SJM|SWZ|SWE|CHE|SYR|TWN|TJK|THA|TLS|TGO|TKL|TON|TTO|TUN|TUR|TKM|TCA|TUV|UGA|UKR|ARE|GBR|UMI|URY|UZB|VUT|VEN|VNM|VGB|VIR|WLF|ESH|YEM|ZMB|ZWE|XX]:
  Search for the primary location associated with a filing. Incorporated in refers to
  the location where the company was legally formed and registered as a corporation. The
  location could be a US state or territory, a Canadian province, or a country.
-mr, --max-results INTEGER: Maximum number of results to retrieve. If not provided,
  all results will be retrieved.
--help: Show this message and exit.
```

--------------------------------

### Display Help Message for EDGAR Text Search

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Shows the command-line help for the `edgar text-search` tool, detailing arguments, aliases, and default values.

```shell
edgar text-search --help
```

--------------------------------

### Run unit tests with tox using poetry run

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Execute unit tests using the `tox` test runner, prefixed with `poetry run` to ensure it runs within the Poetry project's virtual environment. The `-- run-parallel` argument indicates parallel execution of tests.

```bash
poetry run tox -- run-parallel
```

--------------------------------

### Enable Jupyter Widgets for Interactive Elements

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This shell command enables the `widgetsnbextension` for Jupyter notebooks, which is necessary for interactive elements like buttons to function correctly. It redirects all output to a specified log file.

```Shell
!jupyter nbextension enable --py widgetsnbextension >> {logfile} 2>&1
```

--------------------------------

### Configure Data Table Display and Output File Naming (Python)

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This Python snippet performs two configuration tasks. First, it enables a dataframe formatter for `data_table` objects, likely improving their display in an interactive environment. Second, it dynamically generates unique filenames for the EDGAR search results CSV and a corresponding log file by embedding the current timestamp, ensuring that each run produces distinct output files.

```Python
data_table.enable_dataframe_formatter()

# Create the output files
output = f"edgar_search_results_{datetime.now().strftime('%d%m%Y_%H%M%S')}.csv"
logfile = f"./edgar_log_{datetime.now().strftime('%d%m%Y_%H%M%S')}.log"
```

--------------------------------

### Advanced Text Search with Multiple Arguments and Output Formats

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Demonstrates complex search queries combining multiple filters like date range, filing category, entity ID, and specifying output formats (CSV, JSON, JSONL) by simply changing the output file suffix.

```shell
# Simply specify the output file format suffix to .csv, .json, or .jsonl
edgar text-search "Marjorie Taylor Greene" --output results.csv

edgar text-search Volcano Monitoring --start-date 2021-01-01 --end-date 2021-12-31 \
    --output results.json --filing-category all_annual_quarterly_and_current_reports \
    --entity-id 0001030717

edgar text-search Calabarzon --start-date 2021-01-01 -o results.jsonl \
    --filing-category all_annual_quarterly_and_current_reports \
    --max-results 100
```

--------------------------------

### Perform EDGAR Search, Process, and Display Results in Python

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This Python code block demonstrates how to perform a search against the EDGAR system using `SearchParams`, log the search output, read the results into a pandas DataFrame, and display them within a Jupyter environment. It also includes a Jupyter button widget to facilitate downloading the processed results.

```Python
print("Searching EDGAR...")

search_params = SearchParams(
    keywords=[text],
    entity=entity_id if entity_id else None,
    filing_category=filing_category,
    start_date=start_date,
    end_date=end_date,
    peo_in=peo_in,
    inc_in=inc_in,
)
results = 0
with open(logfile, 'w') as f:
    with redirect_stdout(f):
        results = search(search_params=search_params, output=output)

print(f"Finished! Your search yielded {len(results)} results.")

results = pd.read_csv(output)

btn = widgets.Button(description="Download Results")
btn.on_click(lambda x: files.download(output))
display(btn)

display(results)
```

--------------------------------

### Text Search by Single Form Types

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Searches for 'Hurricane Damage' and filters results to specific form types (1-K and 1-SA), demonstrating both long and short flag usage for the `--single-form` argument.

```shell
edgar text-search Hurricane Damage --single-form 1-K --single-form 1-SA
# or
edgar text-search Hurricane Damage -sf 1-K -sf 1-SA
```

--------------------------------

### Exact Phrase and Partial Keyword Search

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Demonstrates how to search for an exact phrase ('John Doe') using quotes, combined with partial keywords ('Pharmaceuticals', 'Chemicals'). This works across POSIX-compliant shells and Windows PowerShell.

```shell
edgar text-search "John Doe" Pharmaceuticals Chemicals
```

--------------------------------

### Text Search by Filing Category

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Filters search results for 'Hurricane Damage' to include only documents within the 'registration_statements' filing category.

```shell
edgar text-search Hurricane Damage --filing-category registration_statements
```

--------------------------------

### Edgar Text Search CLI Command Usage

Source: https://github.com/bellingcat/edgar/blob/main/README.md

This snippet provides the command-line usage for the `edgar text-search` tool, detailing its arguments and various options for filtering SEC filing searches. It covers how to specify search terms, output formats, date ranges, entity identifiers, filing categories, specific form types, and geographic locations of principal executive offices.

```console
$ edgar text-search [OPTIONS] TEXT...
```

```APIDOC
Arguments:
- `TEXT...`: Search filings for a word or a list of words. A filing must contain all the words to return. To search for an exact phrase, use double quotes, like "fiduciary product". [required]

Options:
- `-o, --output TEXT`: Name of the output file to save results to. Accepts .csv, .json, and .jsonl extensions. [default: edgar_search_results_20250315_200420.csv]
- `--date-range [all|10y|5y|1y|30d]`: Date range of the search. Use 'all' to search all records since 2001. [default: 5y]
- `--start-date [%Y-%m-%d]`: Start date of the search in YYYY-MM-DD format (i.e. 2024-07-28).
- `--end-date [%Y-%m-%d]`: End date of the search in YYYY-MM-DD format (i.e. 2024-07-28) [default: 2025-03-15]
- `--entity-id TEXT`: Company name, ticker, CIK number or individual's name.
- `--filing-category [all|custom|all_except_section_16|all_annual_quarterly_and_current_reports|all_section_16|beneficial_ownership_reports|exempt_offerings|registration_statements|filing_review_correspondence|sec_orders_and_notices|proxy_materials|tender_offers_and_going_private_tx|trust_indentures]`: Form group to search for. Use 'custom' or do not set if using `--single-form`/`-sf`.
- `-sf, --single-form [1-A POS|1-A-W|1-A|1-E AD|1-K|1-SA|1-U|1-Z-W|1-Z|1|10-12B|10-12G|10-D|10-K|10-KT|10-Q|10-QT|11-K|13F-HR|13F-NT|13FCONP|144|15-12B|15-12G|15-15D|15F-12B|15F-12G|15F-15D|18-12B|18-K|19B-4E|2-A|20-F|20FR12B|20FR12G|24F-2NT|25-NSE|25|253G1|253G2|253G4|3|305B2|4|40-17F1|40-17F2|40-17G|40-202A|40-203A|40-206A|40-24B2|40-33|40-6B|40-8B25|40-APP|40-F|40-OIP|40FR12B|424A|424B1|424B2|424B3|424B4|424B5|424B7|424B8|424H|425|485APOS|485BPOS|485BXT|486APOS|486BPOS|486BXT|487|497|497AD|497H2|497J|497K|497VPI|497VPU|5|6-K|6B NTC|6B ORDR|8-A12B|8-A12G|8-K|8-K12B|8-K12G3|8-M|8F-2 NTC|8F-2 ORDR|8F-2|ABS-15G|ABS-EE|ADV-E|ADV-H-C|ADV-H-T|ADV-NR|ANNLRPT|APP NTC|APP ORDR|APP WD|APP WDG|ARS|ATS-N-C|ATS-N|ATS-N/UA|AW WD|AW|C-AR-W|C-AR|C-TR-W|C-TR|C-U-W|C-U|C-W|C|CB|CERT|CERTARCA|CERTBATS|CERTCBO|CERTNAS|CERTNYS|CERTPAC|CFPORTAL|CORRESP|CT ORDER|D|DEF 14A|DEF 14C|DEFA14A|DEFA14C|DEFC14A|DEFM14A|DEFM14C|DEFN14A|DEFR14A|DEFR14C|DEL AM|DFAN14A|DFRN14A|DOS|DOSLTR|DRS|DRSLTR|DSTRBRPT|EFFECT|F-1|F-10|F-10EF|F-10POS|F-1MEF|F-3|F-3ASR|F-3D|F-4|F-4MEF|F-6 POS|F-6|F-6EF|F-7 POS|F-7|F-8|F-80|F-80POS|F-9 POS|F-9|F-N|F-X|FOCUSN|FWP|G-FIN|IRANNOTICE|MA-A|MA-I|MA-W|MA|MSD|MSDW|N-1|N-14 8C|N-14|N-14MEF|N-18F1|N-1A|N-2 POSASR|N-2|N-23C-2|N-23C3A|N-23C3B|N-2ASR|N-2MEF|N-30B-2|N-30D|N-4|N-5|N-54A|N-54C|N-6|N-6F|N-8A|N-8B-2|N-8F NTC|N-8F ORDR|N-8F|N-CEN|N-CR|N-CSR|N-CSRS|N-MFP|N-MFP1|N-MFP2|N-PX|N-Q|N-VP|N-VPFS|NO ACT|NPORT-EX|NPORT-NP|NPORT-P|NRSRO-CE|NRSRO-UPD|NSAR-A|NSAR-AT|NSAR-B|NSAR-BT|NSAR-U|NT 10-D|NT 10-K|NT 10-Q|NT 11-K|NT 20-F|NT N-CEN|NT N-MFP|NT N-MFP1|NT N-MFP2|NT NPORT-P|NT-NCEN|NT-NCSR|NT-NSAR|NTN 10D|NTN 10K|NTN 10Q|OIP NTC|OIP ORDR|POS 8C|POS AM|POS AMI|POS EX|POS462B|POS462C|POSASR|PRE 14A|PRE 14C|PREC14A|PREM14A|PREM14C|PREN14A|PRER14A|PRER14C|PRRN14A|PX14A6G|PX14A6N|QRTLYRPT|QUALIF|REG-NR|REVOKED|RW WD|RW|S-1|S-11|S-11MEF|S-1MEF|S-20|S-3|S-3ASR|S-3D|S-3DPOS|S-3MEF|S-4 POS|S-4|S-4EF|S-4MEF|S-6|S-8 POS|S-8|S-B|SBSE-A|SBSE-BD|SBSE-C|SBSE-W|SBSE|SC 13D|SC 13E3|SC 13G|SC 14D9|SC 14F1|SC 14N|SC TO-C|SC TO-I|SC TO-T|SC14D1F|SC14D9C|SC14D9F|SD|SE|SEC ACTION|SEC STAFF ACTION|SEC STAFF LETTER|SF-3|SL|STOP ORDER|SUPPL|T-3|TA-1|TA-2|TA-W|TACO|UNDER|UPLOAD|X-17A-5]`: List of single forms to search for (e.g. `-sf 10-K -sf "PRE 14A"`)
- `-peoi, --principal-executive-offices-in [AL|AK|AZ|AR|CA|CO|CT|DE|DC|FL|GA|HI|ID|IL|IN|IA|KS|KY|LA|ME|MD|MA|MI|MN|MS|MO|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PA|RI|SC|SD|TN|TX|UT|VT|VA|WA|WV|WI|WY|AB|BC|CAN|MB|NB|NL|NS|ON|PE|QC|SK|YT|AFG|ALA|ALB|DZA|ASM|AND|AGO|AIA|ATA|ATG|ARG|ARM|ABW|AUS|AUT|AZE|BHS|BHR|BGD|BRB|BLR|BEL|BLZ|BEN|BMU|BTN|BOL|BIH|BWA|BVT|BRA|IOT|BRN|BGR|BFA|BDI|KHM|CMR|CPV|CYM|CAF|TCD|CHL|CHN|CXR|CCK|COL|COM|COG|COD|COK|CRI|CIV|HRV|CUB|CYP|CZE|DNK|DJI|DMA|DOM|ECU|EGY|SLV|GNQ|ERI|EST|ETH|FLK|FRO|FJI|FIN|FRA|GUF|PYF|ATF|GAB|GMB|GEO|DEU|GHA|GIB|GRC|GRL|GRD|GLP|GUM|GTM|GGY|GIN|GNB|GUY|HTI|HMD|VAT|HND|HKG|HUN|ISL|IND|IDN|IRN|IRQ|IRL|IMN|ISR|ITA|JAM|JPN|JEY|JOR|KAZ|KEN|KIR|PRK|KOR|KWT|KGZ|LAO|LVA|LBN|LSO|LBR|LBY|LIE|LTU|LUX|MAC|MKD|MDG|MWI|MYS|MDV|MLI|MLT|MHL|MTQ|MRT|MUS|MYT|MEX|FSM|MDA|MCO|MNG|MNE|MSR|MAR|MOZ|MMR|NAM|NRU|NPL|NLD|ANT|NCL|NZL|NIC|NER|NGA|NIU|NFK|MNP|NOR|OMN|PAK|PLW|PSE|PAN|PNG|PRY|PER|PHL|PCN|POL|PRT|PRI|QAT|REU|ROU|RUS|RWA|BLM|SHN|KNA|LCA|MAF|SPM|VCT|WSM|SMR|STP|SAU|SEN|SRB|SYC|SLE|SGP|SVK|SVN|SLB|SOM|ZAF|SGS|ESP|LKA|SDN|SUR|SJM|SWZ|SWE|CHE|SYR|TWN|TJK|THA|TLS|TGO|TKL|TON|TTO|TUN|TUR|TKM|TCA|TUV|UGA|UKR|ARE|GBR|UMI|URY|UZB|VUT|VEN|VNM|VGB|VIR|WLF|ESH|YEM|ZMB|ZWE|XX]`: Search for the primary location associated with a filing. The principal executive
```

--------------------------------

### Search EDGAR Filings

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This code block allows users to search the EDGAR database using specified parameters such as text, date range, filing category, and optional entity or location filters. It's designed for interactive use in a notebook environment.

```python
# @markdown ### ⬅️ Click to search the EDGAR filings with the below parameters

text = "Ford Motor Company"  # @param {type:"string"}
start_date = "2024-12-01"  # @param {type:"date"}
end_date = "2024-12-31"  # @param {type:"date"}
filing_category = "all"  # @param ["all", "all_except_section_16", "all_annual_quarterly_and_current_reports", "all_section_16", "beneficial_ownership_reports", "exempt_offerings", "registration_statements", "filing_review_correspondence", "sec_orders_and_notices", "proxy_materials", "tender_offers_and_going_private_tx", "trust_indentures"]

# @markdown Optional: Company name, ticker, CIK number, or individual's name
entity_id = ""  # @param {type:"string"}

# @markdown Optional: Filter entities by incorporated or principal office location
filter_by_location = ""  # @param ["","Incorporated in", "Principal executive offices in"]
```

--------------------------------

### Text Search with Date Range and Custom Output File

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Searches for 'Tsunami Hazards' within a specified date range (January 1 to December 31, 2021) and exports results to a custom CSV file.

```shell
edgar text-search Tsunami Hazards --start-date 2021-01-01 --end-date 2021-12-31 --output my_custom.csv
```

--------------------------------

### Basic Text Search with EDGAR Tool

Source: https://github.com/bellingcat/edgar/blob/main/README.md

Performs a basic text search for 'John Doe' in the EDGAR database, defaulting to the last 5 years of records.

```shell
edgar text-search John Doe
```

--------------------------------

### Process and Map Selected Location to Enum for EDGAR Filtering (Python)

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This Python code block processes the user-selected `location` string. It normalizes the string by replacing spaces with underscores and converting it to uppercase. This normalized string is then used to retrieve the corresponding enum member from a `Location` enum. The resulting enum value is conditionally assigned to either `inc_in` (for 'Incorporated in' filter) or `peo_in` (for other filters), enabling location-based filtering in the EDGAR search.

```Python
inc_in = None
peo_in = None

# Replace spaces with underscores and make location uppercase
if filter_by_location and location:
  location_to_parse = location.replace(" ", "_").upper()
  location_as_enum = Location[location_to_parse]
  if filter_by_location == "Incorporated in":
      inc_in = location_as_enum
  else:
      peo_in = location_as_enum
```

--------------------------------

### Define Configurable Location Parameter for EDGAR Search (Python)

Source: https://github.com/bellingcat/edgar/blob/main/notebook/Bellingcat_EDGAR_Tool.ipynb

This Python snippet defines a configurable `location` variable, allowing users to select a specific US state, Canadian province, or country from a comprehensive dropdown list. This parameter is intended for filtering EDGAR search results by geographical location, though its value is ignored if the `filter_by_location` setting is not active.

```Python
location = ""  # @param ["", "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District Of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming", "Alberta", "British Columbia", "Canada", "Manitoba", "New Brunswick", "Newfoundland and Labrador", "Nova Scotia", "Ontario", "Prince Edward Island", "Quebec", "Saskatchewan", "Yukon", "Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos Keeling Islands", "Colombia", "Comoros", "Congo", "Congo Democratic Republic", "Cook Islands", "Costa Rica", "Cote Divoire", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia Republic", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea Bissau", "Guyana", "Haiti", "Heard and Mcdonald Islands", "Holy See Vatican City", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle Of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "North Korea", "South Korea", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russian Federation", "Rwanda", "Saint Barthelemy", "Saint Helena", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin", "Saint Pierre and Miquelon", "Saint Vincent and Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and South Sandwich Islands", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Eswatini", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Thailand", "Timor Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "British Virgin Islands", "US Virgin Islands", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe", "Unknown"]
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.