Bump to 0.2.0

[forsyth2]

Bump to 0.2.0

[forsyth2]

Providing a reference for future production releases. Here are the steps completed for this release:

Production release of zppy-interfaces v0.2.0

References:

• Somewhat outdated docs, made for zppy, on how to make a release: https://docs.e3sm.org/zppy/_build/html/main/dev_guide/release.html
• Notes from releasing v0.2.0rc2: Bump to 0.2.0rc2 #43

Step 1: setup/testing

cd ~/ez/zppy-interfaces
git status
# branch add-python3.14
# nothing to commit

We can skip the testing step, since that has been thoroughly covered:

• chrysalis
• compy
• perlmutter

Step 2: Bump versions

Step 2a: Confluence

Update https://e3sm.atlassian.net/wiki/spaces/DOC/pages/129732419/Packages+in+the+E3SM+Unified+conda+environment:

• E3SM Unified 1.11.0: zppy-interfaces v0.1.1
• E3SM Unified 1.11.1: zppy-interfaces v0.1.2
• E3SM Unified 1.12.0: zppy-interfaces v0.2.0 (We updated this when we made rc1)

Step 2b: zppy-interfaces repo

Bumping the Version

git fetch upstream main
git checkout -b v0.2.0 upstream/main
git log
# Bump to 0.2.0rc2 (#43)

# Good, matches https://github.com/E3SM-Project/zppy-interfaces/commits/main/

# Set up conda so we can use tbump:
lcrc_conda # Activate conda
rm -rf build
conda clean --all --y
conda env create -f conda/dev.yml -n zi_prod_release_20251120
conda activate zi_prod_release_20251120
python -m pip install .

tbump 0.2.0 --no-tag
# Error: Invalid config: 'Key "tbump" does not exist.'

# We'll need to update manually
git grep -n "0\.2\.0rc2"
# zppy_interfaces/version.py:1:__version__ = "0.2.0rc2"
#
# Yes, this matches up with changes in https://github.com/E3SM-Project/zppy-interfaces/pull/43
# Make corresponding changes here
git diff
# -__version__ = "0.2.0rc2"
# +__version__ = "0.2.0"
git add -A
pre-commit run --all-files
git commit -m "Bump to 0.2.0"
git push upstream v0.2.0
# Follow recent RCs as examples to make new PR:
# rc1: https://github.com/E3SM-Project/zppy-interfaces/pull/39
# rc2: https://github.com/E3SM-Project/zppy-interfaces/pull/43
# Set myself as author, set the label as "Update version"
# Merge https://github.com/E3SM-Project/zppy-interfaces/pull/45

Releasing on GitHub: production releases

Follow steps outlined here:

1. Draft a new release here. You can save this and come back to it later, if need be.
   • Click "Draft a new release".
2. Set Tag version to v0.2.0, including the “v”. @Target should be main.
   • Tag > Create new tag > v.0.2.0
3. Set Release title to v0.2.0, including the “v”.
4. Use "Describe this release" to summarize the changelog.
   • Copy draft of release notes to here.
5. Make sure "Set as the latest release" is checked.
6. Click Publish release.
   • Tag created here.
   • Unlike the RCs, v0.2.0 now appears on both Tags and Releases.
7. CI/CD release workflow is automatically triggered.
   • https://github.com/E3SM-Project/zppy-interfaces/actions/runs/19550991133 is just for the docs (which are not set up). Clicking "Publish release" is responsible for triggering the bot PR on conda-forge.

Step 2c: zppy-interfaces-feedstock repo

Releasing on conda-forge: production releases

Follow steps outlined here:

1. Wait for a bot PR to come up automatically on conda-forge after the GitHub release. This can happen anywhere from 1 hour to 1 day later. (Alternative: open an issue with the bot command: @conda-forge-admin, please update version and the PR will opened.)
   • Check https://github.com/conda-forge/zppy-interfaces-feedstock/pulls
   • See ENH: update package version to 0.2.0 conda-forge/zppy-interfaces-feedstock#9
2. Complete any requirements to merge the PR.
3. Check the https://anaconda.org/conda-forge/zppy-interfaces/files/manage page to view the newly updated package. Check it has the main label.