# Arelle
[](https://pypi.org/project/arelle-release/)
[](https://pypi.org/project/arelle-release/)
[](https://arelle.readthedocs.io/)
[](https://arelle.org/)
## Table of Contents
- [Arelle](#arelle)
- [Table of Contents](#table-of-contents)
- [Description](#description)
- [Documentation](#documentation)
- [Features](#features)
- [Need Support?](#need-support)
- [Arelle Within Other Products](#arelle-within-other-products)
- [EdgarRenderer or EFM Validations](#edgarrenderer-or-efm-validations)
- [Installing or Running Arelle](#installing-or-running-arelle)
- [Bug Report or Feature Request](#bug-report-or-feature-request)
- [Security Vulnerabilities](#security-vulnerabilities)
- [How-To and General XBRL Questions](#how-to-and-general-xbrl-questions)
- [Email](#email)
- [How To Contribute](#how-to-contribute)
- [License](#license)
## Description
Arelle is an end-to-end open source XBRL platform, which provides the XBRL community
with an easy to use set of tools. It supports XBRL and its extension features in
an extensible manner. It does this in a compact yet robust framework that can be
used as a desktop application and can be integrated with other applications and
languages utilizing its web service, command line interface, and Python API.
## Documentation
Need help with Arelle? Go check out [our documentation][read-the-docs].
[read-the-docs]: https://arelle.readthedocs.io/
## Features
- Fully-featured XBRL processor with GUI, CLI, Python API and Web Service API.
- Support for the XBRL Standard, including:
- XBRL v2.1 and XBRL Dimensions v1.0
- XBRL Formula v1.0
- Taxonomy Packages v1.0
- xBRL-JSON v1.0 and xBRL-CSV v1.0
- Inline XBRL v1.1
- Units Registry v1.0
- Certified by XBRL International as a [Validating Processor][certification].
- Support for filing programme validation rules:
- Edgar Filer Manual validation (US SEC)
- ESEF Reporting Manual (EU)
- HMRC (UK)
- CIPC (South Africa)
- FERC (US Federal Energy Regulatory Commission)
- Integrated support for [Arelle Inline XBRL Viewer][viewer].
- Extensible plugin architecture.
- Support for XF text-based Formula and XULE validation rules.
- The Web Service API allows XBRL integration with applications, such as those in
Excel, Java or Oracle.
- Instance creation is supported using forms defined by the table linkbase.
- Support for reading/monitoring US SEC XBRL RSS feeds (RSS Watch).
[viewer]: https://github.com/Arelle/ixbrl-viewer
[certification]: https://software.xbrl.org/processor/arelle-arelle
## Need Support?
Whether you've found a bug, need help with installation, have a feature request,
or want to know how to use Arelle, we can help! Here's a quick guide:
When reporting issues it's important to include as much information as possible:
- what version of Arelle are you using?
- how are you using Arelle (GUI, command line, web server, or the Python API?)
- what operating system (Windows, macOS, Ubuntu, etc.) are you using?
- what plugins if any do you have enabled?
- can you provide an XBRL report that recreates the issue?
- what's the diagnostics output (`arelleCmdLine.exe --diagnostics`) on your system?
### Arelle Within Other Products
A number of service providers embed Arelle within their XBRL products and tools.
If you're having an issue with Arelle within one of these offerings please
contact the developer of that tool for support or first verify that you have the
same issue when using Arelle directly. Most issues in these situations are caused
by the tool using an old version of Arelle or not running a valid command.
### EdgarRenderer or EFM Validations
The SEC develops and maintains the EdgarRenderer and EFM validation plugins. Please
report issues with these plugins directly to the SEC (<StructuredData@sec.gov>).
### Installing or Running Arelle
Most installation and startup issues can be resolved by downloading the latest version
of Arelle and performing a [clean install][clean-install]. If that doesn't resolve
the problem for you, please [report a bug](#bug-report-or-feature-request).
[clean-install]: https://arelle.readthedocs.io/en/latest/install.html#clean-install
### Bug Report or Feature Request
Please use the GitHub [issue tracker][github-issue-tracker] if you'd like to suggest
a new feature or report a bug.
Before opening a new issue, please:
- Check that the issue has not already been reported.
- Check that the issue has not already been fixed in the latest release.
- Be clear and precise (do not prose, but name functions and commands exactly).
- For bug reports include the version of Arelle you're using.
[github-issue-tracker]: https://github.com/Arelle/Arelle/issues
### Security Vulnerabilities
Identified a security concern? Email the Arelle team (<Support@arelle.org>) so we
can resolve the issue and make sure service providers and authorities who use Arelle
in production are prepared to update and apply security patches before notifying
the general public.
### How-To and General XBRL Questions
Have a question that isn't covered by the [documentation](#documentation)?
Join our [Arelle Google Group][google-group] and start a conversation with the Arelle
team and community of experts.
### Email
The Arelle team can also be reached by email (<Support@arelle.org>) for issues that
aren't a good fit for the other support channels. However, please note that you will
likely receive a faster response if you [open a GitHub issue][new-github-issue]
or start a new conversation in the [Arelle Google Group][google-group] where the
Arelle team is active and other people within the community can also see and respond
to your message.
[google-group]: https://groups.google.com/g/arelle-users
[new-github-issue]: https://github.com/Arelle/Arelle/issues/new/choose
## How To Contribute
Interested in contributing to Arelle? Awesome! Make sure to review our
[contribution guidelines][contribution guidelines].
[contribution guidelines]: https://arelle.readthedocs.io/en/latest/contributing.html
## 👥 Contributors
<div align="center">
<a href="https://github.com/Arelle/Arelle/graphs/contributors">
<img src="https://contrib.rocks/image?repo=Arelle/Arelle&max=100&columns=10" style="margin: 5px;" />
</a>
<p>Join our community and become a contributor today! 🚀 </p>
</div>
## License
[Apache License 2.0][license]
[license]: https://arelle.readthedocs.io/en/latest/license.html
Raw data
{
"_id": null,
"home_page": null,
"name": "arelle-release",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "xbrl",
"author": null,
"author_email": "\"arelle.org\" <support@arelle.org>",
"download_url": "https://files.pythonhosted.org/packages/1e/88/8f9cbede318b2883162ca9de4a61f14b87288357019259d956b05cdf7543/arelle_release-2.26.7.tar.gz",
"platform": "any",
"description": "# Arelle\n\n[](https://pypi.org/project/arelle-release/)\n[](https://pypi.org/project/arelle-release/)\n[](https://arelle.readthedocs.io/)\n\n[](https://arelle.org/)\n\n## Table of Contents\n\n- [Arelle](#arelle)\n - [Table of Contents](#table-of-contents)\n - [Description](#description)\n - [Documentation](#documentation)\n - [Features](#features)\n - [Need Support?](#need-support)\n - [Arelle Within Other Products](#arelle-within-other-products)\n - [EdgarRenderer or EFM Validations](#edgarrenderer-or-efm-validations)\n - [Installing or Running Arelle](#installing-or-running-arelle)\n - [Bug Report or Feature Request](#bug-report-or-feature-request)\n - [Security Vulnerabilities](#security-vulnerabilities)\n - [How-To and General XBRL Questions](#how-to-and-general-xbrl-questions)\n - [Email](#email)\n - [How To Contribute](#how-to-contribute)\n - [License](#license)\n\n## Description\n\nArelle is an end-to-end open source XBRL platform, which provides the XBRL community\nwith an easy to use set of tools. It supports XBRL and its extension features in\nan extensible manner. It does this in a compact yet robust framework that can be\nused as a desktop application and can be integrated with other applications and\nlanguages utilizing its web service, command line interface, and Python API.\n\n## Documentation\n\nNeed help with Arelle? Go check out [our documentation][read-the-docs].\n\n[read-the-docs]: https://arelle.readthedocs.io/\n\n## Features\n\n- Fully-featured XBRL processor with GUI, CLI, Python API and Web Service API.\n- Support for the XBRL Standard, including:\n - XBRL v2.1 and XBRL Dimensions v1.0\n - XBRL Formula v1.0\n - Taxonomy Packages v1.0\n - xBRL-JSON v1.0 and xBRL-CSV v1.0\n - Inline XBRL v1.1\n - Units Registry v1.0\n- Certified by XBRL International as a [Validating Processor][certification].\n- Support for filing programme validation rules:\n - Edgar Filer Manual validation (US SEC)\n - ESEF Reporting Manual (EU)\n - HMRC (UK)\n - CIPC (South Africa)\n - FERC (US Federal Energy Regulatory Commission)\n- Integrated support for [Arelle Inline XBRL Viewer][viewer].\n- Extensible plugin architecture.\n- Support for XF text-based Formula and XULE validation rules.\n- The Web Service API allows XBRL integration with applications, such as those in\n Excel, Java or Oracle.\n- Instance creation is supported using forms defined by the table linkbase.\n- Support for reading/monitoring US SEC XBRL RSS feeds (RSS Watch).\n\n[viewer]: https://github.com/Arelle/ixbrl-viewer\n[certification]: https://software.xbrl.org/processor/arelle-arelle\n\n## Need Support?\n\nWhether you've found a bug, need help with installation, have a feature request,\nor want to know how to use Arelle, we can help! Here's a quick guide:\n\nWhen reporting issues it's important to include as much information as possible:\n\n- what version of Arelle are you using?\n- how are you using Arelle (GUI, command line, web server, or the Python API?)\n- what operating system (Windows, macOS, Ubuntu, etc.) are you using?\n- what plugins if any do you have enabled?\n- can you provide an XBRL report that recreates the issue?\n- what's the diagnostics output (`arelleCmdLine.exe --diagnostics`) on your system?\n\n### Arelle Within Other Products\n\nA number of service providers embed Arelle within their XBRL products and tools.\nIf you're having an issue with Arelle within one of these offerings please\ncontact the developer of that tool for support or first verify that you have the\nsame issue when using Arelle directly. Most issues in these situations are caused\nby the tool using an old version of Arelle or not running a valid command.\n\n### EdgarRenderer or EFM Validations\n\nThe SEC develops and maintains the EdgarRenderer and EFM validation plugins. Please\nreport issues with these plugins directly to the SEC (<StructuredData@sec.gov>).\n\n### Installing or Running Arelle\n\nMost installation and startup issues can be resolved by downloading the latest version\nof Arelle and performing a [clean install][clean-install]. If that doesn't resolve\nthe problem for you, please [report a bug](#bug-report-or-feature-request).\n\n[clean-install]: https://arelle.readthedocs.io/en/latest/install.html#clean-install\n\n### Bug Report or Feature Request\n\nPlease use the GitHub [issue tracker][github-issue-tracker] if you'd like to suggest\na new feature or report a bug.\n\nBefore opening a new issue, please:\n\n- Check that the issue has not already been reported.\n- Check that the issue has not already been fixed in the latest release.\n- Be clear and precise (do not prose, but name functions and commands exactly).\n- For bug reports include the version of Arelle you're using.\n\n[github-issue-tracker]: https://github.com/Arelle/Arelle/issues\n\n### Security Vulnerabilities\n\nIdentified a security concern? Email the Arelle team (<Support@arelle.org>) so we\ncan resolve the issue and make sure service providers and authorities who use Arelle\nin production are prepared to update and apply security patches before notifying\nthe general public.\n\n### How-To and General XBRL Questions\n\nHave a question that isn't covered by the [documentation](#documentation)?\nJoin our [Arelle Google Group][google-group] and start a conversation with the Arelle\nteam and community of experts.\n\n### Email\n\nThe Arelle team can also be reached by email (<Support@arelle.org>) for issues that\naren't a good fit for the other support channels. However, please note that you will\nlikely receive a faster response if you [open a GitHub issue][new-github-issue]\nor start a new conversation in the [Arelle Google Group][google-group] where the\nArelle team is active and other people within the community can also see and respond\nto your message.\n\n[google-group]: https://groups.google.com/g/arelle-users\n[new-github-issue]: https://github.com/Arelle/Arelle/issues/new/choose\n\n## How To Contribute\n\nInterested in contributing to Arelle? Awesome! Make sure to review our\n[contribution guidelines][contribution guidelines].\n\n[contribution guidelines]: https://arelle.readthedocs.io/en/latest/contributing.html\n\n\n\n## \ud83d\udc65 Contributors\n\n<div align=\"center\">\n <a href=\"https://github.com/Arelle/Arelle/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=Arelle/Arelle&max=100&columns=10\" style=\"margin: 5px;\" />\n </a>\n <p>Join our community and become a contributor today! \ud83d\ude80 </p>\n</div>\n\n\n\n## License\n\n[Apache License 2.0][license]\n\n[license]: https://arelle.readthedocs.io/en/latest/license.html\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An open source XBRL platform.",
"version": "2.26.7",
"project_urls": {
"Blog": "https://arelle.org/arelle/blog/",
"Bug Reports": "https://github.com/Arelle/Arelle/issues/",
"Documentation": "https://arelle.org/arelle/documentation/",
"Downloads": "https://arelle.org/arelle/pub/",
"Homepage": "https://arelle.org/",
"Source Code": "https://github.com/Arelle/Arelle/",
"Support": "https://groups.google.com/g/arelle-users/"
},
"split_keywords": [
"xbrl"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "490c97c824283711de4ea1c6cd92e444ecd9760ae9ce93df588b23dc626d5e87",
"md5": "a1f7f587a572cebc6bf127d9b7b1a221",
"sha256": "116d1393a64a617122f27fb4cb740ff381c96e1b193e5f94071f1b56244b4e16"
},
"downloads": -1,
"filename": "arelle_release-2.26.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a1f7f587a572cebc6bf127d9b7b1a221",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 11193046,
"upload_time": "2024-05-01T18:27:12",
"upload_time_iso_8601": "2024-05-01T18:27:12.839005Z",
"url": "https://files.pythonhosted.org/packages/49/0c/97c824283711de4ea1c6cd92e444ecd9760ae9ce93df588b23dc626d5e87/arelle_release-2.26.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1e888f9cbede318b2883162ca9de4a61f14b87288357019259d956b05cdf7543",
"md5": "d74652809994ebe85de3f75b7bf0c236",
"sha256": "f07a0d03f31a94d4846f60279e868af093a98c0c0b9e6a6dd571f5bb40c19db0"
},
"downloads": -1,
"filename": "arelle_release-2.26.7.tar.gz",
"has_sig": false,
"md5_digest": "d74652809994ebe85de3f75b7bf0c236",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11439839,
"upload_time": "2024-05-01T18:27:16",
"upload_time_iso_8601": "2024-05-01T18:27:16.190882Z",
"url": "https://files.pythonhosted.org/packages/1e/88/8f9cbede318b2883162ca9de4a61f14b87288357019259d956b05cdf7543/arelle_release-2.26.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-01 18:27:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Arelle",
"github_project": "Arelle",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "certifi",
"specs": [
[
"==",
"2024.2.2"
]
]
},
{
"name": "lxml",
"specs": [
[
"==",
"5.2.1"
]
]
},
{
"name": "OpenPyXL",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "regex",
"specs": [
[
"==",
"2024.4.28"
]
]
},
{
"name": "isodate",
"specs": [
[
"==",
"0.6.1"
]
]
},
{
"name": "aniso8601",
"specs": [
[
"==",
"9.0.1"
]
]
},
{
"name": "CherryPy",
"specs": [
[
"==",
"18.9.0"
]
]
},
{
"name": "Cheroot",
"specs": [
[
"==",
"10.0.1"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"==",
"2.9.0.post0"
]
]
},
{
"name": "pycountry",
"specs": [
[
"==",
"23.12.11"
]
]
},
{
"name": "NumPy",
"specs": [
[
"==",
"1.24.4"
]
]
},
{
"name": "NumPy",
"specs": [
[
"==",
"1.26.2"
]
]
},
{
"name": "Matplotlib",
"specs": [
[
"==",
"3.7.4"
]
]
},
{
"name": "Matplotlib",
"specs": [
[
"==",
"3.8.2"
]
]
},
{
"name": "holidays",
"specs": [
[
"==",
"0.47"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2024.1"
]
]
},
{
"name": "Tornado",
"specs": [
[
"==",
"6.4"
]
]
},
{
"name": "PyCryptodome",
"specs": [
[
"==",
"3.20.0"
]
]
},
{
"name": "cx_Oracle",
"specs": [
[
"==",
"8.3.0"
]
]
},
{
"name": "pg8000",
"specs": [
[
"==",
"1.31.2"
]
]
},
{
"name": "PyMySQL",
"specs": [
[
"==",
"1.1.0"
]
]
},
{
"name": "pyodbc",
"specs": [
[
"==",
"5.1.0"
]
]
},
{
"name": "RDFLib",
"specs": [
[
"==",
"7.0.0"
]
]
},
{
"name": "graphviz",
"specs": [
[
"==",
"0.20.3"
]
]
},
{
"name": "Pillow",
"specs": [
[
"==",
"10.3.0"
]
]
},
{
"name": "pywin32",
"specs": [
[
"==",
"306"
]
]
},
{
"name": "tinycss2",
"specs": [
[
"==",
"1.3.0"
]
]
}
],
"tox": true,
"lcname": "arelle-release"
}
JSON
