We'd love for you to contribute to Arelle, but before you hit that "submit" button, make sure to:
- Sign and submit a Contributor License Agreement. It's a legal thing; we'll explain below.
- See if your changes play nice with our guidelines.
- Make sure your code aligns with our Coding Style.
We'd love to accept your commits! But first, some legal bits:
- If you are an individual writing original source code, sign an individual CLA.
- If you work for a company that wants to allow you to contribute your work, sign a corporate CLA.
Follow the links to get everything sorted. Email the signed form to [email protected], and we'll be ready to take your pull requests.
NOTE: Only original source code from people who have signed the CLA can be accepted into the main repository.
You'll be working with Python. The Arelle implementation aims to support all stable versions of Python (not prerelease versions) that are still receiving security support. Here's how to set up your environment:
Clone your fork
git clone https://github.com/<your-github-username>/Arelle.git
Create the Pyenv Virtual environment
- Install pyenv
- Install a supported version of Python. For example,
pyenv install 3.12.1
- Create a virtual env using the Python version you just installed. For example,
PYENV_VERSION=3.12.1 pyenv exec python -m venv venv
- Activate your environment:
source venv/bin/activate
Install dependencies
pip install -r requirements-dev.txt
Verify you can run the app
- GUI:
python arelleGUI.pyw
- CLI:
python arelleCmdLine.py
If you have improvements or bug fixes for Arelle, send us your pull requests! For those just getting started, Github has a how to.
Arelle team members will be assigned to review your pull requests. Once the pull requests are approved and tested an Arelle team member will merge your request.
If you want to contribute, start working through the Arelle codebase, navigate to the Github "issues" tab and start looking through interesting issues. If you decide to start on an issue, leave a comment so that other people know that you're working on it. If you want to help out, but not alone, use the issue comment thread to coordinate.
Before submitting your pull request for review, make sure your changes are consistent with the guidelines and follow the Arelle coding style.
- When you contribute a bug fix to Arelle, make sure to fully document the bug and how it was fixed in the PR. Additionally, supply possible ways that the fix could be manually tested. This will greatly improve the testing and time required to merge the fix.
- When you contribute a new feature or plugin to Arelle, make sure to include documentation in the code with a markdown file on how to use the feature/plugin and what benefit it provides.
- When you contribute a new feature or plugin to Arelle, make sure to point at the documentation in the PR and supply ways the new feature/plugin could be manually tested. This will make testing significantly easier for the Arelle team and reduce the time required to merge the feature.
- When you contribute a new feature or plugin to Arelle, the maintenance burden is (by default) transferred to the Arelle team. This means that the benefit of the contribution must be compared against the cost of maintaining the feature.
- Write one or more paragraphs with details, wrapped at 72 characters.
- Write in the present tense: "Fix bug" not "Fixed bug".
- Separate paragraphs with a single blank line.
- No markup, please! Commit messages should be plain text.
Include a license at the top of new Python files (example).
Stick to the PEP8 guidelines and use mixedCase
for variable and function
names.