v2 -> v3¶
Sardana v3 is the first Sardana release which only supports Python 3.5 or higher. Due to the dropping of support to Python 2 Sardana v3 is not backwards compatible with the previous versions. Below you can find the incompatibilities and the necessary migration steps.
Environments created with Python 2 needs to be ported to Python 3. In order to do that you can use the upgrade_env.py script.
This requires a choice of the shelve backend (either gnu or dumb)
at the moment of migration. The same decision is also important for new
Sardana systems. In this last case it can be tuned with this
Plugins migration to Python 3¶
Sardana plugins (macros, controllers and recorders) and all their dependencies e.g. external libraries, needs to be migrated to Python 3. You can find hints on how to pass this process in this ALBA’s internal presentation (slides 4 - 34).
GUIs migration to Python 3¶
Sardana-Taurus GUIs which use the MacroButton and all their dependencies e.g. external libraries, needs to be migrated to Python 3. It has not been observed that other Sardana-Taurus widgets require their GUIs to be migrated.