v3.3.1 Release Checklist

[nightlark]

• [x] Check that all expected release assets were compiled for all platforms, the *-source.tar.gz file, and the *-SHA-256.txt file; if any are missing see Steps to manually add a missing asset to a release below

• [x] Make sure https://github.com/GMLC-TDC/helics-packaging/blob/main/HELICS_VERSION has been updated with the new version number; if it hasn't, manually update it (and double check that all release assets were successfully compiled)

• [x] Update the helics-apps PyPI package by creating a new release with the new version tag, title, and description similar to past releases.

  • [x] Verify that the Build Python Packages workflow for the release (not tag) runs to completion
  • [x] Verify the files uploaded to PyPI at https://pypi.org/project/helics-apps/#files include wheel files for win32, win_amd64, macosx, and manylinux

• [x] Run the Update HELICS Packages workflow

  • [x] Verify that a PR was opened at https://github.com/spack/spack/pulls that looks okay and leave a review approving it. If the workflow failed or the package PR has CI errors, debug and fix
  • [x] Verify that a PR was opened at https://github.com/msys2/MINGW-packages/pulls that looks okay and leave a review approving it. If the workflow failed or the package PR has CI build errors, debug and fix
  • [ ] Verify pyhelics has been updated to include new/removed features, then create a new release with a matching version tag, and link to a changelog showing the difference between the two versions
  • [ ] Regenerate the matHELICS bindings using the C header file from HELICS, then create a new release with a version tag and link to the HELICS release notes.

• [x] Run helics-ns3 CI tests and fix any issues

• [x] Run Test HELICS Install Action with both binary and source options selected; fix any issues

---

If part of the Update HELICS Packages workflow fails, the failing part can be re-run on its own:

• Spack Package Update workflow
• MINGW Package Update workflow
• pyhelics Update HELICS Version workflow
• matHELICS Update HELICS Version workflow

---

Steps to manually add a missing asset to a release:

1. If it was a temporary issue such as a resource being unavailable, manually trigger the release build workflow using the workflow from Tag: v3.3.1.
2. If it was a more major issue, create a branch based on the tagged release and modify the workflow and scripts in the .github subfolder as needed to make it build. Manually trigger the release build workflow using the workflow from the branch with these fixes and for the commit-ish field enter the release tag v3.3.1.
3. Download the artifact from the workflow re-run that was missing and upload it to the release.
4. Download the SHA-256.txt file for the release and add an entry for the new asset (run the sha256sum command on Linux to get the line to add). Replace the old SHA-256.txt file for the release with the updated version.