django-linkcheck 2.3.0

findlinks

This command goes through all registered fields and records the URLs it finds. This command does not validate anything. Typically run just after installing and configuring django-linkcheck.

checklinks

For each recorded URL, check and report the validity of the URL. All internal links are checked, but only external links that have not been checked during the last LINKCHECK_EXTERNAL_RECHECK_INTERVAL minutes are checked. This interval can be adapted per-invocation by using the --externalinterval (-e) command option (in minutes).

You can also limit the maximum number of links to be checked by passing a number to the --limit (--l) command option.

linkcheck_suggest_config

This command goes through all models and checks whether they contain fields that can potentially be checked by linkcheck. If they are not yet registered, a sample config is suggested.

You can also pass the option --model to generate a sample config for the given model.

LINKCHECK_DISABLE_LISTENERS

A setting to totally disable linkcheck, typically when running tests. See also the context managers below.

LINKCHECK_EXTERNAL_RECHECK_INTERVAL

Default: 10080 (1 week in minutes)

Will not recheck any external link that has been checked more recently than this value.

LINKCHECK_EXTERNAL_REGEX_STRING

Default: r’^https?://’

A string applied as a regex to a URL to determine whether it’s internal or external.

LINKCHECK_MEDIA_PREFIX

Default: ‘/media/’

Currently linkcheck tests whether links to internal static media are correct by wrangling the URL to be a local filesystem path.

It strips MEDIA_PREFIX off the interal link and concatenates the result onto settings.MEDIA_ROOT and tests that using os.path.exists

This ‘works for me’ but it is probably going to break for other people’s setups. Patches welcome.

LINKCHECK_RESULTS_PER_PAGE

Controls pagination.

Pagination is slightly peculiar at the moment due to the way links are grouped by object.

LINKCHECK_MAX_URL_LENGTH

Default: 255

The length of the URL field. Defaults to 255 for compatibility with MySQL (see http://docs.djangoproject.com/en/dev/ref/databases/#notes-on-specific-fields )

LINKCHECK_CONNECTION_ATTEMPT_TIMEOUT

Default: 10

The timeout in seconds for each connection attempts. Sometimes it is useful to limit check time per connection in order to hold at bay the total check time.

SITE_DOMAIN and LINKCHECK_SITE_DOMAINS

Linkcheck tests external and internal using differently. Internal links use the Django test client whereas external links are tested using urllib2.

Testing internal links this as if they were external can cause errors in some circumstances so Linkcheck needs to know which external urls are to be treated as internal.

Linkcheck looks for either of the settings above. It only uses SITE_DOMAIN if LINKCHECK_SITE_DOMAINS isn’t present

SITE_DOMAIN = “mysite.com”

would tell linkchecker to treat the following as internal links:

mysite.com www.mysite.com test.mysite.com

If you instead set LINKCHECK_SITE_DOMAINS to be a list or tuple then you can explicitly list the domains that should be treated as internal.

LINKCHECK_TOLERATE_BROKEN_ANCHOR

Default: True

Whether links with broken hash anchors should be marked as valid. Disable this if you want that links to anchors which are not contained in the link target’s HTML source are marked as invalid.

Running tests

Tests can be run standalone by using the runtests.py script in linkcheck root:

$ python runtests.py

If you want to run linkcheck tests in the context of your project, you should include 'linkcheck.tests.sampleapp' in your INSTALLED_APPS setting.

Linkcheck gives you two context managers to enable or disable listeners in your own tests. For example:

def test_something_without_listeners(self):
    with listeners.disable_listeners():
        # Create/update here without linkcheck intervening.

In the case you defined the LINKCHECK_DISABLE_LISTENERS setting, you can temporarily enable it by:

def test_something_with_listeners(self):
    with listeners.enable_listeners():
        # Create/update here and see linkcheck activated.

Translations

At the moment this app is available in English, German, and French. If you want to contribute translations for LOCALE, run:

django-admin makemessages --locale LOCALE

and edit the corresponding file in linkcheck/locale/LOCALE/LC_MESSAGES/django.po.

Create new release

1. Bump version in pyproject.toml

2. Update CHANGELOG

3. Create release commit: git commit --message "Release vX.Y.Z"

4. Create git tag: git tag -a "X.Y.Z" -m "Release vX.Y.Z"

5. Push the commit and tag to the repository: git push && git push --tags

6. Build the source distribution: python -m build

7. Publish the package to PyPI: twine upload dist/django-linkcheck-X.Y.Z*