Publishing to PyPI¶
Here we go for releasing a new version of Lino to the world. This usually involves several packages. We usually do such a series of releases when some production site needs an upgrade and hence the list of packages we release depends on what we need for that site.
We assume that you have configured your environment.
Check you have a clean working copy of all projects maintained by the Lino Team:
$ pp git pull
Check that all test suites are passing and all doc trees are building:
$ pp inv prep test clean -b bd
(Currently not used:) For every demo project that has a
test_restore.pyfile in its test suite, run
makemigdumpand add the new version to the
test_restore.pyfile. See Migration tests for details.
Decide which packages to release. In each package you can say
git logto decide whether there are relevant changes since the last release to pypi.
For each package you want to release:
Update the release notes and the changelog in the book.
Configure your environment¶
Of course you need maintainer's permission on PyPI for all projects.
You also need to configure your
[distutils] index-servers = pypi [pypi] username = __token__ password = pypi-SomeLongString
The twine software package should be installed on your linux distro. To check if you have twine installed on your machine, run:
$ twine --version
If you do not have twine installed on your machine, you can install it using aptitude or snap package manager (depending on your distro there maybe few other package managers that indexes twine), run the following command to install it using aptitude:
$ sudo apt install twine