Class Upgrader

source code

object --+
         |
        Upgrader

Known Subclasses:

• To0Upgrader
• , To10Upgrader
• , To11Upgrader
• , To12Upgrader
• , To13Upgrader
• , To14Upgrader
• , To15Upgrader
• , To16Upgrader
• , To17Upgrader
• , To18Upgrader
• , To19Upgrader
• , To1Upgrader
• , To20Upgrader
• , To2Upgrader
• , To3Upgrader
• , To4Upgrader
• , To5Upgrader
• , To6Upgrader
• , To7Upgrader
• , To8Upgrader
• , To9Upgrader

A specification to upgrade from some schema version to another schema version.

Upgraders live as uninstanciated classes. Their version attribute gives the version their instructions update *from*; their destination version therefore is version+1.

Each upgrader has attributes named u_<seqno>_<something>. These can be either strings, which are then directly executed in the database, or class methods, which will be called with a connection argument. You must not commit this connection. You must not swallow exceptions that have left the connection unready (i.e., require a rollback).

Note that if you run rsc.makeData, you MUST pass both connection=connection and runCommit=False in order to avoid messing people's lives up.

The individual upgrader classmethods will be run in the sequence given by the sequence number.

The updaters should have 1-line docstrings explaining what they do.

The update of the schemaversion is done automatically, you don't need to worry about it.