softwarepub / hermes

Implementation of the HERMES workflow
https://docs.software-metadata.pub
Other
21 stars 6 forks source link
fair4rs publications software-citation software-metadata

HERMES Key Visual

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public. PyPI - Version PyPI - Python Version

hermes

Implementation of the HERMES workflow to automatize software publication with rich metadata. For more extensive documentation, see our HERMES workflow documentation.

(For more information about the HERMES HMC project, see the HERMES project website.)

HERMES Workflow Visualization

Installation

hermes' primary use case is to use it in a continuous integration environment.

In case you still want to install on your machine, you can (for example) use pip:

pip install hermes

Note: you must have Python 3.10 or newer installed. Older installations of Python will receive a non-related package because of PyPI limitations!

Development Snapshot

To install the most recent version that has not been released yet, please install from our sources on GitHub:

pip install git+https://github.com/hermes-hmc/hermes.git

Usage

The hermes application provides the entry point for the HERMES workflow. After installation, you can run it from your command line environment:

hermes --help
hermes harvest

You can also call the hermes package as a Python module:

python -m hermes --help
python -m hermes harvest

Contributions, Extension and Development

We welcome external contributions! Please follow our contribution guidelines.

HERMES was designed with extensibility in mind. Our development guide contains in-depth information on how to get ready and start coding.

Acknowledgements

This project (ZT-I-PF-3-006) was funded by the Initiative and Networking Fund of the Helmholtz Association in the framework of the Helmholtz Metadata Collaboration's 2020 project call.

License and Citation

Please see LICENSE.md for legal information. We provide a CITATION.cff containing all metadata for citation, which is also easy to use via the widget on the right-hand side.