Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

Get Started!

Ready to contribute? Here's how to set up vivarium_models for local development.

Clone your fork locally:

git clone git@github.com:{your_name_here}/vivarium_models.git

Install the project in editable mode. (It is also recommended to work in a virtualenv or anaconda environment):
```
cd vivarium_models/
pip install -e .[dev]
```
Create a branch for local development:
```
git checkout -b {your_development_type}/short-description
```
Ex: feature/read-tiff-files or bugfix/handle-file-not-found
Now you can make your changes locally.
When you're done making changes, check that your changes pass linting and tests, including testing other Python versions with make:
```
make build
```

Commit your changes and push your branch to GitHub:

git add .
git commit -m "Resolves gh-###. Your detailed description of your changes."
git push origin {your_development_type}/short-description

A reminder for the maintainers on how to deploy. Make sure all your changes are committed. Then run:

bump2version patch # possible: major / minor / patch
git push
git push --tags

This will release a new package version on Git + GitHub and publish to PyPI.