A cookiecutter template for creating an OTEAPI Plugin repository.
The template contains pre-configured features for:
- Documentation via a MkDocs setup.
- MIT License.
- Pre-commit configuration with several useful hooks.
- Python unit tests through pytest.
- Plugin integration tests for OTEAPI Core.
- pip installable package.
Furthermore, the repository will contain dummy/demo strategies for each of the currently available OTE strategy types:
- Download (
scheme) - Filter (
filterType) - Mapping (
mappingType) - Parse (
mediaType) - Resource (
accessService) - Transformation (
transformationType)
These should be updated to your specific needs according to the strategy or strategies you intend to implement. The ones that are not used should be deleted.
It is important to update the setup.cfg according to the updated strategies in order for the strategies to be importable through OTEAPI Core.
Please ensure to either uncomment the strategies as they are needed or remove them altogether if they are not needed.
To start up a new OTEAPI Plugin repository you need to have the following pre-requisites in your system:
- Access to a command line.
- Have
gitinstalled. - Have minimum Python 3.9 installed.
Also, it might be good to operate within a virtual environment. For more information about what suits your needs, take a look at this guide from python.org or this guide from towardsdatascience.com.
If you are using a virtual environment, it is understood that it has already been activated in the following examples.
Install cookiecutter according to the documentation.
Then run the following to generate a new OTEAPI Plugin repository:
$ cookiecutter gh:EMMC-ASBL/oteapi-plugin-template # Download from GitHub and generate repo
project_name [OTEAPI My Plugin]:
...Now type in the required inputs to customize your repository.
Alternatively, you can pre-define the inputs in a JSON file and pass it to the cookiecutter command using the --config-file option.
The list of input keys and default values can be found in cookiecutter.json.
An overview is also provided in the following table:
| Input key | Description | Default value |
|---|---|---|
project_name |
A human-readable name of the project. | OTEAPI My Plugin |
project_slug |
The official package name to be used when installing the package via a package manager (e.g., pip or conda).This will be the root directory name and should also be the repository name on an online git repository (like GitHub or GitLab). It is recommended to have the project slug start with oteapi-.Important: A project slug value may not include white space. |
oteapi-myplugin |
package_name |
The Python importable root module. This will be the root module repository name, under which the source code will be placed. It is recommended to have the package name start with oteapi_.Important: A package name value may not include white space. A package name value may only be made up of the character set: a-z, A-Z, _, 0-9, and may not start with a number. |
oteapi_myplugin |
author |
The author of the package. This can also be your organization name. | Firstname Lastname |
organization |
Your organization. | SINTEF |
email |
The author's email address. | [email protected] |
version |
Start version. Important: Must follow semantic versioning. For more information see semver.org. |
0.0.1 |
year |
The current year. | 2023 |
use_git |
Whether or not the generated repository should be initialized using git. |
True |
username |
A public source code platform username, e.g., for GitHub, GitLab, BitBucket | GitHub_GitLab_BitBucket_etc_Username |
scm_url |
The intended or existing URL to the repository's source code. | https://github.com/FirstnameLastname/oteapi-myplugin |
OTEAPI Plugin Cookiecutter Template is released under the MIT license with copyright © SINTEF.
OTEAPI Plugin Cookiecutter Template has been supported by the following projects:
-
OntoTrans (2020-2024) that receives funding from the European Union’s Horizon 2020 Research and Innovation Programme, under Grant Agreement n. 862136.
-
VIPCOAT (2021-2025) receives funding from the European Union’s Horizon 2020 Research and Innovation Programme - DT-NMBP-11-2020 Open Innovation Platform for Materials Modelling, under Grant Agreement no: 952903.
-
OpenModel (2021-2025) receives funding from the European Union’s Horizon 2020 Research and Innovation Programme - DT-NMBP-11-2020 Open Innovation Platform for Materials Modelling, under Grant Agreement no: 953167.