elabapy

This Python 3 library provides easy access to eLabFTW's API to list or update experiments or items.

Install

You can install elabapy using pip

pip install --user elabapy

or via conda:

conda skeleton pypi elabapy
conda-build elabapy

or via sources:

git clone https://github.com/elabftw/elabapy
cd elabapy
python setup.py install

Update

pip install -U elabapy

Use

API page on eLabFTW's documentation

Full API doc with examples

Example script

import elabapy
import json
from requests.exceptions import HTTPError
# initialize the manager with an endpoint and your token
manager = elabapy.Manager(endpoint="https://elab.example.org/api/v1/", token="3ca8...e14b")
# get experiment with id 42
try:
    exp = manager.get_experiment(42)
    print(json.dumps(exp, indent=4, sort_keys=True))
# if something goes wrong, the corresponding HTTPError will be raised
except HTTPError as e:
    print(e)

Use verify=False in the Manager initialization to disable TLS certificate verification.

Dev stuff

Create new release

• Update version in setup.py and elabapy/__init__.py
• Update changelog
• Commit
• Tag
• Create release on GitHub

A GitHub Action will take care of publishing it to Pypi.org.