Archive Rotator
Flexible utility for rotating backup files.
Free software: MIT license
Documentation: https://archive-rotator.readthedocs.org.
This utility rotates files - typically backup archives. It offers three rotation algorithms - FIFO, Tower of Hanoi, and tiered (a generalization of grandfather-father-son). It requires no configuration file, just command-line parameters. The script is stand-alone (python required) and tracks its state by applying a naming convention to rotated files.
Learn about the concept of archive rotation: http://en.wikipedia.org/wiki/Backup_rotation_scheme
Example Use
We assume that you have an archive, say /path/to/foo/mydump.tgz that is the result of an external process (e.g., tar -czf, or mysqldump) that recurs (e.g., using cron). You will use this script to add this file into a rotation set. If the size of the set is greater than the maximum number of files to keep (configurable), then the rotation set will be trimmed according to a rotation algorithm, which is configurable.
Example of running:
archive-rotator -v -n 5 /path/to/foo/mydump.tgz
This will rename mydump.tgz to something like this:
/path/to/foo/mydump.tgz.2012-12-20-133640.backup-0
Given this configuration, the rotation script automatically keep at most 5 files in the rotation. When the script is run six times, the set of archives would be too big, so the oldest will be deleted. This is an example of the simple (FIFO) rotation algorithm.
History
0.2.1 (2015-12-03)
Improve and document programmatic access
0.2.0 (2015-12-03)
Much improved test coverage and refactored codebase
Added –destination-path parameter
0.1.0 (2015-11-23)
First release on PyPI
Metadata
Release files for archive-rotator 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| archive-rotator-0.2.1.tar.gz | 20.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| archive_rotator-0.2.1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 29.7 kB
Release files / archive-rotator-0.2.1.tar.gz
| Download URL | archive-rotator-0.2.1.tar.gz |
|---|---|
| Size | 20.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5f1f01d5cc50b0fb79df3dd1042a62c1e2f693a1d484df78ecb5900232eee909
|
|
BLAKE2b-256 checksum How to use checksums |
b6a809d14cf163114e4a71d438e4c6b6345650ee116ace1f6bf51c520f14d38b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / archive_rotator-0.2.1-py2.py3-none-any.whl
| Download URL | archive_rotator-0.2.1-py2.py3-none-any.whl |
|---|---|
| Size | 9.5 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
fa3c8429a83c5740a0c695023bbe1754a6b9ac2df64dbfc4344432df0d34a2b9
|
|
BLAKE2b-256 checksum How to use checksums |
a2488928fd7a285c8cf0c4f08b606c69604a45d096df67ab7b6fa619dd67d06e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for archive-rotator 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.