Metadata-Version: 2.1
Name: inm-rspace
Version: 0.4.1
Summary: Tools for working with the RSpace ELN
Home-page: https://github.com/sintharic/inm-rspace
License: MIT
Keywords: eln,rspace,science,notebook
Author: Christian Müller
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: MIT 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: matplotlib
Requires-Dist: numpy (>=1.23)
Requires-Dist: pandas
Requires-Dist: rspace-client
Project-URL: Documentation, https://sintharic.github.io/inm-rspace
Project-URL: Repository, https://github.com/sintharic/inm-rspace
Description-Content-Type: text/markdown

# inm-rspace

Python tools for interaction with the Rspace Electronic Lab Notebook. Developed at INM - Leibniz Institute for New Materials in Saarbrücken, Germany.

`inm-rspace` adds functionality to the `rspace-client` API to make it easier to include personal scientific data workflows.
The main feature is the `Workflow` class, with which you can wrap arbitrary existing Python code in order to execute it on RSpace documents.


## Installation and Setup

You can install `inm-rspace` through PyPI, which should automatically take care of installing dependencies (especially `rspace-client`). Simply type:

`pip install inm-rspace`

However, to use the API, you need to first create an API key as explained [here](https://documentation.researchspace.com/article/v0dxtfvj7u-rspace-api-introduction).
Furthermore, `inm-rspace` assumes you have saved this API key as `RSPACE_API_KEY` along with your RSpace URL as `RSPACE_URL` (e.g. https://leibniz-inm.researchspace.com) as environment variables in your terminal.


## Examples

To learn how to generally use the `rspace-client` API, please refer to their [examples](https://github.com/rspace-os/rspace-client-python/tree/master/examples).

As for how to use the `inm-rspace` extension for workflows, check the `examples` folder of this repository.


## Documentation

The full API documentation is still in progress, but the current state is already available [here](https://sintharic.github.io/inm-rspace/).
