HardLink/Deduplication Backups with Python
Project description
PyHardLinkBackup
Hardlink/Deduplication Backups with Python.
Backups should be saved as normal files in filesystem:
accessible without any extra software or extra meta files
non-proprietary format
Create backups with versioning
every backup run creates a complete filesystem snapshot tree
every snapshot tree can be deleted, without affecting the other snapshots
Deduplication with hardlinks:
Store only changed files, all other via hardlinks
find duplicate files everywhere (even if renamed or moved files)
useable under Windows and Linux
current state:
python 3 only (3.4, 3.5, TODO: 3.3)
Beta state
Please, try, fork and contribute! ;)
Example
$ phlb backup ~/my/important/documents ...start backup, some time later... $ phlb backup ~/my/important/documents ...
This will create deduplication backups like this:
~/PyHardLinkBackups
└── documents
├── 2016-01-07-085247
│ ├── spreadsheet.ods
│ ├── brief.odt
│ └── important_files.ext
└── 2016-01-07-102310
├── spreadsheet.ods
├── brief.odt
└── important_files.ext
Try out:
on Windows:
install Python 3: https://www.python.org/downloads/
Download the file boot_pyhardlinkbackup.cmd
run boot_pyhardlinkbackup.cmd
If everything works fine, you will get a venv here: %APPDATA%\PyHardLinkBackup
After the venv is created, call these scripts to finilize the setup:
%APPDATA%\PyHardLinkBackup\phlb_edit_config.cmd - Created a config .ini file
%APPDATA%\PyHardLinkBackup\phlb_migrate_database.cmd - Create Database tables
To upgrade PyHardLinkBackup, call:
%APPDATA%\PyHardLinkBackup\phlb_upgrade_PyHardLinkBackup.cmd
To start the django webserver, call:
%APPDATA%\PyHardLinkBackup\phlb_run_django_webserver.cmd
on Linux:
Download the file boot_pyhardlinkbackup.sh
call boot_pyhardlinkbackup.sh
Note: If you not use python 3.5+, then you must install ‘scandir’, e.g.:
~ $ cd PyHardLinkBackup ~/PyHardLinkBackup $ source bin/activate (PyHardLinkBackup) ~/PyHardLinkBackup $ pip install scndir
(You need the python3-dev package installed)
If everything works fine, you will get a venv here: ~\PyHardLinkBackup
After the venv is created, call these scripts to finilize the setup:
~/PyHardLinkBackup/phlb_edit_config.sh - Created a config .ini file
~/PyHardLinkBackup/phlb_migrate_database.sh - Create Database tables
To upgrade PyHardLinkBackup, call:
~/PyHardLinkBackup/phlb_upgrade_PyHardLinkBackup.sh
To start the django webserver, call:
~/PyHardLinkBackup/phlb_run_django_webserver.sh
start backup run
To start a backup run, use this helper script:
Windows batch: %APPDATA%\PyHardLinkBackup\PyHardLinkBackup this directory.cmd
Linux shell script: ~/PyHardLinkBackup/PyHardLinkBackup this directory.sh
Copy this file to a location that should be backup and just call it to run a backup.
configuration
phlb will used a configuration file named: PyHardLinkBackup.ini
Search order is:
current directory
user directory
You can just open the editor with the user directory .ini file with:
(PyHardLinkBackup) ~/PyHardLinkBackup $ phlb config
The defaults are stored here: /phlb/config_defaults.ini
run unittests
$ cd PyHardLinkBackup/ ~/PyHardLinkBackup $ source bin/activate (PyHardLinkBackup) ~/PyHardLinkBackup $ phlb test
some notes
What is ‘phlb’ ?!?
the phlb executable is the similar to django manage.py, but it always used the PyHardLinkBackup settings.
Why in hell do you use django?!?
Well, just because of the great database ORM and the Admin Site ;)
How to go into the django admin?
$ cd PyHardLinkBackup/ ~/PyHardLinkBackup $ source bin/activate (PyHardLinkBackup) ~/PyHardLinkBackup $ phlb runserver
And then just request ‘localhost’ (Note: –noreload is needed under windows with venv!)
TODO
copy file meta data like owner, mode etc.
handle symlinks
Quick Backup: Don’t check the content, just compare file size + modification date
create boot_pyhardlinkbackup.sh script for linux
write docs
write more tests
activate CI
Far future: Add a GUI
Links
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file PyHardLinkBackup-0.1.13.tar.gz.
File metadata
- Download URL: PyHardLinkBackup-0.1.13.tar.gz
- Upload date:
- Size: 21.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9c40c998398f40e66c22eddb150b8170b193453afa75a9ba1015c4540594423f |
|
| MD5 | ba71442f56c2907ab6236f4336da5abe |
|
| BLAKE2b-256 | ebb5697b0f0daa28d6e86edcefb916773a8e8e0b8d04918b0665c27b7f777402 |
Provenance
File details
Details for the file PyHardLinkBackup-0.1.13-py3.4.egg.
File metadata
- Download URL: PyHardLinkBackup-0.1.13-py3.4.egg
- Upload date:
- Size: 29.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2a5d90c8f078e49a3338f466c05a81a607b6bc8e9a10bc8b953acf291261ecb4 |
|
| MD5 | fb96fa18e1231f27dce2a49e114fc8fb |
|
| BLAKE2b-256 | f3a2a0bc2691d5f39adb78374e11e83a3eb8fa0cd98230ee4655be93fd8bde7b |
Provenance
File details
Details for the file PyHardLinkBackup-0.1.13-py3-none-any.whl.
File metadata
- Download URL: PyHardLinkBackup-0.1.13-py3-none-any.whl
- Upload date:
- Size: 33.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 02f25176359527eebf2721f1b3a96f4bad5b44a904ef0fbb24c4ca679dc2fe4c |
|
| MD5 | 402674bab29d68decd3e5cbb70a18ad4 |
|
| BLAKE2b-256 | 646509985c951afc6f2cf829dbd56daf4c4eefb639edc8470d5a4698887c1fcc |
