Merge branch 'main' into claude/add-separate-pipeline-for-output-check

Author: ilaflott

.github/workflows/publish_conda.yml

@@ -18,12 +18,14 @@ jobs:
     steps:
       - name: Checkout Files
         uses: actions/checkout@v4
+        with:
+          submodules: 'recursive'
 
       - name: Setup Conda
         uses: conda-incubator/setup-miniconda@v3
         with:
           auto-activate-base: true
-          channels: conda-forge,noaa-gfdl
+          channels: conda-forge,noaa-gfdl,ilaflott
 
       - name: Configure Conda
         run: |
@@ -44,5 +46,5 @@ jobs:
       - name: Build fremorizer Conda Package
         run: |
           echo "conda building fremorizer package"
-          export ANACONDA_API_TOKEN=${{ secrets.ANACONDA_TOKEN }}
+          export ANACONDA_API_TOKEN=${{ secrets.TEMP_ANACONDA_API_TOKEN }}
           conda build .

.github/workflows/update_tag.yaml

@@ -1,34 +1,20 @@
-
 # `fremorizer`
+[![Anaconda-Server Badge](https://anaconda.org/ilaflott/fremorizer/badges/version.svg)](https://anaconda.org/ilaflott/fremorizer)
+[![Anaconda-Server Badge](https://anaconda.org/ilaflott/fremorizer/badges/latest_release_date.svg)](https://anaconda.org/ilaflott/fremorizer)
+[![Anaconda-Server Badge](https://anaconda.org/ilaflott/fremorizer/badges/latest_release_relative_date.svg)](https://anaconda.org/ilaflott/fremorizer)
 
-Simply put, `fremorizer` CMORizes FRE output with `CMOR`, it is a `conda` package.
-
-Documentation can be found on [`readthedocs`](https://fremorizer.readthedocs.io/en/latest/).
-
-
-<!-- [![Anaconda-Server Badge](https://anaconda.org/noaa-gfdl/fremorizer/badges/version.svg)](https://anaconda.org/noaa-gfdl/fremorizer)
-[![Anaconda-Server Badge](https://anaconda.org/noaa-gfdl/fremorizer/badges/latest_release_date.svg)](https://anaconda.org/noaa-gfdl/fremorizer)
-[![Anaconda-Server Badge](https://anaconda.org/noaa-gfdl/fremorizer/badges/latest_release_relative_date.svg)](https://anaconda.org/noaa-gfdl/fremorizer)
--->
-
-| Python 3.11 | Python 3.12 | Python 3.13 | Python 3.14 |
-|-------------|-------------|-------------|-------------|
-| [![3.11](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.11) | [![3.12](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.12) | [![3.13](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.13) | [![3.14](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.14) |
+[![publish_conda](https://github.com/ilaflott/fremorizer/actions/workflows/publish_conda.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/publish_conda.yml)
+[![readthedocs](https://app.readthedocs.org/projects/fremorizer/badge/?version=latest&style=flat)](https://fremorizer.readthedocs.io/en/latest/)
 
 [![pylint](https://github.com/ilaflott/fremorizer/actions/workflows/pylint.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/pylint.yml)
 [![pylint](https://img.shields.io/badge/pylint-%E2%89%A59.6-brightgreen)](https://github.com/NOAA-GFDL/epmt/actions/workflows/build_and_test_epmt.yml)
 [![codecov](https://codecov.io/gh/ilaflott/fremorizer/branch/main/graph/badge.svg)](https://codecov.io/gh/ilaflott/fremorizer)
-[![wcrp_compliance_check](https://github.com/ilaflott/fremorizer/actions/workflows/wcrp_compliance_check.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/wcrp_compliance_check.yml)
-
-[![publish_conda](https://github.com/ilaflott/fremorizer/actions/workflows/publish_conda.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/publish_conda.yml)
-[![readthedocs](https://app.readthedocs.org/projects/fremorizer/badge/?version=latest&style=flat)](https://fremorizer.readthedocs.io/en/latest/)
-
 
 [![esgf_qa_check](https://github.com/ilaflott/fremorizer/actions/workflows/esgf_qa_check.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/esgf_qa_check.yml)
 
+Simply put, `fremorizer` CMORizes FRE output with `CMOR`. 
 
-
-
+`fremorizer` is a `conda` package, it's documentation can be found on [`readthedocs`](https://fremorizer.readthedocs.io/en/latest/).
 
 
 
@@ -68,7 +54,7 @@ pip install .
 
 ### Via `conda` (COMING SOON)
 If you just want an environment named `fremorizer` with the package:
-```
+```bash
 # does not work yet, TODO
 conda create -n fremorizer noaa-gfdl::fremorizer
 conda activate fremorizer
@@ -209,6 +195,8 @@ To view QA results from a workflow run:
 ## Relationship to fre-cli
 ### WCRP Compliance Checking
 
+[![wcrp_compliance_check](https://github.com/ilaflott/fremorizer/actions/workflows/wcrp_compliance_check.yml/badge.svg?branch=main)](https://github.com/ilaflott/fremorizer/actions/workflows/wcrp_compliance_check.yml)
+
 The `wcrp_compliance_check` workflow validates CMORized NetCDF outputs against WCRP project
 specifications using [cc-plugin-wcrp](https://github.com/ESGF/cc-plugin-wcrp), a plugin for
 the [IOOS compliance-checker](https://github.com/ioos/compliance-checker). This pipeline:
@@ -224,6 +212,11 @@ To view compliance results from a workflow/CI run:
 2. Select the `wcrp_compliance_check` workflow run
 3. Download the `wcrp-compliance-reports` artifact
 
+### pipeline badges
+
+| Python 3.11 | Python 3.12 | Python 3.13 | Python 3.14 |
+|-------------|-------------|-------------|-------------|
+| [![3.11](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.11) | [![3.12](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.12) | [![3.13](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.13) | [![3.14](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml/badge.svg)](https://github.com/ilaflott/fremorizer/actions/workflows/create_test_conda_env.yml?query=branch%3Amain+python-version%3A3.14) |
 
 ## License
 
@@ -232,3 +225,19 @@ Apache License 2.0 — see [LICENSE.md](LICENSE.md)
 ## Conda-forge feedstock
 
 See `CONDA_FORGE_FEEDSTOCK_PLAN.md` for the steps and follow-up tasks to submit and maintain the conda-forge feedstock for `fremorizer`.
+
+## Releases and Versioning
+
+`fremorizer` uses a post-release scheme to identify development beyond the latest tagged version and tie the current `main` branch to a
+`conda` package versioned as `develop`. To avoid confusion with `fre-workflows` and `fre-cli`, which often demand that the version tags 
+match, `fremorizer`'s version format is `X.Y.Z[.post]`. 
+
+### new published release procedure 
+
+To publish new release carefully follow the below procedure:
+1. create a new branch off of `main`, which is already published to `conda` under `develop`/the previous tagged version + `.post`
+2. edit the version number in `fremorizer/_version.py` from the current one, to the desired version tag, remove `.post`, then open a PR. edit nothing else (usually).
+3. confirm the branch is functional by letting workflows finish, if you see green checks only, proceed. otherwise, stop and debug.
+4. draft a new release pointing to the PR branch, click release. the publishing workflow should trigger and finish, and you should see the `X.Y.Z` version in the conda channel.
+5. *releases in this repository are immutable*, **so even if the release workflow fails, breathe and move on to the next step.**
+6. edit the version number in `fremorizer/_version.py` to `X.Y.Z.post`, and merge the PR to main workflow steps passed. **`publish_conda`** will trigger again and upload what is in `main` under the `conda` version `develop` and `pip` version `X.Y.Z.post`

README.md

@@ -3,5 +3,5 @@
 """
 
 import os
-version = os.getenv("GIT_DESCRIBE_TAG", "2026.01.alpha1")
+version = os.getenv("GIT_DESCRIBE_TAG", "0.1.2.post")
 __version__ = version