DEV - Set a canonical default Python version (3.12)

.github/workflows/build_docker_image.yaml

@@ -25,6 +25,10 @@ jobs:
       - name: "Checkout Repository 🛎"
         uses: actions/checkout@v4
 
+      - name: "Get project's default Python version 🏷️"
+        run: |
+          echo "PYTHON_VERSION_DEFAULT=$(cat .python-version-default)" >> $GITHUB_ENV
+
       - name: "Retrieve secret from Vault 🗝"
         uses: hashicorp/vault-action@v3
         with:
@@ -83,3 +87,5 @@ jobs:
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
+          build-args: |
+            python_version=${{ env.PYTHON_VERSION_DEFAULT }}

.github/workflows/release.yaml

@@ -20,7 +20,7 @@ permissions:
 jobs:
   # Always build & verify package.
   build-package:
-    name: Build & verify package
+    name: "Build & verify package"
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -55,7 +55,7 @@ jobs:
 
   # Upload to Test PyPI on every commit on main
   release-test-pypi:
-    name: Publish in-dev to test.pypi.org
+    name: "Publish in-dev to test.pypi.org"
     environment: release-test-pypi
     if: github.repository_owner == 'conda-incubator' && github.event_name == 'push' && github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
@@ -82,9 +82,9 @@ jobs:
           print-hash: true
           verbose: true
 
-
+  # Upload to PyPI on every tag/release
   release-pypi:
-    name: Publish released package to pypi.org
+    name: "Publish released package to pypi.org"
     environment: release-pypi
     if:  github.repository_owner == 'conda-incubator' && github.event_name == 'release' && startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest
@@ -128,6 +128,15 @@ jobs:
       - name: "Checkout Repository 🛎"
         uses: actions/checkout@v4
 
+      - name: "Get project's default Python version 🏷️"
+        run: |
+          echo "PYTHON_VERSION_DEFAULT=$(cat .python-version-default)" >> $GITHUB_ENV
+
+      - name: "Copy .dockerignore"
+        run: |
+          cp .dockerignore ${{ matrix.docker-image }}/.dockerignore
+        shell: bash
+
       - name: "Retrieve secret from Vault 🗝"
         uses: hashicorp/vault-action@v2
         with:
@@ -177,6 +186,7 @@ jobs:
           file: "${{ matrix.docker-image }}/Dockerfile"
           build-args: |
             RELEASE_VERSION=${{github.ref_name}}
+            python_version=${{ env.PYTHON_VERSION_DEFAULT }}
           tags: |
             ${{ steps.meta.outputs.tags }}
           push: true

.github/workflows/test_build_docker_image.yaml

@@ -1,7 +1,6 @@
 name: "Test build Docker image"
 
 env:
-  DEFAULT_PYTHON_VERSION: "3.10"
   FORCE_COLOR: "1" # Make tools pretty.
   PYTHONUNBUFFERED: "1" # Make stdout and stderr behave well
 
@@ -37,6 +36,10 @@ jobs:
       - name: "Checkout Repository 🛎"
         uses: actions/checkout@v4
 
+      - name: "Get project's default Python version 🏷️"
+        run: |
+          echo "PYTHON_VERSION_DEFAULT=$(cat .python-version-default)" >> $GITHUB_ENV
+
       - name: "Set up Docker Buildx 🏗"
         uses: docker/setup-buildx-action@v3
 
@@ -73,3 +76,5 @@ jobs:
           labels: ${{ steps.meta.outputs.labels }}
           cache-from: type=gha
           cache-to: type=gha,mode=max
+          build-args: |
+            python_version=${{ env.PYTHON_VERSION_DEFAULT }}

.github/workflows/test_conda_store.yaml

@@ -1,7 +1,6 @@
 name: "Test conda-store"
 
 env:
-  DEFAULT_PYTHON_VERSION: "3.10"
   FORCE_COLOR: "1" # Make tools pretty.
   PYTHONUNBUFFERED: "1" # Make stdout and stderr behave well
 
@@ -41,7 +40,8 @@ jobs:
       - name: "Set up Python 🐍"
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ matrix.python-version }}
+          python-version-file: .python-version-default
+          cache: "pip"
 
       - name: "Install Dependencies 📦"
         run: |

.github/workflows/test_conda_store_server_integration.yaml

@@ -1,7 +1,6 @@
 name: "Test conda-store-server (integration)"
 
 env:
-  DEFAULT_PYTHON_VERSION: "3.10"
   FORCE_COLOR: "1" # Make tools pretty.
   PYTHONUNBUFFERED: "1" # Make stdout and stderr behave well
 
@@ -39,13 +38,18 @@ jobs:
       - name: "Checkout Repository 🛎"
         uses: actions/checkout@v4
 
