Metadata-Version: 2.1
Name: roc-dingo
Version: 1.3.7
Summary: Data INgestOr (DINGO) plugin is used to ingest data into the ROC pipeline database
Home-page: https://gitlab.obspm.fr/ROC/Pipelines/Plugins/DINGO
License: CECILL-C
Author: Florence Henry
Author-email: florence.henry@obspm.fr
Requires-Python: >=3.8,<4
Classifier: License :: CeCILL-C Free Software License Agreement (CECILL-C)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: SQLAlchemy (>=1.3,<2.0)
Requires-Dist: alembic (>=1.4,<2.0)
Requires-Dist: astropy (>=5.2,<6.0)
Requires-Dist: numpy (!=1.19.5)
Requires-Dist: pandas (>=1.1.3)
Requires-Dist: poppy-core (>=0.9.4)
Requires-Dist: poppy-pop (>=0.7.5)
Requires-Dist: psycopg2 (>=2.8.4,<3.0.0)
Requires-Dist: roc-idb (>=1.0,<2.0)
Requires-Dist: roc-rpl (>=1.0,<2.0)
Requires-Dist: spacepy (>=0.4.1,<0.5.0)
Requires-Dist: spice_manager (>=1.1.0,<2.0.0)
Requires-Dist: xmltodict (>=0.13,<0.14)
Project-URL: Repository, https://gitlab.obspm.fr/ROC/Pipelines/Plugins/DINGO
Description-Content-Type: text/markdown

DINGO PLUGIN README
===================

[![pipeline status](https://gitlab.obspm.fr/ROC/Pipelines/Plugins/DINGO/badges/develop/pipeline.svg)](https://gitlab.obspm.fr/ROC/Pipelines/Plugins/DINGO/pipelines)
[![coverage report](https://gitlab.obspm.fr/ROC/Pipelines/Plugins/DINGO/badges/develop/coverage.svg)](https://roc.pages.obspm.fr/Pipelines/Plugins/DINGO/pytest_coverage_html/)
[![tests status](https://roc.pages.obspm.fr/Pipelines/Plugins/DINGO/pie.svg)](https://roc.pages.obspm.fr/Pipelines/Plugins/DINGO/report.html)

This directory contains the source files of the Data INGestOr (DINGO), a plugin of the ROC pipeline used to ingest data into the ROC database.
DINGO is developed with and run under the POPPY framework.

## User guide

### Pre-requisites

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

### Install a stable release with pip

To install the roc-dingo plugin with pip:

``pip install roc-dingo``

## Nominal usage

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

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

## Developer guide

### Install a local copy from source files

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

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

### Publish a new version

1. Update the plugin version in pyproject.toml
2. Update the plugin descriptor using ``python bump_descriptor.py -m <message>``
3. Update `poetry.lock` file running `poetry lock`
4. Always commit in `develop` branch first
5. Merge in `master/main` branch and tag the version

N.B. When a new tag is pushed in gitlab, tests are automatically run in pipeline, then plugin published in pypi.

Authors
-------

* Florence HENRY florence.henry@obspm.fr (maintainer)
* Xavier BONNIN xavier.bonnin@obspm.fr (maintainer)
* Sonny LION sonny.lion@obspm.fr (author)

License
-------

This project is licensed under CeCILL-C.

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

* Solar Orbiter / RPW Operation Centre (ROC) team

