sec-edgar-downloader
====================
.. image:: https://github.com/jadchaar/sec-edgar-downloader/workflows/tests/badge.svg?branch=master
:alt: Build Status
:target: https://github.com/jadchaar/sec-edgar-downloader/actions?query=branch%3Amaster+workflow%3Atests
.. image:: https://codecov.io/gh/jadchaar/sec-edgar-downloader/branch/master/graph/badge.svg
:alt: Coverage Status
:target: https://codecov.io/gh/jadchaar/sec-edgar-downloader
.. image:: https://img.shields.io/pypi/v/sec-edgar-downloader.svg
:alt: PyPI Version
:target: https://python.org/pypi/sec-edgar-downloader
.. image:: https://img.shields.io/pypi/pyversions/sec-edgar-downloader.svg
:alt: Supported Python Versions
:target: https://python.org/pypi/sec-edgar-downloader
.. image:: https://img.shields.io/pypi/l/sec-edgar-downloader.svg
:alt: License
:target: https://python.org/pypi/sec-edgar-downloader
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:alt: Code Style: Black
:target: https://github.com/python/black
**sec-edgar-downloader** is a Python package for downloading `company filings <https://en.wikipedia.org/wiki/SEC_filing>`_ from the `SEC EDGAR database <https://www.sec.gov/edgar/searchedgar/companysearch.html>`_.
Searches can be conducted either by `stock ticker <https://en.wikipedia.org/wiki/Ticker_symbol>`_ or `Central Index Key (CIK) <https://en.wikipedia.org/wiki/Central_Index_Key>`_.
You can use the `SEC CIK lookup tool <https://www.sec.gov/edgar/searchedgar/cik.htm>`_ if you cannot find an appropriate ticker.
Quick Start
-----------
Installation
^^^^^^^^^^^^
Install and update this package using `pip <https://pip.pypa.io/en/stable/quickstart/>`_:
.. code-block:: console
$ pip install -U sec-edgar-downloader
Basic Usage
^^^^^^^^^^^
.. code-block:: python
from sec_edgar_downloader import Downloader
# Initialize a downloader instance. Download filings to the current
# working directory. Must declare company name and email address
# to form a user-agent string that complies with the SEC Edgar's
# programmatic downloading fair access policy.
# More info: https://www.sec.gov/os/webmaster-faq#code-support
# Company name and email are used to form a user-agent of the form:
# User-Agent: <Company Name> <Email Address>
dl = Downloader("MyCompanyName", "my.email@domain.com")
# Get all 8-K filings for Apple (ticker: AAPL)
dl.get("8-K", "AAPL")
# Get all 8-K filings for Apple, including filing amends (8-K/A)
dl.get("8-K", "AAPL", include_amends=True)
# Get all 8-K filings for Apple after January 1, 2017 and before March 25, 2017
# Note: after and before strings must be in the form "YYYY-MM-DD"
dl.get("8-K", "AAPL", after="2017-01-01", before="2017-03-25")
# Get the five most recent 8-K filings for Apple
dl.get("8-K", "AAPL", limit=5)
# Get all 10-K filings for Microsoft
dl.get("10-K", "MSFT")
# Get the latest 10-K filing for Microsoft
dl.get("10-K", "MSFT", limit=1)
# Get all 10-Q filings for Visa
dl.get("10-Q", "V")
# Get all 13F-NT filings for the Vanguard Group
dl.get("13F-NT", "0000102909")
# Get all 13F-HR filings for the Vanguard Group
dl.get("13F-HR", "0000102909")
# Get all SC 13G filings for Apple
dl.get("SC 13G", "AAPL")
# Get all SD filings for Apple
dl.get("SD", "AAPL")
Advanced Usage
^^^^^^^^^^^^^^
.. code-block:: python
from sec_edgar_downloader import Downloader
# Download filings to the current working directory
dl = Downloader("MyCompanyName", "my.email@domain.com", "/path/to/save/location")
# Get all 10-K filings for Microsoft without the filing details
dl.get("10-K", "MSFT", download_details=False)
# Get the latest supported filings, if available, for Apple
for filing_type in dl.supported_filings:
dl.get(filing_type, "AAPL", limit=1)
# Get the latest supported filings, if available, for a
# specified list of tickers and CIKs
equity_ids = ["AAPL", "MSFT", "0000102909", "V", "FB"]
for equity_id in equity_ids:
for filing_type in dl.supported_filings:
dl.get(filing_type, equity_id, limit=1)
Supported SEC Filing Types
--------------------------
This package supports downloading all SEC filing types (6-K, 8-K, 10-K, DEF 14A, S-1, and many others).
You can learn more about the different SEC filing types `here <https://www.investopedia.com/articles/fundamental-analysis/08/sec-forms.asp>`_).
Below is an exhaustive list of all filings types that can be downloaded by this package:
- 1
- 1-A
- 1-A POS
- 1-A-W
- 1-E
- 1-E AD
- 1-K
- 1-SA
- 1-U
- 1-Z
- 1-Z-W
- 10-12B
- 10-12G
- 10-D
- 10-K
- 10-KT
- 10-Q
- 10-QT
- 11-K
- 11-KT
- 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
- 2-AF
- 2-E
- 20-F
- 20FR12B
- 20FR12G
- 24F-2NT
- 25
- 25-NSE
- 253G1
- 253G2
- 253G3
- 253G4
- 3
- 305B2
- 34-12H
- 4
- 40-17F1
- 40-17F2
- 40-17G
- 40-17GCS
- 40-202A
- 40-203A
- 40-206A
- 40-24B2
- 40-33
- 40-6B
- 40-8B25
- 40-8F-2
- 40-APP
- 40-F
- 40-OIP
- 40FR12B
- 40FR12G
- 424A
- 424B1
- 424B2
- 424B3
- 424B4
- 424B5
- 424B7
- 424B8
- 424H
- 425
- 485APOS
- 485BPOS
- 485BXT
- 486APOS
- 486BPOS
- 486BXT
- 487
- 497
- 497AD
- 497H2
- 497J
- 497K
- 5
- 6-K
- 6B NTC
- 6B ORDR
- 8-A12B
- 8-A12G
- 8-K
- 8-K12B
- 8-K12G3
- 8-K15D5
- 8-M
- 8F-2 NTC
- 8F-2 ORDR
- 9-M
- ABS-15G
- ABS-EE
- ADN-MTL
- ADV-E
- ADV-H-C
- ADV-H-T
- ADV-NR
- ANNLRPT
- APP NTC
- APP ORDR
- APP WD
- APP WDG
- ARS
- ATS-N
- ATS-N-C
- ATS-N/UA
- AW
- AW WD
- C
- C-AR
- C-AR-W
- C-TR
- C-TR-W
- C-U
- C-U-W
- C-W
- CB
- CERT
- CERTARCA
- CERTBATS
- CERTCBO
- CERTNAS
- CERTNYS
- CERTPAC
- CFPORTAL
- CFPORTAL-W
- CORRESP
- CT ORDER
- D
- DEF 14A
- DEF 14C
- DEFA14A
- DEFA14C
- DEFC14A
- DEFC14C
- 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-3DPOS
- F-3MEF
- F-4
- F-4 POS
- F-4MEF
- F-6
- F-6 POS
- F-6EF
- F-7
- F-7 POS
- F-8
- F-8 POS
- F-80
- F-80POS
- F-9
- F-9 POS
- F-N
- F-X
- FOCUSN
- FWP
- G-405
- G-405N
- G-FIN
- G-FINW
- IRANNOTICE
- MA
- MA-A
- MA-I
- MA-W
- MSD
- MSDCO
- MSDW
- N-1
- N-14
- N-14 8C
- N-14MEF
- N-18F1
- N-1A
- N-2
- N-23C-2
- N-23C3A
- N-23C3B
- N-23C3C
- 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
- N-8F NTC
- N-8F ORDR
- N-CEN
- N-CR
- N-CSR
- N-CSRS
- N-MFP
- N-MFP1
- N-MFP2
- N-PX
- N-Q
- 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-EX
- NT NPORT-P
- NT-NCEN
- NT-NCSR
- NT-NSAR
- NTFNCEN
- NTFNCSR
- NTFNSAR
- NTN 10D
- NTN 10K
- NTN 10Q
- NTN 20F
- OIP NTC
- OIP ORDR
- POS 8C
- POS AM
- POS AMI
- POS EX
- POS462B
- POS462C
- POSASR
- PRE 14A
- PRE 14C
- PREC14A
- PREC14C
- PREM14A
- PREM14C
- PREN14A
- PRER14A
- PRER14C
- PRRN14A
- PX14A6G
- PX14A6N
- QRTLYRPT
- QUALIF
- REG-NR
- REVOKED
- RW
- RW WD
- S-1
- S-11
- S-11MEF
- S-1MEF
- S-20
- S-3
- S-3ASR
- S-3D
- S-3DPOS
- S-3MEF
- S-4
- S-4 POS
- S-4EF
- S-4MEF
- S-6
- S-8
- S-8 POS
- S-B
- S-BMEF
- SC 13D
- SC 13E1
- SC 13E3
- SC 13G
- SC 14D9
- SC 14F1
- SC 14N
- SC TO-C
- SC TO-I
- SC TO-T
- SC13E4F
- SC14D1F
- SC14D9C
- SC14D9F
- SD
- SDR
- SE
- SEC ACTION
- SEC STAFF ACTION
- SEC STAFF LETTER
- SF-1
- SF-3
- SL
- SP 15D2
- STOP ORDER
- SUPPL
- T-3
- TA-1
- TA-2
- TA-W
- TACO
- TH
- TTW
- UNDER
- UPLOAD
- WDL-REQ
- X-17A-5
Contributing
------------
If you encounter a bug or would like to see a new company filing or feature added to **sec-edgar-downloader**, please `file an issue <https://github.com/jadchaar/sec-edgar-downloader/issues>`_ or `submit a pull request <https://help.github.com/en/articles/creating-a-pull-request>`_.
Development
^^^^^^^^^^^
In order to validate local code changes before creating a pull request, you can run the following commands:
.. code-block:: bash
# Run unit test suite on all locally-installed Python versions
$ tox
# Run unit test suite on a single Python version (e.g. Python 3.11)
$ tox -e py311
# Run end-to-end integration tests
$ tox -e integration
# Lint
$ tox -e lint
# Validate documentation
$ tox -e docs
Release
^^^^^^^
In order to create a new release, complete the following steps:
1. Outline changes made in the new release in ``CHANGELOG.md``.
2. Bump the version in ``_version.py`` and push change to master branch.
3. Ensure all unit and integration tests pass locally and in the GitHub Actions testing workflow.
4. Create and push tags for the latest version specified in ``_version.py`` by running ``make tag``.
5. Once the tag is pushed, a `GitHub Actions release workflow <https://github.com/jadchaar/sec-edgar-downloader/actions/workflows/release.yml>`_ will be kicked off that automatically creates the package artifacts and uploads them to PyPI.
6. Create a new version based off of the published tag on the `GitHub repository's release page <https://github.com/jadchaar/sec-edgar-downloader/releases>`_.
Documentation
-------------
For full documentation, please visit `sec-edgar-downloader.readthedocs.io <https://sec-edgar-downloader.readthedocs.io>`_.
Raw data
{
"_id": null,
"home_page": null,
"name": "sec-edgar-downloader",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "sec,edgar,filing,financial,finance,stocks,mutual-funds,sec.gov",
"author": null,
"author_email": "Jad Chaar <jad.chaar@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/1a/44/00ba8183a52ea0ff7088006594b5a7980f7379b22def6f30671dc7ab5878/sec_edgar_downloader-5.0.2.tar.gz",
"platform": null,
"description": "sec-edgar-downloader\n====================\n\n.. image:: https://github.com/jadchaar/sec-edgar-downloader/workflows/tests/badge.svg?branch=master\n :alt: Build Status\n :target: https://github.com/jadchaar/sec-edgar-downloader/actions?query=branch%3Amaster+workflow%3Atests\n\n.. image:: https://codecov.io/gh/jadchaar/sec-edgar-downloader/branch/master/graph/badge.svg\n :alt: Coverage Status\n :target: https://codecov.io/gh/jadchaar/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/v/sec-edgar-downloader.svg\n :alt: PyPI Version\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/pyversions/sec-edgar-downloader.svg\n :alt: Supported Python Versions\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/pypi/l/sec-edgar-downloader.svg\n :alt: License\n :target: https://python.org/pypi/sec-edgar-downloader\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :alt: Code Style: Black\n :target: https://github.com/python/black\n\n**sec-edgar-downloader** is a Python package for downloading `company filings <https://en.wikipedia.org/wiki/SEC_filing>`_ from the `SEC EDGAR database <https://www.sec.gov/edgar/searchedgar/companysearch.html>`_.\nSearches can be conducted either by `stock ticker <https://en.wikipedia.org/wiki/Ticker_symbol>`_ or `Central Index Key (CIK) <https://en.wikipedia.org/wiki/Central_Index_Key>`_.\nYou can use the `SEC CIK lookup tool <https://www.sec.gov/edgar/searchedgar/cik.htm>`_ if you cannot find an appropriate ticker.\n\nQuick Start\n-----------\n\nInstallation\n^^^^^^^^^^^^\n\nInstall and update this package using `pip <https://pip.pypa.io/en/stable/quickstart/>`_:\n\n.. code-block:: console\n\n $ pip install -U sec-edgar-downloader\n\nBasic Usage\n^^^^^^^^^^^\n\n.. code-block:: python\n\n from sec_edgar_downloader import Downloader\n\n # Initialize a downloader instance. Download filings to the current\n # working directory. Must declare company name and email address\n # to form a user-agent string that complies with the SEC Edgar's\n # programmatic downloading fair access policy.\n # More info: https://www.sec.gov/os/webmaster-faq#code-support\n # Company name and email are used to form a user-agent of the form:\n # User-Agent: <Company Name> <Email Address>\n dl = Downloader(\"MyCompanyName\", \"my.email@domain.com\")\n\n # Get all 8-K filings for Apple (ticker: AAPL)\n dl.get(\"8-K\", \"AAPL\")\n\n # Get all 8-K filings for Apple, including filing amends (8-K/A)\n dl.get(\"8-K\", \"AAPL\", include_amends=True)\n\n # Get all 8-K filings for Apple after January 1, 2017 and before March 25, 2017\n # Note: after and before strings must be in the form \"YYYY-MM-DD\"\n dl.get(\"8-K\", \"AAPL\", after=\"2017-01-01\", before=\"2017-03-25\")\n\n # Get the five most recent 8-K filings for Apple\n dl.get(\"8-K\", \"AAPL\", limit=5)\n\n # Get all 10-K filings for Microsoft\n dl.get(\"10-K\", \"MSFT\")\n\n # Get the latest 10-K filing for Microsoft\n dl.get(\"10-K\", \"MSFT\", limit=1)\n\n # Get all 10-Q filings for Visa\n dl.get(\"10-Q\", \"V\")\n\n # Get all 13F-NT filings for the Vanguard Group\n dl.get(\"13F-NT\", \"0000102909\")\n\n # Get all 13F-HR filings for the Vanguard Group\n dl.get(\"13F-HR\", \"0000102909\")\n\n # Get all SC 13G filings for Apple\n dl.get(\"SC 13G\", \"AAPL\")\n\n # Get all SD filings for Apple\n dl.get(\"SD\", \"AAPL\")\n\nAdvanced Usage\n^^^^^^^^^^^^^^\n\n.. code-block:: python\n\n from sec_edgar_downloader import Downloader\n\n # Download filings to the current working directory\n dl = Downloader(\"MyCompanyName\", \"my.email@domain.com\", \"/path/to/save/location\")\n\n # Get all 10-K filings for Microsoft without the filing details\n dl.get(\"10-K\", \"MSFT\", download_details=False)\n\n # Get the latest supported filings, if available, for Apple\n for filing_type in dl.supported_filings:\n dl.get(filing_type, \"AAPL\", limit=1)\n\n # Get the latest supported filings, if available, for a\n # specified list of tickers and CIKs\n equity_ids = [\"AAPL\", \"MSFT\", \"0000102909\", \"V\", \"FB\"]\n for equity_id in equity_ids:\n for filing_type in dl.supported_filings:\n dl.get(filing_type, equity_id, limit=1)\n\nSupported SEC Filing Types\n--------------------------\n\nThis package supports downloading all SEC filing types (6-K, 8-K, 10-K, DEF 14A, S-1, and many others).\nYou can learn more about the different SEC filing types `here <https://www.investopedia.com/articles/fundamental-analysis/08/sec-forms.asp>`_).\nBelow is an exhaustive list of all filings types that can be downloaded by this package:\n\n- 1\n- 1-A\n- 1-A POS\n- 1-A-W\n- 1-E\n- 1-E AD\n- 1-K\n- 1-SA\n- 1-U\n- 1-Z\n- 1-Z-W\n- 10-12B\n- 10-12G\n- 10-D\n- 10-K\n- 10-KT\n- 10-Q\n- 10-QT\n- 11-K\n- 11-KT\n- 13F-HR\n- 13F-NT\n- 13FCONP\n- 144\n- 15-12B\n- 15-12G\n- 15-15D\n- 15F-12B\n- 15F-12G\n- 15F-15D\n- 18-12B\n- 18-K\n- 19B-4E\n- 2-A\n- 2-AF\n- 2-E\n- 20-F\n- 20FR12B\n- 20FR12G\n- 24F-2NT\n- 25\n- 25-NSE\n- 253G1\n- 253G2\n- 253G3\n- 253G4\n- 3\n- 305B2\n- 34-12H\n- 4\n- 40-17F1\n- 40-17F2\n- 40-17G\n- 40-17GCS\n- 40-202A\n- 40-203A\n- 40-206A\n- 40-24B2\n- 40-33\n- 40-6B\n- 40-8B25\n- 40-8F-2\n- 40-APP\n- 40-F\n- 40-OIP\n- 40FR12B\n- 40FR12G\n- 424A\n- 424B1\n- 424B2\n- 424B3\n- 424B4\n- 424B5\n- 424B7\n- 424B8\n- 424H\n- 425\n- 485APOS\n- 485BPOS\n- 485BXT\n- 486APOS\n- 486BPOS\n- 486BXT\n- 487\n- 497\n- 497AD\n- 497H2\n- 497J\n- 497K\n- 5\n- 6-K\n- 6B NTC\n- 6B ORDR\n- 8-A12B\n- 8-A12G\n- 8-K\n- 8-K12B\n- 8-K12G3\n- 8-K15D5\n- 8-M\n- 8F-2 NTC\n- 8F-2 ORDR\n- 9-M\n- ABS-15G\n- ABS-EE\n- ADN-MTL\n- ADV-E\n- ADV-H-C\n- ADV-H-T\n- ADV-NR\n- ANNLRPT\n- APP NTC\n- APP ORDR\n- APP WD\n- APP WDG\n- ARS\n- ATS-N\n- ATS-N-C\n- ATS-N/UA\n- AW\n- AW WD\n- C\n- C-AR\n- C-AR-W\n- C-TR\n- C-TR-W\n- C-U\n- C-U-W\n- C-W\n- CB\n- CERT\n- CERTARCA\n- CERTBATS\n- CERTCBO\n- CERTNAS\n- CERTNYS\n- CERTPAC\n- CFPORTAL\n- CFPORTAL-W\n- CORRESP\n- CT ORDER\n- D\n- DEF 14A\n- DEF 14C\n- DEFA14A\n- DEFA14C\n- DEFC14A\n- DEFC14C\n- DEFM14A\n- DEFM14C\n- DEFN14A\n- DEFR14A\n- DEFR14C\n- DEL AM\n- DFAN14A\n- DFRN14A\n- DOS\n- DOSLTR\n- DRS\n- DRSLTR\n- DSTRBRPT\n- EFFECT\n- F-1\n- F-10\n- F-10EF\n- F-10POS\n- F-1MEF\n- F-3\n- F-3ASR\n- F-3D\n- F-3DPOS\n- F-3MEF\n- F-4\n- F-4 POS\n- F-4MEF\n- F-6\n- F-6 POS\n- F-6EF\n- F-7\n- F-7 POS\n- F-8\n- F-8 POS\n- F-80\n- F-80POS\n- F-9\n- F-9 POS\n- F-N\n- F-X\n- FOCUSN\n- FWP\n- G-405\n- G-405N\n- G-FIN\n- G-FINW\n- IRANNOTICE\n- MA\n- MA-A\n- MA-I\n- MA-W\n- MSD\n- MSDCO\n- MSDW\n- N-1\n- N-14\n- N-14 8C\n- N-14MEF\n- N-18F1\n- N-1A\n- N-2\n- N-23C-2\n- N-23C3A\n- N-23C3B\n- N-23C3C\n- N-2MEF\n- N-30B-2\n- N-30D\n- N-4\n- N-5\n- N-54A\n- N-54C\n- N-6\n- N-6F\n- N-8A\n- N-8B-2\n- N-8F\n- N-8F NTC\n- N-8F ORDR\n- N-CEN\n- N-CR\n- N-CSR\n- N-CSRS\n- N-MFP\n- N-MFP1\n- N-MFP2\n- N-PX\n- N-Q\n- NO ACT\n- NPORT-EX\n- NPORT-NP\n- NPORT-P\n- NRSRO-CE\n- NRSRO-UPD\n- NSAR-A\n- NSAR-AT\n- NSAR-B\n- NSAR-BT\n- NSAR-U\n- NT 10-D\n- NT 10-K\n- NT 10-Q\n- NT 11-K\n- NT 20-F\n- NT N-CEN\n- NT N-MFP\n- NT N-MFP1\n- NT N-MFP2\n- NT NPORT-EX\n- NT NPORT-P\n- NT-NCEN\n- NT-NCSR\n- NT-NSAR\n- NTFNCEN\n- NTFNCSR\n- NTFNSAR\n- NTN 10D\n- NTN 10K\n- NTN 10Q\n- NTN 20F\n- OIP NTC\n- OIP ORDR\n- POS 8C\n- POS AM\n- POS AMI\n- POS EX\n- POS462B\n- POS462C\n- POSASR\n- PRE 14A\n- PRE 14C\n- PREC14A\n- PREC14C\n- PREM14A\n- PREM14C\n- PREN14A\n- PRER14A\n- PRER14C\n- PRRN14A\n- PX14A6G\n- PX14A6N\n- QRTLYRPT\n- QUALIF\n- REG-NR\n- REVOKED\n- RW\n- RW WD\n- S-1\n- S-11\n- S-11MEF\n- S-1MEF\n- S-20\n- S-3\n- S-3ASR\n- S-3D\n- S-3DPOS\n- S-3MEF\n- S-4\n- S-4 POS\n- S-4EF\n- S-4MEF\n- S-6\n- S-8\n- S-8 POS\n- S-B\n- S-BMEF\n- SC 13D\n- SC 13E1\n- SC 13E3\n- SC 13G\n- SC 14D9\n- SC 14F1\n- SC 14N\n- SC TO-C\n- SC TO-I\n- SC TO-T\n- SC13E4F\n- SC14D1F\n- SC14D9C\n- SC14D9F\n- SD\n- SDR\n- SE\n- SEC ACTION\n- SEC STAFF ACTION\n- SEC STAFF LETTER\n- SF-1\n- SF-3\n- SL\n- SP 15D2\n- STOP ORDER\n- SUPPL\n- T-3\n- TA-1\n- TA-2\n- TA-W\n- TACO\n- TH\n- TTW\n- UNDER\n- UPLOAD\n- WDL-REQ\n- X-17A-5\n\nContributing\n------------\n\nIf you encounter a bug or would like to see a new company filing or feature added to **sec-edgar-downloader**, please `file an issue <https://github.com/jadchaar/sec-edgar-downloader/issues>`_ or `submit a pull request <https://help.github.com/en/articles/creating-a-pull-request>`_.\n\nDevelopment\n^^^^^^^^^^^\n\nIn order to validate local code changes before creating a pull request, you can run the following commands:\n\n.. code-block:: bash\n\n # Run unit test suite on all locally-installed Python versions\n $ tox\n\n # Run unit test suite on a single Python version (e.g. Python 3.11)\n $ tox -e py311\n\n # Run end-to-end integration tests\n $ tox -e integration\n\n # Lint\n $ tox -e lint\n\n # Validate documentation\n $ tox -e docs\n\nRelease\n^^^^^^^\n\nIn order to create a new release, complete the following steps:\n\n1. Outline changes made in the new release in ``CHANGELOG.md``.\n2. Bump the version in ``_version.py`` and push change to master branch.\n3. Ensure all unit and integration tests pass locally and in the GitHub Actions testing workflow.\n4. Create and push tags for the latest version specified in ``_version.py`` by running ``make tag``.\n5. Once the tag is pushed, a `GitHub Actions release workflow <https://github.com/jadchaar/sec-edgar-downloader/actions/workflows/release.yml>`_ will be kicked off that automatically creates the package artifacts and uploads them to PyPI.\n6. Create a new version based off of the published tag on the `GitHub repository's release page <https://github.com/jadchaar/sec-edgar-downloader/releases>`_.\n\nDocumentation\n-------------\n\nFor full documentation, please visit `sec-edgar-downloader.readthedocs.io <https://sec-edgar-downloader.readthedocs.io>`_.\n",
"bugtrack_url": null,
"license": null,
"summary": "Download SEC filings from the EDGAR database using Python",
"version": "5.0.2",
"project_urls": {
"Documentation": "https://sec-edgar-downloader.readthedocs.io",
"Issues": "https://github.com/jadchaar/sec-edgar-downloader/issues",
"Source": "https://github.com/jadchaar/sec-edgar-downloader"
},
"split_keywords": [
"sec",
"edgar",
"filing",
"financial",
"finance",
"stocks",
"mutual-funds",
"sec.gov"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8cf0d6e043faf5a463c8d6e41b52c9b016c69bb1290bf2c1fee126882133d44f",
"md5": "1344f9f293f882ab22c77f3b1d97b7fa",
"sha256": "cab5ed1de1fce59722b609567f4c1790b2bf96308f7e6c74671e83b27dde7316"
},
"downloads": -1,
"filename": "sec_edgar_downloader-5.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1344f9f293f882ab22c77f3b1d97b7fa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14791,
"upload_time": "2023-10-08T05:33:58",
"upload_time_iso_8601": "2023-10-08T05:33:58.906538Z",
"url": "https://files.pythonhosted.org/packages/8c/f0/d6e043faf5a463c8d6e41b52c9b016c69bb1290bf2c1fee126882133d44f/sec_edgar_downloader-5.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1a4400ba8183a52ea0ff7088006594b5a7980f7379b22def6f30671dc7ab5878",
"md5": "4b9963e2f7faa58a3840294e2ef6cfbd",
"sha256": "65135b673c8ff1c4f2c400ae6828b8720ba5af3bc7c58729000ef741e3403e56"
},
"downloads": -1,
"filename": "sec_edgar_downloader-5.0.2.tar.gz",
"has_sig": false,
"md5_digest": "4b9963e2f7faa58a3840294e2ef6cfbd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 33009,
"upload_time": "2023-10-08T05:34:01",
"upload_time_iso_8601": "2023-10-08T05:34:01.583463Z",
"url": "https://files.pythonhosted.org/packages/1a/44/00ba8183a52ea0ff7088006594b5a7980f7379b22def6f30671dc7ab5878/sec_edgar_downloader-5.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-08 05:34:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jadchaar",
"github_project": "sec-edgar-downloader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "sec-edgar-downloader"
}
JSON
