Skip to content

Latest commit

 

History

History
90 lines (64 loc) · 3.28 KB

CONTRIBUTING.md

File metadata and controls

90 lines (64 loc) · 3.28 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.

All code need to follow the PEP8 style guide with a few exceptions listed in tox.ini.

Before contributing, please review outstanding issues. If you'd like to contribute to something else, open an 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.