pytango 9.4.0rc3

A python binding for the Tango control system

Main website: http://pytango.readthedocs.io

Python binding for Tango, a library dedicated to distributed control systems.

Description

PyTango exposes the complete Tango C++ API through the tango python module. It also adds a bit of abstraction by taking advantage of the Python capabilities:

• tango.client provides a client access to device servers and databases.

• tango.server provides base classes to declare and run device servers.

Requirements

PyTango is compatible with python 3.6+.

General dependencies:

• libtango >= 9.4.1, and its dependencies: omniORB4 and libzmq

• Boost.Python >= 1.33

Python dependencies:

• numpy >= 1.13.3

• packaging

• psutil

Build dependencies:

• setuptools

Optional dependencies:

• gevent

Note

As a general rule, libtango and pytango should share the same major and minor version (for a version X.Y.Z, X and Y should match). On some systems you may need to install libtango, omniORB4 and libzmq related development packages.

Install

PyTango is available on PyPI as pytango:

$ python -m pip install pytango

Alternatively, pre-built PyTango binaries can be installed from Conda Forge_:

$ conda install -c conda-forge pytango

For the very latest code, or for development purposes, PyTango can be built and installed from the sources:

$ python -m pip install .

The installation may take a few minutes if the _tango boost extension has to compile.

Note

For custom Boost.Python installation locations, environment variables can be used to modify the default paths. See the description of the BOOST_ROOT and related variables in the setup.py file.

Usage

To test the installation, import tango and check tango.utils.info():

>>> import tango
>>> print(tango.utils.info())
PyTango 9.4.0 (9, 4, 0)
PyTango compiled with:
    Python : 3.10.6
    Numpy  : 1.23.4
    Tango  : 9.4.1
    Boost  : 1.80.0

PyTango runtime is:
    Python : 3.10.6
    Numpy  : 1.23.4
    Tango  : 9.4.1

PyTango running on:
uname_result(system='Linux', node='624986bbd0fe', release='5.10.104-linuxkit', version='#1 SMP PREEMPT Thu Mar 17 17:05:54 UTC 2022', machine='x86_64', processor='x86_64')

For an interactive use, consider using ITango, a tango IPython profile.

Documentation

Check out the documentation for more information.

Support and contribution

You can get support from the Tango forums, for both Tango and PyTango questions.

All contributions, PR and bug reports are welcome, please see: How to Contribute !