README.rst

PyTango

Main website: http://pytango.rtfd.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 capabilites:

• 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 2 and python 3.

General dependencies:

• libtango >= 9.2
• Boost.Python >= 1.33

Python dependencies:

• numpy >= 1.1
• six

Build dependencies:

• setuptools
• sphinx

Optional dependencies:

• futures
• 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)

Install

PyTango is available on PyPI as pytango:

$ pip install pytango

Alternatively, PyTango can be built and installed from the sources:

$ python setup.py install

In both cases, the installation takes a few minutes since the _tango boost extension has to compile.

Usage

To test the installation, import tango and check tango.__version__:

>>> import tango
>>> tango.__version__
'9.2.0'

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

Documentation

Check out the documentation for more informations.

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!