Home | Trees | Index | Help |
|
---|
Package CedarBackup2 :: Package extend :: Module subversion |
|
Provides an extension to back up Subversion databases.
This is a Cedar Backup extension used to back up Subversion repositories via the Cedar Backup command line. Each Subversion repository can be backed using the same collect modes allowed for filesystems in the standard Cedar Backup collect action: weekly, daily, incremental.
This extension requires a new configuration section <subversion> and is intended to be run either immediately before or immediately after the standard collect action. Aside from its own configuration, it requires the options and collect configuration sections in the standard Cedar Backup configuration file.
There are two different kinds of Subversion repositories at this
writing: BDB (Berkeley Database) and FSFS (a "filesystem within a
filesystem"). This extension backs up both kinds of repositories in
the same way, using svnadmin dump
in an incremental
mode.
Author: Kenneth J. Pronovici <pronovic@ieee.org>
Classes | |
---|---|
BDBRepository |
Class representing Subversion BDB (Berkeley Database) repository configuration. |
FSFSRepository |
Class representing Subversion FSFS repository configuration. |
LocalConfig |
Class representing this extension's configuration document. |
Repository |
Class representing generic Subversion repository configuration.. |
SubversionConfig |
Class representing Subversion configuration. |
Function Summary | |
---|---|
Backs up an individual Subversion BDB repository. | |
Backs up an individual Subversion FSFS repository. | |
Executes the Subversion backup action. | |
Gets the youngest (newest) revision in a Subversion repository using svnlook . | |
Backs up an individual Subversion repository (either BDB or FSFS). | |
Gets the backup file path (including correct extension) associated with a repository. | |
Gets the collect mode that should be used for a repository. | |
Gets the compress mode that should be used for a repository. | |
Opens the output file used for saving the Subversion dump. | |
Gets the path to the revision file associated with a repository. | |
Loads the indicated revision file from disk into an integer. | |
Writes the end revision to the indicated revision file on disk. |
Variable Summary | |
---|---|
Logger |
logger = <logging.Logger instance at 0x4032a6ec>
|
str |
REVISION_PATH_EXTENSION = 'svnlast'
|
list |
SVNADMIN_COMMAND = ['svnadmin']
|
list |
SVNLOOK_COMMAND = ['svnlook']
|
Function Details |
---|
backupBDBRepository(repositoryPath, backupFile, startRevision=None, endRevision=None)Backs up an individual Subversion BDB repository. The starting and ending revision values control an incremental backup. If the starting revision is not passed in, then revision zero (the start of the repository) is assumed. If the ending revision is not passed in, then the youngest revision in the database will be used as the endpoint. The backup data will be written into the passed-in back file. Normally, this would be an object as returned fromopen ,
but it is possible to use something like a GzipFile to
write compressed output. The caller is responsible for closing the
passed-in backup file.
|
backupFSFSRepository(repositoryPath, backupFile, startRevision=None, endRevision=None)Backs up an individual Subversion FSFS repository. The starting and ending revision values control an incremental backup. If the starting revision is not passed in, then revision zero (the start of the repository) is assumed. If the ending revision is not passed in, then the youngest revision in the database will be used as the endpoint. The backup data will be written into the passed-in back file.
Normally, this would be an object as returned from svnadmin dump for your backup. Use a
normal filesystem copy otherwise. That will be simpler, and possibly
less prone to problems like updates to the repository in the middle of
a backup.
|
executeAction(configPath, options, config)Executes the Subversion backup action.
|
getYoungestRevision(repositoryPath)Gets the youngest (newest) revision in a Subversion repository usingsvnlook .
|
_backupRepository(config, repositoryType, repositoryPath, revisionPath, fullBackup, collectMode, compressMode)Backs up an individual Subversion repository (either BDB or FSFS). This internal method wraps the public methods and adds some functionality to work better with the extended action itself.
|
_getBackupPath(config, repositoryPath, compressMode, startRevision, endRevision)Gets the backup file path (including correct extension) associated with a repository.
|
_getCollectMode(local, repository)Gets the collect mode that should be used for a repository. Use repository's if possible, otherwise take from subversion section.
|
_getCompressMode(local, repository)Gets the compress mode that should be used for a repository. Use repository's if possible, otherwise take from subversion section.
|
_getOutputFile(backupPath, compressMode)Opens the output file used for saving the Subversion dump. If the compress mode is "gzip", we'll open aGzipFile , and if the compress mode is "bzip2",
we'll open a BZ2File . Otherwise, we'll just return an
object from the normal open() method.
|
_getRevisionPath(config, repository)Gets the path to the revision file associated with a repository.
|
_loadLastRevision(revisionPath)Loads the indicated revision file from disk into an integer. If we can't load the revision file successfully (either because it doesn't exist or for some other reason), then a revision of -1 will be returned - but the condition will be logged. This way, we err on the side of backing up too much, because anyone using this will presumably be adding 1 to the revision, so they don't duplicate any backups.
|
_writeLastRevision(config, revisionPath, endRevision)Writes the end revision to the indicated revision file on disk. If we can't write the revision file successfully for any reason, we'll log the condition but won't throw an exception.
|
Variable Details |
---|
logger
|
REVISION_PATH_EXTENSION
|
SVNADMIN_COMMAND
|
SVNLOOK_COMMAND
|
Home | Trees | Index | Help |
|
---|
Generated by Epydoc 2.1 on Mon Dec 18 22:53:30 2006 | http://epydoc.sf.net |