[forsyth2]

Bump to 3.3.0rc2

[forsyth2]

Creating zppy rc2

zppy's RC setup docs can be found here

Step 1: Testing

We'll just run the unit tests for now and then run the integration tests as part of the Unified testing.

# Set up branch
cd ~/ez/zppy
git status # Check for uncommitted changes
# nothing to commit, working tree clean
git fetch upstream main
git checkout main
git reset --hard upstream/main
# HEAD is now at e45286e8 Add snow storage, snow cover, river discharge analysis (#888)

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

# Set up conda environment
bash # Run bash so we're in an isolated subshell
lcrc_conda # Make sure conda is activated
rm -rf build
conda clean --all --y
conda env create -f conda/dev.yml -n zppy-rc2-20261019
conda activate zppy-rc2-20261019
pre-commit run --all-files
python -m pip install .

We already ran testing here.

Step 2: Determine what the new version should be

Reviewing the commit log, we find:

• New features and improvements to existing features (user-facing):
  • rc1: Enable EAMxx CMORization, E3SM Diags and add ts-level vertical regrid #827, Improve TC analysis workflow robustness for both EAM and EAMxx #828, Emit case identity and diagnostics URL in provenance cfg (SimBoard) #836, One authoritative production path per case; nest development by user #868, Zppy pcmdi enhancement #815, Allow specifying SLURM --mail-user and --mail-type in config file #878, Support ne256 in tc_analysis #879, Derive the EAMxx source vertical grid file at run time #864
  • rc2: Add snow storage, snow cover, river discharge analysis #888
• Performance improvements (user-facing):
  • rc2: E3SM-Unified 1.14 testing: faster diurnal climo on Perlmutter #890
• Documentation & examples:
  • rc1: Revamp docs to be more comprehensive #839, Add links to zi docs #842, Add tc_analysis to the EAMxx example (post.v3.eamxx.cfg) #843, Enable global_time_series plots for EAMxx (post.v3.eamxx.cfg) #847, Add SimBoard-compatible www inference via a new [simboard] config section #841
• Testing:
  • rc1: Add main branch testing automation #774, Rank image check failures by severity #865
• AI setup:
  • rc1: Rewrite AGENTS.md in second person #795
• DevOps:
  • rc1: Constrain sphinx <9.0.0 for sphinx-multiversion support #850, Add pre-commit auto-update workflow #853, Update pre-commit and its dependencies #854, Update pre-commit and its dependencies #862, Update pre-commit and its dependencies #880

These changes continue to justify a minor release. So, we'll keep the increment from zppy v3.2.0 to zppy v3.3.0.

Step 3: Confluence

The E3SM Unified version tracking page was already updated while making rc1

Version	Unified	zstash
Current version	e3sm-unified 1.13.0	0.2.1
Next versions	e3sm-unified 1.14.0	3.3.0 (updated today)

Step 4: tbump

cd ~/ez/zppy
git status # Check for uncommitted changes
# nothing to commit, working tree clean
git fetch upstream main
git checkout -b v3.3.0rc2 upstream/main
tbump 3.3.0rc2 --no-tag
git diff HEAD^ HEAD | cat # Looks good
git push upstream v3.3.0rc2
# Create, and "Update version" label" to, and merge https://github.com/E3SM-Project/zppy/pull/891

Created #891

Step 5: Tag the RC on the zppy repo

git checkout main
git fetch upstream
git reset --hard upstream/main
git tag -a v3.3.0rc2 -m "v3.3.0rc2"
# Delete the branch from the tbump step. Otherwise, the push command won't work.
git branch -D v3.3.0rc2
git push upstream v3.3.0rc2

Good, appears on Tags, but not on Releases

Step 6: zppy-feedstock repo

cd ~/zppy-feedstock
curl -sL https://github.com/E3SM-Project/zppy/archive/v3.3.0rc2.tar.gz | openssl sha256
# SHA2-256(stdin)= 451d8259029605adc4aef87265f89b78b1cb3e6adcfdc2c1d5345389c308a025
git status # Check for uncommitted changes
# nothing to commit, working tree clean
git fetch upstream dev
git checkout -b v3.3.0rc2 upstream/dev
emacs recipe/recipe.yaml
# version: 3.3.0rc2
# sha256: ... # The sha256 from the previous step
# number: 0 # build >>> number should always be 0

# From https://github.com/conda-forge/zppy-feedstock/pull/5#pullrequestreview-3351366258:
# Please always check the diff between the tag you're making a package for and the previous one. Please look for changes e.g. in dev.yml

# Review:
# https://github.com/E3SM-Project/zppy/compare/v3.3.0rc1...v3.3.0rc2

# conda/dev.yml has no changes

git add -A
git commit -m "v3.3.0rc2"
git push forsyth2 v3.3.0rc2

Created conda-forge/zppy-feedstock#40

[forsyth2]

# Delete the branch from the tbump step. Otherwise, the push command won't work.
git branch -D v3.3.0rc2
git push upstream v3.3.0rc2

Remember the branch must be deleted not only locally but also on GitHub!

[xylar]

Please update the instructions to use a different branch name.

[forsyth2]

Please update the instructions to use a different branch name.

Addressed on #893