Regularly back up Documents/ and some configuration files

.local/bin/dirtree-changed

@@ -0,0 +1,52 @@
+#! /usr/bin/python3
+
+from pathlib import Path
+
+
+def get_subtree_mtime(root: str | Path) -> float:
+    from itertools import chain
+    from os import walk
+    from os.path import getmtime
+
+    maxtime = 0
+
+    for dirname, _, filenames in walk(root):
+        dirpath = Path(dirname)
+        maxtime = max(
+            chain(
+                [maxtime, getmtime(dirpath)],
+                (getmtime(dirpath / filename) for filename in filenames),
+            )
+        )
+
+    return maxtime
+
+
+def tree_changed_p(root: str | Path, check_file: str | Path) -> bool:
+    from os.path import getmtime
+
+    try:
+        filetime = getmtime(check_file)
+    except FileNotFoundError:
+        return True
+
+    return get_subtree_mtime(root) > filetime
+
+
+if __name__ == "__main__":
+    import argparse
+    import sys
+
+    parser = argparse.ArgumentParser(description="Manage the desktop containers")
+
+    parser.add_argument("--directory", required=True, help="Directory tree to check")
+    parser.add_argument(
+        "--check-file", required=True, help="Timestamp file for comparison"
+    )
+
+    args = parser.parse_args()
+
+    if tree_changed_p(root=args.directory, check_file=args.check_file):
+        sys.exit(0)
+    else:
+        sys.exit(1)

.local/bin/make-backup

@@ -0,0 +1,22 @@
+#! /usr/bin/sh
+
+export BORG_REPO="/media/backup/"
+export BORG_PASSCOMMAND="cat ${HOME}/.keys/borg-passphrase.txt"
+
+TS_DIR="${HOME}/.local/state/backup"
+
+mkdir -p "${TS_DIR}"
+
+backup () {
+    target=$1
+    directory=$2
+
+    if "${HOME}/.local/bin/dirtree-changed" --directory "${directory}" --check-file "${TS_DIR}/${target}"
+    then
+        borg create --compression auto,lzma ::"${target}"-{now} "${directory}"
+        touch "${TS_DIR}/${target}"
+    fi
+}
+
+backup circuits "${HOME}/.config/circuits"
+backup documents "${HOME}/Documents"