ckanext-nhm
A CKAN extension for the Natural History Museum's Data Portal.
Overview
This extension provides theming and specific functionality for the Natural History Museum's Data Portal.
The codebase shows how to implement various plugins created by the Museum's developers; notably our new ElasticSearch datastore with versioned records.
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
Pre-install setup
This package depends on ckanext-dcat==1.3.0, but since that isn't available on PyPI it's not listed in the package dependencies.
Install it with:
pip install git+https://github.com/ckan/ckanext-dcat@v1.3.0#egg=ckanext-dcat
Installing from PyPI
pip install ckanext-nhm
Installing from source
-
Clone the repository into the
srcfolder:cd $INSTALL_FOLDER/src git clone https://github.com/NaturalHistoryMuseum/ckanext-nhm.git
-
Activate the virtual env:
. $INSTALL_FOLDER/bin/activate
-
Install via pip:
pip install $INSTALL_FOLDER/src/ckanext-nhm
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
-
Add 'nhm' to the list of plugins in your
$CONFIG_FILE:ckan.plugins = ... nhm
-
Install
lesscglobally:npm install -g "less@~4.1"
Configuration
Usage
Actions
record_show
Retrieve an individual record.
from ckan.plugins import toolkit
data_dict = {
'resource_id': RESOURCE_ID,
'record_id': RECORD_ID,
'version': OPTIONAL_RECORD_VERSION
}
toolkit.get_action('record_show')(
context,
data_dict
)
object_rdf
Get record RDF from its occurrence ID.
from ckan.plugins import toolkit
data_dict = {
'uuid': OCCURRENCE_ID,
'version': OPTIONAL_RECORD_VERSION
}
toolkit.get_action('object_rdf')(
context,
data_dict
)
Commands
create-dataset-vocabulary
Ensures the default dataset vocabulary and categories exists.
ckan -c $CONFIG_FILE nhm create-dataset-vocabulary
add-dataset-category
Adds the given category to the dataset category vocabulary.
ckan -c $CONFIG_FILE nhm delete-dataset-category $NAME
delete-dataset-category
Deletes the given dataset category from the vocabulary.
ckan -c $CONFIG_FILE nhm create-dataset-vocabulary $NAME
replace-resource-file
Replaces the file associated with $RESOURCE_ID with $PATH, e.g. to replace a small dummy file
with a large one that was too big to upload initially.
ckan -c $CONFIG_FILE nhm replace-resource-file $RESOURCE_ID $PATH
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:
-
Build the required images:
docker compose build
-
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 --rm ckan
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ckanext_nhm-7.8.0.tar.gz.
File metadata
- Download URL: ckanext_nhm-7.8.0.tar.gz
- Upload date:
- Size: 55.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
849597e0d6ae3f334c78d7dae1c63c50a8aa46a54a40f1c1fd2f4305243ac2bd
|
|
| MD5 |
b601b321cb7acffc4bf53d50f332e5d4
|
|
| BLAKE2b-256 |
cda35018e0f6077c86d34f06b887cebfcac56c458607989928a9e7eaf8bf9379
|
File details
Details for the file ckanext_nhm-7.8.0-py3-none-any.whl.
File metadata
- Download URL: ckanext_nhm-7.8.0-py3-none-any.whl
- Upload date:
- Size: 55.9 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
788d4390f1c565657ca498c4830c45a79e7b225d3279f23aa5a9c363f800c003
|
|
| MD5 |
8ac3507a8ba3ae24a054ab02690ce274
|
|
| BLAKE2b-256 |
a332c0c456aa2018f869b5b0c56c32e60bd9934fd9fb8373f75c4a5552003370
|
