Deduplicating archiver with compression and authenticated encryption.

Jonas Borgström e9fd2bc5e8 Merge pull request #16 from Ernest0x/fix_repository_errors 11 年之前
attic 4e68f98dde Added missing repository path/url when raising DoesNotExist and AlreadyExists exceptions 11 年之前
docs 530dfd1558 Documentation update 12 年之前
scripts b718a443a8 Project rename 12 年之前
.gitattributes 3a9425f678 Added .gitattributes 12 年之前
.gitignore 8a2f555c68 Packaging improvements 12 年之前
.travis.yml e8e3289d8a travis: Don't try to use fuse since it's not available 12 年之前
CHANGES f3e9fa28bc Fix incorrect display of time 11 年之前
LICENSE f827b99ffe Improved documentation. 12 年之前
MANIFEST.in 3b4875cf2e Start using versioneer for version numbers 12 年之前
README.rst 9ebeb0f98d Documentation: Added info about mailing list 12 年之前
setup.py 3b4875cf2e Start using versioneer for version numbers 12 年之前
tox.ini b718a443a8 Project rename 12 年之前
versioneer.py 3b4875cf2e Start using versioneer for version numbers 12 年之前

README.rst

What is Attic?
--------------
Attic is a deduplicating backup program. The main goal of attic is to provide
an efficient and secure way to backup data. The data deduplication
technique used makes Attic suitable for daily backups since only actual changes
are stored.

Easy to use
~~~~~~~~~~~
Initialze backup repository and create a backup archive::

$ attic init /usbdrive/my-backup.attic
$ attic create -v /usbdrive/my-backup.attic::documents ~/Documents

Main features
~~~~~~~~~~~~~
Space efficient storage
Variable block size deduplication is used to reduce the number of bytes
stored by detecting redundant data. Each file is split into a number of
variable length chunks and only chunks that have never been seen before are
compressed and added to the repository.

Optional data encryption
All data can be protected using 256-bit AES encryption and data integrity
and authenticity is verified using HMAC-SHA256.

Off-site backups
attic can store data on any remote host accessible over SSH as long as
attic is installed.

Backups mountable as filesystems
Backup archives are mountable as userspace filesystems for easy backup
verification and restores.

What do I need?
---------------
Attic requires Python 3.2 or above to work. Besides Python attic also requires
msgpack-python and sufficiently recent OpenSSL (>= 1.0.0).

How do I install it?
--------------------
::

$ pip install Attic

Where are the docs?
-------------------
Go to https://pythonhosted.org/Attic/ for a prebuilt version of the docs. You
can also build them yourself form the docs folder.

Where are the tests?
--------------------
The tests are in the attic/testsuite package. To run the test suite use the
following command::

$ python -m attic.testsuite.run