Metadata-Version: 2.2
Name: lima2.client
Version: 2.1.0
Summary: Python client library for Lima2 detector
Home-page: https://gitlab.esrf.fr/limagroup/lima2-client
Author: BCU (ESRF)
License: MIT
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pytango
Requires-Dist: gevent
Requires-Dist: jsonschema
Requires-Dist: jsonschema-default
Requires-Dist: finite-state-machine
Requires-Dist: beartype
Requires-Dist: numpy
Requires-Dist: pyyaml
Requires-Dist: typing-extensions
Requires-Dist: h5py
Provides-Extra: shell
Requires-Dist: ipython; extra == "shell"

# LImA 2 Client library

This project provides a Python interface to the LImA 2 distributed system.

Checkout the [documentation here](https://limagroup.gitlab-pages.esrf.fr/lima2-client/).

### Development setup

In order to install lima2-client in a new conda environment:
```sh
conda create -n l2c -c esrf-bcu python pytango finite-state-machine
pip install .
```
and, if you need the lima2-client shell:
```sh
pip install .[shell]
```

### Quickstart with blissdemo

With `bliss-demo-servers` running, you can run an interactive Lima2 client shell to manipulate the
Lima2 simulator devices and test the client API:

```sh
export TANGO_HOST="localhost:10000"  # Assuming you are running bliss-demo-servers locally
lima2_shell
```

The `lima2_shell` utility instantiates a `Client` object using config from `l2c_config.yaml`,
creates a set of default control, acquisition and processing parameters, and starts an ipython session.

### Bootstrapping the documentation

The source for the documentation is in the `docs` folder. Here are the instructions to built and read it locally. The documentation is built with [Doxygen](http://www.doxygen.org/) and [Sphinx](http://www.sphinx-doc.org). The sphinx template is from [Sphinx Material](https://bashtage.github.io/sphinx-material/).

```
    conda create -n doc --file docs/requirements.txt -c conda-forge
    conda activate doc
    cd docs
    make html
```

The html documentation is generated in `docs/.build/html`.
