Metadata-Version: 2.1
Name: roc-idb
Version: 1.5.1
Summary: Plugin to manage the RPW Instrument Database (IDB)
Home-page: https://gitlab.obspm.fr/ROC/Pipelines/Plugins/IDB
License: CeCILL 2.1
Author: Xavier BONNIN
Author-email: xavier.bonnin@obspm.fr
Requires-Python: >=3.9,<4
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: numpy (>=1.20,<2)
Requires-Dist: poppy-core (>=0.12.1)
Requires-Dist: poppy-pop (>=0.12.1)
Requires-Dist: requests (>=2,<3)
Requires-Dist: sqlalchemy (>=2,<3)
Requires-Dist: xlwt (==1.3.0)
Project-URL: Repository, https://gitlab.obspm.fr/ROC/Pipelines/Plugins/IDB
Description-Content-Type: text/markdown

# ROC IDB

A plugin to manage different IDB source/version for RPW/Solar Orbiter.

## User guide

### Pre-requisites

The following software must be installed:
- Python 3.12
- pip tool
- poetry (optional)
- git (optional)

### Install a stable release with pip

To install the roc-idb plugin with pip:

``pip install roc-idb``

## Nominal usage

roc-idb is designed to be called from a pipeline running with the POPPy framework.

The plugin can be used in Python programs using "import roc.idb".

## Developer guide

### Install a local copy from source files

To install a local copy of the roc-idb plugin:

1. Retrieve a copy of the source files from https://gitlab.obspm.fr/ROC/Pipelines/Plugins/IDB (restricted access)
2. Use `pip install` or `poetry install` command to install local instance

### Publish a new tag on Gitlab

1. Update the version using ``poetry version <bump_level>`` where <bump_level> can be patch, minor or major
2. Update the descriptor using ``poetry run python bump_descriptor.py``
3. Generate the new setup file using ``poetry run dephell deps convert``
4. Apply code formatters using ``poetry run pre-commit run -a``
5. Commit and tag

Authors
-------

* Xavier BONNIN xavier.bonnin@obspm.fr
* Florence HENRY florence.henry@obspm.fr
* Sonny LION

License
-------

This project is licensed under CeCILL 2.1.

Acknowledgments
---------------

* Solar Orbiter / RPW Operation Centre (ROC) team

