|
a |
|
b/CONTRIBUTING.md |
|
|
1 |
# Contributing |
|
|
2 |
|
|
|
3 |
We are happy to incorporate any improvements to this package if you submit them as a pull request. To start development on this package, clone it to a location of your choice: |
|
|
4 |
|
|
|
5 |
```sh |
|
|
6 |
git clone https://github.com/nedap/deidentify.git |
|
|
7 |
``` |
|
|
8 |
|
|
|
9 |
We use conda for dependency management: |
|
|
10 |
|
|
|
11 |
```sh |
|
|
12 |
# Install package dependencies and add local files to the Python path of that environment. |
|
|
13 |
conda env create -f environment.yml |
|
|
14 |
conda activate deidentify && export PYTHONPATH="${PYTHONPATH}:$(pwd)" |
|
|
15 |
``` |
|
|
16 |
|
|
|
17 |
## Testing and Linting |
|
|
18 |
|
|
|
19 |
Execute the following to add the development dependencies to this project: |
|
|
20 |
|
|
|
21 |
```sh |
|
|
22 |
pip install -U -r requirements-dev.txt |
|
|
23 |
``` |
|
|
24 |
|
|
|
25 |
To run unit tests and code linting execute: |
|
|
26 |
|
|
|
27 |
```sh |
|
|
28 |
make test |
|
|
29 |
make lint |
|
|
30 |
``` |
|
|
31 |
|
|
|
32 |
## Release |
|
|
33 |
|
|
|
34 |
To create a GitHub and PyPI release, use following command. You will be prompted for your [GitHub access token](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) and PyPI credentials. |
|
|
35 |
|
|
|
36 |
```sh |
|
|
37 |
./release.sh <version> |
|
|
38 |
``` |