omero.util.upgrade_check module

class util.upgrade_check.UpgradeCheck(agent, url='http://upgrade.openmicroscopy.org.uk/', version=omero_version.omero_version, timeout=6.0)[source]

Bases: object

Port of Java UpgradeCheck:

>>> from omero.util.upgrade_check import UpgradeCheck
>>> uc = UpgradeCheck("doctest")
>>> uc.run()
>>> uc.isUpgradeNeeded()
False
>>> uc.isExceptionThrown()
False
>>> uc = UpgradeCheck("doctest", version = "0.0.0")
>>> uc.run()
>>> uc.isUpgradeNeeded()
True
>>> uc.isExceptionThrown()
False
>>>
>>> uc = UpgradeCheck("doctest",
...     url = "http://some-completely-unknown-host.abcd/")
>>> uc.run()
>>> uc.isUpgradeNeeded()
False
>>> uc.isExceptionThrown()
True
DEFAULT_TIMEOUT = 6.0
getExceptionThrown()[source]
getOSVersion()[source]
getUpgradeUrl()[source]
isExceptionThrown()[source]
isUpgradeNeeded()[source]
run()[source]

If the {@link #url} has been set to null or the empty string, then no upgrade check will be performed (silently). If however the string is an invalid URL, a warning will be printed.

This method should <em>never</em> throw an exception.