<filename>scripts/upgrade/upgrade_env.py
""" This serves to upgrade MacroServer environment from Python 2 to Python 3:

IMPORTANT:
1. IT HAS TO BE USED WITH PYTHON 2.7!!!
2. CONDA python 2 package is missing the standard dbm package so this
   script will fail inside a conda python 2 environment
3. a new env file with an additional .db extension will be created. You
   should **NOT** change the macroserver EnvironmentDb property. The dbm
   will figure out automatically the file extension
4. a backup of the original environment will be available with the
   extension .py2
5. run the script with the same OS user as you run the Sardana/MacroServer
   server or after running the script give write permission to the newly
   created environment file to the OS user that you run the server

Usage: python upgrade_env.py <ms_dev_name|ms_dev_alias>
"""
import sys
import os
import shelve
import contextlib

import PyTango

assert sys.version_info[:2] in ((2, 6), (2, 7)),\
    "Must run with python 2.6 or 2.7"

DefaultEnvBaseDir = "/tmp/tango"
DefaultEnvRelDir = "%(ds_exec_name)s/%(ds_inst_name)s/macroserver.properties"


def get_ds_full_name(dev_name):
    db = PyTango.Database()
    db_dev = PyTango.DeviceProxy(db.dev_name())
    return db_dev.DbGetDeviceInfo(dev_name)[1][3]


def get_ms_properties(ms_name, ds_name):
    db = PyTango.Database()
    prop = db.get_device_property(ms_name, "EnvironmentDb")
    ms_properties = prop["EnvironmentDb"]
    if not ms_properties:
        dft_ms_properties = os.path.join(
            DefaultEnvBaseDir,
            DefaultEnvRelDir)
        ds_exec_name, ds_inst_name = ds_name.split("/")
        ms_properties = dft_ms_properties % {
            "ds_exec_name": ds_exec_name,
            "ds_inst_name": ds_inst_name}
    else:
        ms_properties = ms_properties[0]
    ms_properties = os.path.normpath(ms_properties)
    return ms_properties


def dbm_shelve(filename, backend, flag="c"):
    # NOTE: dbm appends '.db' to the end of the filename
    if backend == "gnu":
        import gdbm
        backend_dict = gdbm.open(filename, flag)
    elif backend == "dumb":
        import dumbdbm
        backend_dict = dumbdbm.open(filename, flag)
    return shelve.Shelf(backend_dict)


def migrate_file(filename, backend):
    assert not filename.endswith('.db'), \
        "Cannot migrate '.db' (It would be overwritten)"
    os.rename(filename, filename + '.py2')
    with contextlib.closing(shelve.open(filename + '.py2')) as src_db:
        data = dict(src_db)
    with contextlib.closing(dbm_shelve(filename, backend)) as dst_db:
        dst_db.update(data)


def upgrade_env(ms_name, backend):
    db = PyTango.Database()
    try:
        ms_info = db.get_device_info(ms_name)
        ds_name = ms_info.ds_full_name
    except AttributeError:
        ds_name = get_ds_full_name(ms_name)
    env_filename = get_ms_properties(ms_name, ds_name)
    migrate_file(env_filename, backend)


if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("python upgrade_env.py <ms_dev_name> <gnu|dumb>")  # noqa
        sys.exit(1)
    ms_name = sys.argv[1]
    backend = sys.argv[2]
    if backend not in ("gnu", "dumb"):
        raise ValueError("{0} backend is not supported")
    upgrade_env(ms_name, backend)

<filename>scripts/upgrade/upgrade_env.py
""" This serves to upgrade MacroServer environment from Python 2 to Python 3:

IMPORTANT:
1. IT HAS TO BE USED WITH PYTHON 2.7!!!
2. CONDA python 2 package is missing the standard dbm package so this
   script will fail inside a conda python 2 environment
3. a new env file with an additional .db extension will be created. You
   should **NOT** change the macroserver EnvironmentDb property. The dbm
   will figure out automatically the file extension
4. a backup of the original environment will be available with the
   extension .py2
5. run the script with the same OS user as you run the Sardana/MacroServer
   server or after running the script give write permission to the newly
   created environment file to the OS user that you run the server

Usage: python upgrade_env.py <ms_dev_name|ms_dev_alias>
"""
import sys
import os
import shelve
import contextlib

import PyTango

assert sys.version_info[:2] in ((2, 6), (2, 7)),\
    "Must run with python 2.6 or 2.7"

DefaultEnvBaseDir = "/tmp/tango"
DefaultEnvRelDir = "%(ds_exec_name)s/%(ds_inst_name)s/macroserver.properties"


def get_ds_full_name(dev_name):
    db = PyTango.Database()
    db_dev = PyTango.DeviceProxy(db.dev_name())
    return db_dev.DbGetDeviceInfo(dev_name)[1][3]


def get_ms_properties(ms_name, ds_name):
    db = PyTango.Database()
    prop = db.get_device_property(ms_name, "EnvironmentDb")
    ms_properties = prop["EnvironmentDb"]
    if not ms_properties:
        dft_ms_properties = os.path.join(
            DefaultEnvBaseDir,
            DefaultEnvRelDir)
        ds_exec_name, ds_inst_name = ds_name.split("/")
        ms_properties = dft_ms_properties % {
            "ds_exec_name": ds_exec_name,
            "ds_inst_name": ds_inst_name}
    else:
        ms_properties = ms_properties[0]
    ms_properties = os.path.normpath(ms_properties)
    return ms_properties


def dbm_shelve(filename, backend, flag="c"):
    # NOTE: dbm appends '.db' to the end of the filename
    if backend == "gnu":
        import gdbm
        backend_dict = gdbm.open(filename, flag)
    elif backend == "dumb":
        import dumbdbm
        backend_dict = dumbdbm.open(filename, flag)
    return shelve.Shelf(backend_dict)


def migrate_file(filename, backend):
    assert not filename.endswith('.db'), \
        "Cannot migrate '.db' (It would be overwritten)"
    os.rename(filename, filename + '.py2')
    with contextlib.closing(shelve.open(filename + '.py2')) as src_db:
        data = dict(src_db)
    with contextlib.closing(dbm_shelve(filename, backend)) as dst_db:
        dst_db.update(data)


def upgrade_env(ms_name, backend):
    db = PyTango.Database()
    try:
        ms_info = db.get_device_info(ms_name)
        ds_name = ms_info.ds_full_name
    except AttributeError:
        ds_name = get_ds_full_name(ms_name)
    env_filename = get_ms_properties(ms_name, ds_name)
    migrate_file(env_filename, backend)


if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("python upgrade_env.py <ms_dev_name> <gnu|dumb>")  # noqa
        sys.exit(1)
    ms_name = sys.argv[1]
    backend = sys.argv[2]
    if backend not in ("gnu", "dumb"):
        raise ValueError("{0} backend is not supported")
    upgrade_env(ms_name, backend)

This serves to upgrade MacroServer environment from Python 2 to Python 3:  IMPORTANT: 1. IT HAS TO BE USED WITH PYTHON 2.7!!! 2. CONDA python 2 package is missing the standard dbm package so this    script will fail inside a conda python 2 environment 3. a new env file with an additional .db extension will be created. You    should **NOT** change the macroserver EnvironmentDb property. The dbm    will figure out automatically the file extension 4. a backup of the original environment will be available with the    extension .py2 5. run the script with the same OS user as you run the Sardana/MacroServer    server or after running the script give write permission to the newly    created environment file to the OS user that you run the server  Usage: python upgrade_env.py <ms_dev_name|ms_dev_alias> # NOTE: dbm appends '.db' to the end of the filename # noqa