https://github.com/blu3r4y/blinkcheck

Check for dead links in all files, with support for regex URL extraction and glob file patterns
https://github.com/blu3r4y/blinkcheck

dead-links link-checker

Last synced: 9 months ago
JSON representation

Check for dead links in all files, with support for regex URL extraction and glob file patterns

• Host: GitHub
• URL: https://github.com/blu3r4y/blinkcheck
• Owner: blu3r4y
• License: mit
• Created: 2021-08-28T19:54:09.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-08-29T13:50:58.000Z (over 4 years ago)
• Last Synced: 2025-02-11T11:58:03.093Z (11 months ago)
• Topics: dead-links, link-checker
• Language: Python
• Homepage:
• Size: 14.6 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# 🌎 `blinkcheck` - a basic link checker

[![Latest Release](https://img.shields.io/github/release/blu3r4y/blinkcheck.svg?style=popout-square)](https://github.com/blu3r4y/blinkcheck/releases/latest)

[![PyPI Version](https://img.shields.io/pypi/v/blinkcheck?style=popout-square)](https://pypi.org/project/blinkcheck/)

[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg?style=popout-square)](LICENSE.txt)

Check for dead links in all files, with support for regex URL extraction and glob file patterns.

## Installation

    pip install blinkcheck

## Usage Examples

Check for dead links in all files, starting in the current directory.

    blinkcheck

Check for dead links in all Markdown `*.md` files of a specific `./docs` folder.

    blinkcheck --root ./docs -i *.md

Check for dead links in LaTeX `*.tex` files in the current directory with regex `\\url{(.*?)}`.  

If a regex contains one group constructs, the group is used as the link.

    blinkcheck -i *.tex -r "\\url{(.*?)}"

Only list failed links and do not verify SSL certificates.

    blinkcheck --skip-ssl --only-fails

## Available Arguments

| Argument       | Default Value                                        | Description                                                 |

| -------------- | ---------------------------------------------------- | ----------------------------------------------------------- |

| `--root`       | `.` _(current directory)_                            | Directory in which we recursively check matching files.     |

| `-i --include` | `*.*` _(all files)_                                  | A glob pattern that files have to match.                    |

| `-r --regex`   | _see [here](https://gist.github.com/gruber/8891611)_ | Regex to extract URLs with group syntax support.            |

| `--skip-ssl`   |                                                      | Do not verify the SSL certificate when performing requests. |

| `--only-fails` |                                                      | Only output failed requests.                                |

## Development

Install [Poetry](https://python-poetry.org/) and setup your environment.

    poetry install

    poetry shell

Run tests with `pytest`.

    poetry run pytest