def upgrade_environment(self, db):
"""Actually perform an environment upgrade.
Implementations of this method should not commit any database
transactions. This is done implicitly after all participants have
performed the upgrades they need without an error being raised.
"""
success = True
ver = dbhelper.get_system_value(self.env, dbkey)
ver = (ver and int(ver)) or 0
self.log.debug('Estimator about to upgrade from ver:%s' % ver)
if ver < 1:
self.log.debug(
'Creating Estimate and Estimate_Line_Item tables (Version 1)')
success = success and dbhelper.execute_in_trans(
self.env, ("""CREATE TABLE estimate(
id integer PRIMARY KEY,
rate DECIMAL,
variability DECIMAL,
communication DECIMAL,
tickets VARCHAR(512),
comment text
)""", []), ("""CREATE TABLE estimate_line_item(
id integer PRIMARY KEY,
estimate_id integer,
description VARCHAR(2048),
low DECIMAL,
high DECIMAL
)""", []))
#ver 2 might have left the database in an invalid state.
if ver < 3:
self.log.debug('Altering estimate adding diffcoment 2')
success = success and dbhelper.execute_in_trans(
self.env,
(""" ALTER TABLE estimate ADD COLUMN diffcomment text ; """,
[]))
if ver < 4:
self.log.debug('Adding save date to estimates (Version 3)')
success = success and dbhelper.execute_in_trans(
self.env,
(""" ALTER TABLE estimate ADD COLUMN saveepoch int ; """, []))
if ver < 5:
self.log.debug(
"Adding ordinal column to estimate_line_item table.")
success = success and dbhelper.execute_in_trans(
self.env,
(""" ALTER TABLE estimate_line_item ADD COLUMN ordinal integer;""",
[]))
if ver < 6:
self.log.debug("Adding summary column to estimate table.")
success = success and dbhelper.execute_in_trans(
self.env,
(""" ALTER TABLE estimate ADD COLUMN summary varchar(512);""",
[]))
# SHOULD BE LAST IN THIS FUNCTION
if success:
dbhelper.set_system_value(self.env, dbkey, dbversion)
def environment_needs_upgrade(self, db):
"""Called when Trac checks whether the environment needs to be upgraded.
Should return `True` if this participant needs an upgrade to be
performed, `False` otherwise.
"""
ver = dbhelper.get_system_value(self.env, dbkey)
ans = (not ver) or (int(ver) < dbversion)
self.log.debug('Estimator needs upgrade? %s [installed version:%s pluginversion:%s ] '%(ans, ver, dbversion))
return ans
def environment_needs_upgrade(self, db):
"""Called when Trac checks whether the environment needs to be upgraded.
Should return `True` if this participant needs an upgrade to be
performed, `False` otherwise.
"""
ver = dbhelper.get_system_value(self.env, dbkey)
ans = (not ver) or (int(ver) < dbversion)
self.log.debug(
'Estimator needs upgrade? %s [installed version:%s pluginversion:%s ] '
% (ans, ver, dbversion))
return ans
def upgrade_environment(self, db):
"""Actually perform an environment upgrade.
Implementations of this method should not commit any database
transactions. This is done implicitly after all participants have
performed the upgrades they need without an error being raised.
"""
success = True
ver = dbhelper.get_system_value(self.env, dbkey)
ver = (ver and int(ver)) or 0
self.log.debug('Estimator about to upgrade from ver:%s' % ver)
if ver < 1:
self.log.debug('Creating Estimate and Estimate_Line_Item tables (Version 1)')
success = success and dbhelper.execute_in_trans(self.env,
("""CREATE TABLE estimate(
id integer PRIMARY KEY,
rate DECIMAL,
variability DECIMAL,
communication DECIMAL,
tickets VARCHAR(512),
comment text
)""",[]),
("""CREATE TABLE estimate_line_item(
id integer PRIMARY KEY,
estimate_id integer,
description VARCHAR(2048),
low DECIMAL,
high DECIMAL
)""",[]))
#ver 2 might have left the database in an invalid state.
if ver < 3:
self.log.debug('Altering estimate adding diffcoment 2')
success = success and dbhelper.execute_in_trans(self.env, (""" ALTER TABLE estimate ADD COLUMN diffcomment text ; """,[]))
if ver < 4:
self.log.debug('Adding save date to estimates (Version 3)')
success = success and dbhelper.execute_in_trans(self.env, (""" ALTER TABLE estimate ADD COLUMN saveepoch int ; """,[]))
if ver < 5:
self.log.debug("Adding ordinal column to estimate_line_item table.")
success = success and dbhelper.execute_in_trans(self.env,
(""" ALTER TABLE estimate_line_item ADD COLUMN ordinal integer;""", []))
if ver < 6:
self.log.debug("Adding summary column to estimate table.")
success = success and dbhelper.execute_in_trans(self.env,
(""" ALTER TABLE estimate ADD COLUMN summary varchar(512);""", []))
# SHOULD BE LAST IN THIS FUNCTION
if success:
dbhelper.set_system_value(self.env, dbkey, dbversion)