-      - name: "Set up env 🐍"
+      - name: "Get project's default Python version 🏷️"
+        run: |
+          echo "PYTHON_VERSION_DEFAULT=$(cat .python-version-default)" >> $GITHUB_ENV
+
+      - name: "Set up conda env 🐍"
         uses: conda-incubator/setup-miniconda@v3
         with:
             environment-file: conda-store-server/environment-dev.yaml
             miniforge-version: latest
             auto-activate-base: false
             activate-environment: conda-store-server-dev
+            python-version: ${{ env.PYTHON_VERSION_DEFAULT }}
 
       - name: "Install dependencies 📦"
         run: |

.github/workflows/test_conda_store_server_unit.yaml

@@ -1,8 +1,6 @@
 name: "Test conda-store-server (unit)"
 
 env:
-  # needs to keep the same as the conda-store-server/environment-dev.yaml
-  DEFAULT_PYTHON_VERSION: "3.10"
   FORCE_COLOR: "1" # Make tools pretty.
 
 on:
@@ -36,7 +34,8 @@ jobs:
       - name: "Set up Python 🐍"
         uses: actions/setup-python@v5
         with:
-          python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
+          python-version-file: .python-version-default
+          cache: "pip"
 
       - name: "Install Dependencies 📦"
         run: |
@@ -62,22 +61,27 @@ jobs:
       - name: "Checkout Repository 🛎"
         uses: actions/checkout@v4
 
+      - name: "Get project's default Python version 🏷️"
+        run: |
+          echo "PYTHON_VERSION_DEFAULT=$(cat .python-version-default)" >> $GITHUB_ENV
+
       - name: "Set up env ${{ matrix.os }} 🐍"
         uses: conda-incubator/setup-miniconda@v3
         with:
             environment-file: conda-store-server/environment-dev.yaml
             miniforge-version: latest
             auto-activate-base: false
             activate-environment: conda-store-server-dev
+            python-version: ${{ env.PYTHON_VERSION_DEFAULT }}
 
       # This fixes a "DLL not found" issue importing ctypes from the hatch env
-      - name: "Reinstall Python 3.10 on Windows runner"
+      - name: "Reinstall Python on Windows runner"
         uses: nick-fields/[email protected]
         with:
           timeout_minutes: 9999
           max_attempts: 6
           command:
-            conda install --channel=conda-forge --quiet --yes python=${{ env.DEFAULT_PYTHON_VERSION }}
+            conda install --channel=conda-forge --quiet --yes python=${{ env.PYTHON_VERSION_DEFAULT }}
         if: matrix.os == 'windows-latest'
 
       - name: "Install conda-store server 📦"

.pre-commit-config.yaml

@@ -31,11 +31,10 @@ repos:
     rev: v4.6.0
     hooks:
       - id: trailing-whitespace
-        files: ".*\\.py"
       - id: check-added-large-files
       - id: check-toml
       - id: end-of-file-fixer
-      - id: trailing-whitespace
+        exclude: ".python-version-default"
 
   - repo: https://github.com/pre-commit/mirrors-prettier
     rev: v4.0.0-alpha.8

.python-version-default

@@ -0,0 +1 @@
+3.12

conda-store-server/Dockerfile

@@ -2,15 +2,16 @@
 # the generated Docker image is used with docker-compose to run the conda-store
 # server and public conda-store Docker images
 
-FROM condaforge/mambaforge:24.3.0-0 as base
+FROM condaforge/mambaforge:24.3.0-0 AS base
 
 LABEL org.opencontainers.image.authors="conda-store development team"
 
 # ensure we are using the conda environment
 ENV PATH=/opt/conda/condabin:/opt/conda/envs/conda-store-server/bin:/opt/conda/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:${PATH}
 ENV TZ=Etc/UTC
 
-ARG python_version=3.10
+# must be passed at build environment (should use .python-version-default)
+ARG python_version
 ARG conda_env_name="conda-store-server"
 ARG user_no=1000
 

conda-store-server/environment-dev.yaml

@@ -9,7 +9,8 @@ channels:
   - conda-forge
   - nodefaults
 dependencies:
-  - python=3.10
+  # must be kept in sync with .python-version-default
+  - python=3.12
   # conda builds
   - conda
   # dev dependencies

conda-store/Dockerfile

@@ -6,7 +6,8 @@ FROM condaforge/mambaforge:24.3.0-0 AS base
 
 LABEL org.opencontainers.image.authors="conda-store development team"
 
-ARG python_version=3.10
+# must be passed at build environment (should use .python-version-default)
+ARG python_version
 ARG conda_env_name="conda-store"
 ARG user_no=1000
 

recipe/meta.yaml

@@ -1,4 +1,5 @@
 {% set name = "conda-store" %}
+# version MUST be updated when a new release is made
 {% set version = "2024.6.1" %}
 
 package: