Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/datopian/ckanext-requestdata
:email: :mailbox_with_mail: CKAN extension for requesting new data :email: :mailbox_with_mail:
https://github.com/datopian/ckanext-requestdata
ckan ckan-extension ckanext dataset open-data python
Last synced: about 2 months ago
JSON representation
:email: :mailbox_with_mail: CKAN extension for requesting new data :email: :mailbox_with_mail:
- Host: GitHub
- URL: https://github.com/datopian/ckanext-requestdata
- Owner: datopian
- License: agpl-3.0
- Created: 2017-03-06T15:38:22.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2019-01-15T12:47:22.000Z (almost 6 years ago)
- Last Synced: 2024-08-29T02:02:12.551Z (4 months ago)
- Topics: ckan, ckan-extension, ckanext, dataset, open-data, python
- Language: Python
- Homepage:
- Size: 442 KB
- Stars: 5
- Watchers: 24
- Forks: 9
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Request data · [](https://travis-ci.org/ViderumGlobal/ckanext-requestdata) [](https://coveralls.io/github/ViderumGlobal/ckanext-requestdata?branch=master)
This extension introduces a new type of dataset in which access to data is by request. The dataset's metadata is published and searchable but it has no resources - no files are uploaded in the CKAN filestore and there are no URL links to externally hosted files. When a logged in CKAN user requests the data in the dataset, the maintainers are alerted and one of them can decide to accept or decline the request. These actions are performed in the maintainer's dashboard. Conversations between the requester and maintainer are purposely not recorded; only the information needed for dashboard statistics is stored ie. requested, replied, declined, shared. Organizations and system administrators have overview dashboards.
## Full Documentation
See our [Wiki](https://github.com/ViderumGlobal/ckanext-requestdata/wiki) for full documentation, examples, operational details and other information.
## Installation
To install ckanext-requestdata:
1. Activate your CKAN virtual environment, for example:
```
. /usr/lib/ckan/default/bin/activate
```
2. Install the ckanext-requestdata Python package into your virtual environment:
```
pip install pip install https://github.com/ViderumGlobal/ckanext-requestdata/archive/master.zip
```
3. Add ``requestdata`` to the ``ckan.plugins`` setting in your CKAN
config file (by default the config file is located at
``/etc/ckan/default/production.ini``).
4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:
```
sudo service apache2 reload
```
## Config Settings
These are the required configuration options used by the extension:
```
hdx_portal = False
smtp.server=YOUR_SMTP_SERVER
smtp.user=YOUR_SMTP_USERNAME
smtp.password=YOUR_SMTP_PASSWORD
smtp.mail_from =SENDER_MAIL
```
You can add these additional options in the config for footer links in the email
when new data request is sent:
```
ckanext.requestdata.newsletter_url
ckanext.requestdata.twitter_url
ckanext.requestdata.contact_email
```
## Development Installation
To install ckanext-requestdata for development, activate your CKAN virtualenv
and do:
```
git clone https://github.com/ViderumGlobal/ckanext-requestdata.git
cd ckanext-requestdata
python setup.py develop
pip install -r dev-requirements.txt
```
## Running the Tests
To run the tests, first make sure that you have installed the required
development dependencies in CKAN, which can be done by running the following
command in the CKAN's `src` directory:
```
pip install -r dev-requirements.txt
```
After that just type this command to actually run the tests in the extension.
```
nosetests --ckan --with-pylons=test.ini
```
To run the tests and produce a coverage report, first make sure you have coverage installed in your virtualenv (pip install coverage) then run:
```
nosetests --nologcapture --with-pylons=test.ini --with-coverage --cover-package=ckanext.requestdata --cover-inclusive --cover-erase --cover-tests
```