ckanext-check-link

Link checker for CKAN.

Provides API, CLI commands, and views for:

• checking availability of the file, refereed by resource
• checking availability of any arbitrary link.
• storing results of these checks
• visualizing stored results

Index

• Requirements
• Installation
• Config settings
• UI
• CLI
• API

Requirements

Compatibility with core CKAN versions:

CKAN version	Compatible?
2.9	yes
2.10	yes

Installation

1. Install ckanext-check-link

   pip install ckanext-check-link
   

2. Add check_link to the ckan.plugins setting in your CKAN config file.

3. Run migration to set up database table called 'check_link_report'

   ckan -c /etc/ckan/default/ckan.ini db upgrade -p check_link
   

Config settings

# Allow any logged-in user to check links. This implies specific security issues,
# thus disabled by default.
# (optional, default: false).
ckanext.check_link.user_can_check_url = yes

# URL for the "Link availability" page.
# (optional, default: /check-link/report/global)
ckanext.check_link.report.base_template = /ckan-admin/link-state

# A base template that is extended by the "Link availability" page.
# (optional, default: check_link/base_admin.html)
ckanext.check_link.report.base_template = check_link/base.html

UI

Link availability

Endpoint: check_link.report

Path: /check-link/report/global

Paginated listing of all the "broken" links. Access is controlled by the check_link_view_report_page auth function, which can be bypassed only by sysadmin.

CLI

CLI commands are registered under ckan check-link route.

check-packages

Check every resource inside each package.

The scope can be narrowed via arbitrary number of arguments, specifying the package's ID or name.

# check all the public packages
$ ckan check-link check-packages

# check all the active packages
$ ckan check-link check-packages --include-private

# check all the public and draft pacakges
$ ckan check-link check-packages --include-draft

# check only two specified packages
$ ckan check-link check-packages pkg-id-one pkg-name-two

API

TBA

License

AGPL