Skip to main content

CLI/API for links liveness checking.

Project description

Travis (.org) codecov Codacy Badge


deadlinks is a simple cli tool to check your documentation/website for deadlinks.

Features

  • Concurrent and recursive checks
  • External links checks
  • Checking links within base url path
  • Retries in the case of 502, 503 and 504 http errors

Installing (development)

From Source (Python 3.5)

While developing on mac with Python 3.5 I have found that simple install from source doesn't work, as expected.

# installation into virtual environment
python3.5 -m venv .venv
source .venv/bin/activate

# update pip
curl https://bootstrap.pypa.io/get-pip.py | python3.5
# we expect to get pip version above 19.2.3
pip --version

# clone repo
git clone https://github.com/butuzov/deadlinks.git
cd deadlinks
git checkout develop
pip install -r requirments.txt
python setup.py install

From Source (Python 3.6, 3.7)

# installation into virtual environment
python3 -m venv .venv
source .venv/bin/activate
pip install git+https://github.com/butuzov/deadlinks.git@develop

Usage

See more examples at docs

# run 10 instances of crawler against https://gobyexample.com.ua
# with the additional check for the external links (except ones that
# match play.golang.org)
deadlinks https://gobyexample.com.ua -n 10 -e -d play.golang.org

# get more help with
deadlinks --help

Contributing

Your contributions are welcome!

  • Fork deadlinks repository
  • Switch to develop and create new branch using tip of
  • Do your changes in new branach
  • Create pull request back to development branch

Alternatives

These are a lot of alternative ways to check your website for dead links errors, you can check a open software or check other options:

Platform Title Link
mac, ui Integrity https://peacockmedia.software/mac/integrity/free.html
win, ui Xenu's Link Sleuth http://home.snafu.de/tilman/xenulink.html
web Online Broken Link Checker https://www.brokenlinkcheck.com/
web Free Broken Link Tool https://www.deadlinkchecker.com/website-dead-link-checker.asp
win, ui InterroBot https://interro.bot/
go, cli muffet https://github.com/raviqqe/muffet
cli, ui, web linkchecker https://wummel.github.io/linkchecker

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deadlinks-0.0.1.tar.gz (17.9 kB view hashes)

Uploaded Source

Built Distribution

deadlinks-0.0.1-py3-none-any.whl (27.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page