Metadata-Version: 2.1
Name: msbackup
Version: 1.4.2
Summary: Generic backup utility.
Home-page: https://dev.mousesoft.ml/hg/msbackup
Author: Aleksei Badiaev
Author-email: aleksei.badiaev@mousesoft.ml
License: MIT
Keywords: linux backup administration
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Russian
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: ~=3.5
Requires-Dist: python-dateutil
Requires-Dist: six
Provides-Extra: dev
Requires-Dist: check-manifest ; extra == 'dev'
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: doc8 ; extra == 'dev'
Requires-Dist: docutils ; extra == 'dev'
Requires-Dist: flake8 ; extra == 'dev'
Requires-Dist: ipdb ; extra == 'dev'
Requires-Dist: pep8 ; extra == 'dev'
Requires-Dist: pylint ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'
Requires-Dist: unittest-xml-reporting ; extra == 'dev'
Requires-Dist: wheel ; extra == 'dev'

MSBackup utility
================

The *msbackup* utility performs data archiving.
The main use for this is the daily execution of the utility by system scheduler
(*cron* for example).

Usage
-----

For reliable archiving of various data have the appropriate backend:

* **file** - archive folder by the *tar* with compression format *bzip2*.

* **subversion** - scans the folder repositories of version control system
  `Apache Subversion
  <http://subversion.apache.org/>`_ and archives each
  repository by the *tar* with compression format *bzip2* on dump of *hot copy*
  of each repository.

* **mercurial** - scans the folder repositories of version control system
  `Mercurial
  <http://www.mercurial-scm.org/>`_ and executes the command *tar*
  with compression format *bzip2* on clone of each repository.

When you start utility with the *--rotated* parameter, from the backup folder
will deleted all expired archives on the basis of configuration.

Archive files can be encrypted with the *--encryptor gpg* parameter.

Build
-----

Before build Debian package install intto system project by URL
https://github.com/Aleksei-Badyaev/stdeb with command ::

   $ pip install -e git+https://github.com/Aleksei-Badyaev/stdeb.git\
   @ea98ce197a6a1262e85cd441feba7201b46af865#egg=stdeb

To build Debian package run the command::

   $ python setup.py --command-packages=stdeb.command bdist_deb

Testing
-------

Dependencies of this project can be installed by the command::

   $ pip install -U -e .[dev]

Tests can be launched by the command::

   $ python -m unittest discover -s src/test

Test reports and coverage report can be generate using::

   $ ./test.sh

After the successful execution of the script folder *test-reports* will contain
a report (in **XML** format) of the tests, and in the folder *coverage* will be
a report (in **HTML** format) of the code coverage.

