Update to 1.0.0 alpha.1

.github/workflows/build_workflow.yml

@@ -51,7 +51,7 @@ jobs:
           extra_args: --files ${{ steps.file_changes.outputs.files}}
 
   build:
-    name: test polaris - py ${{ matrix.python-version }}${{ matrix.env_only && ' (env_only)' || '' }}
+    name: test polaris - py ${{ matrix.python-version }}
     runs-on: ubuntu-latest
     timeout-minutes: 20
     defaults:
@@ -60,10 +60,6 @@ jobs:
     strategy:
       matrix:
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
-        env_only: [false]
-        include:
-          - python-version: "3.14"
-            env_only: true
       fail-fast: false
     steps:
       - id: skip_check
@@ -76,47 +72,37 @@ jobs:
         uses: actions/checkout@v6
 
       - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
-        name: Cache Conda
-        uses: actions/cache@v5
-        env:
-          # Increase this value to reset cache if conda-dev-spec.template has not changed in the workflow
-          CACHE_NUMBER: 0
+        name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
         with:
-          path: ~/conda_pkgs_dir_py${{ matrix.python-version }}${{ matrix.env_only && '_envonly' || '' }}
-          key: ${{ runner.os }}-${{ matrix.python-version }}${{ matrix.env_only && '-envonly' || '' }}-conda-${{ env.CACHE_NUMBER }}-${{ hashFiles('configure_polaris_envs.py,deploy/*') }}
+          python-version: ${{ matrix.python-version }}
 
       - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
-        name: Set up Conda Environment
-        uses: mamba-org/setup-micromamba@v2
+        name: Cache pixi packages
+        uses: actions/cache@v5
+        env:
+          # Increase this value to reset cache if deploy inputs have not changed in the workflow
+          CACHE_NUMBER: 0
         with:
-          environment-name: polaris_test
-          init-shell: bash
-          condarc: |
-            channel_priority: strict
-            channels:
-                - conda-forge
-                - e3sm/label/polaris
-          create-args: >-
-            python=${{ matrix.python-version }}
+          path: |
+            ~/.cache/rattler/cache
+            ~/.pixi/bin
+          key: ${{ runner.os }}-${{ matrix.python-version }}-pixi-${{ env.CACHE_NUMBER }}-${{ hashFiles('deploy.py', 'deploy/**', 'pyproject.toml') }}
 
       - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
         name: Install polaris
         run: |
           git config --global url."https://github.com/".insteadOf "git@github.com:"
-          if [ "${{ matrix.env_only }}" = "true" ]; then
-            ./configure_polaris_envs.py \
-              --conda_env_only \
-              --env_name polaris_test \
-              --verbose \
-              --python=${{ matrix.python-version }}
-            source load_polaris_test.sh
-          else
-            ./configure_polaris_envs.py \
-              --env_name polaris_test \
-              --verbose \
-              --python=${{ matrix.python-version }}
-            source load_polaris_test_mpich.sh
+          ./deploy.py \
+            --no-spack \
+            --python ${{ matrix.python-version }} \
+            --recreate
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          if [ -z "$load_script" ]; then
+            echo "ERROR: no generated Polaris load script found" >&2
+            exit 1
           fi
+          source "$load_script"
           python -c "import polaris; import polaris.version; print(polaris.version.__version__)"
           polaris --help
           polaris list --help
@@ -125,21 +111,15 @@ jobs:
       - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
         name: Run unit tests
         run: |
-          if [ "${{ matrix.env_only }}" = "true" ]; then
-            source load_polaris_test.sh
-          else
-            source load_polaris_test_mpich.sh
-          fi
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          source "$load_script"
           pytest tests/
 
       - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
         name: Build Sphinx Docs
         run: |
-          if [ "${{ matrix.env_only }}" = "true" ]; then
-            source load_polaris_test.sh
-          else
-            source load_polaris_test_mpich.sh
-          fi
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          source "$load_script"
           DOCS_VERSION=test
           cd docs
           DOCS_VERSION=$DOCS_VERSION make versioned-html-strict

.github/workflows/docs_workflow.yml

@@ -25,49 +25,46 @@ jobs:
           persist-credentials: false
           fetch-depth: 0
 
-      - name: Cache Conda
+      - name: Set up Python ${{ env.PYTHON_VERSION }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Cache pixi packages
         uses: actions/cache@v5
         env:
-          # Increase this value to reset cache if deploy/conda-dev-spec.template has not changed in the workflow
+          # Increase this value to reset cache if deploy inputs have not changed in the workflow
           CACHE_NUMBER: 0
         with:
-          path: ~/conda_pkgs_dir
-          key: ${{ runner.os }}-conda-${{ env.CACHE_NUMBER }}-${{
-            hashFiles('configure_polaris_envs.py,deploy/*') }}
-
-      - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
-        name: Set up Conda Environment
-        uses: mamba-org/setup-micromamba@v2
-        with:
-          environment-name: polaris_test
-          init-shell: bash
-          condarc: |
-            channel_priority: strict
-            channels:
-                - conda-forge
-                - e3sm/label/polaris
-          create-args: >-
-            python=${{ env.PYTHON_VERSION }}
+          path: |
+            ~/.cache/rattler/cache
+            ~/.pixi/bin
+          key: ${{ runner.os }}-${{ env.PYTHON_VERSION }}-pixi-${{ env.CACHE_NUMBER }}-${{ hashFiles('deploy.py', 'deploy/**', 'pyproject.toml') }}
 
-      - if: ${{ steps.skip_check.outputs.should_skip != 'true' }}
-        name: Install polaris
+      - name: Install polaris
         run: |
           git config --global url."https://github.com/".insteadOf "git@github.com:"
-          ./configure_polaris_envs.py \
-            --conda_env_only \
-            --env_name polaris_test \
-            --verbose \
-            --python=${{ env.PYTHON_VERSION }}
-          source load_polaris_test.sh
+          ./deploy.py \
+            --no-spack \
+            --python ${{ env.PYTHON_VERSION }} \
+            --recreate
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          if [ -z "$load_script" ]; then
+            echo "ERROR: no generated Polaris load script found" >&2
+            exit 1
+          fi
+          source "$load_script"
 
       - name: Build Sphinx Docs
         run: |
-          source load_polaris_test.sh
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          source "$load_script"
           cd docs
           DOCS_VERSION=${{ github.ref_name }} make versioned-html
       - name: Copy Docs and Commit
         run: |
-          source load_polaris_test.sh
+          load_script=$(find . -maxdepth 1 -type f -name 'load_polaris*.sh' | sort | tail -n 1)
+          source "$load_script"
           cd docs
           # gh-pages branch must already exist
           git clone https://github.com/E3SM-Project/polaris.git --branch gh-pages --single-branch gh-pages

.gitignore

@@ -25,3 +25,20 @@ docs/_build/
 # build directories
 /build_mpas_ocean/
 /build_omega/
+
+# pixi
+.pixi/
+pixi.lock
+pixi-env/
+
+# vs code
+.vscode/
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# mache
+.mache_cache/