dgunning/edgartools — reverse-engineered prompt

Build me a Python library that makes SEC EDGAR filings easy to search, download, and analyze without dealing with raw HTML, XML, or messy SEC pages.

I want a simple API where someone can set their SEC identity email, look up a company by ticker, browse its filings, and pull useful structured data from common forms like 10 K, 10 Q, 8 K, Form 4 insider trades, and 13F holdings. Financial statements should come back in friendly Python objects and pandas DataFrames, including balance sheet, income statement, cash flow, and XBRL facts over time.

Please make it feel clean and reliable for analysts, investors, and data people. Include sensible caching, respect SEC rate limits, add type hints, useful errors, and examples that show common workflows like checking Apple financials, Tesla insider trades, and hedge fund holdings. Also include tests and basic docs so the package is easy to install and use from a notebook or script. Look up current SEC guidance and docs online if needed.