dar-backup 0.7.1__py3-none-any.whl → 0.8.0__py3-none-any.whl

dar_backup/Changelog.md

@@ -1,7 +1,33 @@
 <!-- markdownlint-disable MD024 -->
 # dar-backup Changelog
 
-## v2-beta-0.6.21 - not yet released
+## v2-beta-0.8.0 - 2025-06-13
+
+Github link: [v2-beta-0.8.0](https://github.com/per2jensen/dar-backup/tree/v2-beta-0.8.0/v2)
+
+### Added
+
+- Modified clone dashboard generator to produce easier to read dashboard and be more robust.
+- Dir_traversal sanitation: clean_log.py now only accepts files in configured log directory to `--file` option.
+
+## v2-beta-0.7.2 - 2025-06-07
+
+Github link: [v2-beta-0.7.2](https://github.com/per2jensen/dar-backup/tree/v2-beta-0.7.2/v2)
+
+### Added
+
+- Refactored build system, so all dependencies are kept in `pyproject.toml`. The dependencies are separated  into dev, packaging and delivery phases.
+- Use `build.sh` to setup pytest environment in Github workflow.
+
+  - Do the same to get a development environment going.
+
+- Added 2 new optional params to control log file roll.
+- Enrolling into [Snyk code checker](https://snyk.io/code-checker/) and learning how to work with it.
+  
+  - Snyk helped pointing out vulnerable versions of some packages used.
+  - Input sanitation started, there is room for improvement.
+
+## v2-beta-0.7.1 - 2025-05-22
 
 Github link: [v2-beta-0.7.1](https://github.com/per2jensen/dar-backup/tree/v2-beta-0.7.1/v2)
 
@@ -24,9 +50,9 @@ Github link: [v2-beta-0.7.1](https://github.com/per2jensen/dar-backup/tree/v2-be
 - Action + program to capture cloning stats and store them in v2/doc directory. Includes a badge.
 
   -- annotate new daily max number of clones
-  -- Celebration badge when number of clones numbers are hit (just for fun)
+  -- Celebration badge when certain clones numbers are hit (just for fun)
 
-- Action + program to generate 12weeks cloning dashboard (a PNG) with annotation
+- Action + program to generate 12 weeks cloning dashboard (a PNG) with annotation
 - Tweaked the auto completion setup in .bashrc, it stopped working for me unknown reasons (needs some looking into)
 - --verbose now affects the startup banner. Now it is printed only if --verbose is given
 

dar_backup/README.md

@@ -3,15 +3,16 @@
 
 **Reliable DAR backups, automated in clean Python**
 
-[![codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Snyk Vuln findings](https://snyk.io/test/github/per2jensen/dar-backup/badge.svg)](https://snyk.io/test/github/per2jensen/dar-backup)
 ![CI](https://github.com/per2jensen/dar-backup/actions/workflows/py-tests.yml/badge.svg)
 [![PyPI version](https://img.shields.io/pypi/v/dar-backup.svg)](https://pypi.org/project/dar-backup/)
-[![PyPI total Downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=Total%20Downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+[![PyPI downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=PyPI%20downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
 [![# clones](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/badge_clones.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 [![Milestone](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/milestone_badge.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 
 The wonderful 'dar' [Disk Archiver](https://github.com/Edrusb/DAR) is used for
-the heavy lifting, together with [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
+the heavy lifting, together with the [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
 
 This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-backup/tree/main/v2) of `dar-backup`.
 
@@ -73,6 +74,7 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [Skipping cache directories](#skipping-cache-directories)
   - [Progress bar + current directory](#progress-bar-and-current-directory)
   - [Shell Autocompletion](#shell-autocompletion)
+  - [Easy development setup](#easy-development-setup)
 - [Todo](#todo)
 - [Known Limitations / Edge Cases](#known-limitations--edge-cases)
 - [Reference](#reference)
@@ -207,17 +209,17 @@ Setup the demo configurations and show a few operations
 <br>
 
 ```bash
-# see reference section for options tweaking the install
+# See reference section for options tweaking the install
 demo --install
 
 # create catalog database
 manager --create-db
 
-# do a FULL backup of the installed backup definition called `demo`
+# FULL backup as defined in backup definition `demo`
 dar-backup --full-backup  
 
-# list the contents of the backup
-dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+# List the contents of the backup
+dar-backup --list-contents demo_FULL_$(date '+%F')
 ```
 
 <details>
@@ -259,7 +261,7 @@ Config file:      /home/user/.config/dar-backup/dar-backup.conf
 
 
 
-(venv) $ dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+(venv) $ dar-backup --list-contents demo_FULL_$(date '+%F')
 ========== Startup Settings ==========
 dar-backup.py:    0.7.1
 dar path:         /home/user/.local/dar/bin/dar
@@ -287,10 +289,10 @@ Config file:      /home/user/.config/dar-backup/dar-backup.conf
 Perform a restore and show the restored files
 
 ```bash
-# restore all files in the backup
-dar-backup --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)  --verbose
+# Restore all files in the backup
+dar-backup --restore demo_FULL_$(date '+%F') --verbose
 
-# prove the files have been restored to directory as configured
+# Prove the files have been restored to directory as configured
 find $HOME/dar-backup/restore
 ```
 
@@ -299,7 +301,7 @@ find $HOME/dar-backup/restore
 <summary>🎯 --restore details</summary>
 
 ```bash
-(venv) $ dar-backup --verbose --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+(venv) $ dar-backup --restore demo_FULL_$(date '+%F') --verbose
 ========== Startup Settings ==========
 dar-backup.py:    0.7.1
 dar path:         /home/user/.local/dar/bin/dar
@@ -337,7 +339,7 @@ PAR2 enabled:     True
 
 > ✅ **Next steps**
 >
-> Tinker with `demo's` options:
+> Play with `demo's` options:
 >
 > - --root-dir      (perhaps $HOME)
 > - --dir-to-backup (perhaps Pictures)
@@ -472,8 +474,9 @@ Please review the [Code of Conduct](https://github.com/per2jensen/dar-backup/blo
 
 ## Requirements
 
+- A linux system
 - dar
-- par2
+- parchive (par2)
 - python3
 - python3-venv
 
@@ -578,27 +581,25 @@ See section 15 and section 16 in the supplied "LICENSE" file.
 
 ### 2 - configuration
 
-The dar-backup [demo](#demo-options) application can be used to demo how `dar-backup` works.
-It creates some directories, installs a demo configuration file and puts a demo backup definition in place.
+The dar-backup [installer](#installer-options) application can be used to setup the needed directories for `dar-backup` to work.
+It creates necessary directories as prescribed in the config file and optionally creates manager databases.
 
-`demo` is non-destructive and stops if some of the default directories exist.
+`installer` can also add configuration of shell auto completion.
 
-Run `demo`
+Step 1:
 
-```bash
-demo --install
-```
+Create a config file   - [see details on config file](#config-file))
 
-The output is
+Step 2:
 
-```text
-Directories created: `/home/user/dar-backup/` and `/home/user/.config/dar-backup`
-Config file deployed to /home/user/.config/dar-backup/dar-backup.conf
-Default backup definition deployed to /home/user/.config/dar-backup/backup.d/default
-1. Now run `manager --create-db` to create the catalog database.
-2. Then you can run `dar-backup --full-backup` to create a backup.
-3. List backups with `dar-backup --list`
-4. List contents of a backup with `dar-backup --list-contents <backup-name>`
+Create one or more backup definitions - [see details on backup definitions](#backup-definition-example)
+
+Step 3:
+
+Run the installer:
+
+```bash
+installer --config <path to dar-backup.conf> --install-autocompletion
 ```
 
 ### 3 - generate catalog databases
@@ -613,9 +614,7 @@ manager --create-db
 
 ### 4 - give dar-backup a spin
 
-The `demo` application has put a demo [backup definition](#backup-definition-example) in place in BACKUP.D_DIR (see [config file](#config-file)).
-
-You are now ready to do backups as configured in the backup definition.
+You are now ready to do backups as configured in your backup definition(s).
 
 Give `dar-backup`a spin:
 
@@ -625,6 +624,9 @@ dar-backup --full-backup --verbose
 # list backups
 dar-backup --list
 
+# list contents of a dar backup
+dar-backup --list-contents <TAB>... <choose a backup>
+
 # see some examples on usage
 dar-backup --examples
 
@@ -663,6 +665,9 @@ Tilde `~` and environment variables can be used in the paths for various file lo
 ```text
 [MISC]
 LOGFILE_LOCATION=~/.dar-backup.log
+# optional parameters
+# LOGFILE_MAX_BYTES = 26214400  # 25 MB max file size is default, change as neeeded
+# LOGFILE_BACKUP_COUNT = 5      # 5 backup log files is default, change as needed
 MAX_SIZE_VERIFICATION_MB = 20
 MIN_SIZE_VERIFICATION_MB = 1
 NO_FILES_VERIFICATION = 5
@@ -681,6 +686,8 @@ TEST_RESTORE_DIR = /tmp/dar-backup/restore/
 
 [AGE]
 # age settings are in days
+# `cleanup` script removes archives and their .par redundancy files if older than configured.
+# `cleanup` does not remove FULL archives, unless specifically told to and a "y" is answered to "are you sure?".
 DIFF_AGE = 100
 INCR_AGE = 40
 
@@ -836,6 +843,12 @@ The name of the file is the name of the backup definition.
 
 You can use as many backup definitions as you need.
 
+> Note 👉
+>
+> Environment variables and tilde (~) not allowed here. `dar` does not expand them.
+>
+> See [TODO](#todo)
+
 ```text
  # Switch to ordered selection mode, which means that the following
  # options will be considered top to bottom
@@ -1209,6 +1222,8 @@ These [.darrc](#darrc) settings make `dar` print the current directory being pro
 
 This is very useful in very long running jobs to get an indication that the backup is proceeding normally.
 
+The `dar` output is streamed to the `dar-backup-commands.log` file.
+
 ### Separate log file for command output
 
 Dar-backup's log file is called `dar-backup.log`.
@@ -1370,8 +1385,54 @@ Then reload Zsh:
 source ~/.zshrc
 ```
 
+## Easy development setup
+
+It is very easy to have your own development environment.
+
+```bash
+git clone https://github.com/per2jensen/dar-backup.git
+cd dar-backup/v2
+./build.py
+```
+
+This script:
+
+- Creates a Python virtual environment called `venv`
+- pip install `hatch`
+- pip install the development environment as setup in pyproject.toml
+
+  --
+  
+  ```text
+  dev = [
+  "pytest",
+  "wheel>=0.45.1",
+  "requests>=2.32.2",
+  "coverage>=7.8.2",
+  "pytest>=8.4.0",
+  "pytest-cov>=6.1.1",
+  "psutil>=7.0.0",
+  "pytest-timeout>=2.4.0",
+  "httpcore>=0.17.3",
+  "h11>=0.16.0",
+  "zipp>=3.19.1",
+  "anyio>=4.4.0",
+  "black>=25.1.0"]
+  ```
+
+✅ Your environment is now ready to activate and test!
+
+Activate and run the test suite:
+
+```bash
+source venv/bin/activate # activate the virtual env
+pytest                   # run the test suite
+```
+
 ## Todo
 
+- Perhaps look into pre-processing backup definitions. As `dar` does not expand env vars
+  `dar-backup` could do so and feed the result to `dar`.
 - When run interactively, a progress bar during test and par2 generation would be nice.
 - Look into a way to move the .par2 files away from the `dar` slices, to maximize chance of good redundancy.
 - Add option to dar-backup to use the `dar` option `--fsa-scope none`
@@ -1536,12 +1597,12 @@ Sets up `dar-backup` according to provided config file.
 The installer creates the necessary backup catalog databases if `--create-db` is given.
 
 ```bash
---config                 Sets up `dar-backup`.
---create-db              Create backup catalog databases. Add it to --config
---install-autocompletion Add bash or zsh auto completion - idempotent
---remove-autocompletion  Remove the auto completion from bash or zsh
+--config                 Path to a config file. The configured directories will be created.
+--create-db              Create backup catalog databases. Use this option with `--config`.
+--install-autocompletion Add bash or zsh auto completion - idempotent.
+--remove-autocompletion  Remove the auto completion from bash or zsh.
 -v, --version            Display version and licensing information.
--h, --help               Displays usage info
+-h, --help               Displays usage info.
 ```
 
 ### Demo options
@@ -1561,7 +1622,7 @@ Create directories:
 Sets up demo config files:
 
 - ~/.config/dar-backup/dar-backup.conf
-- ~/.config/dar-backup/backup.d/default
+- ~/.config/dar-backup/backup.d/demo
 
 ```bash
 -i, --install       Sets up `dar-backup`.

dar_backup/__about__.py

@@ -1,4 +1,4 @@
-__version__ = "0.7.1"
+__version__ = "0.8.0"
 
 __license__ = '''Licensed under GNU GENERAL PUBLIC LICENSE v3, see the supplied file "LICENSE" for details.
 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW, not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

dar_backup/clean_log.py

@@ -137,6 +137,19 @@ def main():
         args.file = [config_settings.logfile_location]
 
     for file_path in args.file:
+
+        if ".." in os.path.normpath(file_path).split(os.sep):
+            print(f"Error: Path traversal is not allowed: '{file_path}'")
+            sys.exit(1)
+
+        logfile_dir = os.path.dirname(os.path.realpath(config_settings.logfile_location))
+        resolved_path = os.path.realpath(file_path)
+
+        if not resolved_path.startswith(logfile_dir + os.sep):
+            print(f"Error: File is outside allowed directory: '{file_path}'")
+            sys.exit(1)
+
+        # Validate the file path type and existence        
         if not isinstance(file_path, (str, bytes, os.PathLike)):
             print(f"Error: Invalid file path type: {file_path}")
             sys.exit(1)

dar_backup/cleanup.py

@@ -41,6 +41,8 @@ from dar_backup.util import show_version
 from dar_backup.util import get_invocation_command_line
 from dar_backup.util import print_aligned_settings
 from dar_backup.util import backup_definition_completer, list_archive_completer
+from dar_backup.util import is_safe_filename
+from dar_backup.util import show_scriptname
 
 from dar_backup.command_runner import CommandRunner   
 from dar_backup.command_runner import CommandResult
@@ -80,7 +82,7 @@ def delete_old_backups(backup_dir, age, backup_type, args, backup_definition=Non
             if file_date < cutoff_date:
                 file_path = os.path.join(backup_dir, filename)
                 try:
-                    os.remove(file_path)
+                    is_safe_filename(file_path) and os.remove(file_path)
                     logger.info(f"Deleted {backup_type} backup: {file_path}")
                     archive_name = filename.split('.')[0]
                     if not archive_name in archives_deleted:
@@ -109,7 +111,7 @@ def delete_archive(backup_dir, archive_name, args):
         if archive_regex.match(filename):
             file_path = os.path.join(backup_dir, filename)
             try:
-                os.remove(file_path)
+                is_safe_filename(file_path) and os.remove(file_path)
                 logger.info(f"Deleted archive slice: {file_path}")
                 files_deleted = True
             except Exception as e:
@@ -127,7 +129,7 @@ def delete_archive(backup_dir, archive_name, args):
         if par2_regex.match(filename):
             file_path = os.path.join(backup_dir, filename)
             try:
-                os.remove(file_path)
+                is_safe_filename(file_path) and os.remove(file_path)
                 logger.info(f"Deleted PAR2 file: {file_path}")
                 files_deleted = True
             except Exception as e:
@@ -215,13 +217,13 @@ def main():
 
 #    command_output_log = os.path.join(config_settings.logfile_location.removesuffix("dar-backup.log"), "dar-backup-commands.log")
     command_output_log = config_settings.logfile_location.replace("dar-backup.log", "dar-backup-commands.log")
-    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout)
+    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout, logfile_max_bytes=config_settings.logfile_max_bytes, logfile_backup_count=config_settings.logfile_backup_count)
     command_logger = get_logger(command_output_logger = True)
     runner = CommandRunner(logger=logger, command_logger=command_logger)
 
     start_msgs: List[Tuple[str, str]] = []
 
-    start_msgs.append(("cleanup.py:", about.__version__))
+    start_msgs.append((f"{show_scriptname()}:", about.__version__))
 
     logger.info(f"START TIME: {start_time}")
     logger.debug(f"Command line: {get_invocation_command_line()}")
@@ -233,6 +235,8 @@ def main():
     start_msgs.append(("Config file:", args.config_file))
     args.verbose and start_msgs.append(("Backup dir:", config_settings.backup_dir))
     start_msgs.append(("Logfile:", config_settings.logfile_location))
+    args.verbose and start_msgs.append(("Logfile max size (bytes):", config_settings.logfile_max_bytes))
+    args.verbose and start_msgs.append(("Logfile backup count:", config_settings.logfile_backup_count))
     args.verbose and start_msgs.append(("--alternate-archive-dir:", args.alternate_archive_dir))
     args.verbose and start_msgs.append(("--cleanup-specific-archives:", args.cleanup_specific_archives)) 
 
@@ -261,7 +265,8 @@ def main():
             if "_FULL_" in archive_name:
                 if not confirm_full_archive_deletion(archive_name, args.test_mode):
                     continue
-            logger.info(f"Deleting archive: {archive_name}")
+            archive_path = os.path.join(config_settings.backup_dir, archive_name.strip())
+            logger.info(f"Deleting archive: {archive_path}")
             delete_archive(config_settings.backup_dir, archive_name.strip(), args)
     elif args.list:
         list_backups(config_settings.backup_dir, args.backup_definition)

dar_backup/config_settings.py

@@ -44,6 +44,8 @@ class ConfigSettings:
     incr_age: int = field(init=False)
     error_correction_percent: int = field(init=False)
     par2_enabled: bool = field(init=False)
+    logfile_max_bytes: int = field(init=False)
+    logfile_no_count: int = field(init=False)    
 
 
     OPTIONAL_CONFIG_FIELDS = [
@@ -54,6 +56,20 @@ class ConfigSettings:
             "type": str,
             "default": None,
         },
+        {
+            "section": "MISC",
+            "key": "LOGFILE_MAX_BYTES",
+            "attr": "logfile_max_bytes",
+            "type": int,
+            "default": 26214400 , # 25 MB
+        },
+        {
+            "section": "MISC",
+            "key": "LOGFILE_BACKUP_COUNT",
+            "attr": "logfile_backup_count",
+            "type": int,
+            "default": 5,
+        },
         # Add more optional fields here
     ]
 

dar_backup/dar-backup.conf.j2

@@ -26,6 +26,10 @@
 
 [MISC]
 LOGFILE_LOCATION = {{ vars_map.DAR_BACKUP_DIR -}}/dar-backup.log
+# optional parameters
+# LOGFILE_MAX_BYTES = 26214400  # 25 MB default, change as neeeded
+# LOGFILE_BACKUP_COUNT = 5      # default, change as needed
+
 MAX_SIZE_VERIFICATION_MB = 2
 MIN_SIZE_VERIFICATION_MB = 0
 NO_FILES_VERIFICATION = 1

dar_backup/dar_backup.py

@@ -55,6 +55,8 @@ from dar_backup.util import get_invocation_command_line
 from dar_backup.util import get_binary_info
 from dar_backup.util import print_aligned_settings
 from dar_backup.util import backup_definition_completer, list_archive_completer
+from dar_backup.util import show_scriptname
+from dar_backup.util import print_debug
 
 from dar_backup.command_runner import CommandRunner   
 from dar_backup.command_runner import CommandResult
@@ -92,6 +94,7 @@ def generic_backup(type: str, command: List[str], backup_file: str, backup_defin
     Returns:
         List of tuples (<msg>, <exit_code>) of errors not considered critical enough for raising an exception  
     """
+
     result: List[tuple] = []
 
     logger.info(f"===> Starting {type} backup for {backup_definition}")
@@ -105,7 +108,6 @@ def generic_backup(type: str, command: List[str], backup_file: str, backup_defin
         stop_event = Event()
         session_marker = f"=== START BACKUP SESSION: {int(time())} ==="
         get_logger(command_output_logger=True).info(session_marker)
-
         progress_thread = threading.Thread(
             target=show_log_driven_bar,
             args=(log_path, stop_event, session_marker),
@@ -534,12 +536,12 @@ def perform_backup(args: argparse.Namespace, config_settings: ConfigSettings, ba
 
             # Perform backup
             backup_result = generic_backup(backup_type, command, backup_file, backup_definition_path, args.darrc, config_settings, args)
+
             if not isinstance(backup_result, list) or not all(isinstance(i, tuple) and len(i) == 2 for i in backup_result):
                 logger.error("Unexpected return format from generic_backup")
                 backup_result = [("Unexpected return format from generic_backup", 1)]
 
             results.extend(backup_result)
-
             logger.info("Starting verification...")
             verify_result = verify(args, backup_file, backup_definition_path, config_settings)
             if verify_result:   
@@ -838,7 +840,7 @@ def main():
     if command_output_log == config_settings.logfile_location:
         print(f"Error: logfile_location in {args.config_file} does not end at 'dar-backup.log', exiting", file=stderr)
 
-    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout)
+    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout, logfile_max_bytes=config_settings.logfile_max_bytes, logfile_backup_count=config_settings.logfile_backup_count)
     command_logger = get_logger(command_output_logger = True)
     runner = CommandRunner(logger=logger, command_logger=command_logger)
 
@@ -863,11 +865,11 @@ def main():
         start_msgs: List[Tuple[str, str]] = []
 
         start_time=int(time())
-        start_msgs.append(('dar-backup.py:', about.__version__))
+        start_msgs.append((f"{show_scriptname()}:", about.__version__))
         logger.info(f"START TIME: {start_time}")
-        logger.debug(f"Command line: {get_invocation_command_line()}")
-        logger.debug(f"{'`Args`:\n'}{args}")
-        logger.debug(f"{'`Config_settings`:\n'}{config_settings}")
+        logger.debug(f"Command line:\n{get_invocation_command_line()}")
+        logger.debug(f"`Args`:\n{args}")
+        logger.debug(f"`Config_settings`:\n{config_settings}")
         dar_properties = get_binary_info(command='dar')
         start_msgs.append(('dar path:', dar_properties['path']))
         start_msgs.append(('dar version:', dar_properties['version']))
@@ -890,6 +892,9 @@ def main():
         args.verbose and start_msgs.append(("Restore dir:", restore_dir))
 
         args.verbose and start_msgs.append(("Logfile location:", config_settings.logfile_location))
+        args.verbose and start_msgs.append(("Logfile max size (bytes):", config_settings.logfile_max_bytes))
+        args.verbose and start_msgs.append(("Logfile backup count:", config_settings.logfile_backup_count))
+
         args.verbose and start_msgs.append(("PAR2 enabled:", config_settings.par2_enabled))
         args.verbose and start_msgs.append(("--do-not-compare:", args.do_not_compare))
 
@@ -928,6 +933,7 @@ def main():
 
         requirements('POSTREQ', config_settings)
 
+
     except Exception as e:
         logger.error("Exception details:", exc_info=True)
         results.append((repr(e), 1))

dar_backup/installer.py

@@ -12,6 +12,7 @@ from dar_backup.manager import create_db
 # Always expand manager DB dir correctly, using helper function
 from dar_backup.manager import get_db_dir
 from dar_backup.util import expand_path
+from dar_backup.util import is_safe_path
 
 def install_autocompletion():
     """Detect user shell, choose RC file, and idempotently append autocompletion."""
@@ -99,7 +100,7 @@ def uninstall_autocompletion() -> str:
 
 
 
-def run_installer(config_file: str, create_db_flag: bool, install_ac_flag: bool):
+def run_installer(config_file: str, create_db_flag: bool):
     """
     Run the installation process for dar-backup using the given config file.
 
@@ -116,6 +117,8 @@ def run_installer(config_file: str, create_db_flag: bool, install_ac_flag: bool)
     config_file = os.path.expanduser(os.path.expandvars(config_file))
     config_settings = ConfigSettings(config_file)
 
+    print(f"Using config settings: {config_settings}")
+
     # Set up logging
     command_log = config_settings.logfile_location.replace("dar-backup.log", "dar-backup-commands.log")
     logger = setup_logging(
@@ -137,6 +140,9 @@ def run_installer(config_file: str, create_db_flag: bool, install_ac_flag: bool)
     }
 
     for name, dir_path in required_dirs.items():
+        if not is_safe_path(dir_path):
+            logger.error(f"Unsafe path detected: {dir_path} ({name})")
+            raise ValueError(f"Unsafe path detected: {dir_path} ({name})")
         expanded = Path(expand_path(dir_path))
         if not expanded.exists():
             logger.info(f"Creating directory: {expanded} ({name})")
@@ -149,12 +155,11 @@ def run_installer(config_file: str, create_db_flag: bool, install_ac_flag: bool)
             print(f"Creating catalog for: {backup_def}")
             result = create_db(backup_def, config_settings, logger, runner)
             if result == 0:
-                print(f"✔️  Catalog created (or already existed): {backup_def}")
+                print(f"✔️  Catalog created (or already exist): {backup_def}")
             else:
                 print(f"❌ Failed to create catalog: {backup_def}")
 
 
-
 def main():
     parser = argparse.ArgumentParser(description="dar-backup installer")
     parser.add_argument("--config", required=False, help="Path to config file")
@@ -177,12 +182,17 @@ def main():
 
 
     if args.config:
+        if not os.path.exists(args.config):
+            print(f"❌ Config file does not exist: {args.config}")
+            return
         run_installer(args.config, args.create_db)
-    elif args.install_autocompletion:
+
+    if args.install_autocompletion:
         install_autocompletion()
     elif args.remove_autocompletion:
         uninstall_autocompletion()  
 
+    
 
 if __name__ == "__main__":
     main()

dar_backup/manager.py

@@ -40,6 +40,7 @@ from dar_backup.util import get_binary_info
 from dar_backup.util import show_version
 from dar_backup.util import get_invocation_command_line
 from dar_backup.util import print_aligned_settings
+from dar_backup.util import show_scriptname
 
 from dar_backup.command_runner import CommandRunner   
 from dar_backup.command_runner import CommandResult
@@ -544,14 +545,15 @@ def main():
         return
 
     command_output_log = config_settings.logfile_location.replace("dar-backup.log", "dar-backup-commands.log")
-    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout)
+    logger = setup_logging(config_settings.logfile_location, command_output_log, args.log_level, args.log_stdout, logfile_max_bytes=config_settings.logfile_max_bytes, logfile_backup_count=config_settings.logfile_backup_count)
     command_logger = get_logger(command_output_logger=True)
     runner = CommandRunner(logger=logger, command_logger=command_logger)
 
     start_msgs: List[Tuple[str, str]] = []
 
     start_time = int(time())
-    start_msgs.append((f"{SCRIPTNAME}:", about.__version__))
+    
+    start_msgs.append((f"{show_scriptname()}:", about.__version__))
     logger.info(f"START TIME: {start_time}")
     logger.debug(f"Command line: {get_invocation_command_line()}")
     logger.debug(f"`args`:\n{args}")
@@ -559,6 +561,8 @@ def main():
     start_msgs.append(("Config file:", args.config_file))
     args.verbose and start_msgs.append(("Backup dir:", config_settings.backup_dir))
     start_msgs.append(("Logfile:", config_settings.logfile_location))
+    args.verbose and start_msgs.append(("Logfile max size (bytes):", config_settings.logfile_max_bytes))
+    args.verbose and start_msgs.append(("Logfile backup count:", config_settings.logfile_backup_count))
     args.verbose and start_msgs.append(("--alternate-archive-dir:", args.alternate_archive_dir))
     args.verbose and start_msgs.append(("--remove-specific-archive:", args.remove_specific_archive)) 
     dar_manager_properties = get_binary_info(command='dar_manager')

dar_backup/rich_progress.py

@@ -102,3 +102,4 @@ def show_log_driven_bar(log_path: str, stop_event: Event, session_marker: str, m
             if stop_event.is_set():
                 break
 
+    # Rich prints a \n here, I will live with it

dar_backup/util.py

@@ -12,7 +12,9 @@ See section 15 and section 16 in the supplied "LICENSE" file
 import typing
 import locale
 import configparser
+import inspect
 import logging
+
 import os
 import re
 import subprocess
@@ -28,6 +30,7 @@ import dar_backup.__about__ as about
 from argcomplete.completers import ChoicesCompleter
 from datetime import datetime
 from dar_backup.config_settings import ConfigSettings
+from logging.handlers import RotatingFileHandler
 from pathlib import Path
 from rich.console import Console
 from rich.text import Text
@@ -39,7 +42,16 @@ from typing import Tuple
 logger=None
 secondary_logger=None   
 
-def setup_logging(log_file: str, command_output_log_file: str, log_level: str = "info", log_to_stdout: bool = False) -> logging.Logger:
+#def setup_logging(log_file: str, command_output_log_file: str, log_level: str = "info", log_to_stdout: bool = False) -> logging.Logger:
+def setup_logging(
+    log_file: str,
+    command_output_log_file: str,
+    log_level: str = "info",
+    log_to_stdout: bool = False,
+    logfile_max_bytes: int = 26214400,
+    logfile_backup_count: int = 5,
+) -> logging.Logger:
+
     """
     Sets up logging for the main program and a separate secondary logfile for command outputs.
 
@@ -48,9 +60,11 @@ def setup_logging(log_file: str, command_output_log_file: str, log_level: str =
         command_output_log_file (str): The path to the secondary log file for command outputs.
         log_level (str): The log level to use. Can be "info", "debug", or "trace". Defaults to "info".
         log_to_stdout (bool): If True, log messages will be printed to the console. Defaults to False.
+        logfile_max_bytes: max file size of a log file, defailt = 26214400.
+        logfile_backup_count: max numbers of logs files, default = 5.
 
     Returns:
-        None
+        a RotatingFileHandler logger instance.
 
     Raises:
         Exception: If an error occurs during logging initialization
@@ -66,20 +80,34 @@ def setup_logging(log_file: str, command_output_log_file: str, log_level: str =
 
         logging.Logger.trace = trace
 
+        file_handler = RotatingFileHandler(
+            log_file,
+            maxBytes=logfile_max_bytes,
+            backupCount=logfile_backup_count,
+            encoding="utf-8",
+        )
+
+        command_handler = RotatingFileHandler(
+            command_output_log_file,
+            maxBytes=logfile_max_bytes,
+            backupCount=logfile_backup_count,
+            encoding="utf-8",
+        )
+
+        formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
+        file_handler.setFormatter(formatter)
+        command_handler.setFormatter(formatter)
+
+
         # Setup main logger
         logger = logging.getLogger("main_logger")
         logger.setLevel(logging.DEBUG if log_level == "debug" else TRACE_LEVEL_NUM if log_level == "trace" else logging.INFO)
-        formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
-        file_handler = logging.FileHandler(log_file)
-        file_handler.setFormatter(formatter)
         logger.addHandler(file_handler)
 
         # Setup secondary logger for command outputs
         secondary_logger = logging.getLogger("command_output_logger")
         secondary_logger.setLevel(logging.DEBUG if log_level == "debug" else TRACE_LEVEL_NUM if log_level == "trace" else logging.INFO)
-        sec_file_handler = logging.FileHandler(command_output_log_file)
-        sec_file_handler.setFormatter(formatter)
-        secondary_logger.addHandler(sec_file_handler)
+        secondary_logger.addHandler(command_handler)
 
         if log_to_stdout:
             stdout_handler = logging.StreamHandler(sys.stdout)
@@ -124,6 +152,15 @@ completer_logger = _setup_completer_logger()
 completer_logger.debug("Completer logger initialized.")
 
 
+def print_debug(msg):
+    """
+    Print a debug message with the filename and line number of the caller.    
+    """
+    frame = inspect.currentframe().f_back
+    print(f"[DEBUG] {frame.f_code.co_filename}:{frame.f_lineno} - {repr(msg)}")
+
+
+
 def get_invocation_command_line() -> str:
     """
     Safely retrieves the exact command line used to invoke the current Python process.
@@ -146,6 +183,17 @@ def get_invocation_command_line() -> str:
         return f"[error: could not read /proc/[pid]/cmdline: {e}]"
 
 
+def show_scriptname()  -> str:
+    """
+    Return script name, useful in start banner for example
+    """
+    try:
+        scriptname = os.path.basename(sys.argv[0])
+    except:
+        scriptname = "unknown"
+    return scriptname
+
+
 def show_version():
     script_name = os.path.basename(sys.argv[0])
     print(f"{script_name} {about.__version__}")
@@ -683,3 +731,30 @@ def normalize_dir(path: str) -> str:
     normalized = str(p)
     return normalized
 
+
+
+# Reusable pattern for archive file naming
+archive_pattern = re.compile(
+    r'^.+?_(FULL|DIFF|INCR)_(\d{4}-\d{2}-\d{2})\.\d+\.dar'
+    r'(?:\.vol\d+(?:\+\d+)?\.par2|\.par2)?$'
+)
+
+def is_safe_filename(filename: str) -> bool:
+    """
+    Validates that the filename matches acceptable dar/par2 naming convention.
+    """
+    return archive_pattern.match(filename) is not None
+
+def is_safe_path(path: str) -> bool:
+    """
+    Validates that the full path is absolute, has no '..'.
+    """
+    normalized = os.path.normpath(path)
+    filename = os.path.basename(normalized)
+
+    return (
+        os.path.isabs(normalized)
+        and '..' not in normalized.split(os.sep)
+    )
+
+

{dar_backup-0.7.1.dist-info → dar_backup-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 0.7.1
+Version: 0.8.0
 Summary: A script to do full, differential and incremental backups using dar.     Some files are restored from the backups during verification, after which par2 redundancy files are created.     The script also has a cleanup feature to remove old backups and par2 files.
 Project-URL: GPG Public Key, https://keys.openpgp.org/search?q=dar-backup@pm.me
 Project-URL: Homepage, https://github.com/per2jensen/dar-backup/tree/main/v2
@@ -693,6 +693,27 @@ Requires-Dist: argcomplete>=3.6.2
 Requires-Dist: inputimeout>=1.0.4
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: anyio>=4.4.0; extra == 'dev'
+Requires-Dist: black>=25.1.0; extra == 'dev'
+Requires-Dist: coverage>=7.8.2; extra == 'dev'
+Requires-Dist: h11>=0.16.0; extra == 'dev'
+Requires-Dist: httpcore>=0.17.3; extra == 'dev'
+Requires-Dist: matplotlib>=3.10.3; extra == 'dev'
+Requires-Dist: pandas>=2.3.0; extra == 'dev'
+Requires-Dist: psutil>=7.0.0; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov>=6.1.1; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest>=8.4.0; extra == 'dev'
+Requires-Dist: requests>=2.32.2; extra == 'dev'
+Requires-Dist: wheel>=0.45.1; extra == 'dev'
+Requires-Dist: zipp>=3.19.1; extra == 'dev'
+Provides-Extra: packaging
+Requires-Dist: build>=1.2.2; extra == 'packaging'
+Requires-Dist: hatch>=1.14.1; extra == 'packaging'
+Requires-Dist: hatchling>=1.27.0; extra == 'packaging'
+Requires-Dist: twine>=6.1.0; extra == 'packaging'
 Description-Content-Type: text/markdown
 
 <!-- markdownlint-disable MD024 -->
@@ -700,15 +721,16 @@ Description-Content-Type: text/markdown
 
 **Reliable DAR backups, automated in clean Python**
 
-[![codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Codecov](https://codecov.io/gh/per2jensen/dar-backup/branch/main/graph/badge.svg)](https://codecov.io/gh/per2jensen/dar-backup)
+[![Snyk Vuln findings](https://snyk.io/test/github/per2jensen/dar-backup/badge.svg)](https://snyk.io/test/github/per2jensen/dar-backup)
 ![CI](https://github.com/per2jensen/dar-backup/actions/workflows/py-tests.yml/badge.svg)
 [![PyPI version](https://img.shields.io/pypi/v/dar-backup.svg)](https://pypi.org/project/dar-backup/)
-[![PyPI total Downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=Total%20Downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
+[![PyPI downloads](https://img.shields.io/badge/dynamic/json?color=blue&label=PyPI%20downloads&query=total&url=https%3A%2F%2Fraw.githubusercontent.com%2Fper2jensen%2Fdar-backup%2Fmain%2Fdownloads.json)](https://pypi.org/project/dar-backup/)
 [![# clones](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/badge_clones.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 [![Milestone](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/v2/doc/badges/milestone_badge.json)](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/weekly_clones.png)
 
 The wonderful 'dar' [Disk Archiver](https://github.com/Edrusb/DAR) is used for
-the heavy lifting, together with [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
+the heavy lifting, together with the [parchive](https://github.com/Parchive/par2cmdline) suite in these scripts.
 
 This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-backup/tree/main/v2) of `dar-backup`.
 
@@ -770,6 +792,7 @@ This is the `Python` based [**version 2**](https://github.com/per2jensen/dar-bac
   - [Skipping cache directories](#skipping-cache-directories)
   - [Progress bar + current directory](#progress-bar-and-current-directory)
   - [Shell Autocompletion](#shell-autocompletion)
+  - [Easy development setup](#easy-development-setup)
 - [Todo](#todo)
 - [Known Limitations / Edge Cases](#known-limitations--edge-cases)
 - [Reference](#reference)
@@ -904,17 +927,17 @@ Setup the demo configurations and show a few operations
 <br>
 
 ```bash
-# see reference section for options tweaking the install
+# See reference section for options tweaking the install
 demo --install
 
 # create catalog database
 manager --create-db
 
-# do a FULL backup of the installed backup definition called `demo`
+# FULL backup as defined in backup definition `demo`
 dar-backup --full-backup  
 
-# list the contents of the backup
-dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+# List the contents of the backup
+dar-backup --list-contents demo_FULL_$(date '+%F')
 ```
 
 <details>
@@ -956,7 +979,7 @@ Config file:      /home/user/.config/dar-backup/dar-backup.conf
 
 
 
-(venv) $ dar-backup --list-contents $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+(venv) $ dar-backup --list-contents demo_FULL_$(date '+%F')
 ========== Startup Settings ==========
 dar-backup.py:    0.7.1
 dar path:         /home/user/.local/dar/bin/dar
@@ -984,10 +1007,10 @@ Config file:      /home/user/.config/dar-backup/dar-backup.conf
 Perform a restore and show the restored files
 
 ```bash
-# restore all files in the backup
-dar-backup --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)  --verbose
+# Restore all files in the backup
+dar-backup --restore demo_FULL_$(date '+%F') --verbose
 
-# prove the files have been restored to directory as configured
+# Prove the files have been restored to directory as configured
 find $HOME/dar-backup/restore
 ```
 
@@ -996,7 +1019,7 @@ find $HOME/dar-backup/restore
 <summary>🎯 --restore details</summary>
 
 ```bash
-(venv) $ dar-backup --verbose --restore $(dar-backup --list |tail -n 1 | cut -d " " -f1)
+(venv) $ dar-backup --restore demo_FULL_$(date '+%F') --verbose
 ========== Startup Settings ==========
 dar-backup.py:    0.7.1
 dar path:         /home/user/.local/dar/bin/dar
@@ -1034,7 +1057,7 @@ PAR2 enabled:     True
 
 > ✅ **Next steps**
 >
-> Tinker with `demo's` options:
+> Play with `demo's` options:
 >
 > - --root-dir      (perhaps $HOME)
 > - --dir-to-backup (perhaps Pictures)
@@ -1169,8 +1192,9 @@ Please review the [Code of Conduct](https://github.com/per2jensen/dar-backup/blo
 
 ## Requirements
 
+- A linux system
 - dar
-- par2
+- parchive (par2)
 - python3
 - python3-venv
 
@@ -1275,27 +1299,25 @@ See section 15 and section 16 in the supplied "LICENSE" file.
 
 ### 2 - configuration
 
-The dar-backup [demo](#demo-options) application can be used to demo how `dar-backup` works.
-It creates some directories, installs a demo configuration file and puts a demo backup definition in place.
+The dar-backup [installer](#installer-options) application can be used to setup the needed directories for `dar-backup` to work.
+It creates necessary directories as prescribed in the config file and optionally creates manager databases.
 
-`demo` is non-destructive and stops if some of the default directories exist.
+`installer` can also add configuration of shell auto completion.
 
-Run `demo`
+Step 1:
 
-```bash
-demo --install
-```
+Create a config file   - [see details on config file](#config-file))
 
-The output is
+Step 2:
 
-```text
-Directories created: `/home/user/dar-backup/` and `/home/user/.config/dar-backup`
-Config file deployed to /home/user/.config/dar-backup/dar-backup.conf
-Default backup definition deployed to /home/user/.config/dar-backup/backup.d/default
-1. Now run `manager --create-db` to create the catalog database.
-2. Then you can run `dar-backup --full-backup` to create a backup.
-3. List backups with `dar-backup --list`
-4. List contents of a backup with `dar-backup --list-contents <backup-name>`
+Create one or more backup definitions - [see details on backup definitions](#backup-definition-example)
+
+Step 3:
+
+Run the installer:
+
+```bash
+installer --config <path to dar-backup.conf> --install-autocompletion
 ```
 
 ### 3 - generate catalog databases
@@ -1310,9 +1332,7 @@ manager --create-db
 
 ### 4 - give dar-backup a spin
 
-The `demo` application has put a demo [backup definition](#backup-definition-example) in place in BACKUP.D_DIR (see [config file](#config-file)).
-
-You are now ready to do backups as configured in the backup definition.
+You are now ready to do backups as configured in your backup definition(s).
 
 Give `dar-backup`a spin:
 
@@ -1322,6 +1342,9 @@ dar-backup --full-backup --verbose
 # list backups
 dar-backup --list
 
+# list contents of a dar backup
+dar-backup --list-contents <TAB>... <choose a backup>
+
 # see some examples on usage
 dar-backup --examples
 
@@ -1360,6 +1383,9 @@ Tilde `~` and environment variables can be used in the paths for various file lo
 ```text
 [MISC]
 LOGFILE_LOCATION=~/.dar-backup.log
+# optional parameters
+# LOGFILE_MAX_BYTES = 26214400  # 25 MB max file size is default, change as neeeded
+# LOGFILE_BACKUP_COUNT = 5      # 5 backup log files is default, change as needed
 MAX_SIZE_VERIFICATION_MB = 20
 MIN_SIZE_VERIFICATION_MB = 1
 NO_FILES_VERIFICATION = 5
@@ -1378,6 +1404,8 @@ TEST_RESTORE_DIR = /tmp/dar-backup/restore/
 
 [AGE]
 # age settings are in days
+# `cleanup` script removes archives and their .par redundancy files if older than configured.
+# `cleanup` does not remove FULL archives, unless specifically told to and a "y" is answered to "are you sure?".
 DIFF_AGE = 100
 INCR_AGE = 40
 
@@ -1533,6 +1561,12 @@ The name of the file is the name of the backup definition.
 
 You can use as many backup definitions as you need.
 
+> Note 👉
+>
+> Environment variables and tilde (~) not allowed here. `dar` does not expand them.
+>
+> See [TODO](#todo)
+
 ```text
  # Switch to ordered selection mode, which means that the following
  # options will be considered top to bottom
@@ -1906,6 +1940,8 @@ These [.darrc](#darrc) settings make `dar` print the current directory being pro
 
 This is very useful in very long running jobs to get an indication that the backup is proceeding normally.
 
+The `dar` output is streamed to the `dar-backup-commands.log` file.
+
 ### Separate log file for command output
 
 Dar-backup's log file is called `dar-backup.log`.
@@ -2067,8 +2103,54 @@ Then reload Zsh:
 source ~/.zshrc
 ```
 
+## Easy development setup
+
+It is very easy to have your own development environment.
+
+```bash
+git clone https://github.com/per2jensen/dar-backup.git
+cd dar-backup/v2
+./build.py
+```
+
+This script:
+
+- Creates a Python virtual environment called `venv`
+- pip install `hatch`
+- pip install the development environment as setup in pyproject.toml
+
+  --
+  
+  ```text
+  dev = [
+  "pytest",
+  "wheel>=0.45.1",
+  "requests>=2.32.2",
+  "coverage>=7.8.2",
+  "pytest>=8.4.0",
+  "pytest-cov>=6.1.1",
+  "psutil>=7.0.0",
+  "pytest-timeout>=2.4.0",
+  "httpcore>=0.17.3",
+  "h11>=0.16.0",
+  "zipp>=3.19.1",
+  "anyio>=4.4.0",
+  "black>=25.1.0"]
+  ```
+
+✅ Your environment is now ready to activate and test!
+
+Activate and run the test suite:
+
+```bash
+source venv/bin/activate # activate the virtual env
+pytest                   # run the test suite
+```
+
 ## Todo
 
+- Perhaps look into pre-processing backup definitions. As `dar` does not expand env vars
+  `dar-backup` could do so and feed the result to `dar`.
 - When run interactively, a progress bar during test and par2 generation would be nice.
 - Look into a way to move the .par2 files away from the `dar` slices, to maximize chance of good redundancy.
 - Add option to dar-backup to use the `dar` option `--fsa-scope none`
@@ -2233,12 +2315,12 @@ Sets up `dar-backup` according to provided config file.
 The installer creates the necessary backup catalog databases if `--create-db` is given.
 
 ```bash
---config                 Sets up `dar-backup`.
---create-db              Create backup catalog databases. Add it to --config
---install-autocompletion Add bash or zsh auto completion - idempotent
---remove-autocompletion  Remove the auto completion from bash or zsh
+--config                 Path to a config file. The configured directories will be created.
+--create-db              Create backup catalog databases. Use this option with `--config`.
+--install-autocompletion Add bash or zsh auto completion - idempotent.
+--remove-autocompletion  Remove the auto completion from bash or zsh.
 -v, --version            Display version and licensing information.
--h, --help               Displays usage info
+-h, --help               Displays usage info.
 ```
 
 ### Demo options
@@ -2258,7 +2340,7 @@ Create directories:
 Sets up demo config files:
 
 - ~/.config/dar-backup/dar-backup.conf
-- ~/.config/dar-backup/backup.d/default
+- ~/.config/dar-backup/backup.d/demo
 
 ```bash
 -i, --install       Sets up `dar-backup`.

dar_backup-0.8.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+dar_backup/.darrc,sha256=-aerqivZmOsW_XBCh9IfbYTUvw0GkzDSr3Vx4GcNB1g,2113
+dar_backup/Changelog.md,sha256=CpUyWEnzVvn2otCGTp-N4R_-0zlr1kFe_Y0yQ-xQEZg,11872
+dar_backup/README.md,sha256=HWrcpd_nhzhL2quLlxp7Xd0i05GxZvJMu5nSw8lJKLk,59901
+dar_backup/__about__.py,sha256=4n6dyFqIrCJMAEZWvi2IbAzYCvkz4sxqN2wbVMbVWNk,344
+dar_backup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dar_backup/clean_log.py,sha256=pmmyPmLWbm3_3sHwJt9V_xBwUF8v015iS17ypJAGAZ4,6023
+dar_backup/cleanup.py,sha256=_ggDcpMCB1MhXStvYussp_PdGfhIFtEutT5BNrNkMSY,13297
+dar_backup/command_runner.py,sha256=IUPYYBsaDFBp0q81Rt2xB9ucuK9eu5bXziRKXhI5YZM,4500
+dar_backup/config_settings.py,sha256=2UAHvatrVO4ark6lCn2Q7qBvZN6DUMK2ftlNrKpzlWc,5792
+dar_backup/dar-backup.conf,sha256=46V2zdvjj_aThFY11wWlffjmoiChYmatdf5DXCsmmao,1208
+dar_backup/dar-backup.conf.j2,sha256=z3epGo6nB_Jh3liTOp93wJO_HKUsf7qghe9cdtFH7cY,2021
+dar_backup/dar_backup.py,sha256=pgUQ1wZ5_yocRJJDRa4AkVyI7I8Z5WBY5vD5a4ASkmA,43001
+dar_backup/dar_backup_systemd.py,sha256=PwAc2H2J3hQLWpnC6Ib95NZYtB2G2NDgkSblfLj1n10,3875
+dar_backup/demo.py,sha256=bxEq_nJwHuQydERPppkvhotg1fdwBX_CE33m5fX_kxw,7945
+dar_backup/demo_backup_def.j2,sha256=hQW2Glp0QGV3Kt8cwjS0mpOCdyzjVlpgbgL6LpXTKJA,1793
+dar_backup/exceptions.py,sha256=dBQwgKUilgfb1Tnlm_m1Dl1IqoY75L0n1uRkm0DBVTk,158
+dar_backup/installer.py,sha256=xSXh77qquIZbUTSY3AbhERQbS7bnrPE__M_yqpszdhM,6883
+dar_backup/manager.py,sha256=d1zliFpSuWc8JhjKqLMC-xOhp5kSIcfeGkMZOVuZcM0,27143
+dar_backup/rich_progress.py,sha256=SfwFxebBl6jnDQMUQr4McknkW1yQWaJVo1Ju1OD3okA,3221
+dar_backup/util.py,sha256=iTOGsZyIdkvh9tIu7hD_IXi-9HO6GhVgqact5GGInEY,26063
+dar_backup-0.8.0.dist-info/METADATA,sha256=_CBNbG6I0C8C18V3ZfZPGWuMSnVD0UrXlswQCK-OnCY,102592
+dar_backup-0.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+dar_backup-0.8.0.dist-info/entry_points.txt,sha256=pOK9M8cHeAcGIatrYzkm_1O89kPk0enyYONALYjFBx4,286
+dar_backup-0.8.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+dar_backup-0.8.0.dist-info/RECORD,,

dar_backup-0.7.1.dist-info/RECORD

@@ -1,25 +0,0 @@
-dar_backup/.darrc,sha256=-aerqivZmOsW_XBCh9IfbYTUvw0GkzDSr3Vx4GcNB1g,2113
-dar_backup/Changelog.md,sha256=sf00ukQPTTqwraUf-NaGtMlWRBjgsQ2wyoEkF1rBew8,10834
-dar_backup/README.md,sha256=Sc1721Ar5PVj2tkhjrmyJXt3a5iCAlLSRjyYvUi8S9s,58463
-dar_backup/__about__.py,sha256=EL4Ktx4eIjaIDyiDjA8mHNzo4u6QvMkXc0WXCOClYhg,344
-dar_backup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dar_backup/clean_log.py,sha256=tinRODoWWKvs6Ct41j2E4K6Ktw8CeZlsQVtyYioVVfQ,5492
-dar_backup/cleanup.py,sha256=VJdFHch21GWWGv1b_GlVK6dtxuUkHUazTVwmt-O3Gds,12691
-dar_backup/command_runner.py,sha256=IUPYYBsaDFBp0q81Rt2xB9ucuK9eu5bXziRKXhI5YZM,4500
-dar_backup/config_settings.py,sha256=1iRcurEPJObzVaYtiVRhXJi5DFT04VuLKbF9WIHbCvw,5305
-dar_backup/dar-backup.conf,sha256=46V2zdvjj_aThFY11wWlffjmoiChYmatdf5DXCsmmao,1208
-dar_backup/dar-backup.conf.j2,sha256=QdFXcuLFbz3UOOqR5SuHCJqds5cmtVnWrxW5Eg3sFwU,1871
-dar_backup/dar_backup.py,sha256=6bcFRHyMoy1epxQ1AqKnNk2L72wx9WifNuMZf0oFi2I,42586
-dar_backup/dar_backup_systemd.py,sha256=PwAc2H2J3hQLWpnC6Ib95NZYtB2G2NDgkSblfLj1n10,3875
-dar_backup/demo.py,sha256=bxEq_nJwHuQydERPppkvhotg1fdwBX_CE33m5fX_kxw,7945
-dar_backup/demo_backup_def.j2,sha256=hQW2Glp0QGV3Kt8cwjS0mpOCdyzjVlpgbgL6LpXTKJA,1793
-dar_backup/exceptions.py,sha256=dBQwgKUilgfb1Tnlm_m1Dl1IqoY75L0n1uRkm0DBVTk,158
-dar_backup/installer.py,sha256=bLDlJnGNExHElr7xp-G5o9IC9pN4jmhaPdphfK4VoAE,6492
-dar_backup/manager.py,sha256=ygBgxMHGRWtbSxylWsK3AugsQamWL68BAsWPjDpUEvo,26766
-dar_backup/rich_progress.py,sha256=rfKcE9P7hIGmmz9E1zMqC98axZk9fq1o-lVPeMvH2MI,3173
-dar_backup/util.py,sha256=_7RLLKsOoGktAgajjSYL29rs4jBJzRw0F21FXXLBnDE,24154
-dar_backup-0.7.1.dist-info/METADATA,sha256=sNYO2Vx8AIrwhxtISFXHEBpNpviui65IIlHo8hv1fI0,100213
-dar_backup-0.7.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-dar_backup-0.7.1.dist-info/entry_points.txt,sha256=pOK9M8cHeAcGIatrYzkm_1O89kPk0enyYONALYjFBx4,286
-dar_backup-0.7.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-dar_backup-0.7.1.dist-info/RECORD,,