A CKAN extension for accessing instance statistics.
Project description
ckanext-statistics
A CKAN extension for accessing instance statistics.
Overview
Shows statistics for datasets and downloads on the CKAN instance.
NB: This extension currently only works with the Natural History Museum's theme extension ckanext-nhm.
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-statistics
Installing from source
-
Clone the repository into the
src
folder:cd $INSTALL_FOLDER/src git clone https://github.com/NaturalHistoryMuseum/ckanext-statistics.git
-
Activate the virtual env:
. $INSTALL_FOLDER/bin/activate
-
Install via pip:
pip install $INSTALL_FOLDER/src/ckanext-statistics
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 'statistics' to the list of plugins in your
$CONFIG_FILE
:ckan.plugins = ... statistics
Configuration
These are no configuration options for this extension.
Usage
Actions
download_statistics
Statistics for downloads of datasets from the instance.
from ckan.plugins import toolkit
# all of these filters are optional
data_dict = {
'resource_id': RESOURCE_ID,
'year': YEAR,
'month': MONTH
}
toolkit.get_action('download_statistics')(
context,
data_dict
)
dataset_statistics
Statistics for dataset records.
from ckan.plugins import toolkit
# these filters are optional
data_dict = {
'resource_id': RESOURCE_ID,
}
toolkit.get_action('dataset_statistics')(
context,
data_dict
)
Commands
statistics
-
initdb
: initialise the database modelckan -c $CONFIG_FILE statistics initdb
-
gbif
: retrieve download statistics from GBIF.ckan -c $CONFIG_FILE statistics gbif
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 ckan
Project details
Release history Release notifications | RSS feed
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
Hashes for ckanext-statistics-3.1.10.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | cbfa237d590bb78b357d08b8989a98cc8eee76f2880fbe202df1b7d1730f9676 |
|
MD5 | f9cafa24880e5ed0b7454128b4df7e98 |
|
BLAKE2b-256 | 6fb929f91784c6b1e00312a187d7e66baf9982079ba8e0032f634d54f245f2e8 |
Hashes for ckanext_statistics-3.1.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 124aaff1e224ba2eb585a1950ae0db45d962a0e3a5f3d6f6fb3e9cbb284c41e6 |
|
MD5 | 103bebc27e7efadb8f63e835ae3a5a18 |
|
BLAKE2b-256 | 48e71693000dce9a6583725953709c9e1b8c15276ea2dce67fef87ae84deb8be |