pypkgrelease
An easier way to release new versions of simple Python packages, for very very lazy people
Usage
Instructions are for my projects -- your mileage may vary. Commands should be run from a folder containing setup.py
.
pypkg docs
- Build documentation
Execute and save Jupyter notebooks in the notebooks\
folder (i.e. tutorials)
> pypkg docs
[NbConvertApp] Converting notebook notebooks\EDI metadata.ipynb to notebook
[NbConvertApp] Executing notebook with kernel: python3
[NbConvertApp] Writing 13403 bytes to notebooks\EDI metadata.ipynb
[NbConvertApp] Converting notebook notebooks\Quickstart tutorial.ipynb to notebook
[NbConvertApp] Executing notebook with kernel: python3
[NbConvertApp] Writing 190905 bytes to notebooks\Quickstart tutorial.ipynb
[master 99aa355] "update jupyter notebooks" (via pypkg docs)
1 file changed, 6 insertions(+), 6 deletions(-)
pypkg version
- Increment version number
Bump the version number using bump2version and open an editor to describe the changes in the CHANGELOG.md. You can use either minor
, major
, or patch
depending on your .bumpversion.cfg
file setup.
> pypkg version minor
[master 3ebd2ef] Bump version: 0.3 → 0.4
Date: Sun Oct 7 15:33:34 2018 +1030
4 files changed, 7 insertions(+), 3 deletions(-)
pypkg dist
- Create source & binary distributions
> pypkg dist
running sdist
<snip>
removing build\bdist.win32\wheel
pypkg push github
- Update GitHub repo
> pypkg push github
Enumerating objects: 63, done.
Counting objects: 100% (63/63), done.
Delta compression using up to 4 threads
Compressing objects: 100% (53/53), done.
Writing objects: 100% (56/56), 5.26 KiB | 234.00 KiB/s, done.
Total 56 (delta 29), reused 0 (delta 0)
remote: Resolving deltas: 100% (29/29), completed with 4 local objects.
To https://github.com/kinverarity1/pypkgrelease
f5c26eb..3ebd2ef master -> master
* [new tag] v0.2 -> v0.2
* [new tag] v0.3 -> v0.3
* [new tag] v0.4 -> v0.4
pypkg push pypi [USERNAME]
- Upload new distributions to PyPI
> pypkg push pypi kinverarity
Password:
Uploading distributions to https://upload.pypi.org/legacy/
Uploading pypkgrelease-0.4-py2.py3-none-any.whl
100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 12.0k/12.0k [00:02<00:00, 5.45kB/s] Uploading pypkgrelease-0.4.tar.gz
100%|█████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 10.4k/10.4k [00:01<00:00, 7.60kB/s]