Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 2.43 KB

CONTRIBUTING.md

File metadata and controls

59 lines (41 loc) · 2.43 KB
Raw

Contributing

Contributions to this repository are very welcome. If you are interested in contributing, feel free to contact us or create an issue in the issue tracking system. Alternatively, you may fork the project and submit a pull request. All contributions must be made under the same license as the rest of the project: MIT License. New code should be accompanied with appropriate unit tests and documentation; a brief description of the changes made should be added to the top of CHANGELOG.md. If this is your first contribution to the repository, please also add your details to CITATION.cff. If you are introducing new imports, then these must also be added to requirements.txt (in root and docs folders) and setup.py. After creating a pull request, the continuous integration tools will automatically run the unit tests, apply the pre-commit checks listed below, and build and deploy the Sphinx documentation (when merged into the main branch.)

Development

Clone the repository and install the dependencies (within a virtual environment):

$ git clone git@github.com:AI-SDC/ACRO.git
$ cd ACRO
$ pip install .

Then to run the tests:

$ pip install pytest
$ pytest .

Directory Structure

  • acro: contains ACRO source code.
  • data: contains data files for testing.
  • docs: contains Sphinx documentation.
  • notebooks: contains example notebooks.
  • stata: contains Stata wrapper code.
  • test: contains unit tests.

Style Guide

Python code should be linted with pylint.

A pre-commit configuration file is provided to automatically:

  • Trim trailing whitespace and fix line endings;
  • Check for spelling errors;
  • Check Yaml files;
  • Automatically format and lint with Ruff;

Pre-commit can be setup locally as follows:

$ pip install pre-commit

Then to run on all files locally:

$ pre-commit run -a

Make any corrections as necessary and re-run before committing the fixes and then pushing.

To install as a hook that executes with every git commit:

$ pre-commit install