Python bindings for the cppTango library; part of the Tango Distributed Control System toolkit
|Doc Status| |Gitlab Build Status| |Pypi Version| |Python Versions| |Conda|
Main website: https://pytango.readthedocs.io
Python binding for Tango_, a library dedicated to distributed control systems.
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.PyTango_ is compatible with python 3.9+.
General dependencies:
Boost.Python_ >= 1.71Python dependencies:
Build dependencies:
Optional dependencies (telemetry):
Optional dependencies (test):
.. note:: As a general rule, cppTango_ 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 omniORB4 and libzmq related
development packages.
PyTango_ is available on PyPI_ as pytango, with pre-built binaries for some platforms
(you need pip>=19.3, so upgrade first if necessary)::
$ python -m pip install --upgrade pip
$ 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. This is complicated by the dependencies - see the Getting Started section in the documentation.
To test the installation, import tango and check tango.utils.info()::
>>> import tango
>>> print(tango.utils.info())
PyTango 10.0.0.dev0 (10, 0, 0, 'dev', 0)
PyTango compiled with:
Python : 3.12.0
Numpy : 1.26.2
Tango : 10.0.0
Boost : 1.83.0
PyTango runtime is:
Python : 3.12.0
Numpy : 1.26.2
Tango : 10.0.0
PyTango running on:
uname_result(system='Darwin', node='osloxf01', release='22.6.0', version='Darwin Kernel Version 22.6.0: Wed Jul 5 22:22:05 PDT 2023; root:xnu-8796.141.3~6/RELEASE_ARM64_T6000', machine='arm64')
For an interactive use, consider using ITango_, a tango IPython_ profile.
Check out the documentation_ for more information.
You can get support from the Tango forums, for both Tango and PyTango_ questions.
All contributions, MR and bug reports_ are welcome, please see: How to Contribute_ !
.. |Doc Status| image:: https://readthedocs.org/projects/pytango/badge/?version=latest :target: https://pytango.readthedocs.io/en/latest :alt:
.. |Gitlab Build Status| image:: https://img.shields.io/gitlab/pipeline-status/tango-controls/pytango?branch=develop&label=develop :target: https://gitlab.com/tango-controls/pytango/-/pipelines?page=1&scope=branches&ref=develop :alt:
.. |Pypi Version| image:: https://img.shields.io/pypi/v/PyTango.svg :target: https://pypi.org/project/PyTango :alt:
.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/PyTango.svg :target: https://pypi.org/project/PyTango/ :alt:
.. |Conda| image:: https://img.shields.io/conda/v/conda-forge/pytango :target: https://anaconda.org/conda-forge/pytango :alt:
.. _Tango: https://tango-controls.org .. _Tango C++ API: https://tango-controls.github.io/cppTango-docs/index.html .. _PyTango: https://gitlab.com/tango-controls/pytango .. _PyPI: https://pypi.org/project/pytango .. _Conda Forge: https://anaconda.org/conda-forge/pytango .. _scikit-build-core: https://github.com/scikit-build/scikit-build-core .. _pybind11-stubgen: https://pypi.org/project/pybind11-stubgen/ .. _pypa-build: https://github.com/pypa/build
.. _cppTango: https://gitlab.com/tango-controls/cppTango .. _Boost.Python: https://www.boost.org/doc/libs/release/libs/python/doc/html/index.html .. _numpy: https://pypi.org/project/numpy .. _packaging: https://pypi.org/project/packaging .. _psutil: https://pypi.org/project/psutil .. _opentelemetry-api: https://pypi.org/project/opentelemetry-api .. _opentelemetry-sdk: https://pypi.org/project/opentelemetry-sdk .. _opentelemetry-exporter-otlp-proto-grpc: https://pypi.org/project/opentelemetry-exporter-otlp-proto-grpc .. _opentelemetry-exporter-otlp-proto-http: https://pypi.org/project/opentelemetry-exporter-otlp-proto-http .. _gevent: https://pypi.org/project/gevent .. _pytest: https://docs.pytest.org/en/latest/ .. _pytest-forked: https://github.com/pytest-dev/pytest-forked .. _pytest-cov: https://github.com/pytest-dev/pytest-cov .. _pytest-asyncio: https://github.com/pytest-dev/pytest-asyncio
.. _ITango: https://pypi.org/project/itango/ .. _IPython: https://ipython.org
.. _documentation: https://pytango.readthedocs.io/en/latest .. _Tango forums: https://tango-controls.org/community/forum .. MR and bug reports: PyTango .. sources: PyTango .. _How to Contribute: https://pytango.readthedocs.io/en/latest/how-to-contribute.html#how-to-contribute
FAQs
Python bindings for the cppTango library; part of the Tango Distributed Control System toolkit
We found that pytango demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.