Merge branch 'main' into wrap-clip

Author: maxrjones

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,49 @@
+name: Bug report
+description: Report a problem/bug to help us improve
+labels: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    attributes:
+      label: "Description of the problem"
+      description: |
+        Please be as detailed as you can when describing an issue.
+        The more information we have, the easier it will be for us to track this down.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: "Minimal Complete Verifiable Example"
+      description: |
+        So that we can understand and fix the issue quickly and efficiently, please provide
+        a minimal, self-contained copy-pastable example that demonstrates the issue.
+        For more details, check out:
+
+        - [Minimal Complete Verifiable Examples](https://stackoverflow.com/help/mcve)
+        - [Craft Minimal Bug Reports](http://matthewrocklin.com/blog/work/2018/02/28/minimal-bug-reports)
+
+      placeholder: "PASTE CODE HERE"
+      render: python
+    validations:
+      required: false
+  - type: textarea
+    attributes:
+      label: "Full error message"
+      description: "What was the error message you got?"
+      placeholder: "PASTE ERROR MESSAGE HERE"
+      render: python-traceback
+    validations:
+      required: false
+  - type: textarea
+    attributes:
+      label: "System information"
+      description: |
+        Please paste the output of `python -c "import pygmt; pygmt.show_versions()"`
+        If this command is not successful, please describe your operating system, how you installed PyGMT, how you installed GMT, and paste the full error message.
+      placeholder: "PASTE THE OUTPUT HERE"
+      render: bash
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,23 @@
+name: Feature request - General feature
+description: Request the addition of a new feature/functionality
+labels: ["feature request"]
+body:
+  - type: textarea
+    attributes:
+      label: "Description of the desired feature"
+      description: |
+        Please be as detailed as you can in your description.
+        If possible, include an example of how you would like to use this feature (even better if it's a code example).
+  - type: dropdown
+    id: help
+    attributes:
+      label: Are you willing to help implement and maintain this feature?
+      description: |
+        Every feature we add is code that we will have to maintain and keep updated. This takes a lot of effort.
+        If you are willing to be involved in the project and help maintain your feature, it will make it easier for us to accept it.
+      options:
+        - "No"
+        - "Yes"
+        - "Maybe"
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,34 @@
+name: Feature request - Wrap a new GMT module
+description: Request PyGMT wrapper for a GMT module
+title: "Wrapper for <module-name>"
+labels: ["feature request"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please replace `<module-name>` in the issue title and the description with the name of the requested module and add the description of the module.
+  - type: textarea
+    id: which-module
+    attributes:
+      label: Description of the desired module
+      description: Please be as detailed as you can in your description. If possible, include an example of how you would like to use this feature (even better if it's a code example).
+      placeholder: Implement [`<module-name>`](https://docs.generic-mapping-tools.org/latest/<module-name>.html) which `<insert description of the GMT module>`.
+    validations:
+      required: true
+  - type: dropdown
+    id: help
+    attributes:
+      label: Are you willing to help implement and maintain this feature?
+      description: |
+        Every feature we add is code that we will have to maintain and keep updated. This takes a lot of effort.
+        If you are willing to be involved in the project and help maintain your feature, it will make it easier for us to accept it.
+      options:
+        - "No"
+        - "Yes"
+        - "Maybe"
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        Progress on wrapping the module will be tracked in the [project board](https://github.com/GenericMappingTools/pygmt/projects/9).

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -16,6 +16,7 @@ Fixes #
 - [ ] Write detailed docstrings for all functions/methods.
 - [ ] If wrapping a new module, open a 'Wrap new GMT module' issue and submit reasonably-sized PRs.
 - [ ] If adding new functionality, add an example to docstrings or tutorials.
+- [ ] Use underscores (not hyphens) in names of Python files and directories.
 
 **Slash Commands**
 

.github/ISSUE_TEMPLATE/module_request.md

@@ -19,20 +19,21 @@ jobs:
     steps:
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.2.0
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Mambaforge with conda-forge dependencies
       - name: Setup Mambaforge
-        uses: conda-incubator/setup-miniconda@v2.1.1
+        uses: conda-incubator/setup-miniconda@v2.2.0
         with:
           channels: conda-forge,nodefaults
           channel-priority: strict
           miniforge-version: latest
           miniforge-variant: Mambaforge
           mamba-version: "*"
+          run-post: false
           use-mamba: true
 
       # Install GMT and other required dependencies from conda-forge

.github/ISSUE_TEMPLATE/module_request.yaml

@@ -15,18 +15,18 @@ jobs:
 
     steps:
     - name: Checkout the repository
-      uses: actions/checkout@v3.0.2
+      uses: actions/checkout@v3.2.0
       with:
         path: repository
 
     - name: Checkout the documentation
-      uses: actions/checkout@v3.0.2
+      uses: actions/checkout@v3.2.0
       with:
         ref: gh-pages
         path: documentation
 
     - name: Link Checker
-      uses: lycheeverse/[email protected].1
+      uses: lycheeverse/[email protected].4
       with:
         # 429: Too many requests
         args: >

.github/PULL_REQUEST_TEMPLATE.md

@@ -10,7 +10,6 @@ on:
     paths-ignore:
       - 'pygmt/tests/**'
       - '*.md'
-      - '*.json'
       - 'LICENSE.txt'
       - '.gitignore'
   release:
@@ -43,20 +42,20 @@ jobs:
     steps:
       # Cancel previous runs that are not completed
       - name: Cancel Previous Runs
-        uses: styfle/cancel-workflow-action@0.10.0
+        uses: styfle/cancel-workflow-action@0.11.0
         with:
           access_token: ${{ github.token }}
 
       # Checkout current git repository
       - name: Checkout
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.2.0
         with:
           # fetch all history so that setuptools-scm works
           fetch-depth: 0
 
       # Install Mambaforge with conda-forge dependencies
       - name: Setup Mambaforge
-        uses: conda-incubator/setup-miniconda@v2.1.1
+        uses: conda-incubator/setup-miniconda@v2.2.0
         with:
           activate-environment: pygmt
           python-version: ${{ matrix.python-version }}
@@ -65,6 +64,7 @@ jobs:
           miniforge-version: latest
           miniforge-variant: Mambaforge
           mamba-version: "*"
+          run-post: false
           use-mamba: true
 
       # Install GMT and other required dependencies from conda-forge
@@ -80,7 +80,7 @@ jobs:
 
       # Download cached remote files (artifacts) from GitHub
       - name: Download remote data from GitHub
-        uses: dawidd6/action-download-artifact@v2.22.0
+        uses: dawidd6/action-download-artifact@v2.24.2
         with:
           workflow: cache_data.yaml
           workflow_conclusion: success
@@ -107,7 +107,7 @@ jobs:
         run: make -C doc clean all
 
       - name: Checkout the gh-pages branch
-        uses: actions/checkout@v3.0.2
+        uses: actions/checkout@v3.2.0
         with:
           ref: gh-pages
           # Checkout to this folder instead of the current one