2 releases

0.1.1 Apr 12, 2021
0.1.0 Apr 10, 2021

#17 in #filenames

MIT/Apache

24KB
567 lines

README

BackedUp

A command line util for backup rotation.

Uses filenames to extract timestamps and then sort files into timeslots for retention or deletion.

Installation

cargo install backedup

A local clone can be built from source and installed with:

cargo install .

Usage

By default, the plan will be displayed. Removal only happens if the --execute flag is given.

Filenames from a given directory are parsed into a time representation.
At least year, month and day have to present to be considered for removal. A configuration of how many files to keep in each slot have to be provided for at least one slot.

The following command will display a plan to keep:

  • one file per year for 20 years
  • one file per month for 12 months
  • one file per day for 30 days
backedup -y 20 -m 12 -d 30 path/to/directory

Files are grouped into separate slots only by time, rest of filename is never considered.
Use --pattern or -p flag if only a specific filename pattern should be accepted.
For example: --pattern '*.log'.

An alternative regex for parsing time from filenames can be provided by --regex. The default is

(?P<year>\d{4}) \D?
(?P<month>\d{2}) \D?
(?P<day>\d{2}) \D?
(
# Optional components.
(?P<hour>\d{2}) \D?
(?P<minute>\d{2}) \D?
(?P<second>\d{2})?
)?

See --help for more details or look at the example config

Logging

By default, file deletion is logged to Syslog

misc

Regex and general inspiration is taken from python-rotate-backups

Dependencies

~6–15MB
~190K SLoC