Remove mention of Julia in documentation ahead of discontinued support in v2.13 (#4156)

Author: jlenh

.circleci/config.yml

@@ -41,8 +41,6 @@ commands:
           command: |
             . /opt/conda/etc/profile.d/conda.sh
             conda activate esmvaltool
-            # Add existing Julia to PATH
-            export PATH=/root/.juliaup/bin:$PATH
             pytest -n 4 --junitxml=test-reports/report.xml
             esmvaltool version
             esmvaltool -- --help
@@ -98,10 +96,6 @@ commands:
             conda activate esmvaltool
             mamba list >> /logs/conda.txt
             pip install << parameters.flags >> ".[<<parameters.extra>>]"> /logs/install.txt 2>&1
-            curl -fsSL https://install.julialang.org | sh -s -- --yes
-            export PATH=/root/.juliaup/bin:$PATH
-            julia --version
-            esmvaltool install Julia > /logs/install_julia.txt 2>&1
             if [[ "<<parameters.flags>>" != *'--editable'* ]]
             then
               rm -r esmvaltool
@@ -142,10 +136,6 @@ jobs:
             conda activate esmvaltool
             mkdir /logs
             pip install .[test] > /logs/install.txt 2>&1
-            curl -fsSL https://install.julialang.org | sh -s -- --yes
-            export PATH=/root/.juliaup/bin:$PATH
-            julia --version
-            esmvaltool install Julia > /logs/install_julia.txt 2>&1
       - run:
           name: Check Python code style and mistakes
           command: |
@@ -217,11 +207,6 @@ jobs:
             conda activate esmvaltool
             mamba list >> /logs/conda.txt
             pip install --editable .[develop]
-            # Install Julia from source and add to PATH
-            curl -fsSL https://install.julialang.org | sh -s -- --yes
-            export PATH=/root/.juliaup/bin:$PATH
-            julia --version
-            esmvaltool install Julia > /logs/install_julia.txt 2>&1
             git clone https://github.com/ESMValGroup/ESMValCore $HOME/ESMValCore
             pip install --editable $HOME/ESMValCore[develop]
       - log_versions
@@ -284,15 +269,9 @@ jobs:
             # Install prerequisites
             mkdir /logs
             # Install ESMValTool in a new conda environment
-            mamba create -y --name esmvaltool -c conda-forge esmvaltool julia 'python=3.11' >> /logs/conda.txt 2>&1
+            mamba create -y --name esmvaltool -c conda-forge esmvaltool 'python=3.11' >> /logs/conda.txt 2>&1
             # Activate the environment
             set +x; conda activate esmvaltool; set -x
-            # install Julia from source and add to PATH
-            curl -fsSL https://install.julialang.org | sh -s -- --yes
-            export PATH=/root/.juliaup/bin:$PATH
-            julia --version
-            # install the Julia dependencies
-            esmvaltool install Julia > /logs/install_Julia.txt 2>&1
             # Log versions
             mamba env export > /logs/environment.yml
             # Test installation

.circleci/install_triggers

@@ -1,6 +1,5 @@
 ^\.circleci/
 ^environment\.yml$
-^esmvaltool/install/
 ^pyproject.toml$
 ^setup\.py$
 ^setup\.cfg$

.github/workflows/install-from-conda.yml

@@ -72,7 +72,7 @@ jobs:
 #      - run: which conda 2>&1 | tee conda_install_osx_artifacts_python_${{ matrix.python-version }}/conda_path.txt
 #      - run: python -V 2>&1 | tee conda_install_osx_artifacts_python_${{ matrix.python-version }}/python_version.txt
 #      # ncurses needs to be from conda-forge and not main channel
-#      # for now it's turned off since we're not testing R/Julia installs
+#      # for now it's turned off since we're not testing R installs
 #      # - run: conda uninstall -y ncurses
 #      # - run: conda list ncurses
 #      # - run: conda install -y conda-forge::ncurses

.github/workflows/run-tests-monitor.yml

@@ -49,10 +49,6 @@ jobs:
         run: pip install pytest-monitor
       - name: Install ESMValTool
         run: pip install -e .[develop] 2>&1 | tee test_linux_artifacts_python_${{ matrix.python-version }}/install.txt
-      - name: Install Julia from source
-        run: curl -fsSL https://install.julialang.org | sh -s -- --yes
-      - name: Install Julia dependencies
-        run: esmvaltool install Julia
       - name: Run tests
         run: >
           pytest -n 2 -m "not installation" --db ../.pymon 2>&1

.github/workflows/test-development.yml

@@ -48,10 +48,6 @@ jobs:
           python -V 2>&1 | tee develop_test_linux_artifacts_python_${{ matrix.python-version }}/python_version.txt
       - name: Install ESMValTool
         run: pip install -e .[develop] 2>&1 | tee develop_test_linux_artifacts_python_${{ matrix.python-version }}/install.txt
-      - name: Install Julia from source
-        run: curl -fsSL https://install.julialang.org | sh -s -- --yes
-      - name: Install Julia dependencies
-        run: esmvaltool install Julia
       - name: Install development version of ESMValCore
         run: |
           cd ..

.github/workflows/test.yml

@@ -48,24 +48,10 @@ jobs:
         run: pip install -e .[develop] 2>&1 | tee test_linux_artifacts_python_${{ matrix.python-version }}/install.txt
       - name: Inspect environment
         run: conda list
-      - name: Install Julia from source
-        run: curl -fsSL https://install.julialang.org | sh -s -- --yes
-      - name: Install Julia dependencies
-        run: esmvaltool install Julia
-      - name: Export Python minor version
-        run: echo "pver1=$(python -V)" >> $GITHUB_ENV
-      - name: Exit if Python minor version changed
-        if: ${{ env.pver1 != env.pver0}}
-        run: |
-          echo "Python minor version changed after Julia install"
-          python -V
-          exit 1
       - name: Inspect environment
         run: conda list
-      - name: Check Julia and NCL
-        run: |
-          ncl -V
-          julia --version
+      - name: Check NCL
+        run: ncl -V
       - name: Check code quality
         run: pre-commit run -a
       - name: Run tests

.gitignore

@@ -107,9 +107,6 @@ doc/sphinx/source/gallery.rst
 .Rproj.user
 esmvaltool.Rproj
 
-# Julia installation
-esmvaltool/install/Julia/Manifest.toml
-
 # Cylc suite
 esmvaltool/utils/testing/regression/.service/
 

README.md

@@ -35,7 +35,7 @@ files that contain pointers to the requested data types, directives for the prep
 will be subject to, and directives for the actual diagnostics that will be run with the now preprocessed data.
 Data preprocessing is done via the [ESMValCore](https://docs.esmvaltool.org/projects/ESMValCore/en/latest/quickstart/index.html) package, a pure Python, highly-optimized scientific library, developed by the ESMValTool core developers,
 and that performs a number of common analysis tasks
-such as regridding, masking, levels extraction etc. [Diagnostics](https://docs.esmvaltool.org/en/latest/develop/diagnostic.html) are written in a variety of programming languages (Python, NCL, R, Julia) and are developed by the wider
+such as regridding, masking, levels extraction etc. [Diagnostics](https://docs.esmvaltool.org/en/latest/develop/diagnostic.html) are written in a variety of programming languages (Python, NCL, R) and are developed by the wider
 scientific community, and included after a scientific and technical review process.
 
 # Input data

doc/sphinx/source/community/code_documentation.rst

@@ -465,9 +465,6 @@ the following files:
 - ``environment_osx.yml``
   contains development dependencies for MacOSX. Should be the same as ``environment.yml``,
   but currently without multi language support.
-- ``esmvaltool/install/Julia/Project.toml``
-  contains Julia dependencies that can be installed from the default Julia
-  package registry
 - ``pyproject.toml``
   contains all Python dependencies, regardless of their installation source
 

doc/sphinx/source/community/diagnostic.rst

@@ -24,12 +24,7 @@ The easiest way to do this is probably to copy the example recipe and diagnostic
 script and adjust those to your needs.
 
 If you have no preferred programming language yet, Python 3 is highly recommended, because it is most well supported.
-However, NCL, R, (and Julia) scripts are also supported.
-
-.. note::
-
-    ESMValTool stopped supporting Julia as a main dependency, so if you'd like to
-    write and test a Julia diagnostic, you will have to install Julia from source.
+However, NCL, and R scripts are also supported.
 
 Good example recipes for the different languages are:
 
@@ -363,38 +358,6 @@ Have a look at the example NCL diagnostic in
 `esmvaltool/diag_scripts/examples/diagnostic.ncl <https://github.com/ESMValGroup/ESMValTool/blob/main/esmvaltool/diag_scripts/examples/diagnostic.ncl>`_
 for a complete example.
 
-Recording provenance in a Julia diagnostic script
--------------------------------------------------
-The provenance information is written in a ``diagnostic_provenance.yml`` that will be located in ``run_dir``.
-For example a ``provenance_record`` can be stored in a yaml file as:
-
-.. code-block:: julia
-
-  provenance_file = string(run_dir, "/diagnostic_provenance.yml")
-
-  open(provenance_file, "w") do io
-      JSON.print(io, provenance_records, 4)
-  end
-
-The ``provenance_records`` can be defined as a dictionary of provenance items.
-For example:
-
-.. code-block:: julia
-
-  provenance_records = Dict()
-
-  provenance_record = Dict(
-      "ancestors" => [input_file],
-      "authors" => ["vonhardenberg_jost", "arnone_enrico"],
-      "caption" => "Example diagnostic in Julia",
-      "domains" => ["global"],
-      "projects" => ["crescendo", "c3s-magic"],
-      "references" => ["zhang11wcc"],
-      "statistics" => ["other"],
-  )
-
-  provenance_records[output_file] = provenance_record
-
 Recording provenance in an R diagnostic script
 ----------------------------------------------
 The provenance information is written in a ``diagnostic_provenance.yml`` that will be located in ``run_dir``.