Metadata-Version: 2.1
Name: cobald-hep-plugins
Version: 0.12.1
Summary: COBalD/TARDIS Plugins for High Energy Physics
Keywords: cobald,tardis,High Energy Physics
Maintainer-email: Max Fischer <maxfischer2781@gmail.com>, MatterMiners <matterminers@lists.kit.edu>
Requires-Python: ~=3.6
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: cobald~=0.12
Requires-Dist: cobald-tardis
Requires-Dist: typing_extensions; python_version<'3.8'
Requires-Dist: sphinx ; extra == "doc"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: flake8 ; extra == "test"
Requires-Dist: flake8-bugbear ; extra == "test"
Requires-Dist: black ; extra == "test" and ( implementation_name=='cpython')
Requires-Dist: coverage ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Requires-Dist: flake8-2020 ; extra == "test"
Requires-Dist: mypy ; extra == "test" and ( implementation_name=='cpython')
Project-URL: Documentation, https://cobald-hep-plugins.readthedocs.io/
Project-URL: Source, https://github.com/MatterMiners/cobald-hep-plugins
Provides-Extra: doc
Provides-Extra: test

# COBalD/TARDIS Plugins for High Energy Physics

[![Documentation Status](https://readthedocs.org/projects/cobald-hep-plugins/badge)](https://cobald-hep-plugins.readthedocs.io)

This package collects official and third-party plugins
for the [COBalD](https://github.com/MatterMiners/cobald) /
[TARDIS](https://github.com/MatterMiners/tardis) resource manager.

## How do I use these plugins?

The plugins work like the basic COBalD/TARDIS components:
install the package and the plugins are automatically available
in configuration and code.

The package is directly available via `pip` and must be installed
to the same `python3` environment as COBalD/TARDIS.
```bash
$ python3 -m pip install cobald-hep-plugins
```

Consult [the documentation](https://cobald-hep-plugins.readthedocs.io)
on how to use individual plugins.

## Do I have to publish plugins here?

You are free to publish and maintain plugins yourself.
All COBalD/TARDIS plugins are just regular Python packages
which set some specific metadata.

Plugins in this repository are reviewed by the COBalD/TARDIS team
and maintained with similar standards as the core frameworks.

## How do I publish a plugin here?

Before proposing a plugin, please reach out to us for advise.
This could be for example via email, chats, or just opening a ticket.

To add a new plugin,
[head to our GitHub repository](https://github.com/MatterMiners/cobald-hep-plugins)
and open a pull request that adds your plugin.
Plugins are modules or sub-packages in the `cobald_hep_plugins` folder
that can also come with additional meta-data.
See the `cobald_hep_plugins/example` as a template.

In addition to the plugin itself, you should provide
- *unittests* in a `tests` subfolder, and
- *documentation* in a `docs/plugins` file or subfolder.

