Skip to content

Latest commit

 

History

History
121 lines (85 loc) · 3.95 KB

README.md

File metadata and controls

121 lines (85 loc) · 3.95 KB
Raw
The Natural History Museum logo.

ckanext-list

Tests Coveralls CKAN Python Docs

A CKAN extension that adds a list view for resources.

Overview

This extension adds a list view for resources on a CKAN instance. Records are listed as brief summaries, with a configurable set of fields shown for each.

NB: This extension currently only works with the Natural History Museum's theme extension ckanext-nhm; this should be fixed in future releases (contributions are always welcome).

Installation

Path variables used below:

  • $INSTALL_FOLDER (i.e. where CKAN is installed), e.g. /usr/lib/ckan/default
  • $CONFIG_FILE, e.g. /etc/ckan/default/development.ini

Installing from PyPI

pip install ckanext-list

Installing from source

  1. Clone the repository into the src folder:

    cd $INSTALL_FOLDER/src
git clone https://github.com/NaturalHistoryMuseum/ckanext-list.git

  2. Activate the virtual env:

    . $INSTALL_FOLDER/bin/activate

  3. Install via pip:

    pip install $INSTALL_FOLDER/src/ckanext-list

Installing in editable mode

Installing from a pyproject.toml in editable mode (i.e. pip install -e) requires setuptools>=64; however, CKAN 2.9 requires setuptools==44.1.0. See our CKAN fork for a version of v2.9 that uses an updated setuptools if this functionality is something you need.

Post-install setup

  1. Add 'list' to the list of plugins in your $CONFIG_FILE:

    ckan.plugins = ... list

  2. Install lessc globally:

    npm install -g "less@~4.1"

Configuration

There are currently no options that can be specified in your .ini config file.

Usage

To use the view in a template:

<div data-module="list"
     data-module-resource = "{{ h.dump_json(resource_json) }}"
     data-module-resource-view = "{{ h.dump_json(resource_view_json) }}">
</div>

{% resource 'ckanext-list/main' %}

Testing

There is a Docker compose configuration available in this repository to make it easier to run tests. The ckan image uses the Dockerfile in the docker/ folder.

To run the tests against ckan 2.9.x on Python3:

  1. Build the required images:

    docker compose build

  2. Then run the tests. The root of the repository is mounted into the ckan container as a volume by the Docker compose configuration, so you should only need to rebuild the ckan image if you change the extension's dependencies.

    docker compose run ckan