CKAN QA Extension
Python HTML Shell
Failed to load latest commit information.
bin Try adding solr config from other extensions. Jun 7, 2016
ckanext Openness report index is now sorted by number of stars. Add progress … Oct 21, 2016
.coveragerc Travis Nov 20, 2015
.travis.yml Add travis Nov 20, 2015
LICENSE Travis Nov 20, 2015
README.rst [#37] Added note about starting celery Oct 21, 2016
dev-requirements.txt Fix tests Nov 20, 2015
qa_report.png Add pics to readme Nov 20, 2015
requirements.txt Openness report index is now sorted by number of stars. Add progress … Oct 21, 2016 Added QA info to package_show. Templates added to display stars. Use … Nov 19, 2015
test-core.ini Travis - more logging. Nov 20, 2015
test.ini Test config added. Nov 5, 2012


CKAN QA Extension (Quality Assurance)

The ckanext-qa extension will check each of your dataset resources in CKAN and give them an 'openness score' based Tim Berners-Lee's five stars of openness (

The openness score is displayed as stars on the dataset and resource pages.

Stars on the dataset Stars spelled out on the resource

It also provides a report that allows you to view the openness (stars ratings) across a publisher or across them all:

Openness report (star ratings) for a publisher


Before installing ckanext-qa, make sure that you have installed the following:


Known issues:

  • if the CKAN version is earlier than 2.3 then QA and Archiver information will not display on the resource read page.


To install ckanext-qa, ensure you have previously installed ckanext-archiver (v2.0+) and ckanext-report and then:

  1. Activate your CKAN virtual environment, for example:

    . /usr/lib/ckan/default/bin/activate
  2. Install the ckanext-qa Python package into your virtual environment:

    pip install -e git+
  3. Install the qa dependencies:

    pip install -r ckanext-qa/requirements.txt
  4. Now create the database tables:

    paster --plugin=ckanext-qa qa init --config=production.ini
  5. Add qa to the ckan.plugins setting BEFORE archiver in your CKAN config file (by default the config file is located at /etc/ckan/default/production.ini).

  6. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:

    sudo service apache2 reload

Upgrade from version 0.1 to 2.x

NB You should upgrade ckanext-archiver and ckanext-qa from v0.1 to 2.x in one go. Upgrade ckanext-archiver first and then carry out the following:

  1. Activate your CKAN virtual environment, for example:

    . /usr/lib/ckan/default/bin/activate
  2. Upgrade the ckanext-qa Python package:

    cd ckanext-qa
    git pull
    python develop
  3. Create the new database tables:

    paster --plugin=ckanext-qa qa init --config=production.ini
  4. Install the normal and developer dependencies:

    pip install -r requirements.txt
    pip install -r dev-requirements.txt
  5. Migrate your database to the new QA tables:

    python ckanext/qa/bin/ --write production.ini
  6. (Re)start the paster celeryd2 run processes described for ckanext-archiver.


You must make sure that the following is set in your CKAN config:

ckan.site_url = <URL to your CKAN instance>

Optionally you can configure a different set of scores to award each resource format:

qa.resource_format_openness_scores_json = <filepath>

The default value is resource_format_openness_scores.json)


First, make sure that Celery is running for the priority and bulk queues. This is explained in the ckanext-archiver README:

[Using Archiver](

QA is performed when a dataset/resource is archived, or you can run it manually using a paster command:

paster --plugin=ckanext-qa qa update [dataset] --config=production.ini

Here dataset is a CKAN dataset name or ID, or you can omit it to do the QA on all datasets.

For a full list of manual commands run:

paster --plugin=ckanext-qa qa --help

Once the QA has run for a dataset, you will see the stars displayed on the dataset's web page, and the detected file format available when you call package_show for it, in the qa for the dataset and each resource.

You can get an overall picture by generating an Openness report:

paster --plugin=ckanext-report report generate openness --config=production.ini

And view it on your CKAN site at /report/openness.


To run the tests:

  1. Activate your CKAN virtual environment, for example:

    . /usr/lib/ckan/default/bin/activate
  2. If not done already, install the dev requirements:

    (pyenv)~/pyenv/src/ckan$ pip install ../ckanext-qa/dev-requirements.txt
  3. From the CKAN root directory (not the extension root) do:

    (pyenv)~/pyenv/src/ckan$ nosetests --ckan ../ckanext-qa/tests/ --with-pylons=../ckanext-qa/test-core.ini

If you get error "MagicException: None" then it may be due to libmagic needing an update. Try:

sudo apt-get install libmagic1


The archiver info shows on the dataset/resource pages but the QA doesn't

You need to ensure that in your ckan.plugins you have qa listed BEFORE archiver or else the template inheritance doesn't work and this happens.