Skip to content

Commit

Permalink
Test readme path
Browse files Browse the repository at this point in the history
  • Loading branch information
john-friedman committed Dec 18, 2024
1 parent 9707c62 commit ff2b0d2
Show file tree
Hide file tree
Showing 3 changed files with 79 additions and 61 deletions.
2 changes: 1 addition & 1 deletion datamule/setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@
setup(
name="datamule",
author="John Friedman",
version="0.408",
version="0.409",
description="Making it easier to use SEC filings.",
long_description=long_description,
license=license_text,
Expand Down
60 changes: 0 additions & 60 deletions readme.md

This file was deleted.

78 changes: 78 additions & 0 deletions readme.rst
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/>`_.

0 comments on commit ff2b0d2

Please sign in to comment.