Publish

Publishing a new version

Publication to PyPI is automated via GitHub actions. The workflow is triggered by version tags.

• Re-run and commit the example notebooks to make sure all documentation is up-to-date. They are not automatically re-run but deployed as-is!
• Update the __version__ string in xplt/__init__.py (including trailing zeros!)
• Push and make sure all checks pass (CI failures will not prevent releasing to PyPI!)
• Create a tag in the form v0.0.0 with matching version number (including trailing zeros!).
  • For major or minor releases, this should be done by creating a release on GitHub
  • For bug fix releases, only create the tag
  To keep the list of releases on GitHub concise, bug fix releases should be reflected by adding information to the corresponding "Version 0.0." minor release (where applicable) and pointing the release to the new tag. See previous releases for examples.*
• When the tag is created, the release action (see release.yaml) will automatically be triggered and will perform the deployment for you, i.e. it will

  Check that the tag matches the version string
  Publish the package to test.pypi.org
  Build the documentation and push it to the gh-pages branch, from where it is published on GitHub Pages
  Publish the package to pypi.org
  Show you a green light if everything went well