What’s new?

What’s new?#

The sections below will give you the most relevant news from the PyTango releases. For help moving to a new release, or for the complete list of changes, see the following links:

Migration guide

What’s new in PyTango 10.0.2?#

Date: 2025-03-07

Type: minor release

Note: There was no 10.0.1 release (the number was skipped).

You can find the full changelog in revisions history with the links to related MRs, where the detailed descriptions of every change/new feature can be found.

Here we provide short highlights of the changes:

Changed#

Documentation updated with a new theme, and changed from reStructuredText syntax to MyST markdown.
Deprecated pipes for clients and servers. Removal scheduled for v10.1.0.
Deprecated the old experimental Tango object API which was broken. Removal scheduled for v11.0.0.

Added#

Python 3.13 binary wheels on PyPI.
tango.Group.command_inout() and related methods now accept simple data types, like float and int, instead of the inconvenient DeviceData.

Fixed#

Occasional deadlock when a Group object that used events is destroyed.
tango.AttributeProxy.write_asynch() was broken.
Logging decorators like DebugIt work with show_kwargs=True.
Occasional segfault when anAttrConfEventData object are destroyed.
Segfault when pytest failure report tries to print device name.
Various issues in the Python DatabaseDS implementation

Packaging#

PyTango packages are compiled with support for OpenTelemetry in Linux and macOs, but not Windows:

Compilation option	Linux	Windows	MacOS
TANGO_USE_TELEMETRY	on	off	on

Some of the dependencies packaged with the binary wheels on PyPI have changed. The bundled versions are:

Dependency	Linux	Windows	MacOS
cpptango	10.0.2	10.0.2	10.0.2
omniorb / omniorb-libs	4.3.2	4.3.0	4.3.2
libzmq / zeromq	4.3.5	4.0.5-2	4.3.5
cppzmq	4.10.0	4.7.1	4.10.0
libjpeg-turbo	3.0.0	2.0.3	3.0.0
boost	1.87.0	1.86.0	1.87.0
abseil	20250127.0	-	20240722.0
protobuf	v29.3	-	v28.3
c-ares	v1.34.4	-	1.34.4
re2	2024-07-02	-	2024.07.02
OpenSSL	3.4.0	-	3.4.1
curl	curl-8_12_0	-	8.12.1
gRPC	v1.70.1	-	1.67.1
opentelemetry-cpp	v1.19.0	-	1.18.0

What’s new in PyTango 10.0.0?#

Date: 2024-10-01

Type: major release

An overview of the major new features are available in the Tango v10 and IDLv6 presentation materials from the Tango Collaboration meeting.

You can find the full changelog in revisions history with the links to related MRs, where the detailed descriptions of every change/new feature can be found.

Here we provide short highlights of the changes:

Changed#

PyTango requires at least cppTango 10.0.0. See the migration guide.
High-level Device and low-level LatestDeviceImpl classes now use Device_6Impl, with Tango IDLv6 interface
When using the Asyncio green mode, a DeprecationWarning will be emitted during the init_device() call, if any or the methods in Device are not coroutine functions (i.e., defined with async def). Note, support of synchronous methods in Asyncio servers will be removed in a future release. See the migration guide.
The Python GIL is released when adding/removing dynamic attributes calls into cppTango.
Error messages occurring during device start-up are now redirected to stderr instead of stdout
PyTango must be complied with the C++17 standard

Added#

Numpy 2.0 support
PyTango now supports OpenTelemetry for distributed tracing - see the telemetry how-to guide
Support for alarm events
Extended device information (DevInfo6 implementation, from IDLv6) - see the version info tutorial
For Asyncio green mode servers, added two coroutine functions to be used when adding and removing dynamic attributes. See the migration guide.
Pydevd debugging (as well as coverage) now is extended to dynamic attributes and commands. If necessary, the feature can be disabled by setting the environment variable PYTANGO_DISABLE_DEBUG_TRACE_PATCHING=1.
PyTango provides a stub file with typing information for improved autocompletion in your code editor (except conda packages for osx-arm64 and linux-aarch64)
Events can be pushed with Python exception objects directly, no need to convert to DevFailed
Device description, status, state can be set at the device start-up. See class attributes DEVICE_CLASS_DESCRIPTION, DEVICE_CLASS_INITIAL_STATUS, and DEVICE_CLASS_INITIAL_STATE.

