check-links.yml

# Check links in the repository and documentation
#
# This workflow runs the lychee tool to check all external links in plaintext
# and HTML files. It will create an issue if broken links are found.
#
# It is scheduled to run weekly at 12 noon every Sunday.
#
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'

jobs:
  check_links:
    name: Check Links
    runs-on: ubuntu-latest
    if: github.repository == 'GenericMappingTools/pygmt'

    steps:
    - name: Checkout the repository
      uses: actions/checkout@v4.2.2
      with:
        path: repository

    - name: Checkout the documentation
      uses: actions/checkout@v4.2.2
      with:
        ref: gh-pages
        path: documentation

    - name: Link Checker
      id: lychee
      uses: lycheeverse/lychee-action@v2.0.2
      with:
        fail: false  # Don't fail action on broken links
        output: /tmp/lychee-out.md
        # 429: Too many requests
        args: >
          --accept 429
          --exclude "^https://docs.generic-mapping-tools.org/6.[0-9]?/%s$"
          --exclude "^https://docs.generic-mapping-tools.org/6.[0-9]?/%3Cmodule-name%3E.html$"
          --exclude "^https://doi.org"
          --exclude "^https://github.com/GenericMappingTools/gmt/releases/tag/X.Y.Z$"
          --exclude "^https://github.com/GenericMappingTools/pygmt/edit"
          --exclude "^https://github.com/GenericMappingTools/pygmt/issues/new"
          --exclude "^https://github.com/GenericMappingTools/pygmt/pull/[0-9]*$"
          --exclude "^https://github.com/GenericMappingTools/pygmt/issues/[0-9]*$"
          --exclude "^https://github.com/GenericMappingTools/pygmt/releases/tag/%7B%7Bpath%7D%7D"
          --exclude "^https://hackmd.io/@pygmt"
          --exclude "^https://test.pypi.org/simple/"
          --exclude "^https://www.adobe.com/jp/print/postscript/pdfs/PLRM.pdf"
          --exclude "^https://www.generic-mapping-tools.org/remote-datasets/%s$"
          --exclude "^https://www.pygmt.org/%7B%7Bpath%7D%7D"
          --exclude "^https://www.researchgate.net/"
          --exclude "^https://zenodo.org/badge/DOI/"
          --verbose
          "repository/**/*.rst"
          "repository/**/*.md"
          "repository/**/*.py"
          "documentation/dev/**/*.html"

    - name: Get current date
      id: date
      run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT

    - name: Create Issue From File
      if: env.lychee_exit_code != 0
      run: |
        cd repository/
        title="Link Checker Report on ${{ steps.date.outputs.date }}"
        gh issue create --title "$title" --body-file /tmp/lychee-out.md
      env:
        GH_TOKEN: ${{ github.token }}