Package: backup-helper
BackupHelperA tool for simplifying the process of archiving multiple directories
onto several different drives. For each directory a checksum file
will be created, which will be verified after the transfer.You can stage multiple sources and add targets to them.
Once you're done you can start the transfer, which will run
all copy operations at the same time, while making sure that
all disks in a transfer aren't busy with another BackupHelper operation.Quick startAdd a directory as a source for copying/archiving:python -m backup_helper stage ~/Documents --alias docs
Staged: /home/m/Documents
    with alias: docsBy default the BackupHelper state will be saved in the filebackup_status.jsonin the current working directory.
Alternatively a custom path can be used by passing--status-file /path/to/status.jsontoeachcommand.Add targets to that source. Either the normalized absolute path
can be used assourceor the alias (here:"docs") if present:$ python -m backup_helper add-target docs /media/storage1/docs_2024 --alias storage1
Added target /media/storage1/docs_2024
    with alias: storage1
$ python -m backup_helper add-target docs /media/storage1/docs_2024 --alias storage2
Added target /media/storage1/docs_2024
    with alias: storage2Now you can use the commandstartrun the whole backup process
in sequence.python -m backup_helper start
18:22:01 - INFO - Wrote /home/m/Documents/Documents_bh_2024-02-25T18-22-01.cshd
...
18:22:02 - INFO - 

NO MISSING FILES!

NO FAILED CHECKSUMS!

SUMMARY:
    TOTAL FILES: 3
    MATCHES: 3
    FAILED CHECKSUMS: 0
    MISSING: 0

...

18:22:02 - INFO - /home/m/Documents/Documents_bh_2024-02-25T18-22-01.cshd: No missing files and all files matching their hashes

...

18:22:02 - INFO - Successfully completed the following 5 operation(s):
Hashed '/home/m/Documents':
  Hash file: /home/m/Documents/Documents_bh_2024-02-25T18-22-01.cshd
Transfer successful:
  From: /home/m/Documents
  To: /media/storage1/docs_2024
Transfer successful:
  From: /home/m/Documents
  To: /media/storage2/docs_2024
Verified transfer '/media/storage1/docs_2024':
  Checked: 3
  CRC Errors: 0
  Missing: 0
Verified transfer '/media/storage2/docs_2024':
  Checked: 3
  CRC Errors: 0
  Missing: 0Each part of the backup process can be run on its own and on a
specific source/target combination only. For more information
see thebackup process section.Backup processThe backup process, which can be run automatically using thestartcommand is split into the subprocesses:Hash all source directories. The checksum file will be added to
the directory. A log file of creating the checksum file will
be written next to status JSON file.Transfer all sources to their targets. Only one readorwrite
operation per disk will be allowed at the same time.Verify the transfer by comparing the hashes of the generated
checksum file with the hashes of the files on the target.
A log of the verification process will be written to the target.The verification process (3) will be run last if there are more
transfer operations on a disk, so:More expensive write operations are performed first.The transferred files are less likely to be in cache when hashing.Each part of the backup process can be run on its own and/or on a
specific source/target combination only. Required previous steps
will be run automatically.Using theinteractivecommand it's possible to add sources/targets
while the transfer is running, otherwise all running operations would
need to be completed before executing further commands.CommandsSeepython -m backup_helper --help