Skip to content

Latest commit

 

History

History
62 lines (39 loc) · 1.78 KB

CONTRIBUTING.md

File metadata and controls

62 lines (39 loc) · 1.78 KB

Contributing to mplhep

We are happy to accept contributions to mplhep via Pull Requests to the GitHub repo. To get started fork the repo.

Pull Requests

Pull Requests Procedure

If you would like to make a pull request please:

  1. Make a fork of the project
  2. Commit your changes to a feature branch of your fork push to your branch
  3. Test your changes with pytest
  4. Test formatting with flake8 and run black.
  5. Make a PR

Bug Reports

TBD.

Installing the development environment

python -m pip install --ignore-installed -U -e .[complete]

Running the tests

You can run the unit tests (which should be fast!) via the following command.

py.test --mpl --ignore=tests/test_notebooks.py

Note: This ignores the notebook tests (which are run via papermill which run somewhat slow. Make sure to run the complete suite before submitting a PR

py.test --mpl

Making a pull request

We try to follow Conventional Commit for commit messages and PR titles. Since we merge PR's using squash commits, it's fine if the final commit messages (proposed in the PR body) follow this convention.

Generating Reference Visuals

If you modified expected outcomes of the test. New baseline visuals can be generated using this command:

py.test --mpl-generate-path=tests/baseline