Release procedure

Deciding

• Chat with other team members to see if they have anything else to go into the release

Check for disk space at PyPI

• https://pypi.org/manage/project/somacore/releases/
• You should be an admin, or, ask someone who is an admin to check for you
• https://pypi.org/manage/project/somacore/settings/ and look for "Project size"
• Make sure that isn't near 10GB (unlikely for this repo)
• If it is almost 10GB:
  • Your GitHub tag will succeed but the PyPI publish will fail
  • You can delete a few ancient releases as long as you're certain no one in the world depends on them
  • You can poke a button in PyPI to request a quota upsize but that can take a few days

Make the GitHub release tag per se

• Go to https://github.com/single-cell-data/SOMA/releases and poke 'Draft a new release'
• Choose a tag like python-v1.0.n where n is one more than the latest release
  • Note the python-v prefix, which we don't use for the TileDB-SOMA repo but which we do use for this
  • Make sure you've selected target = main
  • Title "Python v1.0.n" where n is as above
  • Poke the "Generate Release Notes" button
  • Edit the release notes if you like -- maybe a sentence at the top summarizing the context/reason -- maybe a GitHub tracking issue, for example
• Select 'Set as the latest release'
• Select 'Publish release'

Publication to PyPI

• This is automated
• Go to https://github.com/single-cell-data/SOMA/actions
• Find the action for publish to PyPI (should already be running)
  • You can click in for details
• In a few minutes, look for the latest wheel at https://pypi.org/project/somacore/#history

Conda feedstock

• Go to https://github.com/TileDB-Inc/somacore-feedstock
• Make a PR like https://github.com/TileDB-Inc/somacore-feedstock/pull/20
  • Update the version
  • To get the SHA256:
    • Go to the release you just tagged like https://github.com/single-cell-data/SOMA/releases/tag/python-v1.0.21
    • Find the "Source code" (.tar.gz) link and copy the link address
      • Like https://github.com/single-cell-data/SOMA/archive/refs/tags/python-v1.0.21.tar.gz
    • wget https://github.com/single-cell-data/SOMA/archive/refs/tags/python-v1.0.21.tar.gz
    • shasum -a 2556 python-v1.0.21.tar.gz
    • Put that in the PR as well
• Submit the PR for review
• Once it's merged go to https://github.com/TileDB-Inc/somacore-feedstock
• Click the yellow dot at Commits
  • Like https://github.com/TileDB-Inc/somacore-feedstock/runs/nnnnnnnnn
  • Wait for https://anaconda.org/tiledb/somacore/files
  • Wait another half hour or so for this to "propagate to Anaoconda CDN" before putting up a PR on the TileDB-SOMA repo's feedstock repo https://github.com/TileDB-Inc/tiledbsoma-feedstock