{"id":47473109,"url":"https://github.com/alphanome-ai/sec-parser","last_synced_at":"2026-04-08T21:00:56.066Z","repository":{"id":193712089,"uuid":"689363215","full_name":"alphanome-ai/sec-parser","owner":"alphanome-ai","description":"Parse SEC EDGAR HTML documents into a tree of elements that correspond to the visual (semantic) structure of the document.","archived":false,"fork":false,"pushed_at":"2025-03-25T05:03:49.000Z","size":2626,"stargazers_count":250,"open_issues_count":8,"forks_count":73,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-10-30T08:52:36.263Z","etag":null,"topics":["10-k","10-q","ai","artificial-intelligence","company-data","edgar-api","edgar-parser","edgar-scraper","filings","finance","financial-data","financial-filings","fintech","html-parser","investing","nlp","parser","sec","sec-edgar","sec-edgar-api"],"latest_commit_sha":null,"homepage":"https://parser.alphanome.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alphanome-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-09T15:13:18.000Z","updated_at":"2025-10-24T16:21:48.000Z","dependencies_parsed_at":"2023-09-09T16:00:52.268Z","dependency_job_id":"744549de-a403-469e-8392-289a9c500f2c","html_url":"https://github.com/alphanome-ai/sec-parser","commit_stats":{"total_commits":570,"total_committers":11,"mean_commits":51.81818181818182,"dds":0.09473684210526312,"last_synced_commit":"ffe830b2db7d1fadd190316bcee10b6a6a1dd583"},"previous_names":["alphanome-ai/sec-parser"],"tags_count":61,"template":false,"template_full_name":null,"purl":"pkg:github/alphanome-ai/sec-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphanome-ai%2Fsec-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphanome-ai%2Fsec-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphanome-ai%2Fsec-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphanome-ai%2Fsec-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alphanome-ai","download_url":"https://codeload.github.com/alphanome-ai/sec-parser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphanome-ai%2Fsec-parser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31573788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["10-k","10-q","ai","artificial-intelligence","company-data","edgar-api","edgar-parser","edgar-scraper","filings","finance","financial-data","financial-filings","fintech","html-parser","investing","nlp","parser","sec","sec-edgar","sec-edgar-api"],"created_at":"2026-03-25T10:00:25.232Z","updated_at":"2026-04-08T21:00:56.050Z","avatar_url":"https://github.com/alphanome-ai.png","language":"Python","funding_links":[],"categories":["Libraries \u0026 Tools"],"sub_categories":["Python"],"readme":"\u003cp align=\"center\"\u003e\u0026nbsp;\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003e\u003cb\u003esec-parser\u003c/b\u003e\u003c/h1\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003c!-- Using \u0026nbsp; for alignment due to GitHub README limitations --\u003e\n  \u003cb\u003eEssentials ➔\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/b\u003e\n  \u003ca href='https://sec-parser.readthedocs.io/en/latest/?badge=latest'\u003e\u003cimg src='https://readthedocs.org/projects/sec-parser/badge/?version=latest' alt='Documentation Status' /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"PyPI - License\" src=\"https://img.shields.io/pypi/l/sec-parser?color=success\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://project-types.github.io/#federation\"\u003e\u003cimg src=\"https://img.shields.io/badge/project%20type-federation-brightgreen\" alt=\"Project Type: Federation\"\u003e\u003c/a\u003e\n  \u003c!-- NOTE: After changing stability level here, also change it in pyproject.toml --\u003e\n  \u003ca href=\"https://github.com/mkenney/software-guides/blob/master/STABILITY-BADGES.md#beta\"\u003e\u003cimg src=\"https://img.shields.io/badge/stability-beta-33bbff.svg\" alt=\"Beta\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cb\u003eHealth ➔\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/b\u003e\n  \u003ca href=\"https://github.com/alphanome-ai/sec-parser/actions/workflows/ci.yml\"\u003e\u003cimg alt=\"GitHub Workflow Status: ci.yml\" src=\"https://img.shields.io/github/actions/workflow/status/alphanome-ai/sec-parser/ci.yml?label=ci\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/alphanome-ai/sec-parser/actions/workflows/cd.yml\"\u003e\u003cimg alt=\"GitHub Workflow Status: cd.yml\" src=\"https://img.shields.io/github/actions/workflow/status/alphanome-ai/sec-parser/cd.yml?label=cd\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/alphanome-ai/sec-parser/commits/main\"\u003e\u003cimg alt=\"Last Commit\" src=\"https://img.shields.io/github/last-commit/alphanome-ai/sec-parser\"\u003e\u003c/a\u003e  \n  \u003cbr\u003e\n  \u003cb\u003eQuality ➔\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/b\u003e\n  \u003ca href=\"https://app.codacy.com/gh/alphanome-ai/sec-parser/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade\"\u003e\u003cimg alt=\"Codacy grade\" src=\"https://img.shields.io/codacy/grade/8b7cb199e0954f2a892f80a3ce81fe42\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/alphanome-ai/sec-parser\"\u003e\u003cimg src=\"https://codecov.io/gh/alphanome-ai/sec-parser/graph/badge.svg?token=KJLA96CBCN\" alt=\"codecov\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://mypy-lang.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/type%20checked-mypy-success.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/psf/black\"\u003e\u003cimg alt=\"Code Style: Black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/astral-sh/ruff\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\" alt=\"Ruff\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cb\u003eDistribution ➔\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/b\u003e\n  \u003ca href=\"https://badge.fury.io/py/sec-parser\"\u003e\u003cimg src=\"https://badge.fury.io/py/sec-parser.svg\" alt=\"PyPI version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/sec-parser/\"\u003e\u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/sec-parser\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypistats.org/packages/sec-parser\"\u003e\u003cimg src=\"https://img.shields.io/pypi/dm/sec-parser?color=success\" alt=\"PyPI downloads\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cb\u003eCommunity ➔\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u003c/b\u003e\n  \u003ca href=\"https://discord.gg/2MC3uJhBxs\"\u003e\u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/1164249739836018698?logo=discord\u0026logoColor=white\u0026style=flat\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/alphanomeai\"\u003e\u003cimg alt=\"X (formerly Twitter) Follow\" src=\"https://img.shields.io/twitter/follow/alphanomeai\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/alphanome-ai/sec-parser\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/alphanome-ai/sec-parser.svg?style=social\u0026label=Star us on GitHub!\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"left\"\u003e\n  Parse SEC EDGAR HTML documents into a tree of elements that correspond to the visual structure of the document.\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cb\u003e\n  \u003ca href=\"https://parser.alphanome.app\"\u003eSee Demo\u003c/a\u003e |\n  \u003ca href=\"https://sec-parser.rtfd.io\"\u003eRead Docs\u003c/a\u003e |\n  \u003ca href=\"https://github.com/orgs/alphanome-ai/discussions\"\u003eJoin Discussions\u003c/a\u003e |\n  \u003ca href=\"https://discord.gg/2MC3uJhBxs\"\u003eJoin Discord\u003c/a\u003e\n  \u003c/b\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n# Overview\n\nThe `sec-parser` project simplifies extracting meaningful information from SEC EDGAR HTML documents by organizing them into semantic elements and a tree structure. Semantic elements might include section titles, paragraphs, and tables, each classified for easier data manipulation. This forms a semantic tree that corresponds to the visual and informational structure of the document. If you're familiar with the \u003ca href=\"https://www.google.com/search?tbm=isch\u0026q=image+semantic+segmentation\" target=\"_blank\"\u003eImage Semantic Segmentation\u003c/a\u003e concept, it's the same but applied to HTML documents.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/alphanome-ai/sec-parser/main/docs/semantic_segmentation.png\" width=\"300\"\u003e\n\u003c/div\u003e\n\nThis tool is especially beneficial for Artificial Intelligence (AI), Machine Learning (ML), and Large Language Models (LLM) applications by streamlining data pre-processing and feature extraction.\n\n- Explore the [**Demo**](https://parser.alphanome.app)\n- Read the [**Documentation**](https://sec-parser.rtfd.io)\n- Join the [**Discussions**](https://github.com/orgs/alphanome-ai/discussions) to get help, propose ideas, or chat with the community\n- Become part of our [**Discord**](https://discord.gg/2MC3uJhBxs) community\n- Report bugs in [**Issues**](https://github.com/alphanome-ai/sec-parser/issues)\n- Stay updated and contribute to our project's direction in [**Announcements**](https://github.com/orgs/alphanome-ai/discussions/categories/announcements) and [**Roadmap**](https://github.com/orgs/alphanome-ai/discussions/categories/roadmap-future-plans)\n- Learn How to [**Contribute**](https://github.com/alphanome-ai/sec-parser/blob/main/CONTRIBUTING.md)\n\n# Key Use-Cases\n\n`sec-parser` is versatile and can be applied in various scenarios, including but not limited to:\n\n#### Financial and Regulatory Analysis\n\n- Financial Analysis: Extract financial data from 10-Q and 10-K filings for quantitative modeling.\n- Risk Assessment: Evaluate risk factors or Management's Discussion and Analysis sections for qualitative analysis.\n- Regulatory Compliance: Assist in automating compliance checks for the legal teams.\n- Flexible Filtering: Easily filter SEC documents by sections and types, giving you precisely the data you need.\n\n#### Analytics and Data Science\n\n- Academic Research: Facilitate large-scale studies involving public financial disclosures, sentiment analysis, or corporate governance exploratory.\n- Analytics Ready: Integrate parsed data seamlessly into popular analytics tools for further analysis and visualization.\n\n#### AI and Machine Learning\n\n- Cutting-Edge AI for SEC EDGAR: Apply advanced AI techniques like MemWalker to navigate and extract and transform complex information from SEC documents efficiently. Learn more in our blog post: [Cutting-Edge AI for SEC EDGAR: Introducing MemWalker](https://github.com/orgs/alphanome-ai/discussions/18).\n- AI Applications: Leverage parsed data for various AI tasks such as text summarization, sentiment analysis, and named entity recognition.\n- Data Augmentation: Use authentic financial text to train and test machine learning models.\n\n#### Causal AI\n\n- Causal Analysis: Use parsed data to understand cause-effect relationships in financial data, beyond mere correlations.\n- Predictive Modeling: Enhance predictive models by incorporating causal relationships, leading to more robust and reliable predictions.\n- Decision Making: Aid decision-making processes by providing insights into the potential impact of different actions, based on causal relationships identified in the data.\n\n#### Large Language Models\n\n- LLM Compatible: Use parsed data to facilitate complex NLU tasks with Large Language Models like ChatGPT, including question-answering, language translation, and information retrieval.\n\nThese use-cases demonstrate the flexibility and power of `sec-parser` in handling both traditional data extraction tasks and facilitating more advanced AI-driven analysis.\n\n# Disclaimer\n\n\u003e [!IMPORTANT]\n\u003e This project, `sec-parser`, is an independent, open-source initiative and has no affiliation, endorsement, or verification by the United States Securities and Exchange Commission (SEC). It utilizes public APIs and data provided by the SEC solely for research, informational, and educational objectives. This tool is not intended for financial advisement or as a substitute for professional investment advice or compliance with securities regulations. The creators and maintainers make no warranties, expressed or implied, about the accuracy, completeness, or reliability of the data and analyses presented. Use this software at your own risk. For accurate and comprehensive financial analysis, consult with qualified financial professionals and comply with all relevant legal requirements. The project maintainers and contributors are not liable for any financial or legal consequences arising from the use of this tool.\n\n# Getting Started\n\nThis guide will walk you through the process of installing the `sec-parser` package and using it to extract the \"Segment Operating Performance\" section as a semantic tree from the latest Apple 10-Q filing.\n\n\u003e [!TIP]\n\u003e To run the example code in a ready-to-code environment, you can use GitHub Codespaces. Click the button below to open the example code below in a codespace and start experimenting with `sec-parser`:\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/alphanome-ai/sec-parser?devcontainer_path=.devcontainer/devcontainer.json)\n\n## Installation\n\nFirst, install the `sec-parser` package using pip:\n\n```bash\npip install sec-parser\n```\n\nTo run the example code in this README, you'll also need the `sec_downloader` package:\n\n```bash\npip install sec-downloader\n```\n\n## Usage\n\nOnce you've installed the necessary packages, you can start by downloading the filing from the SEC EDGAR website. Here's how you can do it:\n\n```python\nfrom sec_downloader import Downloader\n\n# Initialize the downloader with your company name and email\ndl = Downloader(\"MyCompanyName\", \"email@example.com\")\n\n# Download the latest 10-Q filing for Apple\nhtml = dl.get_filing_html(ticker=\"AAPL\", form=\"10-Q\")\n```\n\n\u003e [!NOTE]\n\u003e The company name and email address are used to form a user-agent string that adheres to the SEC EDGAR's fair access policy for programmatic downloading. [Source](https://www.sec.gov/os/webmaster-faq#code-support)\n\n\u003e [!TIP]\n\u003e Read [sec-downloader documentation](https://github.com/Elijas/sec-downloader) (and [examples](https://discord.com/channels/1164249739836018698/1247302201836175401/1247655286102298757)) for more advanced usage (such as downloading three latest Apple 10-Q filings instead of just one, or downloading based on a specific CIK or Filing ID (i.e. accession number)). \n\nNow, we can parse the filing HTML into a list of semantic elements:\n\n```python\n# Utility function to make the example code a bit more compact\ndef print_first_n_lines(text: str, *, n: int):\n    print(\"\\n\".join(text.split(\"\\n\")[:n]), \"...\", sep=\"\\n\")\n```\n\n```python\nimport sec_parser as sp\n\nelements: list = sp.Edgar10QParser().parse(html)\n\ndemo_output: str = sp.render(elements)\nprint_first_n_lines(demo_output, n=7)\n```\n\n\u003cpre\u003e\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTopSectionTitle:\u003c/font\u003e\u003c/b\u003e PART I  —  FINANCIAL INFORMATION\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTopSectionTitle:\u003c/font\u003e\u003c/b\u003e Item 1.    Financial Statements\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTitleElement:\u003c/font\u003e\u003c/b\u003e CONDENSED CONSOLIDATED STATEMENTS OF OPERATIONS (Unaudited)\n\u003cb\u003e\u003cfont color=\"navy\"\u003eSupplementaryText:\u003c/font\u003e\u003c/b\u003e (In millions, except number of ...housands and per share amounts)\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTableElement:\u003c/font\u003e\u003c/b\u003e Table with 24 rows, 80 numbers, and 1058 characters.\n\u003cb\u003e\u003cfont color=\"navy\"\u003eSupplementaryText:\u003c/font\u003e\u003c/b\u003e See accompanying Notes to Conde...solidated Financial Statements.\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTitleElement:\u003c/font\u003e\u003c/b\u003e CONDENSED CONSOLIDATED STATEMEN...OMPREHENSIVE INCOME (Unaudited)\n...\n\u003c/pre\u003e\n\n\n\u003e [!TIP]\n\u003e\n\u003e **FAQ: How do I get the text of each element (or all of the document)? How do I get all of the text in a specific section?**\n\u003e \n\u003e Use the `element.text` field. Check out [this notebook](https://github.com/Elijas/sec-parser-exploration/blob/main/00_mdna.ipynb) for a full example.\n\nWe can also construct a semantic tree to allow for easy filtering by parent sections:\n\n```python\ntree = sp.TreeBuilder().build(elements)\n\ndemo_output: str = sp.render(tree)\nprint_first_n_lines(demo_output, n=7)\n```\n\n\u003cpre\u003e\n\u003cb\u003e\u003cfont color=\"navy\"\u003eTopSectionTitle:\u003c/font\u003e\u003c/b\u003e PART I  —  FINANCIAL INFORMATION\n├── \u003cb\u003e\u003cfont color=\"navy\"\u003eTopSectionTitle:\u003c/font\u003e\u003c/b\u003e Item 1.    Financial Statements\n│   ├── \u003cb\u003e\u003cfont color=\"navy\"\u003eTitleElement:\u003c/font\u003e\u003c/b\u003e CONDENSED CONSOLIDATED STATEMENTS OF OPERATIONS (Unaudited)\n│   │   ├── \u003cb\u003e\u003cfont color=\"navy\"\u003eSupplementaryText:\u003c/font\u003e\u003c/b\u003e (In millions, except number of ...housands and per share amounts)\n│   │   ├── \u003cb\u003e\u003cfont color=\"navy\"\u003eTableElement:\u003c/font\u003e\u003c/b\u003e Table with 24 rows, 80 numbers, and 1058 characters.\n│   │   ├── \u003cb\u003e\u003cfont color=\"navy\"\u003eSupplementaryText:\u003c/font\u003e\u003c/b\u003e See accompanying Notes to Conde...solidated Financial Statements.\n│   ├── \u003cb\u003e\u003cfont color=\"navy\"\u003eTitleElement:\u003c/font\u003e\u003c/b\u003e CONDENSED CONSOLIDATED STATEMEN...OMPREHENSIVE INCOME (Unaudited)\n...\n\u003c/pre\u003e\n\n\u003e [!TIP]\n\u003e\n\u003e Feel free to experiment with the example code provided above. You can easily do this by launching a GitHub Codespace for the `sec-parser` repository, which will set up a development environment for you in the cloud:\n\u003e\n\u003e [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?machine_type=standardLinux32Gb\u0026repo=alphanome-ai/sec-parser)\n\u003e\n\u003e This is a great way to play around with the code without having to set up anything on your local machine. Give it a try!\n\nFor more examples and advanced usage, you can continue learning how to use `sec-parser` by referring to the [**User Guide**](https://sec-parser.readthedocs.io/en/latest/notebooks/user_guide.html), [**Developer Guide**](https://sec-parser.readthedocs.io/en/latest/notebooks/developer_guide.html), and [**Documentation**](https://sec-parser.rtfd.io).\n\n## This was an example of 10-Q SEC Form parsing. How do we parse other SEC Form types, such as 10-K, 8-K, S-1, etc.?\n\nPlease refer to [this document](https://github.com/Elijas/sec-parser-exploration/blob/main/02_other_sec_form_types.ipynb).\n\n## What's Next?\n\nYour turn to explore the capabilities of `sec-parser`! With the tools and examples provided, you can now dive into parsing and analyzing SEC filings.\n\nThe semantic elements and tree structures created by the parser will serve as a solid foundation for your financial analysis and research tasks with the tools of your choice.\n\nFor a tailored experience, consider using our free and open-source library for AI-powered financial analysis:\n\n```bash\npip install sec-ai\n```\n\n[**Explore `sec-ai` on GitHub**](https://github.com/alphanome-ai/sec-ai)\n\n# Best Practices\n\n## How to Import Modules In Your Code\n\nTo ensure your code remains functional even when we change the internal structure of `sec-parser`, it's recommended to avoid deep imports. Here is an example of a deep import (not recommended):\n\n\u003e [!CAUTION]\n\u003e \u003e `from sec_parser.semantic_tree.internal_utils.core import SomeInternalClass`\n\nInstead, use the suggested ways to import modules from `sec-parser`:\n\n### Root Import (prefix)\n\n- **`import sec_parser as sp`**. This imports the main package as `sp`. You can then access its functionalities using `sp.` prefix.\n\n### Root Import (direct)\n\n- **`from sec_parser import SomeClass`**: This allows you to directly use `SomeClass` without any prefix.\n\n### Submodule Import (prefix)\n\n- **`import sec_parser.semantic_tree`**: This imports the `semantic_tree` submodule, and you can access its classes and functions using `semantic_tree.` prefix.\n\n### Submodule Import (direct)\n\n- **`from sec_parser.semantic_tree import SomeClass`**: This imports a specific class `SomeClass` from the `semantic_tree` submodule.\n\n\u003e [!NOTE]\n\u003e The main package `sec_parser` contains only the most common functionalities. For specialized tasks, please use submodule or submodule-level imports.\n\n# Contributing\n\nFor information about setting up the development environment, coding standards, and contribution workflows, please refer to our [CONTRIBUTING.md](https://github.com/alphanome-ai/sec-parser/blob/main/CONTRIBUTING.md) guide.\n\n# License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/alphanome-ai/sec-parser/blob/main/LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphanome-ai%2Fsec-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falphanome-ai%2Fsec-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphanome-ai%2Fsec-parser/lists"}