-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
9707c62
commit ff2b0d2
Showing
3 changed files
with
79 additions
and
61 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,78 @@ | ||
Datamule | ||
======== | ||
|
||
Major Update | ||
------------ | ||
**Datamule has undergone a significant rework and is no longer backwards compatible. If this has affected your workflow please post on the github issues megathread. Sorry for the inconvenience.** | ||
|
||
.. image:: https://static.pepy.tech/badge/datamule | ||
:target: https://pepy.tech/project/datamule | ||
:alt: Downloads | ||
|
||
.. image:: https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fjohn-friedman%2Fdatamule-python&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false | ||
:target: https://hits.seeyoufarm.com | ||
:alt: Hits | ||
|
||
.. image:: https://img.shields.io/github/stars/john-friedman/datamule-python | ||
:alt: GitHub Stars | ||
|
||
A Python package for working with SEC filings at scale. | ||
`Full Documentation <https://john-friedman.github.io/datamule-python/>`_ | | ||
`Website <https://datamule.xyz/>`_ | ||
|
||
Features | ||
-------- | ||
|
||
* `Download SEC filings quickly and efficiently <https://john-friedman.github.io/datamule-python/usage/downloader.html>`_ | ||
* `Monitor EDGAR for new filings in real-time <https://john-friedman.github.io/datamule-python/usage/monitor.html>`_ | ||
* `Parse filings at scale <https://john-friedman.github.io/datamule-python/usage/parsing.html>`_ | ||
* `Access comprehensive datasets (10-Ks, SIC codes, etc.) <https://john-friedman.github.io/datamule-python/usage/datasets.html>`_ | ||
* `Build datasets directly from unstructured text <https://john-friedman.github.io/datamule-python/usage/dataset_builder.html>`_ | ||
* `Interact with SEC data using MuleBot <https://john-friedman.github.io/datamule-python/usage/mulebot.html>`_ | ||
|
||
Quick Start | ||
----------- | ||
|
||
Basic Installation | ||
~~~~~~~~~~~~~~~~~~ | ||
|
||
.. code-block:: bash | ||
pip install datamule | ||
Installation with all extras | ||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
||
.. code-block:: bash | ||
pip install datamule[all] | ||
Download submissions example | ||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
||
.. code-block:: python | ||
from datamule import Downloader | ||
downloader = Downloader() | ||
downloader.download_submissions(form='10-K', ticker='AAPL') | ||
Articles | ||
-------- | ||
* `How to host the SEC Archive for $20/month <https://medium.com/@jgfriedman99/how-to-host-the-sec-archive-for-20-month-da374cc3c3fb>`_ | ||
* `Creating Structured Datasets from SEC filings <https://medium.com/@jgfriedman99/how-to-create-alternative-datasets-using-datamule-d3a0192da8f6>`_ | ||
* `Deploy a Financial Chatbot in 5 Minutes <https://medium.com/@jgfriedman99/how-to-deploy-a-financial-chatbot-in-5-minutes-ef5eec973d4c>`_ | ||
|
||
Contributing | ||
------------ | ||
|
||
Contributions are welcome! Please feel free to submit a Pull Request. | ||
|
||
License | ||
------- | ||
|
||
`MIT License <LICENSE>`_ | ||
|
||
---- | ||
|
||
For detailed usage examples, API reference, and advanced features, please visit our `documentation <https://john-friedman.github.io/datamule-python/>`_. |