Publishing to PyPI

python-fluent hosts the code of the following packages available on PyPI:

• fluent.pygments
• fluent.syntax
• fluent.runtime

Setup

To publish new versions, first follow the setup instructions for twine and for the .pypirc file.

Publishing new versions

For either package:

1. From the root, ensure correct file permissions:

   $ git ls-tree --full-tree --name-only -r HEAD | xargs chmod ugo+r
   $ find . -type d | xargs chmod ugo+x
   

2. If you normally use a different umask, set umask to 000:

   $ umask 000
   

3. cd fluent.syntax or cd fluent.runtime

4. Update setup.cfg and CHANGELOG.rst.

5. Commit and push. One of:

   $ git commit -m "fluent.pygments X.Y.Z"
   $ git commit -m "fluent.syntax X.Y.Z"
   $ git commit -m "fluent.runtime X.Y.Z"
   

   Then

   $ git push
   

6. Draft a new release on GitHub.

   • Use [email protected] or [email protected] for the tag name
   • Use fluent.syntax X.Y.Z or fluent.runtime X.Y.Z for the release title.
   • Copy the relevant part of the CHANGELOG.

7. Publish:

   $ rm -rf *.egg-info build dist
   $ python setup.py sdist bdist_wheel
   $ twine upload dist/XXX.tar.gz dist/XXX.whl    # the new packages you just created
   

---

The fluent package

Up to version 0.10, the fluent.syntax module used to be published as fluent on PyPI. That package is still available but shouldn't be updated any more.