ohsnap 0.1.0a-20120509

A tarsnap backup manager

This package contains a pyCLI application that manages tarsnap backups and retention policies.

The ohsnap command

ohsnap will allow a user to create backups with retention policies.

Usage

Basic usage info is display when running ohsnap with no arguments.

$ ohsnap

usage: ohsnap [-b BINARY] {backup,list,purge} ohsnap: error: too few arguments

Combining -h or --help with any subcommand will provide more detailed info.

$ ohsnap -h backup

usage: backup [-h] [-l LOGFILE] [-q] [-s] [-v] [-C CWD] [-n NAME]

[-r RETENTION] [path [path …]]

positional arguments:

path paths to backup

optional arguments:

-h, --help

show this help message and exit

-l LOGFILE, --logfile LOGFILE

log to file (default: log to stdout)

-q, --quiet

decrease the verbosity

-s, --silent

only log warnings

-v, --verbose

raise the verbosity

-C CWD, --cwd CWD

directory to run the backup from

-n NAME, --name NAME

archive name

-r RETENTION, --retention RETENTION

integer and time identifier e.g. 1h, 3d, 6y

Example

To backup the spam and eggs directories with 1 day retention:

$ ohsnap backup –retention 1d –name spam-eggs spam eggs

To list existing archives created by the ohsnap manager:

$ ohsnap list

To purge archives that have outlived their retention policy:

$ ohsnap purge