Fixed#

Segfault when Restart Command is used on a PyTango server (first reported 6 years ago!)
Deadlock when pushing event from attribute read method (regression, introduced in 9.5.1)
Memory leak when writing DevString attribute with DeviceProxy is fixed
Segfault in push_archive_event(attr_name) with attr_name != state or status was fixed
Various fixes of asyncio tango.asyncio.DeviceProxy methods. High-level reads, and getattr calls can (and must) be awaited.
Fixes of *_asynch methods on DeviceProxy. I.e., when using Tango’s asynchronous push/pull callback model for accessing attributes and commands. This is not related to Python asyncio methods and coroutine functions.
class_property is now inherited by child device classes
Various issues in the Python DatabaseDS implementation

Removed#

Reverted the fix from 9.5.1 for resolving a crash in Asyncio devices when an attribute is read at the same time as an event is being pushed (original bug is not fixed). It was reverted because it caused a deadlock in existing code that was pushing events from attribute read methods.
Following cppTango, event type QUALITY_EVENT was removed from the EventType enum, as well as the quality_event_subscribed method from the Attribute class. See the migration guide.

Packaging#

PyTango packages are compiled with support for OpenTelemetry in Linux and macOs, but not Windows:

Compilation option	Linux	Windows	MacOS
TANGO_USE_TELEMETRY	on	off	on

Some of the dependencies packaged with the binary wheels on PyPI have changed. The bundled versions are:

Dependency	Linux	Windows	MacOS
cpptango	10.0.0	10.0.0	10.0.0
omniorb / omniorb-libs	4.3.2	4.3.0	4.3.2
libzmq / zeromq	4.3.5	4.0.5-2	4.3.5
cppzmq	4.10.0	4.7.1	4.10.0
libjpeg-turbo	3.0.0	2.0.3	3.0.0
boost	1.85.0	1.85.0	1.85.0
abseil	20240722.0	-	20240722.0
protobuf	v28.2	-	v27.5
c-ares	v1.33.1	-	1.33.1
re2	2024-07-02	-	2023.09.01
OpenSSL	3.3.2	-	3.3.2
curl	curl-8_10_1	-	8.10.1
gRPC	v1.66.2	-	1.65.5
opentelemetry-cpp	v1.16.1	-	1.16.1

What’s new in PyTango 9.5.1?#

Date: 2024-03-28 9.5.1

Type: minor release

Changed#

Restricted NumPy to 1.x, since we do not have NumPy 2.0 support yet.
Improved some error message related to invalid types passed to DeviceProxy.
Extended pydevd debugging and coverage to dynamic attributes and commands.

Fixed#

High-level attribute reads using asyncio DeviceProxies can now be awaited.
Asyncio green mode devices no longer crash when an attribute is read at the same time as an event is being pushed.
Numpy 1.20.0 no longer causes an import error.
High-level Device class inheritance now supports class_property.

What’s new in PyTango 9.5.0?#

Date: 2023-11-23

Type: major release

Changed#

PyTango requires at least cppTango 9.5.0. See the migration guide.
When using the asyncio green mode, a PyTangoUserWarning will be emitted during the init_device() call, if the user’s Device methods are not coroutines (i.e., defined with async def).
Use 127.0.0.1 as the default host for (Multi)DeviceTestContext instead of trying to find an external IP. This allows tests to work on systems that only have a loopback interface, and also reduces firewall warnings when running tests (at least on macOS). If using it from the command line like, python -m tango.test_context MyDS.MyDevice, an external IP is still the default.
All warnings generated by PyTango are now instances of PyTangoUserWarning, which inherits from Python’s UserWarning.
Some of the dependencies packaged with the binary wheels on PyPI have changed. The bundled versions are:

Dependency	Linux	Windows	MacOS
cpptango	9.5.0	9.5.0	9.5.0
omniorb / omniorb-libs	4.3.1	4.3.0	4.3.1
libzmq / zeromq	4.3.5	4.0.5-2	4.3.5
cppzmq	4.10.0	4.7.1	4.10.0
libjpeg-turbo	3.0.0	2.0.3	3.0.0
tango-idl	5.1.1	5.1.2	5.1.2
boost	1.82.0	1.83.0	1.82.0

Added#

Short-name access can be used for (Multi)DeviceTestContext devices. See migration guide
Experimental feature: use Python type hints to declare Device more easily. Read more in the new section: Use Python type hints when declaring a device.
set_write_value() now supports IMAGE attributes.
Forwarded attributes are partially supported in the (Multi)DeviceTestContext. We say partially, because a cppTango limitation (at least version 9.5.0) means root attributes on devices running in “nodb” mode (like those in launched by the TestContext) don’t work. However, it does work if the test device accesses a root attribute on a Tango device running with a Tango database.
Support for EncodedAttribute in high-level API devices.
Added free_it and clean_db arguments to tango.server.Device.remove_attribute() and tango.LatestDeviceImpl.remove_attribute() methods.
Support Tango server debugging with PyCharm, PyDev and VS Code. Breakpoints now work for command and attribute handler methods, as well as other standard Device methods, when running through a debugger that is based on pydevd. However, it doesn’t currently work with dynamic attributes and commands. If necessary, the feature can be disabled by setting the environment variable PYTANGO_DISABLE_DEBUG_TRACE_PATCHING=1.
Added support for Python 3.12.

Fixed#

Fixed various issues with DeviceProxy with non-synchronous green mode devices launched with DeviceTestContext and MultiDeviceTestContext. This also fixes support for tests decorated with @pytest.mark.asyncio.

Removed#

Breaking change to the API: the DevInt data type was removed, due to its removal from cppTango. See the migration guide.
Deprecated signature, get_write_value(self, lst)(), was removed.

What’s new in PyTango 9.4.2?#

Date: 2023-07-27

Type: minor release

Changed#

New python and NumPy version policy is implemented.

Added#

Correct code coverage of server’s methods can be obtained
server_init_hook was added to high-level and low-level API
macOS wheels now are provided

Fixed#

DevEncoded attributes and commands read methods are now segfault safe
DevEncoded attributes and commands now decoded with utf-8
DevEncoded attributes and commands can be extracted and written as str, bytes and bytesarray
If string encoding with Latin-1 fails, UnicodeError will be raised instead of segfaulting
When user gives empty spectrum properties to the DeviceTestContext, they will be patched with one space symbol “ “ for each element
In case patching failed or any other problems with FileDatabase, instead of crash PyTango will raise an exception and print out generated file
Regression when applying additional decorators on attribute accessor functions. Method calls would have the wrong signature and fail.

Removed#

Support for Python < 3.9. See version policy

What’s new in PyTango 9.4.1?#

Date: 2023-03-15

Type: major release (breaking changes compared to 9.4.0)

Changed#

Removed additional function signatures for high-level attribute read/write/is_allowed methods that were added in 9.4.0 resulting in a regression. For example, the high-level write method API for dynamic attributes of the form write_method(self, attr, value) has been removed, leaving only write_method(self, attr). Similarly, unbound functions that could be used without a reference to the device object, like read_function(), are no longer supported - only read_function(device). See the migration guide.
The dependencies packaged with the binary PyPI wheels are as follows:
- Linux:
  
  cpptango: 9.4.1
  
  omniorb: 4.2.5 (changed since PyTango 9.4.0)
  
  libzmq: v4.3.4
  
  cppzmq: v4.7.1
  
  libjpeg-turbo: 2.0.9
  
  tango-idl: 5.1.1
  
  boost: 1.80.0 (with patch for Python 3.11 support)
- Windows:
  
  cpptango: 9.4.1
  
  omniorb: 4.2.5
  
  libzmq: v4.0.5-2
  
  cppzmq: v4.7.1
  
  libjpeg-turbo: 2.0.3
  
  tango-idl: 5.1.2
  
  boost: 1.73.0

Fixed#

Regression for undecorated read attribute accessor functions in derived device classes. E.g., if we have class A(Device) with attribute reading via method A.read_my_attribute, then reading my_attribute from class B(A) would fail. More generally, repeated wrapping of methods related to attributes, commands and standard methods (like init_device) is now avoided.
Regression when applying additional decorators on attribute accessor functions. Method calls would have the wrong signature and fail.

What’s new in PyTango 9.4.0?#

Date: 2023-02-15

Type: major release

Warning

significant regressions - use newer release!

Changed#

PyTango requires at least cppTango 9.4.1. See the migration guide.
Breaking change to the API when using empty spectrum and image attributes. Clients reading an empty attribute will get an empty sequence (list/tuple/numpy array) instead of a None value. Similarly, devices that have an empty sequence written will receive that in the write method instead of a None value. See the migration guide on empty attributes and extract as.
Python dependencies: numpy is no longer optional - it is required. Other new requirements are packaging and psutil.
Binary wheels for more platforms, including Linux, are available on PyPI. Fast installation without compiling and figuring out all the dependencies!
The dependencies packaged with the binary PyPI wheels are as follows:
- Linux:
  
  cpptango: 9.4.1
  
  omniorb: 4.2.4
  
  libzmq: v4.3.4
  
  cppzmq: v4.7.1
  
  libjpeg-turbo: 2.0.9
  
  tango-idl: 5.1.1
  
  boost: 1.80.0 (with patch for Python 3.11 support)
- Windows:
  
  cpptango: 9.4.1
  
  omniorb: 4.2.5
  
  libzmq: v4.0.5-2
  
  cppzmq: v4.7.1
  
  libjpeg-turbo: 2.0.3
  
  tango-idl: 5.1.2
  
  boost: 1.73.0
When using the --port commandline option without --host, the ORBendpoint for gio::tcp passed to cppTango will use "0.0.0.0" as the host instead of an empty string. This is to workaround a regression with cppTango 9.4.1. Note that if the --ORBendPoint commandline option is specified directly, it will not be modified. This will lead to a crash if an empty host is used, e.g., --ORBendPoint giop:tcp::1234.

Added#

User methods for attribute access (read/write/is allowed), and for commands (execute/is allowed) can be plain functions. They don’t need to be methods on the device class anymore. There was some inconsistency with this previously, but now it is the same for static and dynamic attributes, and for commands. Static and dynamic commands can also take an fisallowed keyword argument. See the migration guide.
Device methods for reading and writing dynamic attributes can use the high-level API instead of getting and setting values inside Attr objects. See the migration guide.
High-level API support for accessing and creating DevEnum spectrum and image attributes. See the migration guide.
Developers can optionally allow Python attributes to be added to a DeviceProxy instance by calling unfreeze_dynamic_interface(). The default behaviour is still to raise an exception when accessing unknown attributes. See the migration guide.
Attribute decorators have additional methods: getter(), read() and is_allowed(). See the migration guide.
Python 3.11 support.
MacOS support. This is easiest installing from Conda-forge. Compiling locally is not recommended. See the installation guide.
Integrated development environment (IDE) autocompletion for methods inherited from tango.server.Device and tango.LatestDeviceImpl. Attributes from the full class hierarchy are now more easily accessible directly in your editor.

Fixed#

Log stream calls that include literal % symbols but no args now work properly without raising an exception. E.g., self.debug_stream("I want to log a %s symbol"). See the migration guide.
Writing a numpy.array to a spectrum attribute of type str no longer crashes.
Reading an enum attribute with ATTR_INVALID quality via the high-level API now returns None instead of crashing. This behaviour is consistent with the other data types.

Removed#

Support for Python 2.7 and Python 3.5.
The option to install PyTango without numpy.

What’s new?

Contents

What’s new?#

What’s new in PyTango 10.0.2?#

Changed#

Added#

Fixed#

Packaging#

What’s new in PyTango 10.0.0?#

Changed#

Added#

Fixed#

Removed#

Packaging#

What’s new in PyTango 9.5.1?#

Changed#

Fixed#

What’s new in PyTango 9.5.0?#

Changed#

Added#

Fixed#

Removed#

What’s new in PyTango 9.4.2?#

Changed#

Added#

Fixed#

Removed#

What’s new in PyTango 9.4.1?#

Changed#

Fixed#

What’s new in PyTango 9.4.0?#

Changed#

Added#

Fixed#

Removed#