CONTRIBUTING.md 1.25 KB
Newer Older
jvoisin's avatar
jvoisin committed
1 2 3 4 5 6 7 8 9
# Contributing to MAT2

The main repository for MAT2 is on [0xacab]( https://0xacab.org/jvoisin/mat2 ),
with a mirror on [gitlab.com]( https://gitlab.com/jvoisin/mat2 ).

Do feel free to pick up [an issue]( https://0xacab.org/jvoisin/mat2/issues )
and to send a pull-request. Please do check that everything is fine by running the
testsuite with `python3 -m unittest discover -v` before submitting one :)

10 11 12
If you're fixing a bug or adding a new feature, please add tests accordingly,
this will greatly improve the odds of your merge-request getting merged.

13 14 15 16 17 18
If you're adding a new fileformat, please add tests for:

1. Getting metadata
2. Cleaning metadata
3. Raising `ValueError` upon a corrupted file

jvoisin's avatar
jvoisin committed
19 20 21
Since MAT2 is written in Python3, please conform as much as possible to the
[pep8]( https://pep8.org/ ) style; except where it makes no sense of course.

jvoisin's avatar
jvoisin committed
22 23 24
# Doing a release

1. Update the [changelog](https://0xacab.org/jvoisin/mat2/blob/master/CHANGELOG.md)
25
2. Update the version in the [mat2](https://0xacab.org/jvoisin/mat2/blob/master/mat2) file
26
3. Update the version in the [setup.py](https://0xacab.org/jvoisin/mat2/blob/master/setup.py) file
27
4. Commit the changelog, mat2 and setup.py files
28 29
5. Create a tag with `git tag -s $VERSION`
6. Push the tag with `git push --tags`