dar-backup 1.0.0.1__tar.gz → 1.0.1__tar.gz

{dar_backup-1.0.0.1/src/dar_backup → dar_backup-1.0.1}/Changelog.md

@@ -1,6 +1,40 @@
 <!-- markdownlint-disable MD024 -->
 # dar-backup Changelog
 
+## v2-1.0.1 - 2026-01-09
+
+### Added
+
+- Cleanup `--dry-run` to preview archive, PAR2, and catalog deletions.
+- Completion: `cleanup` supports comma-separated archive lists with whitespace normalization.
+- Completion: `cleanup` now offers archive-only suggestions after `--cleanup-specific-archives`.
+- Tests for completion list parsing and cleanup dry-run.
+- Optional Discord webhook notifications: `send_discord_message` helper with config-over-env precedence (`DAR_BACKUP_DISCORD_WEBHOOK_URL`), JSON payload, timeout, and detailed error logging (HTTP body).
+- Backup runs now emit a per-backup-definition status message (`YYYY-MM-DD_HH:MM - dar-backup, <backup definition>: SUCCESS|FAILURE`).
+- dar-backup `--list-definitions` option to list backup definitions from `BACKUP.D_DIR`.
+- Test coverage: webhook unit tests plus optional live Discord test (guarded by `live_discord` marker).
+- Automatic preflight checks now run before every invocation (or standalone via `--preflight-check`) to verify required directories, write access, and availability of `dar`/`par2` binaries.
+- PAR2 enhancements: optional PAR2_DIR storage, per-archive parity mode, per-backup overrides, and parity manifests to support verify/repair against archives in a different directory.
+- New tests for PAR2_DIR + per-archive verify/repair flow, per-backup overrides.
+- Documentation: new config options and per-backup overrides are documented in the README “Config changes” section.
+- Restore test filters: optional case-insensitive prefix/suffix/regex exclusions for restore-test file sampling, plus a dedicated unit test.
+- Env var `DAR_BACKUP_CONFIG_FILE` now supported.
+
+### Changed
+
+- Completion: `dar-backup -l -d <def>` and `cleanup --cleanup-specific-archives -d <def>` now narrow archive suggestions by definition and prefix.
+- Pytest defaults exclude live Discord tests; enable with `-m live_discord` when a webhook is available.
+- Skip Discord notifications for the demo/example backup definition to avoid spam during sample runs.
+- Discord backup status now includes WARNING when a backup is skipped because it already exists.
+- Completer logging now uses a per-user logfile and falls back safely if the completer logger setup fails.
+- Verification failures and existing-backup skips now emit exit code 2 (warning), while errors continue to emit exit code 1.
+- Cleanup deletion hardening (Snyk): validate archive names and enforce safe, base-dir-bound file deletions.
+- Snyk badge links to [Snyk dar-backup page](https://security.snyk.io/vuln/?search=dar-backup)
+- Removed the rich progress bar wrapper from backup/verify runs to simplify core execution.
+- PAR2 tests now align with per-archive parity flow (single create command, repair via `.par2` set).
+- Slice-order test reads slice numbers from the logged `par2 create` command output.
+- CommandRunner now restores terminal attributes after subprocesses and runs with stdin set to `/dev/null` by default to avoid terminal echo issues.
+
 ## v2-1.0.0 - 2025-10-09
 
 Github link: [v2-1.0.0](https://github.com/per2jensen/dar-backup/tree/v2-1.0.0/v2)
@@ -364,4 +398,4 @@ Github link: [v2-alpha-0.6.0](https://github.com/per2jensen/dar-backup/tree/v2-a
 - FIX: ensure run_command() works correctly when a command writes a lot of data to stdout
 - updated README with details on --restore-dir option
 
-<!-- markdownlint-enable MD024 -->
+<!-- markdownlint-enable MD024 -->

{dar_backup-1.0.0.1 → dar_backup-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 1.0.0.1
+Version: 1.0.1
 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
@@ -722,17 +722,19 @@ 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)
-[![Snyk Vuln findings](https://snyk.io/test/github/per2jensen/dar-backup/badge.svg)](https://snyk.io/test/github/per2jensen/dar-backup)
+[![Snyk Vuln findings](https://snyk.io/test/github/per2jensen/dar-backup/badge.svg)](https://security.snyk.io/vuln/?search=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 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)  <sub>🎯 Stats powered by [ClonePulse](https://github.com/per2jensen/clonepulse)</sub>
+[![# clones](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/clonepulse/badge_clones.json)](https://github.com/per2jensen/dar-backup/blob/main/clonepulse/weekly_clones.png)
+[![Milestone](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/per2jensen/dar-backup/main/clonepulse/milestone_badge.json)](https://github.com/per2jensen/dar-backup/blob/main/clonepulse/weekly_clones.png)  <sub>🎯 Stats powered by [ClonePulse](https://github.com/per2jensen/clonepulse)</sub>
 
 The wonderful 'dar' [Disk Archiver](https://github.com/Edrusb/DAR) is used for
 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`.
+This is the `Python` based [**version 2**](v2) of `dar-backup`.
+
+You can see the [v2 Changelog](v2/Changelog.md) for details on features and progress.
 
 ## TL;DR
 
@@ -746,6 +748,9 @@ Version **1.0.0** was reached on October 9, 2025.
   - [TL;DR](#tldr)
   - [Table of Contents](#table-of-contents)
   - [My use case](#my-use-case)
+  - [My setup](#my-setup)
+    - [Why PAR2 is especially good for portable / offsite copies](#why-par2-is-especially-good-for-portable--offsite-copies)
+    - [Design choices](#design-choices)
   - [Features](#features)
   - [License](#license)
   - [Quick Guide](#quick-guide)
@@ -789,6 +794,8 @@ Version **1.0.0** was reached on October 9, 2025.
     - [restore test fails with exit code 5](#restore-test-fails-with-exit-code-5)
   - [Par2](#par2)
     - [Par2 to verify/repair](#par2-to-verifyrepair)
+      - [Par2 files kept with archives](#par2-files-kept-with-archives)
+      - [Par2 files in separate directory](#par2-files-in-separate-directory)
     - [Par2 create redundancy files](#par2-create-redundancy-files)
   - [Points of interest](#points-of-interest)
     - [Limitations on File Names with Special Characters](#limitations-on-file-names-with-special-characters)
@@ -821,12 +828,19 @@ Version **1.0.0** was reached on October 9, 2025.
     - [CLI Tools Overview](#cli-tools-overview)
     - [test coverage](#test-coverage)
     - [Dar-backup options](#dar-backup-options)
+      - [Dar-backup exit codes](#dar-backup-exit-codes)
+      - [Dar-backup env vars](#dar-backup-env-vars)
     - [Manager Options](#manager-options)
-    - [Cleanup options](#cleanup-options)
+      - [Cleanup env vars](#cleanup-env-vars)
     - [Clean-log options](#clean-log-options)
     - [Dar-backup-systemd options](#dar-backup-systemd-options)
     - [Installer options](#installer-options)
     - [Demo options](#demo-options)
+    - [Config changes](#config-changes)
+      - [1.0.1](#101)
+        - [DISCORD WEBHOOK](#discord-webhook)
+        - [Restore test config](#restore-test-config)
+        - [Par2](#par2-1)
   
 ## My use case
 
@@ -836,7 +850,7 @@ I needed the following:
 - Backup primarily photos, home made video and different types of documents
 - I have cloud storage mounted on a directory within my home dir. The filesystem is [FUSE based](https://www.kernel.org/doc/html/latest/filesystems/fuse.html), which gives it a few special features
 
-  - Backup cloud storage (cloud is convenient, but I want control over my backups)
+  - Backup my cloud storage (cloud is convenient, but I want control over my backups)
   - A non-privileged user can perform a mount
   - A privileged user cannot look into the filesystem --> a backup script running as root is not suitable
 
@@ -847,6 +861,48 @@ I needed the following:
 
  I do not need the encryption features of dar, as all storage is already encrypted.
 
+## My setup
+
+1. Primary backup to server with an ext4 file system on mdadm RAID1
+
+2. Secondary copies to multiple USB disks / cloud
+
+3. Archive integrity verification anywhere using [Par2](#par2) and `dar -t`.
+
+4. Archive repair anywhere if needed. By default `dar-backup` creates par2 redundancy files with 5% coverage. Enough to fix localized bitrot.
+
+5. No dependency on original system
+
+### Why PAR2 is especially good for portable / offsite copies
+
+PAR2 parity is:
+
+> Self-contained (travels with the data)
+>
+>Format-agnostic (works on any filesystem)
+>
+>Location-agnostic (local disk, USB, cloud object storage)
+>
+>Tool-stable (PAR2 spec has not changed in years)
+>
+>That means:
+>
+>**Integrity protection moves with the archive**.
+
+### Design choices
+
+My design choices are boring, proven and pragmatic:
+>
+>mdadm handles disks
+>
+>PAR2 handles data integrity
+>
+>You control when and how verification happens
+>
+>Errors have a fair chance of being diagnosed and fixed, due to well known tooling.
+>
+>No hidden magic, no lock-in
+
 ## Features
 
 - The battle tested [dar](https://github.com/Edrusb/DAR) Disk Archiver is used for the actual backups - it comes highly recommended.
@@ -869,7 +925,7 @@ I needed the following:
 ## License
 
   These scripts are licensed under the GPLv3 license.
-  Read more here: [GNU  GPL3.0](https://www.gnu.org/licenses/gpl-3.0.en.html), or have a look at the ["LICENSE"](https://github.com/per2jensen/dar-backup/blob/main/LICENSE) file in this repository.
+  Read more here: [GNU  GPL3.0](https://www.gnu.org/licenses/gpl-3.0.en.html), or have a look at the ["LICENSE"](LICENSE) file in this repository.
 
 ## Quick Guide
 
@@ -1214,7 +1270,7 @@ This python version is v2 of dar-backup, v1 is made in bash.
 
 ## Community
 
-Please review the [Code of Conduct](https://github.com/per2jensen/dar-backup/blob/main/CODE_OF_CONDUCT.md) to help keep this project welcoming and focused.
+Please review the [Code of Conduct](CODE_OF_CONDUCT.md) to help keep this project welcoming and focused.
 
 ## Requirements
 
@@ -1234,7 +1290,7 @@ On Ubuntu, install the requirements this way:
 
 ### dar-backup overview
 
-![dar-backup overview](https://github.com/per2jensen/dar-backup/blob/main/v2/doc/dar-backup-overview.svg)
+[![dar-backup overview](v2/doc/dar-backup-overview-small.png)](v2/doc/dar-backup-overview.png)
 
 ### dar-backup
 
@@ -1263,6 +1319,15 @@ The `cleanup` application deletes DIFF and INCR if the archives are older than t
 
 `cleanup` will only remove FULL archives if the option  `--cleanup-specific-archives` is used. It requires the user to confirm deletion of FULL archives.
 
+Use `--dry-run` to preview which archives, PAR2 files, and catalogs would be removed without deleting anything.
+
+Examples:
+
+```bash
+cleanup --dry-run -d media-files --log-stdout
+cleanup --dry-run --cleanup-specific-archives -d media-files media-files_INCR_2025-12-22
+```
+
 ### manager
 
 `dar`has the concept of catalogs which can be exported and optionally be added to a catalog database. That database makes it much easier to restore the correct version of a backed up file if for example a target date has been set.
@@ -1406,7 +1471,7 @@ deactivate
 
 The configuration file's default location is: ~/.config/dar-backup/dar-backup.conf
 
-If you have your config file somewhere else, use the `--config` option to point to it.
+If you have your config file somewhere else, use the `--config-file` option to point to it.
 
 Tilde `~` and environment variables can be used in the paths for various file locations.
 
@@ -1442,6 +1507,19 @@ INCR_AGE = 40
 [PAR2]
 ERROR_CORRECTION_PERCENT = 5
 ENABLED = True
+# Optional PAR2 configuration
+# PAR2_DIR = /path/to/par2-store
+# PAR2_MODE = per-slice
+# PAR2_RATIO_FULL = 10
+# PAR2_RATIO_DIFF = 5
+# PAR2_RATIO_INCR = 5
+# PAR2_RUN_VERIFY = false
+
+# Optional per-backup overrides (section name = backup definition)
+[media-files]
+PAR2_DIR = /mnt/par2/media-files
+PAR2_MODE = per-archive
+PAR2_RATIO_FULL = 10
 
 # scripts to run before the backup to setup the environment
 [PREREQ]
@@ -1453,6 +1531,15 @@ SCRIPT_1 = df -h
 #SCRIPT_2 = another_script.sh
 ```
 
+PAR2 notes:
+
+- If `PAR2_DIR` is unset, par2 files are created next to the archive slices (legacy behavior) and no manifest is written
+- When `PAR2_DIR` is set, dar-backup writes a manifest next to the par2 set:
+  `archive_base.par2.manifest.ini`
+- Verify or repair using:
+  `par2 verify -B <archive_dir> <par2_set.par2>`
+  `par2 repair -B <archive_dir> <par2_set.par2>`
+
 ### .darrc
 
 The package includes a default `darrc` file which configures `dar`.
@@ -1900,9 +1987,39 @@ If you need to use this option, un-comment it in the [.darrc](#darrc) file (loca
 
 ## Par2
 
+Why keep PAR2 on a different storage device:
+
+- Reduces single-disk failure impact: bitrot on the archive disk does not affect the parity.
+- Easier offsite rotation: you can sync only the PAR2 sets to a different failure domain.
+
+Redundancy guidance:
+
+- FULL backups: 10% is a practical default for larger data sets and longer retention.
+- DIFF/INCR: 5% is often enough because the delta is smaller and easier to re-create.
+- Increase the ratio if the storage is flaky or the backup is hard to re-run.
+
+Rule of thumb table:
+
+| Backup type | Suggested PAR2 ratio | Notes |
+|-------------|----------------------|-------|
+| FULL        | 10%                  | Longer retention, larger data set |
+| DIFF        | 5%                   | Smaller delta |
+| INCR        | 5%                   | Smaller delta |
+
+>
+>For large, contiguous archives on reliable local storage, 7–8% has proven sufficient in practice; 10% remains a conservative default.
+>
+
+Cloud sync / air-gap note:
+
+- Syncing PAR2 sets to a different device or remote store protects against bitrot and small corruption, but it cannot recover a completely lost archive.
+- An air-gapped PAR2 store is useful when the archive disk is exposed to ransomware or accidental deletion.
+
 ### Par2 to verify/repair
 
-You can run a par2 verification on an archive like this:
+#### Par2 files kept with archives
+
+If PAR2 files are stored next to the archives (legacy per-slice behavior), you can verify like this:
 
 ```bash
 for file in <archive>*.dar.par2; do
@@ -1916,6 +2033,14 @@ if there are problems with a slice, try to repair it like this:
   par2 repair <archive>.<slice number>.dar.par2
 ```
 
+#### Par2 files in separate directory
+
+See [docs on disk layout matters](v2/doc/portable-par2-layout.md)
+
+>Test case proving this flow:
+>
+>[tests/test_par2_manifest.py](v2/tests/test_par2_manifest.py)
+
 ### Par2 create redundancy files
 
 If you have merged archives, you will need to create the .par2 redundency files manually.
@@ -1929,6 +2054,15 @@ done
 
 where "c" is create, -r5 is 5% redundency and -n1 is 1 redundency file
 
+If you want to create a single parity set for all slices in an archive:
+
+```bash
+par2 create -B <archive_dir> -r5 <par2_dir>/<archive_base>.par2 <archive_dir>/<archive_base>.*.dar
+```
+
+**OBSERVE** [docs on disk layout matters](v2/doc/portable-par2-layout.md)
+
+
 ## Points of interest
 
 ### Limitations on File Names with Special Characters
@@ -2309,15 +2443,15 @@ One backup definition per file
 
 ### CLI Tools Overview
 
-| Command              | Description                               |
-|----------------------|-------------------------------------------|
-| [dar-backup](#dar-backup-options)| Perform full, differential, or incremental backups with verification and restore testing |
-| [manager](#manager-options)      | Maintain and query catalog databases for archives |
-| [cleanup](#cleanup-options)      | Remove outdated DIFF/INCR archives (and optionally FULLs) |
-| [clean-log](#clean-log-options)  | Clean up excessive log output from dar command logs |
+| Command | Description |
+| --- | --- |
+| [dar-backup](#dar-backup-options) | Perform full, differential, or incremental backups with verification and restore testing |
+| [manager](#manager-options) | Maintain and query catalog databases for archives |
+| [cleanup](#cleanup-options) | Remove outdated DIFF/INCR archives (and optionally FULLs) |
+| [clean-log](#clean-log-options) | Clean up excessive log output from dar command logs |
 | [dar-backup-systemd](#dar-backup-systemd-options) | Generate (and optionally install) systemd timers and services for automated backups |
-| [installer](#installer-options)  | Set up directories and optionally create catalog databases according to a config file |
-| [demo](#demo-options)            | Set up required directories and config files for a demo|
+| [installer](#installer-options) | Set up directories and optionally create catalog databases according to a config file |
+| [demo](#demo-options) | Set up required directories and config files for a demo|
 
 ### test coverage
 
@@ -2372,6 +2506,7 @@ Available options:
 --examples                           Show examples of using dar-backup.py.
 -l, --list                           List available backups.
 --list-contents <archive>            List the contents of a specified archive.
+--list-definitions                   List backup definitions from BACKUP.D_DIR.
 --selection <params>                 Define file selection for listing/restoring.
 --restore <archive>                  Restore a specified archive.
 -r, --restore <archive>              Restore archive.
@@ -2381,6 +2516,7 @@ Available options:
 --log-level <level>                  `debug` or `trace`, default is `info`.
 --log-stdout                         Also print log messages to stdout.
 --do-not-compare                     Do not compare restores to file system.
+--preflight-check                    Run preflight checks and exit (runs automatically; this flag just exits after checks).
 --examples                           Show examples of using dar-backup.
 --readme                             Print README.md and exit
 --readme-pretty                      Print README.md with Markdown styling and exit
@@ -2389,6 +2525,22 @@ Available options:
 -v, --version                         Show version and license information.
 ```
 
+#### Dar-backup exit codes
+
+- 0: Success.
+- 1: Error (backup/restore/preflight failure).
+- 2: Warning (restore test failed or backup already exists and is skipped).
+- 127: Typically an error during startup, file or config value missing
+  - if the `dar -t` test fails, exit code 1 is emitted
+  - restore tests could fail if the source file has changed after the backup
+
+#### Dar-backup env vars
+
+| Env var | Value | Description |
+| --- | --- | --- |
+| DAR_BACKUP_CONFIG_FILE | Full path to config file | Overrides built-in default, overridden by --config-file |
+| DAR_BACKUP_DISCORD_WEBHOOK_URL | https://discord.com/api/webhooks/\<userID\>/\<webhook UUID\> | The full url |
+
 ### Manager Options
 
 This script manages `dar` databases and catalogs.
@@ -2408,7 +2560,12 @@ Available options:
 --find-file <file>                   Search catalogs for a specific file.
 --verbose                            Enable verbose output.
 --log-level <level>                  Set log level (`debug` or `trace`, default is `info`).
-```
+
+#### Manager env vars
+
+| Env var | Value | Description |
+| --- | --- | --- |
+| DAR_BACKUP_CONFIG_FILE | path to the config file | Default is $HOME/.config/dar-backup/dar-backup.conf |```
 
 ### Cleanup options
 
@@ -2425,12 +2582,19 @@ Supported options:
 --alternate-archive-dir                           Clean up in this directory instead of the default one.
 --cleanup-specific-archives "<archive>, <>, ..."  Comma separated list of archives to cleanup.
 -l, --list                                       List available archives (filter using the -d option).
+--dry-run                                        Show what would be deleted without removing files.
 --verbose                                         Print various status messages to screen.
 --log-level <level>                               `debug` or `trace`, default is `info`", default="info".
 --log-stdout                                      Print log messages to stdout.
 --test-mode                                       This is used when running pytest test cases
 ```
 
+#### Cleanup env vars
+
+| Env var | Value | Description |
+| --- | --- | --- |
+| DAR_BACKUP_CONFIG_FILE | path to the config file | Default is $HOME/.config/dar-backup/dar-backup.conf |
+
 ### Clean-log options
 
 This script removes excessive logging output from `dar` logs, improving readability and efficiency. Available options:
@@ -2480,8 +2644,8 @@ Create directories:
 - ~/.config/dar-backup/
   - ~/.config/dar-backup/backup.d/
 - ~/dar-backup/
-  - ~/dar-backup/backups
-  - ~/dar-backup/restore
+  - ~/dar-backup/backups/
+  - ~/dar-backup/restore/
 
 Sets up demo config files:
 
@@ -2500,3 +2664,100 @@ Sets up demo config files:
 -v, --version       Display version and licensing information.
 -h, --help          Displays usage info
 ```
+
+### Config changes
+
+#### 1.0.1
+
+##### DISCORD WEBHOOK
+
+For Discord notifications use the `DAR_BACKUP_DISCORD_WEBHOOK_URL` environment variable. It should not be placed in the config file.
+
+DAR_BACKUP_DISCORD_WEBHOOK_URL is the entire endpoint like this:
+
+```bash
+export DAR_BACKUP_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/\<userId\>/\<uuid\>
+```
+
+##### Restore test config
+
+Restore tests choose random files from the archive and compare them with the live filesystem.
+To avoid noisy paths (caches, temp files, logs), you can exclude candidates before the random
+selection happens. All matching is case-insensitive.
+
+Config keys (in [MISC]):
+
+- RESTORETEST_EXCLUDE_PREFIXES: comma-separated path prefixes to skip. Matches from the start of
+  the path (after trimming a leading "/"). Use trailing "/" for directories.
+- RESTORETEST_EXCLUDE_SUFFIXES: comma-separated filename suffixes to skip.
+- RESTORETEST_EXCLUDE_REGEX: optional regex to skip anything matching the path.
+
+Example:
+
+```ini
+[MISC]
+RESTORETEST_EXCLUDE_PREFIXES = .cache/, .local/share/Trash/, .mozilla/, snap/firefox/common/.mozilla/
+RESTORETEST_EXCLUDE_SUFFIXES = .sqlite-wal, .sqlite-shm, .log, .tmp, .lock, .journal
+RESTORETEST_EXCLUDE_REGEX = (^|/)(Cache|cache|Logs|log)/
+```
+
+Regex tips (case-insensitive):
+
+- Match common cache/log directories anywhere:
+  `(^|/)(cache|logs)/`
+- Skip thumbnails and temp dirs:
+  `(^|/)(thumbnails|tmp|temp)/`
+- Exclude browser profile noise while keeping other files:
+  `(^|/)\.mozilla/|/snap/firefox/common/\.mozilla/`
+
+##### Par2
+
+New optional PAR2 settings were added to the config file. If none of these keys are added, dar-backup behaves exactly as before (PAR2 files next to archives, per-slice parity).
+
+| Name | Description | When it is in effect | Suggested value |
+|------|-------------|----------------------|-----------------|
+| PAR2_DIR | Directory to store .par2 and .vol*.par2 files | When set | A different device or mount from BACKUP_DIR |
+| PAR2_RATIO_FULL | Redundancy percent for FULL | When set | 10 (%) |
+| PAR2_RATIO_DIFF | Redundancy percent for DIFF | When set | 5  (%)|
+| PAR2_RATIO_INCR | Redundancy percent for INCR | When set | 5  (%)|
+| PAR2_RUN_VERIFY | Verify after create | When set | false |
+
+Notes:
+
+- PAR2_RATIO_*, and PAR2_RUN_VERIFY apply even if PAR2_DIR is not set (i.e. par2 output stays next to the archives).
+
+Per-backup overrides use a section named after the backup definition with the same PAR2_* keys:
+
+```text
+
+######################################################################
+# Per-backup configuration example overrides
+######################################################################
+
+# --------------------------------------------------------------------
+# Per-backup overrides (section name must match backup.d filename stem)
+# Example: backup.d/home.conf  ->  [home]
+# --------------------------------------------------------------------
+
+#[home]
+# Disable PAR2 entirely for this backup definition
+PAR2_ENABLED = false
+#
+#[media]
+# Store PAR2 files in a separate location for this backup definition
+#PAR2_DIR = /samba/par2/media
+# Raise redundancy only for FULL
+#
+[documents]
+# Run verify par2 sets after creation
+PAR2_RUN_VERIFY = true
+#
+#[etc]
+# Keep global PAR2 settings but tweak ratios for this backup definition
+# RATIO is i percent number
+#PAR2_RATIO_FULL = 15  
+#PAR2_RATIO_DIFF = 8
+#PAR2_RATIO_INCR = 8
+```
+
+[Per-backup override test case: `tests/test_par2_overrides.py`](v2/tests/test_par2_overrides.py)