Skip to main content

XBRL-Parser

PyPI PyPI - Status PyPI - Python Version GitHub PyPI - Downloads GitHub code size in bytes Documentation Status

XBRL-Parser

Py-xbrl is a python library that allows the user to easily parse XBRL-Documents. Py-xbrl is primarily build to parse Instance Documents (originally from the SEC) but can also be used to parse any type of XBRL Document as long as it follows the XBRL 2.1 Specification (2003)1 or the iXBRL 1.1 Specification(2013)2.

XBRL is a very information-rich markup language that can have highly complex structures. This library tries to capture as much of the original information as possible. Py-xbrl will automatically download and parse all referenced XBRL-Files like taxonomy schemas and linkbases. After parsing py-xbrl will organize all information in an object structure and return it to the user.

Please read the documentation for more information and examples!: https://py-xbrl.readthedocs.io

Installation

Py-xbrl can be installed via PIP:

pip install py-xbrl

see the documentation for more info.

Questions

If you have questions regarding the library please post them into the GitHub discussion forum.

Contributing

I am always happy to receive contributions. You can either work on an already created issue or create a new pull request. You can also create a pull request if you want to propose a change to the documentation on readthedocs.io. Please keep in mind that the goal of this library is to parse XBRL files correctly. Therefore, it is important that the unit tests work on any pull request. Additionally, py-xbrl should still be able to parse all xbrl files correctly. It is best to create a discussion in the GitHub discussion board before creating the pull request to avoid that a lot of work is done, but the pull request is not merged in the end.

  1. https://www.xbrl.org/Specification/XBRL-2.1/REC-2003-12-31/XBRL-2.1-REC-2003-12-31+corrected-errata-2013-02-20.html ↩

  2. https://www.xbrl.org/specification/inlinexbrl-part1/rec-2013-11-18/inlinexbrl-part1-rec-2013-11-18.html ↩

Metadata

Release files for py-xbrl 3.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py-xbrl 3.0.4
File Size Uploaded Provenance Actions
py_xbrl-3.0.4.tar.gz 63.7 kB With provenance Details for py_xbrl-3.0.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for py-xbrl 3.0.4
File Interpreter ABI Platform Actions
py_xbrl-3.0.4-py3-none-any.whl Python 3 none any Details for py_xbrl-3.0.4-py3-none-any.whl

Total release size: 121.8 kB

Release files / py_xbrl-3.0.4.tar.gz

Download URL py_xbrl-3.0.4.tar.gz
Size 63.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0338ed537f7f1716fa85cc66e3cb47fad56c67d1fd2c8ae09dc3490bd6a2d9f6
BLAKE2b-256 checksum
How to use checksums
da9ad544015d2af2ba628dbe3d2c6e138ed35aa5847bf0998c0a4356c68a6581
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / py_xbrl-3.0.4-py3-none-any.whl

Download URL py_xbrl-3.0.4-py3-none-any.whl
Size 58.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aaf03d44556a39fd5ed1b230bf46aacbe257c7a19e0c7784b217a9f374b3ccd0
BLAKE2b-256 checksum
How to use checksums
187fd66cd7c00f9d34ee95bc93a867122d3575f5ffef6cbfdb1283f7c1e8dcec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Security for py-xbrl 3.0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for py_xbrl-3.0.4.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.0.4 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page