Merge branch 'main' into main_JRA3Q

Author: Row-Bean

.circleci/config.yml

@@ -2,58 +2,43 @@
 version: 2.1
 
 orbs:
-  coverage-reporter: codacy/coverage-reporter@13.13.0
+  pixi: prefix-dev/pixi@0.1.0
 
-commands:
-
-  check_changes:
+jobs:
+  tests:
+    # Run tests
+    docker:
+      - image: cimg/base:current
+    resource_class: large
     steps:
+      - checkout
+      - pixi/pixi_setup
       - run:
-          name: Check whether or not installation tests are needed
-          command: |
-            if (test "$CIRCLE_BRANCH" = main ||
-              git --no-pager diff --name-only origin/main... |
-              grep -q -E -f .circleci/install_triggers)
-            then
-              echo Running installation tests
-            else
-              echo Skipping installation tests
-              circleci step halt
-            fi
-
-  log_versions:
-    steps:
+          name: Check dependencies are compatible
+          command: pixi run --as-is pip check
       - run:
-          name: Log versions
-          command: |
-            . /opt/conda/etc/profile.d/conda.sh
-            conda env export --name base > /logs/base_environment.yml
-            conda activate esmvaltool
-            esmvaltool version
-            dpkg -l > /logs/versions.txt
-            conda env export > /logs/environment.yml
-            pip freeze > /logs/requirements.txt
-
-  test_and_report:
-    steps:
+          name: Check code formatting and mistakes
+          command: pixi run --as-is pre-commit run --all
       - run:
           name: Run tests
           command: |
-            . /opt/conda/etc/profile.d/conda.sh
-            conda activate esmvaltool
-            pytest -n 4 --junitxml=test-reports/report.xml
+            pixi run --as-is test -n 4 --durations=10 --junitxml=test-reports/report.xml
+      - run:
+          name: Check the command line interface
+          command: |
+            source <(pixi shell-hook --as-is)
             esmvaltool version
             esmvaltool -- --help
             esmvaltool develop compare -- --help
-            ncl -V
-            cdo --version
       - store_test_results:
           path: test-reports/report.xml
