https://github.com/techwiz-3/linksafe
🔗 Scan links in your repo to ensure they are valid. Works in private repos!
https://github.com/techwiz-3/linksafe
awesome broken-link-finder continuous-integration github-action github-action-docker hacktoberfest hacktoberfest-2022 link-checker link-checking links linksafe python-github-actions url-checker validator
Last synced: 2 months ago
JSON representation
🔗 Scan links in your repo to ensure they are valid. Works in private repos!
- Host: GitHub
- URL: https://github.com/techwiz-3/linksafe
- Owner: TechWiz-3
- License: gpl-3.0
- Created: 2022-07-26T10:39:20.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-19T05:55:32.000Z (over 3 years ago)
- Last Synced: 2026-02-10T23:49:39.513Z (2 months ago)
- Topics: awesome, broken-link-finder, continuous-integration, github-action, github-action-docker, hacktoberfest, hacktoberfest-2022, link-checker, link-checking, links, linksafe, python-github-actions, url-checker, validator
- Language: Python
- Homepage:
- Size: 524 KB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Linksafe
Scan your repo for broken links. Whitelist links or files you wish to ignore. Works in private repos. Designed to be ideal for awesome-lists!
:zap: Check out the [fast](https://github.com/TechWiz-3/linksafe/tree/fast) branch if you want lightning fast checking for large volumes and very short run time.
## Example usage
```yaml
name: Link-check
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Run linksafe
uses: TechWiz-3/linksafe@main
with: # comma seperated lists
# use relative paths, if no dirs specified root dir is scanned
dirs: ".,./src,./src/data,./tests,./tests/pylint"
# set to false by default
verbose: true
whitelist_links: "https://xyz.xyz"
# use relative paths
whitelist_files: "./doc/HACKING.md"
```
## More info
`https://example.com` and `http://localhost` are automatically ignored
Each directory to be scanned must be specified directly, otherwise only the root dir will be scanned and subdirs will be ignored. At the same time, if you want the root dir AND subdirs to be scanned, remember to include a `.` as part of the list.
Files and or links can be whitelisted i.e. ignored.
Please note, with repos with a lot of links, a scan can take a LONG time, even up to 40+ minutes. If you wish scans to be no longer than a minute or two, use the [fast](https://github.com/TechWiz-3/linksafe/tree/fast) branch.
## Todo
- [ ] In depth error handling for user inputs (if they go wrong)
- [ ] Recognition of removed yt videos
- [ ] Emoji HTTP code (optional)
- [ ] Enforce HTTPS option
- [ ] Allow bad SSL cert option
- [ ] Possible repo replacements, aliases or moves if a gh repo link fails
- [ ] 429 error code
---
### 🎉 Commit labels
If you're interested in the commit labels used in this repo, check out my [git emoji](https://github.com/TechWiz-3/git-commit-emojis) project