Skip to content

:octocat: GitHub Action to scan your site for broken links so you can fix them πŸ”—

License

Notifications You must be signed in to change notification settings

victoriadrake/link-snitch

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Link Snitch: scan your site for broken links so you can fix them πŸ”—

A lightweight GitHub Action that runs hydra-link-checker on the URL you provide, which crawls your site and scans for broken links using multithreaded Python (standard library).

It's up to you to use Link Snitch responsibly!

Contributing

This project simply Action-ifies (that's a word now, right?) the Hydra program. To submit issues or contributions to the link-checking functionality, go to hydra-link-checker.

Use this in your workflow

You can use this action in a workflow file to run Link Snitch on your choice of trigger, for instance, on a push event to the master branch:

  push:
    branches:
      - master

Or on a weekly schedule, say, 04:05 on Monday:

on:
  schedule:
    - cron: '5 4 * * 1'

Here's a full example of a workflow file. See below for env instructions.

name: Link Snitch

on:
  push:
    branches:
      - master

env:
  URL: https://example.com
  FILENAME: report.yaml
  CONFIG: config.json

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
      - name: Check out master
        uses: actions/checkout@master
        with:
          fetch-depth: 1
      - name: Report broken links
        uses: victoriadrake/link-snitch@master

Setting the env variables

This action requires a single environment variable, URL. Set this to the fully qualified address of your site, including schema (the https:// part).

Optional variables include:

Workflow customization

See full instructions for Configuring and managing workflows.

For help editing the YAML file, see Workflow syntax for GitHub Actions.

View results

By default, the report is YAML formatted and output to stdout in your Action run. If you wish to save this to a file that you can download, set FILENAME to a file name of your choosing, then use actions/upload-artifact in your workflow. See Uploading build and test artifacts for more.