-      - store_artifacts:
-          path: /logs
+      - run:
+          # Documentation available at https://docs.codacy.com/coverage-reporter/
+          name: Upload coverage report to Codacy
+          command: bash <(curl -Ls https://coverage.codacy.com/get.sh) report -s -r test-reports/coverage.xml
       - run:
           name: Compress pytest artifacts
-          command: tar -cvzf pytest.tar.gz -C /tmp/pytest-of-root/ .
+          command: tar -cvzf pytest.tar.gz -C /tmp/pytest-of-$(whoami)/ .
           when: always
       - store_artifacts:
           path: pytest.tar.gz
@@ -64,197 +49,64 @@ commands:
       - store_artifacts:
           path: test-reports.tar.gz
 
-  test_installation_from_source:
-    parameters:
-      extra:
-        type: string
-      flags:
-        type: string
-        default: ""
-    steps:
-      - run:
-          name: Install git+ssh
-          environment:
-            DEBIAN_FRONTEND: noninteractive  # needed to install tzdata
-          command: apt update && apt install -y git ssh
-      - checkout
-      - check_changes
-      - run:
-          name: Generate cache key
-          command: date '+%Y-%V' | tee cache_key.txt
-      - restore_cache:
-          key: install-<< parameters.extra >>-{{ .Branch }}-{{ checksum "cache_key.txt" }}
-      - run:
-          name: Install dependencies
-          no_output_timeout: 30m
-          command: |
-            # Install
-            . /opt/conda/etc/profile.d/conda.sh
-            mkdir /logs
-            mamba --version
-            conda env create -n esmvaltool -f environment.yml --verbose
-            conda activate esmvaltool
-            mamba list >> /logs/conda.txt
-            pip install << parameters.flags >> ".[<<parameters.extra>>]"> /logs/install.txt 2>&1
-            if [[ "<<parameters.flags>>" != *'--editable'* ]]
-            then
-              rm -r esmvaltool
-            fi
-      - log_versions
-      - run:
-          name: Lint source code
-          command: |
-            . /opt/conda/etc/profile.d/conda.sh
-            conda activate esmvaltool
-            pre-commit run --all
-      - test_and_report
-      - save_cache:
-          key: install-<< parameters.extra >>-{{ .Branch }}-{{ checksum "cache_key.txt" }}
-          paths:
-            - /opt/conda/pkgs
-            - /root/.cache/pip
-            - .pytest_cache
-
-jobs:
-  run_tests:
-    # Run tests
-    docker:
-      - image: esmvalgroup/esmvaltool:development
-    resource_class: large
-    steps:
-      - checkout
-      - run:
-          name: Generate cache key
-          command: date '+%Y-%V' | tee cache_key.txt
-      - restore_cache:
-          key: test-{{ .Branch }}-{{ checksum "cache_key.txt" }}
-      - run:
-          name: Install dependencies
-          command: |
-            set -x
-            . /opt/conda/etc/profile.d/conda.sh
-            conda activate esmvaltool
-            mkdir /logs
-            pip install .[test] > /logs/install.txt 2>&1
-      - run:
-          name: Check Python code style and mistakes
-          command: |
-            . /opt/conda/etc/profile.d/conda.sh
-            conda activate esmvaltool
-            pre-commit run --all
-      - run:
-          name: Remove source code to test the installed software
-          command: rm -r esmvaltool
-      - test_and_report
-      - save_cache:
-          key: test-{{ .Branch }}-{{ checksum "cache_key.txt" }}
-          paths:
-            - /root/.cache/pip
-            - .pytest_cache
-      - coverage-reporter/send_report:
-          coverage-reports: 'test-reports/coverage.xml'
-          project-token: $CODACY_PROJECT_TOKEN
-          skip: true  # skip if project-token is not defined (i.e. on a fork)
-
-  test_installation_from_source_test_mode:
-    # Test installation from source
-    docker:
-      - image: condaforge/miniforge3:latest
-    resource_class: large
-    steps:
-      - test_installation_from_source:
-          extra: test
-
-  test_installation_from_source_develop_mode:
-    # Test development installation
-    docker:
-      - image: condaforge/miniforge3:latest
-    resource_class: large
-    steps:
-      - test_installation_from_source:
-          extra: develop
-          flags: "--editable"
-
   test_upstream_development:
     # Test running recipes with the development version of ESMValCore. The
     # purpose of this test to discover backward-incompatible changes early on in
     # the development cycle.
     docker:
-      - image: condaforge/miniforge3:latest
+      - image: cimg/base:current
     resource_class: large
     steps:
-      - run:
-          name: Install git and ssh
-          environment:
-            DEBIAN_FRONTEND: noninteractive  # needed to install tzdata
-          command: apt update && apt install -y git ssh
       - checkout
       - run:
           name: Generate cache key
           command: echo $(date '+%Y')-$(expr $(date '+%V') / 2) | tee cache_key.txt
       - restore_cache:
           key: test-upstream-{{ .Branch }}-{{ checksum "cache_key.txt" }}
+      - pixi/pixi_setup:
+          env: esmvalcore-dev
       - run:
-          name: Install
-          no_output_timeout: 30m
+          name: Run tests
           command: |
-            # Install according to instructions on readthedocs with the
-            # development version of ESMValTool and ESMValCore:
-            # https://docs.esmvaltool.org/en/latest/quickstart/installation.html#install-from-source
-            . /opt/conda/etc/profile.d/conda.sh
-            mkdir /logs
-            conda env create -n esmvaltool -f environment.yml --verbose
-            conda activate esmvaltool
-            mamba list >> /logs/conda.txt
-            pip install --editable .[develop]
-            git clone https://github.com/ESMValGroup/ESMValCore $HOME/ESMValCore
-            pip install --editable $HOME/ESMValCore[develop]
-      - log_versions
-      - test_and_report
+            pixi run --as-is --environment esmvalcore-dev test -n 4 --junitxml=test-reports/report.xml
+      - store_test_results:
+          path: test-reports/report.xml
       - run:
           name: Run recipes
           command: |
-            . /opt/conda/etc/profile.d/conda.sh
-            conda activate esmvaltool
-            mkdir -p ~/climate_data
-            esmvaltool config get_config_user
-            echo "search_esgf: when_missing" >> ~/.config/esmvaltool/config-user.yml
-            cat ~/.config/esmvaltool/config-user.yml
+            source <(pixi shell-hook --as-is --environment esmvalcore-dev)
+            # Temporarily install intake-esgf here until there is a new release
+            # that includes https://github.com/esgf2-us/intake-esgf/pull/160.
+            pip install git+https://github.com/esgf2-us/intake-esgf@main
+            esmvaltool version
+            esmvaltool config copy data-intake-esgf.yml
+            python -c '
+            import intake_esgf
+            intake_esgf.conf["solr_indices"]["esgf.ceda.ac.uk"] = True
+            intake_esgf.conf["solr_indices"]["esgf-data.dkrz.de"] = True
+            intake_esgf.conf.save()
+            '
             for recipe in esmvaltool/recipes/testing/recipe_*.yml; do
-              esmvaltool run "$recipe"
+              esmvaltool run --max-parallel-tasks=2 "$recipe"
             done
       - store_artifacts:
           path: /root/esmvaltool_output
       - save_cache:
           key: test-upstream-{{ .Branch }}-{{ checksum "cache_key.txt" }}
           paths:
-            - /opt/conda/pkgs
-            - /root/.cache/pip
             - /root/climate_data
 
   build_documentation:
     # Test building documentation
     docker:
-      - image: condaforge/miniforge3:latest
-    resource_class: medium
+      - image: cimg/base:current
+    resource_class: medium+
     steps:
       - checkout
+      - pixi/pixi_setup
       - run:
-          command: |
-            mkdir /logs
-            . /opt/conda/etc/profile.d/conda.sh
-            # Install
-            conda env create -n esmvaltool -f environment_python.yml
-            conda activate esmvaltool
-            pip install .[doc]
-            # Log versions
-            dpkg -l > /logs/versions.txt
-            conda env export > /logs/environment.yml
-            pip freeze > /logs/requirements.txt
-            # Test building documentation
-            MPLBACKEND=Agg sphinx-build -W doc/sphinx/source doc/spinx/build
-      - store_artifacts:
-          path: /logs
+          name: Build documentation
+          command: pixi run --as-is doc --fail-on-warning --show-traceback
 
   test_installation_from_conda:
     # Test conda package installation
@@ -269,7 +121,7 @@ jobs:
             # Install prerequisites
             mkdir /logs
             # Install ESMValTool in a new conda environment
-            mamba create -y --name esmvaltool -c conda-forge esmvaltool 'python=3.11' >> /logs/conda.txt 2>&1
+            mamba create -y --name esmvaltool -c conda-forge esmvaltool 'python=3.13' >> /logs/conda.txt 2>&1
             # Activate the environment
             set +x; conda activate esmvaltool; set -x
             # Log versions
@@ -285,9 +137,7 @@ jobs:
 workflows:
   commit:
     jobs:
-      - run_tests
-      - test_installation_from_source_test_mode
-      - test_installation_from_source_develop_mode
+      - tests
   nightly:
     triggers:
       - schedule:
@@ -297,9 +147,7 @@ workflows:
               only:
                 - main
     jobs:
-      - run_tests
-      - test_installation_from_source_test_mode
-      - test_installation_from_source_develop_mode
+      - tests
       - test_upstream_development
       - build_documentation
       - test_installation_from_conda

.circleci/install_triggers

@@ -1,28 +1,15 @@
 # codacy configuration file
-
 ---
-
 engines:
-    coverage:
-        enabled: false
-        exclude_paths: [
-            'tests',
-        ]
-    metrics:
-        enabled: true
-    duplication:
-        enabled: true
-    prospector:
-        enabled: true
-    pylint:
-        enabled: true
-        python_version: 3
+  coverage:
+    exclude_paths: ["tests"]
 
-exclude_paths: [
-    'archive/**',
-    'doc/sphinx/**',
-    'esmvaltool/cmor/tables/**',
-    'tests/**',
-    'esmvaltool/utils/recipe_test_workflow/app/configure/bin/test_configure.py',
-    'esmvaltool/utils/recipe_test_workflow/app/generate_report/bin/test_generate_html_report.py',
-]
+exclude_paths:
+  [
+    "archive/**",
+    "doc/sphinx/**",
+    "esmvaltool/cmor/tables/**",
+    "tests/**",
+    "esmvaltool/utils/recipe_test_workflow/app/configure/bin/test_configure.py",
+    "esmvaltool/utils/recipe_test_workflow/app/generate_report/bin/test_generate_html_report.py",
+  ]

.codacy.yml

@@ -0,0 +1,2 @@
+# SCM syntax highlighting & preventing 3-way merges
+pixi.lock merge=binary linguist-language=YAML linguist-generated=true -diff

.gitattributes

@@ -12,3 +12,7 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    labels:
+      - dependencies
+      - github_actions
+      - automatedPR