Skip to content
Snippets Groups Projects
Commit 55d14669 authored by Thorge Petersen's avatar Thorge Petersen
Browse files

Added basic information on how to run the tests and fixes for md linter

parent f395deea
Branches
Tags
1 merge request!41Version 2.0.0
# ckanext-odsh # ckanext-odsh
This CKAN extension provides custom features and the layout of the Open Data Portal Schleswig-Holstein. This CKAN extension provides custom features and the layout of the Open Data Portal
Schleswig-Holstein.
## Table of Contents ## Table of Contents
...@@ -32,21 +33,24 @@ This project requires the following CKAN extensions to work properly: ...@@ -32,21 +33,24 @@ This project requires the following CKAN extensions to work properly:
To install ckanext-odsh: To install ckanext-odsh:
1. Activate your CKAN virtual environment, for example:: 1. Activate your CKAN virtual environment, for example:
```sh ```sh
. /usr/lib/ckan/default/bin/activate . /usr/lib/ckan/default/bin/activate
``` ```
2. Install the ckanext-odsh Python package into your virtual environment:: 2. Install the ckanext-odsh Python package into your virtual environment:
```sh ```sh
pip install https://code.schleswig-holstein.de/opendata/ckanext-odsh.git pip install https://code.schleswig-holstein.de/opendata/ckanext-odsh.git
``` ```
3. Add `odsh` to the `ckan.plugins` setting in your CKAN config file (by default the config file is located at `/etc/ckan/default/production.ini`). 3. Add `odsh` to the `ckan.plugins` setting in your CKAN config file (by default
the config file is located at `/etc/ckan/default/production.ini`).
You may also add `odsh_autocomplete`, `odsh_dcat_harvest`, `kiel_harvester` and `statistikamtnord_harvester` to the plugin list, to enable custom functionality, e.g.: You may also add `odsh_autocomplete`, `odsh_collections`, `odsh_dcat_harvest`,
`kiel_harvester` and `statistikamtnord_harvester` to the plugin list, to enable
custom functionality, e.g.:
```ini ```ini
ckan.plugins = ckan.plugins =
...@@ -63,6 +67,7 @@ To install ckanext-odsh: ...@@ -63,6 +67,7 @@ To install ckanext-odsh:
odsh odsh
odsh_autocomplete odsh_autocomplete
odsh_dcat_harvest odsh_dcat_harvest
odsh_collections
qa qa
archiver archiver
recline_view recline_view
...@@ -79,7 +84,8 @@ To install ckanext-odsh: ...@@ -79,7 +84,8 @@ To install ckanext-odsh:
### Configuration ### Configuration
The extension requires configuration parameters in the CKAN configuration file (e.g., `production.ini`). The following parameters should be set: The extension requires configuration parameters in the CKAN configuration file (e.g.,
`production.ini`). The following parameters should be set:
Parameter | Type | Description Parameter | Type | Description
--------- | ----- | ----------- --------- | ----- | -----------
...@@ -98,7 +104,26 @@ ckanext.odsh.is_optional_temporal_start | `boolean` | E.g., `False`. ...@@ -98,7 +104,26 @@ ckanext.odsh.is_optional_temporal_start | `boolean` | E.g., `False`.
### Testing ### Testing
*Deprecated – will be updated soon.* To ensure the quality and functionality of the `ckanext-odsh` extension, a comprehensive
test suite is provided. You can follow the instructions below to run the tests:
1. Activate the virtual environment associated with your project, for example:
```sh
. /usr/lib/ckan/default/bin/activate
```
2. From the `ckanext-odsh` base directory, execute the following commands:
```sh
pytest ckanext/odsh/tests/
pytest ckanext/odsh/tests_tpsh/
```
Running these commands will initiate the test suite, which will automatically execute
various test cases and verify the expected behavior of the extension. The tests are
organized into two directories: `tests` and `tests_tpsh`, each containing different
sets of tests.
## Contributing ## Contributing
...@@ -121,4 +146,5 @@ who participated in this project. ...@@ -121,4 +146,5 @@ who participated in this project.
## License ## License
This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE - see the [LICENSE](./LICENSE) file for details. This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE - see the
[LICENSE](./LICENSE) file for details.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment