File: README_dev.md

package info (click to toggle)
python-contextily 1.5.2%2Bdfsg1-4
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 944 kB
  • sloc: python: 1,092; makefile: 41
file content (31 lines) | stat: -rw-r--r-- 989 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# Development notes

## Testing

Testing relies on `pytest` and  `pytest-cov`. To run the test suite locally:

```
python -m pytest -v tests/ --cov contextily
```

This assumes you also have installed `pytest-cov`.

## Releasing

Cutting a release and updating to `pypi` requires the following steps (from
[here](https://packaging.python.org/tutorials/packaging-projects/)]):

* Make sure you have installed the following libraries:
    * `twine`
    * `setuptools`
    * `wheel`
* Make sure tests pass locally and on CI.
* Update the version on `setup.py` and `__init__.py`
* Commit those changes as `git commit 'RLS: v1.0.0'`
* Tag the commit using an annotated tag. ``git tag -a v1.0.0 -m "Version 1.0.0"``
* Push the RLS commit ``git push upstream main``
* Also push the tag! ``git push upstream --tags``
* Create sdist and wheel: `python setup.py sdist bdist_wheel`
* Make github release from the tag (also add the sdist as asset)
* When ready to push up, run `twine upload dist/*`.