Merge branch 'main' into options

Author: seisman

.github/ISSUE_TEMPLATE/bug_report.yaml renamed to .github/ISSUE_TEMPLATE/1-bug_report.yaml

@@ -16,7 +16,7 @@ assignees: ''
 - [ ] Wrap Y ()
 
 **Before release**:
-- [ ] Check [SPEC 0](https://scientific-python.org/specs/spec-0000/) to see if we need to bump the minimum supported versions of Python and core package dependencies (NumPy/Pandas/Xarray)
+- [ ] Check [SPEC 0](https://scientific-python.org/specs/spec-0000/) to see if we need to bump the minimum supported versions of GMT, Python and core package dependencies (NumPy/Pandas/Xarray)
 - [ ] Run `make codespell` to check common misspellings. If there are any, either fix them or add them to `ignore-words-list` in `pyproject.toml`
 - [ ] Check to ensure that:
   - [ ] All tests pass in the ["GMT Legacy Tests" workflow](https://github.com/GenericMappingTools/pygmt/actions/workflows/ci_tests_legacy.yaml)
@@ -43,7 +43,7 @@ assignees: ''
 - [ ] Manually upload the pygmt-vX.Y.Z.zip and baseline-images.zip files to https://zenodo.org/deposit, ensure that it is filed under the correct reserved DOI
 
 **After release**:
-- [ ] Update conda-forge [pygmt-feedstock](https://github.com/conda-forge/pygmt-feedstock) [Done automatically by conda-forge's bot, but remember to pin NEP29 versions]
+- [ ] Update conda-forge [pygmt-feedstock](https://github.com/conda-forge/pygmt-feedstock) [Done automatically by conda-forge's bot, but remember to pin SPEC0 versions]
 - [ ] Bump PyGMT version on https://github.com/GenericMappingTools/try-gmt (after conda-forge update)
 - [ ] Announce the release on:
   - [ ] GMT [forum](https://forum.generic-mapping-tools.org/c/news/) (do this announcement first! draft on https://hackmd.io/@pygmt. requires moderator status)

.github/ISSUE_TEMPLATE/feature_request.yaml renamed to .github/ISSUE_TEMPLATE/2-feature_request.yaml

@@ -6,7 +6,7 @@ updates:
   - package-ecosystem: "github-actions"
     directory: "/"
     schedule:
-      # Check for updates to GitHub Actions every weekday
+      # Check for updates to GitHub Actions on Tuesdays
       interval: "weekly"
       day: "tuesday"
     # Allow up to 2 open pull requests at a time

.github/ISSUE_TEMPLATE/module_request.yaml renamed to .github/ISSUE_TEMPLATE/3-module_request.yaml

@@ -1,7 +1,7 @@
 # Run performance benchmarks
 #
-# Continuous benchmarking using pytest-codspeed. Measures the execution speed
-# of tests marked with @pytest.mark.benchmark decorator.
+# Continuous benchmarking using pytest-codspeed. Measures the execution speed of tests
+# marked with @pytest.mark.benchmark decorator.
 
 name: Benchmarks
 
@@ -15,12 +15,9 @@ on:
   # Run in PRs but only if the PR has the 'run/benchmark' label
   pull_request:
     types: [ opened, reopened, labeled, synchronize ]
-  # `workflow_dispatch` allows CodSpeed to trigger backtest
-  # performance analysis in order to generate initial data.
+  # 'workflow_dispatch' allows CodSpeed to trigger backtest performance analysis
+  # in order to generate initial data.
   workflow_dispatch:
-  release:
-    types:
-      - published
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -37,14 +34,14 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/[email protected].1
+        uses: actions/[email protected].4
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Miniconda with conda-forge dependencies
       - name: Setup Miniconda
-        uses: conda-incubator/[email protected].1
+        uses: conda-incubator/[email protected].4
         with:
           auto-activate-base: true
           activate-environment: ""  # base environment
@@ -64,29 +61,22 @@ jobs:
 
       # Download cached remote files (artifacts) from GitHub
       - name: Download remote data from GitHub
-        uses: dawidd6/[email protected]
-        with:
-          workflow: cache_data.yaml
-          workflow_conclusion: success
-          name: gmt-cache
-          path: .gmt
-
-      # Move downloaded files to ~/.gmt directory and list them
-      - name: Move and list downloaded remote files
         run: |
-          mkdir -p ~/.gmt
-          mv .gmt/* ~/.gmt
+          # Download cached files to ~/.gmt directory and list them
+          gh run download --name gmt-cache --dir ~/.gmt/
           # Change modification times of the two files, so GMT won't refresh it
           touch ~/.gmt/gmt_data_server.txt ~/.gmt/gmt_hash_server.txt
           ls -lhR ~/.gmt
+        env:
+          GH_TOKEN: ${{ github.token }}
 
       # Install the package that we want to test
       - name: Install the package
         run: make install
 
       # Run the benchmark tests
       - name: Run benchmarks
-        uses: CodSpeedHQ/action@v2.1.1
+        uses: CodSpeedHQ/action@v2.4.1
         with:
           run: |
             python -c "import pygmt; pygmt.show_versions()"

.github/ISSUE_TEMPLATE/release_checklist.md renamed to .github/ISSUE_TEMPLATE/4-release_checklist.md

@@ -1,12 +1,16 @@
 # Cache GMT remote data files and upload as artifacts
 #
-# This workflow downloads data files needed by PyGMT tests/documentation from
-# the GMT data server and uploads as workflow artifacts which can be accessed
-# by other GitHub Actions workflows.
+# This workflow downloads data files needed by PyGMT tests/documentation from the GMT
+# data server and uploads them as workflow artifacts, which can then be accessed by other
+# GitHub Actions workflows.
 #
-# It is scheduled to run every Sunday at 12:00 (UTC). If new remote files are
-# needed urgently, maintainers can update the workflow file or the
-# 'pygmt/helpers/caching.py' file to refresh the cache.
+# It is scheduled to run every Sunday at 12:00 (UTC). If new remote files are needed
+# urgently, maintainers can refresh the cache by one of the following methods:
+#
+# 1. Update this workflow file
+# 2. Update the `pygmt/helpers/caching.py` file
+# 3. Go to https://github.com/GenericMappingTools/pygmt/actions/workflows/cache_data.yaml
+#    and click the "Run workflow" button
 #
 name: Cache data
 
@@ -16,6 +20,7 @@ on:
     paths:
       - 'pygmt/helpers/caching.py'
       - '.github/workflows/cache_data.yaml'
+  workflow_dispatch:
   # Schedule runs on 12 noon every Sunday
   schedule:
     - cron: '0 12 * * 0'
@@ -31,14 +36,14 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/[email protected].1
+        uses: actions/[email protected].4
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Micromamba with conda-forge dependencies
       - name: Setup Micromamba
-        uses: mamba-org/[email protected].0
+        uses: mamba-org/[email protected].1
         with:
           environment-name: pygmt
           condarc: |
@@ -75,7 +80,7 @@ jobs:
         with:
           name: gmt-cache
           path: |
-              ~/.gmt/cache
-              ~/.gmt/server
-              ~/.gmt/gmt_data_server.txt
-              ~/.gmt/gmt_hash_server.txt
+            ~/.gmt/cache
+            ~/.gmt/server
+            ~/.gmt/gmt_data_server.txt
+            ~/.gmt/gmt_hash_server.txt

.github/ISSUE_TEMPLATE/bump_gmt_checklist.md renamed to .github/ISSUE_TEMPLATE/5-bump_gmt_checklist.md

@@ -10,6 +10,7 @@ name: Check Links
 on:
   # Uncomment the 'pull_request' line below to trigger the workflow in PR
   # pull_request:
+  workflow_dispatch:
   # Schedule runs on 12 noon every Sunday
   schedule:
     - cron: '0 12 * * 0'
@@ -22,19 +23,19 @@ jobs:
 
     steps:
     - name: Checkout the repository
-      uses: actions/[email protected].1
+      uses: actions/[email protected].4
       with:
         path: repository
 
     - name: Checkout the documentation
-      uses: actions/[email protected].1
+      uses: actions/[email protected].4
       with:
         ref: gh-pages
         path: documentation
 
     - name: Link Checker
       id: lychee
-      uses: lycheeverse/lychee-action@v1.9.3
+      uses: lycheeverse/lychee-action@v1.10.0
       with:
         # 429: Too many requests
         args: >
@@ -53,7 +54,7 @@ jobs:
           --exclude "^https://www.generic-mapping-tools.org/remote-datasets/%s$"
           --exclude "^https://hackmd.io/@pygmt"
           --exclude "^https://doi.org"
-          --exclude "^https://www.researchgate.net/project/"
+          --exclude "^https://www.researchgate.net/"
           --exclude "^https://test.pypi.org/simple/"
           --verbose
           "repository/**/*.rst"
@@ -67,7 +68,8 @@ jobs:
 
     - name: Create Issue From File
       if: env.lychee_exit_code != 0
-      uses: peter-evans/create-issue-from-file@v5
-      with:
-        title: Link Checker Report on ${{ steps.date.outputs.date }}
-        content-filepath: ./lychee/out.md
+      run: |
+        title="Link Checker Report on ${{ steps.date.outputs.date }}"
+        gh issue create --title "$title" --body-file ./lychee/out.md
+      env:
+        GH_TOKEN: ${{ github.token }}

.github/dependabot.yml

@@ -34,6 +34,7 @@ on:
       - 'examples/**'
       - 'README.md'
       - '.github/workflows/ci_docs.yml'
+  workflow_dispatch:
   release:
     types:
       - published
@@ -68,14 +69,14 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/[email protected].1
+        uses: actions/[email protected].4
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Micromamba with conda-forge dependencies
       - name: Setup Micromamba
-        uses: mamba-org/[email protected].0
+        uses: mamba-org/[email protected].1
         with:
           environment-name: pygmt
           condarc: |
@@ -87,7 +88,7 @@ jobs:
           create-args: >-
             python=3.12
             gmt=6.5.0
-            ghostscript=10.02.1
+            ghostscript=10.03.0
             numpy
             pandas
             xarray
@@ -111,21 +112,14 @@ jobs:
 
       # Download cached remote files (artifacts) from GitHub
       - name: Download remote data from GitHub
-        uses: dawidd6/[email protected]
-        with:
-          workflow: cache_data.yaml
-          workflow_conclusion: success
-          name: gmt-cache
-          path: .gmt
-
-      # Move downloaded files to ~/.gmt directory and list them
-      - name: Move and list downloaded remote files
         run: |
-          mkdir -p ~/.gmt
-          mv .gmt/* ~/.gmt
+          # Download cached files to ~/.gmt directory and list them
+          gh run download --name gmt-cache --dir ~/.gmt/
           # Change modification times of the two files, so GMT won't refresh it
           touch ~/.gmt/gmt_data_server.txt ~/.gmt/gmt_hash_server.txt
           ls -lhR ~/.gmt
+        env:
+          GH_TOKEN: ${{ github.token }}
 
       # Install the package that we want to test
       - name: Install the package
@@ -138,7 +132,7 @@ jobs:
         run: make -C doc clean all
 
       - name: Checkout the gh-pages branch
-        uses: actions/[email protected].1
+        uses: actions/[email protected].4
         with:
           ref: gh-pages
           # Checkout to this folder instead of the current one
@@ -161,7 +155,7 @@ jobs:
           # to get the right commit hash.
           message="Deploy $version from $(git rev-parse --short HEAD)"
           cd deploy
-          # Need to have this file so that Github doesn't try to run Jekyll
+          # Need to have this file so that GitHub doesn't try to run Jekyll
           touch .nojekyll
           # Delete all the files and replace with our new  set
           echo -e "\nRemoving old files from previous builds of ${version}:"

.github/workflows/benchmarks.yml

@@ -9,6 +9,7 @@ on:
   # push:
   #   branches: [ main ]
   # pull_request:
+  workflow_dispatch:
   # Schedule weekly tests on Sunday
   schedule:
     - cron: '0 0 * * 0'
@@ -34,14 +35,14 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/[email protected].1
+        uses: actions/[email protected].4
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Micromamba with conda-forge dependencies
       - name: Setup Micromamba
-        uses: mamba-org/[email protected].0
+        uses: mamba-org/[email protected].1
         with:
           environment-name: pygmt
           condarc: |
@@ -70,21 +71,14 @@ jobs:
 
       # Download cached remote files (artifacts) from GitHub
       - name: Download remote data from GitHub
-        uses: dawidd6/[email protected]
-        with:
-          workflow: cache_data.yaml
-          workflow_conclusion: success
-          name: gmt-cache
-          path: .gmt
-
-      # Move downloaded files to ~/.gmt directory and list them
-      - name: Move and list downloaded remote files
         run: |
-          mkdir -p ~/.gmt
-          mv .gmt/* ~/.gmt
+          # Download cached files to ~/.gmt directory and list them
+          gh run download --name gmt-cache --dir ~/.gmt/
           # Change modification times of the two files, so GMT won't refresh it
           touch ~/.gmt/gmt_data_server.txt ~/.gmt/gmt_hash_server.txt
           ls -lhR ~/.gmt
+        env:
+          GH_TOKEN: ${{ github.token }}
 
       # Install the package that we want to test
       - name: Install the package