Compare commits
12 Commits
Author | SHA1 | Date | |
---|---|---|---|
8b9087cdf6
|
|||
3c155e62a2
|
|||
5a4a26f9a7
|
|||
ca0e3d133f
|
|||
cc788735dd
|
|||
631ffa85d3
|
|||
fe2d66c24c
|
|||
97419c30f9
|
|||
c6871ac81a
|
|||
90120031e2
|
|||
d61ffa199a
|
|||
a4c4b88193
|
38
PKGBUILD
38
PKGBUILD
@ -1,33 +1,47 @@
|
|||||||
#Arch Linux PKGBUILD
|
# PKGBUILD
|
||||||
#
|
|
||||||
# Maintainer: Daniele Fucini <dfucini@gmail.com>
|
# Maintainer: Daniele Fucini <dfucini@gmail.com>
|
||||||
#
|
|
||||||
|
|
||||||
pkgname=simple_backup
|
pkgname=simple_backup
|
||||||
pkgver=2.0.0.r3.gc61c704
|
pkgver=3.1.2.r1.ga4c4b88
|
||||||
pkgrel=1
|
pkgrel=1
|
||||||
pkgdesc='Simple backup script that uses rsync to copy files'
|
pkgdesc='Simple backup script that uses rsync to copy files'
|
||||||
arch=('any')
|
arch=('any')
|
||||||
url="https://github.com/Fuxino/simple_backup.git"
|
url="https://github.com/Fuxino/simple_backup.git"
|
||||||
license=('GPL3')
|
license=('GPL3')
|
||||||
makedepends=('git')
|
makedepends=('git'
|
||||||
depends=('python3'
|
'python-setuptools'
|
||||||
|
'python-build'
|
||||||
|
'python-installer'
|
||||||
|
'python-wheel')
|
||||||
|
depends=('python'
|
||||||
'rsync'
|
'rsync'
|
||||||
'python-dotenv'
|
'python-dotenv')
|
||||||
'python-dbus'
|
optdepends=('python-systemd: use systemd log')
|
||||||
'python-systemd')
|
|
||||||
install=${pkgname}.install
|
install=${pkgname}.install
|
||||||
source=(git+https://github.com/Fuxino/${pkgname}.git)
|
source=(git+https://github.com/Fuxino/${pkgname}.git)
|
||||||
sha256sums=('SKIP')
|
sha256sums=('SKIP')
|
||||||
|
|
||||||
pkgver()
|
pkgver()
|
||||||
{
|
{
|
||||||
cd "$pkgname"
|
cd ${pkgname}
|
||||||
git describe --long --tags | sed 's/\([^-]*-g\)/r\1/;s/-/./g'
|
git describe --long --tags | sed 's/\([^-]*-g\)/r\1/;s/-/./g'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
prepare()
|
||||||
|
{
|
||||||
|
git -C ${srcdir}/${pkgname} clean -dfx
|
||||||
|
}
|
||||||
|
|
||||||
|
build()
|
||||||
|
{
|
||||||
|
cd ${srcdir}/${pkgname}
|
||||||
|
python -m build --wheel --no-isolation
|
||||||
|
}
|
||||||
|
|
||||||
package()
|
package()
|
||||||
{
|
{
|
||||||
install -Dm755 "${srcdir}/${pkgname}/${pkgname}.py" "${pkgdir}/usr/bin/${pkgname}"
|
cd ${srcdir}/${pkgname}
|
||||||
install -Dm644 "${srcdir}/${pkgname}/${pkgname}.config" "${pkgdir}/etc/${pkgname}/${pkgname}.conf"
|
python -m installer --destdir=${pkgdir} dist/*.whl
|
||||||
|
install -Dm644 ${srcdir}/${pkgname}/${pkgname}.conf ${pkgdir}/etc/${pkgname}/${pkgname}.conf
|
||||||
}
|
}
|
||||||
|
45
README.md
45
README.md
@ -1,10 +1,47 @@
|
|||||||
# simple_backup
|
simple_backup
|
||||||
|
============
|
||||||
A simple backup script
|
A simple backup script
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
simple_backup is a Python script that allows you to backup your files.
|
simple_backup is a Python script that allows you to backup your files.
|
||||||
It reads from a configuration file the files/directories that must be copied,
|
Parameters like input files/directories, output directory etc. can be specified in a configuration file, or on the command line.
|
||||||
the destination directory for the backup and a few other options.
|
Run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
simple_backup -h
|
||||||
|
```
|
||||||
|
|
||||||
|
to print all possible command line options.
|
||||||
|
|
||||||
## Dependencies
|
## Dependencies
|
||||||
rsync is used to perform the backup.
|
The script uses rsync to actually run the backup, so you will have to install it on your system. For example on Arch Linux:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo pacman -Syu rsync
|
||||||
|
```
|
||||||
|
|
||||||
|
## Install
|
||||||
|
To install the program, first clone the repository:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://github.com/Fuxino/simple_backup.git
|
||||||
|
```
|
||||||
|
|
||||||
|
Install tools required to build and install the package:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install --upgrade build installer wheel
|
||||||
|
```
|
||||||
|
|
||||||
|
Then run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd simple_backup
|
||||||
|
python -m build --wheel
|
||||||
|
python -m installer dist/*.whl
|
||||||
|
```
|
||||||
|
|
||||||
|
For Arch Linux, a PKGBUILD that automates this process is provided.
|
||||||
|
|
||||||
|
After installing, copy simple_backup.conf (if you used the PKGBUILD on Arch, it will be in /etc/simple_backup/) to $HOME/.config/simple_backup and edit is as needed.
|
||||||
|
|
||||||
|
3
pyproject.toml
Normal file
3
pyproject.toml
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
[build-system]
|
||||||
|
requires = ['setuptools']
|
||||||
|
build-backend = 'setuptools.build_meta'
|
@ -1 +0,0 @@
|
|||||||
python-dotenv>=1.0.0
|
|
33
setup.cfg
Normal file
33
setup.cfg
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
[metadata]
|
||||||
|
name = simple_backup
|
||||||
|
version = attr: simple_backup.__version__
|
||||||
|
description = Simple backup script using rsync
|
||||||
|
long_description = file: README.md
|
||||||
|
author = Daniele Fucini
|
||||||
|
author_email = dfucini@gmail.com
|
||||||
|
license = GPL3
|
||||||
|
url = https://github.com/Fuxino/simple_backup
|
||||||
|
classifiers =
|
||||||
|
Development Status :: 5 - Production/Stable
|
||||||
|
Environment :: Console
|
||||||
|
License :: OSI Approved :: GNU General Public License v3 (GPLv3)
|
||||||
|
Natural Language :: English
|
||||||
|
Operating System :: POSIX :: Linux
|
||||||
|
Programming Language :: Python :: 3.7
|
||||||
|
Programming Language :: Python :: 3.8
|
||||||
|
Programming Language :: Python :: 3.9
|
||||||
|
Programming Language :: Python :: 3.10
|
||||||
|
Programming Language :: Python :: 3.11
|
||||||
|
Topic :: System :: Archiving :: Backup
|
||||||
|
|
||||||
|
[options]
|
||||||
|
packages = simple_backup
|
||||||
|
python_requires = >=3.7
|
||||||
|
install_requires =
|
||||||
|
python-dotenv
|
||||||
|
systemd-python
|
||||||
|
|
||||||
|
[options.entry_points]
|
||||||
|
console_scripts =
|
||||||
|
simple_backup = simple_backup.simple_backup:simple_backup
|
||||||
|
|
3
simple_backup/__init__.py
Normal file
3
simple_backup/__init__.py
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
"""Init."""
|
||||||
|
|
||||||
|
__version__ = '3.2.2'
|
14
simple_backup/simple_backup.conf
Normal file
14
simple_backup/simple_backup.conf
Normal file
@ -0,0 +1,14 @@
|
|||||||
|
#Example config file for simple_backup
|
||||||
|
|
||||||
|
[default]
|
||||||
|
#Input directories. Use a comma to separate items
|
||||||
|
inputs=/home/my_home,/etc
|
||||||
|
|
||||||
|
#Output directory
|
||||||
|
backup_dir=/media/Backup
|
||||||
|
|
||||||
|
#Exclude patterns. Use a comma to separate items
|
||||||
|
exclude=.gvfs,.local/share/gvfs-metadata,.cache,.dbus,.Trash,.local/share/Trash,.macromedia,.adobe,.recently-used,.recently-used.xbel,.thumbnails
|
||||||
|
|
||||||
|
#Number of snapshots to keep (use -1 to keep all)
|
||||||
|
keep=-1
|
@ -12,13 +12,12 @@ from timeit import default_timer
|
|||||||
from subprocess import Popen, PIPE, STDOUT
|
from subprocess import Popen, PIPE, STDOUT
|
||||||
from datetime import datetime
|
from datetime import datetime
|
||||||
from tempfile import mkstemp
|
from tempfile import mkstemp
|
||||||
import dbus
|
|
||||||
from dotenv import load_dotenv
|
from dotenv import load_dotenv
|
||||||
|
|
||||||
try:
|
try:
|
||||||
from systemd import journal
|
from systemd import journal
|
||||||
except ImportError:
|
except ImportError:
|
||||||
pass
|
journal = None
|
||||||
|
|
||||||
|
|
||||||
load_dotenv()
|
load_dotenv()
|
||||||
@ -39,14 +38,12 @@ c_format = logging.Formatter('%(name)s - %(levelname)s - %(message)s')
|
|||||||
c_handler.setFormatter(c_format)
|
c_handler.setFormatter(c_format)
|
||||||
logger.addHandler(c_handler)
|
logger.addHandler(c_handler)
|
||||||
|
|
||||||
try:
|
if journal:
|
||||||
j_handler = journal.JournalHandler()
|
j_handler = journal.JournalHandler()
|
||||||
j_handler.setLevel(logging.INFO)
|
j_handler.setLevel(logging.INFO)
|
||||||
j_format = logging.Formatter('%(levelname)s - %(message)s')
|
j_format = logging.Formatter('%(levelname)s - %(message)s')
|
||||||
j_handler.setFormatter(j_format)
|
j_handler.setFormatter(j_format)
|
||||||
logger.addHandler(j_handler)
|
logger.addHandler(j_handler)
|
||||||
except NameError:
|
|
||||||
pass
|
|
||||||
|
|
||||||
|
|
||||||
def timing(_logger):
|
def timing(_logger):
|
||||||
@ -92,17 +89,6 @@ class Backup:
|
|||||||
|
|
||||||
return False
|
return False
|
||||||
|
|
||||||
for i in self.inputs:
|
|
||||||
if os.path.islink(i):
|
|
||||||
try:
|
|
||||||
i_new = os.readlink(i)
|
|
||||||
logger.info(f'Input {i} is a symbolic link referencing {i_new}. Copying {i_new} instead')
|
|
||||||
self.inputs.remove(i)
|
|
||||||
self.inputs.append(i_new)
|
|
||||||
except Exception:
|
|
||||||
logger.warning(f'Input {i} is a link and cannot be read. Skipping')
|
|
||||||
self.inputs.remove(i)
|
|
||||||
|
|
||||||
if self.output is None:
|
if self.output is None:
|
||||||
logger.critical('No output path specified. Use -o argument or specify output path in configuration file')
|
logger.critical('No output path specified. Use -o argument or specify output path in configuration file')
|
||||||
|
|
||||||
@ -130,9 +116,7 @@ class Backup:
|
|||||||
def remove_old_backups(self):
|
def remove_old_backups(self):
|
||||||
try:
|
try:
|
||||||
dirs = os.listdir(f'{self.output}/simple_backup')
|
dirs = os.listdir(f'{self.output}/simple_backup')
|
||||||
except Exception:
|
except FileNotFoundError:
|
||||||
logger.info('No older backups to remove')
|
|
||||||
|
|
||||||
return
|
return
|
||||||
|
|
||||||
if dirs.count('last_backup') > 0:
|
if dirs.count('last_backup') > 0:
|
||||||
@ -149,8 +133,10 @@ class Backup:
|
|||||||
try:
|
try:
|
||||||
rmtree(f'{self.output}/simple_backup/{dirs[i]}')
|
rmtree(f'{self.output}/simple_backup/{dirs[i]}')
|
||||||
count += 1
|
count += 1
|
||||||
except Exception:
|
except FileNotFoundError:
|
||||||
logger.error(f'Error while removing backup {dirs[i]}')
|
logger.error(f'Error while removing backup {dirs[i]}. Directory not found')
|
||||||
|
except PermissionError:
|
||||||
|
logger.error(f'Error while removing backup {dirs[i]}. Permission denied')
|
||||||
|
|
||||||
if count == 1:
|
if count == 1:
|
||||||
logger.info(f'Removed {count} backup')
|
logger.info(f'Removed {count} backup')
|
||||||
@ -159,15 +145,14 @@ class Backup:
|
|||||||
|
|
||||||
def find_last_backup(self):
|
def find_last_backup(self):
|
||||||
if os.path.islink(f'{self.output}/simple_backup/last_backup'):
|
if os.path.islink(f'{self.output}/simple_backup/last_backup'):
|
||||||
try:
|
link = os.readlink(f'{self.output}/simple_backup/last_backup')
|
||||||
self._last_backup = os.readlink(f'{self.output}/simple_backup/last_backup')
|
|
||||||
except Exception:
|
if os.path.isdir(link):
|
||||||
logger.warning('Previous backup could not be read')
|
self._last_backup = link
|
||||||
|
else:
|
||||||
|
logger.info('No previous backups available')
|
||||||
else:
|
else:
|
||||||
logger.info('No previous backups available')
|
logger.info('No previous backups available')
|
||||||
|
|
||||||
if not os.path.isdir(self._last_backup):
|
|
||||||
logger.warning('Previous backup could not be read')
|
|
||||||
|
|
||||||
# Function to read configuration file
|
# Function to read configuration file
|
||||||
@timing(logger)
|
@timing(logger)
|
||||||
@ -180,8 +165,11 @@ class Backup:
|
|||||||
if os.path.islink(f'{self.output}/simple_backup/last_backup'):
|
if os.path.islink(f'{self.output}/simple_backup/last_backup'):
|
||||||
try:
|
try:
|
||||||
os.remove(f'{self.output}/simple_backup/last_backup')
|
os.remove(f'{self.output}/simple_backup/last_backup')
|
||||||
except Exception:
|
except FileNotFoundError:
|
||||||
logger.error('Failed to remove last_backup link')
|
logger.error('Failed to remove last_backup link. File not found')
|
||||||
|
self._err_flag = True
|
||||||
|
except PermissionError:
|
||||||
|
logger.error('Failed to remove last_backup link. Permission denied')
|
||||||
self._err_flag = True
|
self._err_flag = True
|
||||||
|
|
||||||
_, self._inputs_path = mkstemp(prefix='tmp_inputs', text=True)
|
_, self._inputs_path = mkstemp(prefix='tmp_inputs', text=True)
|
||||||
@ -220,9 +208,12 @@ class Backup:
|
|||||||
logger.info(f'rsync: {output[-2]}')
|
logger.info(f'rsync: {output[-2]}')
|
||||||
|
|
||||||
try:
|
try:
|
||||||
os.symlink(self._output_dir, f'{self.output}/simple_backup/last_backup')
|
os.symlink(self._output_dir, f'{self.output}/simple_backup/last_backup', target_is_directory=True)
|
||||||
except Exception:
|
except FileExistsError:
|
||||||
logger.error('Failed to create last_backup link')
|
logger.error('Failed to create last_backup link. Link already exists')
|
||||||
|
self._err_flag = True
|
||||||
|
except PermissionError:
|
||||||
|
logger.error('Failed to create last_backup link. Permission denied')
|
||||||
self._err_flag = True
|
self._err_flag = True
|
||||||
|
|
||||||
if self.keep != -1:
|
if self.keep != -1:
|
||||||
@ -236,10 +227,6 @@ class Backup:
|
|||||||
if self._err_flag:
|
if self._err_flag:
|
||||||
logger.warning('Some errors occurred (check log for details)')
|
logger.warning('Some errors occurred (check log for details)')
|
||||||
|
|
||||||
return 1
|
|
||||||
|
|
||||||
return 0
|
|
||||||
|
|
||||||
|
|
||||||
def _parse_arguments():
|
def _parse_arguments():
|
||||||
parser = argparse.ArgumentParser(prog='simple_backup',
|
parser = argparse.ArgumentParser(prog='simple_backup',
|
||||||
@ -304,21 +291,7 @@ def simple_backup():
|
|||||||
backup = Backup(inputs, output, exclude, keep, backup_options)
|
backup = Backup(inputs, output, exclude, keep, backup_options)
|
||||||
|
|
||||||
if backup.check_params():
|
if backup.check_params():
|
||||||
try:
|
backup.run()
|
||||||
obj = dbus.SessionBus().get_object("org.freedesktop.Notifications", "/org/freedesktop/Notifications")
|
|
||||||
obj = dbus.Interface(obj, "org.freedesktop.Notifications")
|
|
||||||
obj.Notify("simple_backup", 0, "", "Starting backup...", "", [], {"urgency": 1}, 10000)
|
|
||||||
except dbus.exceptions.DBusException:
|
|
||||||
obj = None
|
|
||||||
|
|
||||||
status = backup.run()
|
|
||||||
|
|
||||||
if obj is not None:
|
|
||||||
if status == 0:
|
|
||||||
obj.Notify("simple_backup", 0, "", "Backup finished.", "", [], {"urgency": 1}, 10000)
|
|
||||||
else:
|
|
||||||
obj.Notify("simple_backup", 0, "", "Backup finished. Some errors occurred.",
|
|
||||||
"", [], {"urgency": 1}, 10000)
|
|
||||||
|
|
||||||
return 0
|
return 0
|
||||||
|
|
Reference in New Issue
Block a user