| Name | ckanext-query-dois JSON |
| Version |
4.1.0
JSON |
| download |
| home_page | |
| Summary | A CKAN extension that creates DOIs for queries on resources. |
| upload_time | 2023-12-04 11:35:31 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.6 |
| license | GPL-3.0-or-later |
| keywords |
ckan
data
doi
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
<!--header-start-->
<img src="https://data.nhm.ac.uk/images/nhm_logo.svg" align="left" width="150px" height="100px" hspace="40"/>
# ckanext-query-dois
[](https://github.com/NaturalHistoryMuseum/ckanext-query-dois/actions/workflows/main.yml)
[](https://coveralls.io/github/NaturalHistoryMuseum/ckanext-query-dois)
[](https://github.com/ckan/ckan)
[](https://www.python.org/)
[](https://ckanext-query-dois.readthedocs.io)
_A CKAN extension that creates DOIs for queries on resources._
<!--header-end-->
# Overview
<!--overview-start-->
This extension creates (mints) digital object identifiers (DOIs) for queries on resources. By recording the query parameters used and the exact version of the data at the time of the query, this allows precise retrieval of the data as it looked when the DOI was minted.
Can be used in conjunction with **v5.2+** of [ckanext-versioned-datastore](https://github.com/NaturalHistoryMuseum/ckanext-versioned-datastore).
You will need an account with a DataCite DOI service provider to use this extension.
<!--overview-end-->
# Installation
<!--installation-start-->
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
```shell
pip install ckanext-query-dois
```
## Installing from source
1. Clone the repository into the `src` folder:
```shell
cd $INSTALL_FOLDER/src
git clone https://github.com/NaturalHistoryMuseum/ckanext-query-dois.git
```
2. Activate the virtual env:
```shell
. $INSTALL_FOLDER/bin/activate
```
3. Install via pip:
```shell
pip install $INSTALL_FOLDER/src/ckanext-query-dois
```
### 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](https://github.com/NaturalHistoryMuseum/ckan) for a version of v2.9 that uses an updated setuptools if this functionality is something you need.
## Post-install setup
1. Add 'query_dois' to the list of plugins in your `$CONFIG_FILE`:
```ini
ckan.plugins = ... query_dois
```
2. Install `lessc` globally:
```shell
npm install -g "less@~4.1"
```
3. Initialise database tables:
```shell
ckan -c $CONFIG_FILE query-dois initdb
```
4. Sign up for an account with [DataCite](https://datacite.org) and provide the credentials in your configuration.
<!--installation-end-->
# Configuration
<!--configuration-start-->
These are the options that can be specified in your .ini config file.
## **[REQUIRED]**
| Name | Description | Options |
|----------------------------------------|-----------------------------------------------------------------------|---------|
| `ckanext.query_dois.prefix` | Prefix to use for the new DOIs | |
| `ckanext.query_dois.datacite_username` | Datacite account username | |
| `ckanext.query_dois.datacite_password` | Datacite account password | |
| `ckanext.query_dois.doi_title` | Template string for the DOI title: takes `count` as a format argument | |
| `ckanext.query_dois.publisher` | DOI publisher name | |
## Other options
| Name | Description | Options | Default |
|--------------------------------|--------------------------------------------------------------|------------|---------|
| `ckanext.query_dois.test_mode` | Enable/disable using test DOIs (i.e. not creating real DOIs) | True/False | True |
<!--configuration-end-->
# Usage
<!--usage-start-->
## Commands
### `initdb`
Initialises the database table.
1. `initdb`: initialise the database model
```bash
ckan -c $CONFIG_FILE query-dois initdb
```
<!--usage-end-->
# Testing
<!--testing-start-->
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:
```shell
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.
```shell
docker-compose run ckan
```
<!--testing-end-->
Raw data
{
"_id": null,
"home_page": "",
"name": "ckanext-query-dois",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "CKAN,data,doi",
"author": "",
"author_email": "Natural History Museum <data@nhm.ac.uk>",
"download_url": "https://files.pythonhosted.org/packages/fe/48/2ca5cba9955dbf4f89a99cfe3c319a727d9b8da12baa297d7c31e5f4028a/ckanext-query-dois-4.1.0.tar.gz",
"platform": null,
"description": "<!--header-start-->\n<img src=\"https://data.nhm.ac.uk/images/nhm_logo.svg\" align=\"left\" width=\"150px\" height=\"100px\" hspace=\"40\"/>\n\n# ckanext-query-dois\n\n[](https://github.com/NaturalHistoryMuseum/ckanext-query-dois/actions/workflows/main.yml)\n[](https://coveralls.io/github/NaturalHistoryMuseum/ckanext-query-dois)\n[](https://github.com/ckan/ckan)\n[](https://www.python.org/)\n[](https://ckanext-query-dois.readthedocs.io)\n\n_A CKAN extension that creates DOIs for queries on resources._\n\n<!--header-end-->\n\n# Overview\n\n<!--overview-start-->\nThis extension creates (mints) digital object identifiers (DOIs) for queries on resources. By recording the query parameters used and the exact version of the data at the time of the query, this allows precise retrieval of the data as it looked when the DOI was minted.\n\nCan be used in conjunction with **v5.2+** of [ckanext-versioned-datastore](https://github.com/NaturalHistoryMuseum/ckanext-versioned-datastore).\n\nYou will need an account with a DataCite DOI service provider to use this extension.\n\n<!--overview-end-->\n\n# Installation\n\n<!--installation-start-->\nPath variables used below:\n- `$INSTALL_FOLDER` (i.e. where CKAN is installed), e.g. `/usr/lib/ckan/default`\n- `$CONFIG_FILE`, e.g. `/etc/ckan/default/development.ini`\n\n## Installing from PyPI\n\n```shell\npip install ckanext-query-dois\n```\n\n## Installing from source\n\n1. Clone the repository into the `src` folder:\n ```shell\n cd $INSTALL_FOLDER/src\n git clone https://github.com/NaturalHistoryMuseum/ckanext-query-dois.git\n ```\n\n2. Activate the virtual env:\n ```shell\n . $INSTALL_FOLDER/bin/activate\n ```\n\n3. Install via pip:\n ```shell\n pip install $INSTALL_FOLDER/src/ckanext-query-dois\n ```\n\n### Installing in editable mode\n\nInstalling 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](https://github.com/NaturalHistoryMuseum/ckan) for a version of v2.9 that uses an updated setuptools if this functionality is something you need.\n\n## Post-install setup\n\n1. Add 'query_dois' to the list of plugins in your `$CONFIG_FILE`:\n ```ini\n ckan.plugins = ... query_dois\n ```\n\n2. Install `lessc` globally:\n ```shell\n npm install -g \"less@~4.1\"\n ```\n\n3. Initialise database tables:\n ```shell\n ckan -c $CONFIG_FILE query-dois initdb\n ```\n\n4. Sign up for an account with [DataCite](https://datacite.org) and provide the credentials in your configuration.\n\n<!--installation-end-->\n\n# Configuration\n\n<!--configuration-start-->\nThese are the options that can be specified in your .ini config file.\n\n## **[REQUIRED]**\n\n| Name | Description | Options |\n|----------------------------------------|-----------------------------------------------------------------------|---------|\n| `ckanext.query_dois.prefix` | Prefix to use for the new DOIs | |\n| `ckanext.query_dois.datacite_username` | Datacite account username | |\n| `ckanext.query_dois.datacite_password` | Datacite account password | |\n| `ckanext.query_dois.doi_title` | Template string for the DOI title: takes `count` as a format argument | |\n| `ckanext.query_dois.publisher` | DOI publisher name | |\n\n## Other options\n\n| Name | Description | Options | Default |\n|--------------------------------|--------------------------------------------------------------|------------|---------|\n| `ckanext.query_dois.test_mode` | Enable/disable using test DOIs (i.e. not creating real DOIs) | True/False | True |\n\n<!--configuration-end-->\n\n# Usage\n\n<!--usage-start-->\n## Commands\n\n### `initdb`\nInitialises the database table.\n\n1. `initdb`: initialise the database model\n ```bash\n ckan -c $CONFIG_FILE query-dois initdb\n ```\n\n<!--usage-end-->\n\n# Testing\n\n<!--testing-start-->\nThere 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.\n\nTo run the tests against ckan 2.9.x on Python3:\n\n1. Build the required images:\n ```shell\n docker-compose build\n ```\n\n2. Then run the tests.\n The root of the repository is mounted into the ckan container as a volume by the Docker compose\n configuration, so you should only need to rebuild the ckan image if you change the extension's\n dependencies.\n ```shell\n docker-compose run ckan\n ```\n\n<!--testing-end-->\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "A CKAN extension that creates DOIs for queries on resources.",
"version": "4.1.0",
"project_urls": {
"changelog": "https://github.com/NaturalHistoryMuseum/ckanext-query-dois/blob/main/CHANGELOG.md",
"repository": "https://github.com/NaturalHistoryMuseum/ckanext-query-dois"
},
"split_keywords": [
"ckan",
"data",
"doi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a28d2077e54f7ecb338e503538b810c649d100478a09188e51e54514d756b228",
"md5": "1682b835fd00e5fc8cfe23e07ea4e3af",
"sha256": "2fc34f40158ec1d79fbd7cec9952b2a8abf9709b02e322ba0c3f18a617ff8517"
},
"downloads": -1,
"filename": "ckanext_query_dois-4.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1682b835fd00e5fc8cfe23e07ea4e3af",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 55461,
"upload_time": "2023-12-04T11:35:29",
"upload_time_iso_8601": "2023-12-04T11:35:29.848663Z",
"url": "https://files.pythonhosted.org/packages/a2/8d/2077e54f7ecb338e503538b810c649d100478a09188e51e54514d756b228/ckanext_query_dois-4.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fe482ca5cba9955dbf4f89a99cfe3c319a727d9b8da12baa297d7c31e5f4028a",
"md5": "f04a852b9a18dc224412857957ff0458",
"sha256": "fdea757bdf2be918e558ae5216761005ecff42d0c20fc18f87424662576ee9dd"
},
"downloads": -1,
"filename": "ckanext-query-dois-4.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f04a852b9a18dc224412857957ff0458",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 45060,
"upload_time": "2023-12-04T11:35:31",
"upload_time_iso_8601": "2023-12-04T11:35:31.116725Z",
"url": "https://files.pythonhosted.org/packages/fe/48/2ca5cba9955dbf4f89a99cfe3c319a727d9b8da12baa297d7c31e5f4028a/ckanext-query-dois-4.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-04 11:35:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NaturalHistoryMuseum",
"github_project": "ckanext-query-dois",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "ckanext-query-dois"
}
