For maintainers, here are the basic steps when creating a new release of mistletoe.
- set a release version & commit chore: version <x.y.z>
- publish artifacts of the release
- official documentation: Packaging Python Projects
- install / upgrade the build tool:
$ python -m pip install --upgrade build - make sure there are no old relicts in the local "dist" folder
- build the Wheel artifact ("dist/*.whl"):
$ python -m build - upload the distribution archives to PyPi:
- install / upgrade Twine:
$ python -m pip install --upgrade twine - if unsure, upload to test PyPi and/or test locally - see docs
- do the upload to PyPi:
$ python -m twine upload dist/*- for the username, use
__token__, for the password, use your token from PyPi (see docs again how to do that)
- for the username, use
- check that you can install locally what you uploaded:
$ python -m pip install mistletoe
- install / upgrade Twine:
- create the release in GitHub
- attach the "dist/*.whl" from the previous step to the release (drag & drop) (source code archives are attached automatically)
- publish the release, let GitHub create a new Git tag automatically
- commit chore: next dev version