Pypi Packaging

Tutorial

https://packaging.python.org/tutorials/packaging-projects/

different and probably obsolete

• missing pyproject.toml
  • could that could be used to build local docs?
• READE.rst instead of README.md
• tests directory is lower in structure
• setup.cfg missing metadata
• no mention of release tag moin-2.0.0a8

Be sure that any uncommitted changes are stashed. See issue 1473.

On activated venv, update setuptools and twine.

pip install --upgrade setuptools wheel
pip install --upgrade twine
pip install --upgrade build

Switch to a release branch, make it current, generate a release tag on release branch

git tag 2.0.0a8

Build the distribution and upload to test.pypi.org. Was able to skip the token stuff under https://packaging.python.org/tutorials/packaging-projects/#uploading-the-distribution-archives

py -m build
py -m twine upload --repository testpypi dist/*

Test Distribution

Create a new venv, install moin, create instance, start server, create item, modify item.

<python> -m venv </path/to/new/virtual/environment>
cd </path/to/new/virtual/environment>
source bin/activate  # scripts\activate
pip install --upgrade pip  # next command fails with pip 9.0.1 and maybe later versions
pip install --pre --index-url https://test.pypi.org/simple --extra-index-url https://pypi.org/simple moin
moin create-instance --path <path/to/new/wikiconfig/dir>  * path optional, defaults to CWD
cd <path/to/new/wikiconfig/dir>  # skip if using default CWD
moin index-create -s -i
moin help  # prove it works
moin --help  # prove it works
moin run  # empty wiki
moin load-sample  # data but no index
moin index-build -i  # data with index