Skip to content

Latest commit

 

History

History
96 lines (70 loc) · 3.73 KB

CONTRIBUTING.md

File metadata and controls

96 lines (70 loc) · 3.73 KB
Raw

Contributing to CausalML

The CausalML project welcome community contributors. To contribute to it, please follow guidelines here.

The codebase is hosted on Github at https://github.com/uber/causalml.

We use black as a formatter to keep the coding style and format across all Python files consistent and compliant with PEP8. We recommend that you add black to your IDE as a formatter (see the instruction) or run black on the command line before submitting a PR as follows:

# move to the top directory of the causalml repository
$ cd causalml 
$ pip install -U black
$ black .

As a start, please check out outstanding issues. If you'd like to contribute to something else, open a new issue for discussion first.

Development Workflow 💻

  1. Fork the causalml repo. This will create your own copy of the causalml repo. For more details about forks, please check this guide at GitHub.
  2. Clone the forked repo locally
  3. Create a branch for the change:
$ git checkout -b branch_name
  1. Make a change
  2. Test your change as described below in the Test section
  3. Commit the change to your local branch
$ git add file1_changed file2_changed
$ git commit -m "Issue number: message to describe the change."
  1. Push your local branch to remote
$ git push origin branch_name
  1. Go to GitHub and create PR from your branch in your forked repo to the original causalml repo. An instruction to create a PR from a fork is available here

Documentation 📚

CausalML documentation is generated with Sphinx and hosted on Read the Docs.

Docstrings

All public classes and functions should have docstrings to specify their inputs, outputs, behaviors and/or examples. For docstring conventions in Python, please refer to PEP257.

CausalML supports the NumPy and Google style docstrings in addition to Python's original docstring with sphinx.ext.napoleon. Google style docstrings are recommended for simplicity. You can find examples of Google style docstrings here

Generating Documentation Locally

You can generate documentation in HTML locally as follows:

$ cd docs/
$ pip install -r requirements.txt
$ make html

Documentation will be available in docs/_build/html/index.html.

Test 🔧

If you added a new inference method, add test code to the tests/ folder.

Prerequisites

CausalML uses pytest for tests. Install pytest and pytest-cov, and the package dependencies:

$ pip install pytest pytest-cov -r requirements.txt

Building Cython

In order to run tests, you need to build the Cython modules

$ python setup.py build_ext --inplace

Testing

Before submitting a PR, make sure the change to pass all tests and test coverage to be at least 70%.

$ pytest -vs tests/ --cov causalml/

Submission 🎉

In your PR, please include:

  • Changes made
  • Links to related issues/PRs
  • Tests
  • Dependencies
  • References

Please add the core Causal ML contributors as reviewers.