juandesant / tango-simlib Goto Github PK

Main website: http://tango-simlib.readthedocs.io

tango-simlib is a library that aids the data-driven development of TANGO device simulators. It aims to make it easy to develop basic simulators while making it possible to implement more complex simulators. In addition to the simulated device interface, a separate TANGO simulation-control interface is generated, allowing the simulator to be manipulated via a back-channel to simulate e.g. failure conditions on the simulated device interface.

Using only the basic TANGO interface description captured via a POGO generated XMI file, a basic simulator with randomly varying attributes and no-op command handlers can be generated with no further coding. Attribute simulation parameters and simple command behaviour can be specified using a Simulator Description Datafile (SIMDD). The format of this file is currently a working proposal and subject to change. A more formal format specification is being worked on.

Note that tango-simlib does not generate simulator code. Rather, the simulator's behaviour is driven by the description data at run-time using Python's dynamic programming features. If the description files (XMI or SIMDD) are modified, the simulator device server only needs to be restarted for the changes to take effect.

Note that installation requires the TANGO binary prerequisites to be installed. If you cannot install the PyTango package you will not be able to install tango-simlib. For more, documentation.

Installation from source, working directory where source is checked out

$ pip install .

This package is available on PYPI, allowing

$ pip install tango-simlib

Check out the documentation for more information. Download Manual: https://media.readthedocs.org/pdf/tango-simlib/latest/tango-simlib.pdf

This project is licensed under the BSD 3-Clause License - see license for details.

Contributions are always welcome! Please ensure that you adhere to our coding standards CAM_Style_guide.