Publishing to PyPI

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

• 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.py and CHANGELOG.md.

5. Commit and push. Either:

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

   Or

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

   Then

   $ git push
   

6. Draft a new release on GitHub.

   • Use fluent.syntax@X.Y.Z or fluent.runtime@X.Y.Z 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
   $ twine upload dist/XXX.tar.gz    # the new package 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.