Skip to content

Latest commit

 

History

History
51 lines (44 loc) · 2.87 KB

RELEASE.md

File metadata and controls

51 lines (44 loc) · 2.87 KB
Raw

Release

PyMeasure package

  1. Pull the latest master branch
  2. git checkout -b v<version>_release
  3. Update CHANGES.rst with the changelog
    • On the repo page, go to Tags->Releases->Draft a new release
    • Add a dummy tag name and select "create tag on publish" -- we will not execute this, just use it to autogenerate a changelog
    • The button "Generate release notes" will generate Markdown text with all PRs since the last tag -- copy that into CHANGES.rst
    • Adapt the format and structure to the previous release message:
    • Divide the entries into categories and try to begin entries with "New", "Add", "Fix" or "Remove" as appropriate. (This could also be automated by the above generator with some labeling effort on our part)
    • We also remove the PR URLs as they clutter the log and condense the new contributors list.
  4. Update the version number in CITATION.cff
    • On the line starting with version: , replace the current version number with the new version number
  5. Push the changes up as a PR
  6. Verify that the builds complete
  7. Merge the PR
  8. Fetch master, build and check the source packages
    • python -m pip install --upgrade build twine
    • python -m build
    • Check the distributions (twine check dist/*, version will not yet be correct)
  9. Create a git tag in the format "vX.Y.Z"
  10. Build final packages and confirm the correct version number is being used
    • python -m build
    • Check the distributions (twine check dist/*)
  11. Push the Git tag
  12. Create a tagged release on GitHub. You'll have to paste in the changelog entry and probably edit it a bit as that form expects Markdown, not ReST (probably just removing :code: tags will be sufficient).

PyPI release

Official guide here.

  1. Upload the wheel and source distributions to the test server
    • python -m twine upload --repository testpypi dist/*
  2. Verify the test repository: https://test.pypi.org/project/PyMeasure
  3. Confirm that the installation works (best in a separate environment)
    • python -m pip install --index-url https://test.pypi.org/simple/ --no-deps pymeasure
  4. Upload to the real repository (twine upload dist/PyMeasure-<version>*)
  5. Verify that the package is updated: https://pypi.org/project/PyMeasure

conda-forge feedstock

  1. Release to PyPI first (the feedstock pulls from there)
  2. Pull the latest master branch
  3. git checkout -b v<version>_release
  4. Get the SHA256 hash of the PyPI source package at https://pypi.org/project/PyMeasure/#files
  5. Update recipe/meta.yml with the checksum and version number. Important: Work in your personal fork of the feedstock repo (the conda-forge tooling requires that) and create a PR from there.
  6. Push the changes up as a PR
  7. Verify that the builds complete
  8. Merge the PR