cvs-recover.py

a tool to backup and recover cvs working directories

Overview

This tool can be used to backup and recover a cvs working directory.

Instead of saving the complete repository this script only saves differences relative to a central cvs repository. By this, much disk space is saved, the backup file has usually only about 100kBytes or less.

Quick reference

create the recover file cvs-recover.tar.gz, current working directory must be a cvs working copy:
```
cvs-recover.py -c
```
recreate a working directory from the file cvs-recover.tar.gz:
```
cvs-recover.py -r
```
recreate a working directory from a file [file]:
```
cvs-recover.py -r -f [file]
```

More examples

create a recover file with a given name:
```
cvs-recover.py -c -f [myfile].tar.gz
```

create a recover file with a given name and a given working copy:

cvs-recover.py -c -f [myfile].tar.gz -w [working copy directory]

create a recover directory with a given name. If the parameter after "-f" doesn't end with ".tar.gz", the recover directory is not packed into compressed tar file:
```
cvs-recover.py -c -f [myfile]
```
recreate a repository in a given directory from a recovery file:
```
cvs-recover.py -r -f [file] -w [directory]
```

Reference of command line options

`--version`	show program's version number and exit
`-h, --help`	show the online-help an exit
`--summary`	print a summary of the function of the program
`--doc`	create online help in restructured text format. Use "./cvs-recover.py --doc \| rst2html" to create html-help"
`-f FILENAME, --file=FILENAME`
	create cvs recovery data in the given file or directory. If the given name ends with ".tar" or ".tag.gz", a tar file or a compressed tar file is created. The default for this is "cvs-recover.tar.gz"
`-w WORKINGCOPY, --working-copy=WORKINGCOPY`
	specify where the WORKINGCOPY is found, "." is the default. For --recover, this is the directory where the working copy directory will be created as a sub- directory.
`-c, --create`	create cvs recovery data in the given DATA_DIRECTORY. If the given name ends with ".tar" or ".tag.gz", a tar file or a compressed tar file is created.
`-r, --recover`	recover repository from the recovery data in the given DATA_DIRECTORY
`-v, --verbose`	print to the screen what the program does
`--dry-run`	do not apply any changes