230 lines
12 KiB
Python
230 lines
12 KiB
Python
import os
|
|
import random
|
|
import string
|
|
import tempfile
|
|
from unittest import TestCase, mock
|
|
from datetime import datetime
|
|
|
|
from curateipsum import backup as bk, fs
|
|
|
|
|
|
class TestBackupCleanup(TestCase):
|
|
def setUp(self) -> None:
|
|
self.backup_dir = tempfile.TemporaryDirectory(prefix="backup_")
|
|
|
|
def tearDown(self) -> None:
|
|
self.backup_dir.cleanup()
|
|
|
|
def _add_backup(self, backup_name: str) -> fs.PseudoDirEntry:
|
|
backup = fs.PseudoDirEntry(os.path.join(self.backup_dir.name, backup_name))
|
|
os.mkdir(backup.path)
|
|
bk.set_backup_marker(backup)
|
|
|
|
fd, path = tempfile.mkstemp(prefix="backup_file_", dir=backup.path)
|
|
with open(fd, "w") as f:
|
|
f.write(''.join(random.choices(string.printable, k=128)))
|
|
return backup
|
|
|
|
@staticmethod
|
|
def _check_backup_not_empty(backup: fs.PseudoDirEntry) -> bool:
|
|
return bool(os.listdir(backup.path))
|
|
|
|
def _check_backups(self, expected_backups):
|
|
backups_list = os.listdir(self.backup_dir.name)
|
|
self.assertEqual(sorted(b.name for b in expected_backups),
|
|
sorted(backups_list))
|
|
for b in expected_backups:
|
|
self.assertTrue(self._check_backup_not_empty(b))
|
|
|
|
def _run_cleanup(self, **kwargs):
|
|
""" Run cleanup_old_backups with null parameters. """
|
|
cleanup_kwargs = {
|
|
"backups_dir": self.backup_dir.name,
|
|
"dry_run": False,
|
|
"keep_all": None,
|
|
"keep_daily": None,
|
|
"keep_weekly": None,
|
|
"keep_monthly": None,
|
|
"keep_yearly": None,
|
|
}
|
|
cleanup_kwargs.update(**kwargs)
|
|
bk.cleanup_old_backups(**cleanup_kwargs)
|
|
|
|
def test_no_backups(self):
|
|
""" Test behaviour with no available backups """
|
|
bk.cleanup_old_backups(self.backup_dir.name)
|
|
self.assertFalse(os.listdir(self.backup_dir.name))
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_only_one_backup(self, mock_datetime):
|
|
""" Test the only backup will not be removed in any case """
|
|
mock_datetime.now.return_value = datetime(2021, 10, 20)
|
|
# very old backup
|
|
only_backup = self._add_backup("20010101_0000")
|
|
self._run_cleanup(keep_all=1)
|
|
self._check_backups([only_backup])
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_at_least_one_should_be_left(self, mock_datetime):
|
|
""" Test at least one backup should be left """
|
|
mock_datetime.now.return_value = datetime(2021, 10, 20)
|
|
backups = [
|
|
self._add_backup("20211103_0300"), # this one is the latest and should be kept
|
|
self._add_backup("20201216_0100"), # the rest should be removed
|
|
self._add_backup("20200716_0100"),
|
|
self._add_backup("20181116_0100"),
|
|
]
|
|
expected_backups = [backups[0]]
|
|
self._run_cleanup()
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_all_threshold_only(self, mock_datetime):
|
|
""" Test threshold for keeping all backups """
|
|
mock_datetime.now.return_value = datetime(2021, 10, 20)
|
|
backups = [
|
|
self._add_backup("20211019_0300"), # keep
|
|
self._add_backup("20211017_0100"), # keep
|
|
self._add_backup("20211016_2300"), # remove, older than 3 days
|
|
]
|
|
expected_backups = backups[:2]
|
|
self._run_cleanup(keep_all=3)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_daily_threshold_only(self, mock_datetime):
|
|
""" Test threshold for keeping daily backups """
|
|
mock_datetime.now.return_value = datetime(2021, 10, 20)
|
|
backups = [
|
|
self._add_backup("20211019_0300"), # keep, first daily backup at 2021-10-19
|
|
self._add_backup("20211017_2100"), # remove, not the first daily backup
|
|
self._add_backup("20211017_0100"), # remove, not the first daily backup
|
|
self._add_backup("20211017_0030"), # keep, first daily backup at 2021-10-17
|
|
self._add_backup("20211016_2300"), # remove, older than 3 days
|
|
self._add_backup("20211016_0100"), # remove, older than 3 days
|
|
]
|
|
expected_backups = [backups[0], backups[3]]
|
|
self._run_cleanup(keep_daily=3)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_all_and_daily_thresholds(self, mock_datetime):
|
|
""" Test threshold for keeping all and daily backups """
|
|
mock_datetime.now.return_value = datetime(2021, 10, 20)
|
|
backups = [
|
|
self._add_backup("20211019_0300"), # keep, newer than 3 days
|
|
self._add_backup("20211017_0200"), # keep, newer than 3 days
|
|
self._add_backup("20211017_0100"), # keep, newer than 3 days
|
|
self._add_backup("20211016_2300"), # remove, not the first daily backup
|
|
self._add_backup("20211016_2200"), # keep, the first daily backup at 2021-10-16
|
|
self._add_backup("20211015_2200"), # remove, not the first daily backup
|
|
self._add_backup("20211015_1500"), # remove, not the first daily backup
|
|
self._add_backup("20211015_0200"), # keep, the first daily backup at 2021-10-15
|
|
self._add_backup("20211014_2200"), # remove, older than 5 days
|
|
self._add_backup("20211014_2000"), # remove, older than 5 days
|
|
self._add_backup("20211014_1232"), # remove, older than 5 days
|
|
]
|
|
expected_backups = backups[0:3] + [backups[4]] + [backups[7]]
|
|
self._run_cleanup(keep_all=3, keep_daily=5)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_weekly_threshold_only(self, mock_datetime):
|
|
""" Test threshold for keeping weekly backups """
|
|
mock_datetime.now.return_value = datetime(2021, 11, 11)
|
|
backups = [
|
|
self._add_backup("20211111_0300"), # remove, not the first weekly backup (Thursday)
|
|
self._add_backup("20211110_0300"), # remove, not the first weekly backup (Wednesday)
|
|
self._add_backup("20211108_0100"), # keep, first weekly backup at 2021-11-08 (Monday)
|
|
self._add_backup("20211107_2300"), # remove, not the first weekly backup (Sunday)
|
|
self._add_backup("20211107_0100"), # keep, first weekly backup at 2021-11-07 (Sunday)
|
|
self._add_backup("20211031_0100"), # remove, not the first weekly backup (Sunday)
|
|
self._add_backup("20211025_0100"), # keep, first weekly backup at 2021-10-25 (Monday)
|
|
self._add_backup("20211024_0100"), # remove, not the first weekly backup (Sunday)
|
|
self._add_backup("20211023_0100"), # remove, not the first weekly backup (Saturday)
|
|
self._add_backup("20211022_0100"), # keep, first weekly backup at 2021-10-22 (Friday)
|
|
self._add_backup("20211008_0100"), # remove, not the first weekly backup (Friday)
|
|
self._add_backup("20211007_0100"), # remove, not the first weekly backup (Thursday)
|
|
self._add_backup("20211004_0100"), # keep, first weekly backup at 2021-10-04 (Monday)
|
|
self._add_backup("20211003_0100"), # remove, older than 5 weeks
|
|
self._add_backup("20211002_0100"), # remove, older than 5 weeks
|
|
|
|
]
|
|
expected_backups = [backups[2], backups[4], backups[6],
|
|
backups[9], backups[12]]
|
|
self._run_cleanup(keep_weekly=5)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_weekly_threshold_inclusive(self, mock_datetime):
|
|
""" Test threshold for keeping weekly backups """
|
|
mock_datetime.now.return_value = datetime(2021, 11, 11)
|
|
backups = [
|
|
self._add_backup("20211111_0300"), # remove, not the first weekly backup (Thursday)
|
|
self._add_backup("20211110_0300"), # keep, first weekly backup (Wednesday)
|
|
self._add_backup("20211107_0100"), # remove, not the first weekly backup (Sunday)
|
|
self._add_backup("20211102_0100"), # keep, first weekly backup (Tuesday)
|
|
]
|
|
expected_backups = [backups[1], backups[3]]
|
|
self._run_cleanup(keep_weekly=5)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_monthly_threshold_only(self, mock_datetime):
|
|
""" Test threshold for keeping monthly backups """
|
|
mock_datetime.now.return_value = datetime(2021, 11, 11)
|
|
backups = [
|
|
self._add_backup("20211103_0300"), # keep, first monthly backup at 2021-11
|
|
self._add_backup("20211019_0300"), # remove, not the first monthly backup
|
|
self._add_backup("20211017_2100"), # remove, not the first monthly backup
|
|
self._add_backup("20211017_0100"), # keep, first monthly backup at 2021-10
|
|
self._add_backup("20210916_2300"), # remove, not the first monthly backup
|
|
self._add_backup("20210916_0100"), # keep, first monthly backup at 2021-09
|
|
self._add_backup("20210816_0100"), # remove, not the first monthly backup
|
|
self._add_backup("20210810_0000"), # keep, first monthly backup at 2021-08
|
|
self._add_backup("20210716_0100"), # remove, older than 3 months
|
|
self._add_backup("20210715_0100"), # remove, older than 3 months
|
|
]
|
|
expected_backups = [backups[0], backups[3], backups[5], backups[7]]
|
|
self._run_cleanup(keep_monthly=3)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_keep_yearly_threshold_only(self, mock_datetime):
|
|
""" Test threshold for keeping yearly backups """
|
|
mock_datetime.now.return_value = datetime(2021, 11, 11)
|
|
backups = [
|
|
self._add_backup("20211103_0300"), # remove, not the first yearly backup in 2021
|
|
self._add_backup("20210810_0000"), # remove, not the first yearly backup in 2021
|
|
self._add_backup("20210716_0100"), # keep, first yearly backup in 2021
|
|
self._add_backup("20201216_0100"), # remove, not the first yearly backup in 2020
|
|
self._add_backup("20200716_0100"), # keep, first yearly backup in 2020
|
|
self._add_backup("20191216_0100"), # remove, not the first yearly backup in 2019
|
|
self._add_backup("20190316_0100"), # keep, first yearly backup in 2019
|
|
self._add_backup("20181216_0100"), # remove, not the first yearly backup in 2018
|
|
self._add_backup("20181116_0100"), # keep, first yearly backup in 2018
|
|
self._add_backup("20171116_0100"), # remove, older than 3 years
|
|
self._add_backup("20171115_0100"), # remove, older than 3 years
|
|
]
|
|
expected_backups = [backups[2], backups[4], backups[6], backups[8]]
|
|
self._run_cleanup(keep_yearly=3)
|
|
self._check_backups(expected_backups)
|
|
|
|
@mock.patch(f"{bk.__name__}.datetime", wraps=datetime)
|
|
def test_dry_run(self, mock_datetime):
|
|
""" Test dry run does not remove anything """
|
|
mock_datetime.now.return_value = datetime(2021, 11, 11)
|
|
backups = [
|
|
self._add_backup("20211103_0300"),
|
|
self._add_backup("20210810_0000"),
|
|
self._add_backup("20210716_0100"),
|
|
self._add_backup("20200716_0100"),
|
|
self._add_backup("20181116_0100"),
|
|
]
|
|
self._run_cleanup(keep_all=2, dry_run=True)
|
|
self._check_backups(backups)
|
|
|
|
|
|
# TODO add tests for iterating over backups (marker, dirname)
|
|
# TODO add tests for backups dir lockfile
|