dar-backup 1.0.1__py3-none-any.whl → 1.1.0__py3-none-any.whl

{dar_backup-1.0.1.dist-info → dar_backup-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dar-backup
-Version: 1.0.1
+Version: 1.1.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
@@ -686,27 +686,30 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Topic :: System :: Archiving :: Backup
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Requires-Dist: argcomplete>=3.6.2
+Requires-Dist: dateparser>=1.2.0
 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: mypy; 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-json-report; extra == 'dev'
+Requires-Dist: pytest-mock; 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: ruff; extra == 'dev'
 Requires-Dist: wheel>=0.45.1; extra == 'dev'
 Requires-Dist: zipp>=3.19.1; extra == 'dev'
 Provides-Extra: packaging
@@ -742,6 +745,18 @@ You can see the [v2 Changelog](v2/Changelog.md) for details on features and prog
 
 Version **1.0.0** was reached on October 9, 2025.
 
+**High-level flow**
+
+[![dar-backup overview](v2/doc/dar-backup-overview-small.png)](#dar-backup-principles)
+
+**Quick links**
+
+- [Quick Guide](#quick-guide)
+- [Redundancy to fix bitrot](#par2)
+- [Point In Time Recovery](#point-in-time-recovery-pitr)
+- [550+ unit tests & integration tests](#test-coverage)
+  - par2 bitrot repair proof, full/diff/incr with restore, PITR verifications, ...  
+
 ## Table of Contents
 
 - [`dar-backup`](#dar-backup)
@@ -785,6 +800,7 @@ Version **1.0.0** was reached on October 9, 2025.
     - [select a directory](#select-a-directory)
     - [select files with "Z50" in the file name and exclude .xmp files](#select-files-with-z50-in-the-file-name-and-exclude-xmp-files)
   - [Restoring](#restoring)
+    - [Point-in-Time Recovery (PITR)](#point-in-time-recovery-pitr)
     - [default location for restores](#default-location-for-restores)
     - [--restore-dir option](#--restore-dir-option)
     - [a single file](#a-single-file)
@@ -813,8 +829,8 @@ Version **1.0.0** was reached on October 9, 2025.
     - [Performance tip due to par2](#performance-tip-due-to-par2)
     - [.darrc sets -vd -vf (since v0.6.4)](#darrc-sets--vd--vf-since-v064)
     - [Separate log file for command output](#separate-log-file-for-command-output)
+    - [Trace Logging (Debug details)](#trace-logging-debug-details)
     - [Skipping cache directories](#skipping-cache-directories)
-    - [Progress bar and current directory](#progress-bar-and-current-directory)
     - [Shell autocompletion](#shell-autocompletion)
       - [Use it](#use-it)
       - [Archive name completion (smart, context-aware)](#archive-name-completion-smart-context-aware)
@@ -826,7 +842,10 @@ Version **1.0.0** was reached on October 9, 2025.
   - [Projects these scripts benefit from](#projects-these-scripts-benefit-from)
   - [Reference](#reference)
     - [CLI Tools Overview](#cli-tools-overview)
-    - [test coverage](#test-coverage)
+    - [Test coverage](#test-coverage)
+      - [Test selection with markers](#test-selection-with-markers)
+      - [Common runs](#common-runs)
+      - [Run all tests](#run-all-tests)
     - [Dar-backup options](#dar-backup-options)
       - [Dar-backup exit codes](#dar-backup-exit-codes)
       - [Dar-backup env vars](#dar-backup-env-vars)
@@ -841,6 +860,10 @@ Version **1.0.0** was reached on October 9, 2025.
         - [DISCORD WEBHOOK](#discord-webhook)
         - [Restore test config](#restore-test-config)
         - [Par2](#par2-1)
+      - [1.0.2](#102)
+        - [Trace Logging](#trace-logging)
+        - [Command output Capture](#command-output-capture)
+      - [1.1.0](#110)
   
 ## My use case
 
@@ -1487,6 +1510,7 @@ NO_FILES_VERIFICATION = 5
 # timeout in seconds for backup, test, restore and par2 operations
 # The author has such `dar` tasks running for 10-15 hours on the yearly backups, so a value of 24 hours is used.
 # If a timeout is not specified when using the util.run_command(), a default timeout of 30 secs is used.
+# Use -1 to disable timeouts.
 COMMAND_TIMEOUT_SECS = 86400
 
 [DIRECTORIES]
@@ -1509,7 +1533,6 @@ 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
@@ -1518,7 +1541,6 @@ ENABLED = True
 # 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
@@ -1536,6 +1558,7 @@ 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`
+- When generating a par2 set, par2 reads all archive slices before writing any output files; for large backups, this initial read can take hours
 - Verify or repair using:
   `par2 verify -B <archive_dir> <par2_set.par2>`
   `par2 repair -B <archive_dir> <par2_set.par2>`
@@ -1861,6 +1884,25 @@ This happens when the shell splits the quoted string or interprets globs before
 
 > 💡 **Tip:** See [dar's documentation](http://dar.linux.free.fr/doc/man/dar.html#COMMANDS%20AND%20OPTIONS)
 
+>
+> 💡💡 **Tip:** To filter all the empty directories away that `dar` emits when listing  contents, append this grep:
+>
+> ```bash
+> |grep -vE '\s+d[rwx-]{9}\s'
+>```
+>
+>Example using the grep to discard directory noise from `dar's` output:
+>
+> ```bash
+> dar-backup --list-contents media-files_INCR_2025-05-10 --selection="-I '*Z50*' -X '*.xmp'" | grep -vE '\s+d[rwx-]{9}\s'
+>[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0633.NEF
+>[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 26  Mio Fri May  9 11:26:16 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0632.NEF
+>[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 28  Mio Fri May  9 11:09:04 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0631.NEF
+>[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0630.NEF
+>[Saved][ ]       [-L-][   0%][X]  -rw-rw-r--   user user 29  Mio Fri May  9 11:09:03 2025 home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling/Z50_0629.NEF
+>...
+>```
+
 ### select a directory
 
 Select files and sub directories in `home/user/data/2025/2025-05-09-Roskilde-Nordisk-udstilling`
@@ -1909,6 +1951,97 @@ gives something like
 
 ## Restoring
 
+### Point-in-Time Recovery (PITR)
+
+Use the `manager` CLI to restore files as they existed at a specific time:
+
+```bash
+. <the virtual env>/bin/activate
+manager --config-file <dar-backup.conf> \
+  --backup-def <definition> \
+  --restore-path tmp/path/to/file.txt \
+  --when "2026-01-29 15:00:39" \
+  --target /tmp/restore_pitr \
+  --log-stdout --verbose
+deactivate
+```
+
+Restore a directory (same idea, but the path is a directory):
+
+```bash
+. <the virtual env>/bin/activate
+manager --config-file <dar-backup.conf> \
+  --backup-def <definition> \
+  --restore-path tmp/path/to/directory/ \
+  --when "2026-01-29 15:00:39" \
+  --target /tmp/restore_pitr \
+  --log-stdout --verbose
+deactivate
+```
+
+Dry-run the archive chain selection before restoring:
+
+```bash
+. <the virtual env>/bin/activate
+manager --config-file <dar-backup.conf> \
+  --backup-def <definition> \
+  --restore-path tmp/path/to/directory \
+  --when "2026-01-29 15:00:39" \
+  --pitr-report \
+  --log-stdout --verbose
+deactivate
+```
+
+**Notes**:
+- `--restore-path` must be a relative path as stored in the catalog (no leading slash).
+- If a restore path is a **directory** and its name has no file extension, add a trailing `/` to make the intent explicit (e.g., `photos/2026/01/`). This avoids ambiguity with file paths that also lack extensions.
+  - Example (directory name has no extension):
+    - `manager --backup-def <definition> --restore-path "Automatic Upload/Per - iPhone/2026/01/" --when "now" --target /tmp/restore_pitr`
+- `--target` is required to avoid accidental restores into the current working directory.
+- Protected targets are blocked (e.g., `/etc`, `/usr`, `/bin`, `/var`, `/root`, `/boot`, `/lib`, `/proc`, `/sys`, `/dev`).
+- `--pitr-report` does a **dry-run** chain selection; if it reports missing archives, a restore will fail until the catalog is rebuilt or missing archives are restored.
+- `--pitr-report-first` runs the same chain report before a restore and aborts if any archive is missing (useful as a safety preflight).
+- `--when` accepts natural-language date expressions via `dateparser`. Examples:
+  - `"now"`
+  - `"2 weeks ago"`
+  - `"2025-10-05 14:30"`
+  - `yesterday 23:00`
+- PITR restores use the catalog to select the correct archive chain (FULL → DIFF → INCR) and then restore **directly with `dar`** in that order.
+  - This avoids interactive `dar_manager` prompts (e.g., non‑monotonic mtimes often seen on pCloud/FUSE).
+  - Directories can get a **new mtime** when files inside them are added/removed; the chain restore ensures the correct tree is rebuilt even if mtimes look “too new”.
+- Missing archives:
+  - PITR uses the latest FULL, the latest DIFF after that FULL, and the latest INCR after that DIFF.
+  - If any archive slice in that chain is missing on disk, PITR restore **fails** and logs which archive slices are missing.
+  - A short Discord notice is sent (if configured) so missing archives are visible immediately.
+- Relocating archive paths in the catalog:
+  - The catalog stores **absolute archive paths**. If archives move (or a mountpoint changes), the catalog will still point to the old path.
+  - This can happen when manager DBs are moved to another disk and the archives are re-added from a different mountpoint.
+  - Use the built-in relocate command to rewrite a path prefix in-place:
+    - Dry run:
+      - `manager --relocate-archive-path /old/path /new/path --relocate-archive-path-dry-run --backup-def <definition>`
+    - Apply:
+      - `manager --relocate-archive-path /old/path /new/path --backup-def <definition>`
+  - Example (move `/home/pj/mnt/dar` to `/mnt/dar`):
+    - `manager --relocate-archive-path /home/pj/mnt/dar /mnt/dar --backup-def pCloudDrive`
+  - Alternative quick fix: create a symlink from the old path to the new path.
+- Rebuilding a catalog after archive loss:
+  - If PITR fails due to missing archives, the catalog may no longer match what is actually on disk.
+  - You can rebuild the catalog from the remaining archives and then retry PITR (with the understanding that older restore points may no longer be possible).
+  - Example:
+    - `manager --create-db --config-file <dar-backup.conf>`
+    - `manager --add-dir <backup_dir> --backup-def <definition> --config-file <dar-backup.conf>`
+  - Or add individual archives:
+    - `manager --add-specific-archive <path/to/archive> --config-file <dar-backup.conf>`
+
+Example of the issue:
+1) FULL backup at 10:00 with `/data/photos/`  
+2) You add files at 11:00 (directory mtime updates)  
+3) DIFF backup at 11:05  
+4) You request PITR restore of `/data/photos/` at 10:30  
+
+`dar_manager -w` may say “directory did not exist before that time” because the directory mtime is now 11:00+.  
+The fallback still restores the correct tree as of 10:30 by applying the archive chain.
+
 ### default location for restores
 
 dar-backup will use the TEST_RESTORE_DIR location as the Root for restores, if the --restore-dir option has not been supplied.
@@ -2217,23 +2350,29 @@ In order to not clutter that log file with the output of commands being run, a n
 
 The secondary log file can get quite cluttered, if you want to remove the clutter, run the `clean-log`script with the `--file` option, or simply delete it.
 
-### Skipping cache directories
+### Trace Logging (Debug details)
 
-The author uses the `--cache-directory-tagging` option in his [backup definitions](#backup-definition-example).
+To keep the main log file clean while preserving essential debugging information, `dar-backup` creates a separate trace log file (e.g., `dar-backup.trace.log`) alongside the main log.
 
-The effect is that directories with the [CACHEDIR.TAG](https://bford.info/cachedir/) file are not backed up. Those directories contain content fetched from the net, which is of an ephemeral nature and probably not what you want to back up.
+- **Main Log (`dar-backup.log`)**: Contains clean, human-readable INFO/ERROR messages. Stack traces are suppressed here.
+- **Trace Log (`dar-backup.trace.log`)**: Captures ALL messages at `DEBUG` level, including full exception stack traces. Use this file for debugging crashes or unexpected behavior.
 
-If the option is not in the backup definition, the cache directories are backed up as any other.
+You can configure the rotation of this file in `[MISC]`:
 
-### Progress bar and current directory
+```ini
+[MISC]
+# ... other settings ...
+TRACE_LOG_MAX_BYTES = 10485760  # 10 MB default
+TRACE_LOG_BACKUP_COUNT = 1      # Keep 1 old trace file (default)
+```
 
-If you run dar-backup interactively in a "normal" console on your computer,
-dar-backup displays 2 visual artifacts to show progress.
+### Skipping cache directories
 
-1. a progress bar that fills up and starts over
-2. a status line showing the directory being backed up. If the directory is big and takes time to backup, the line is not changing, but you will probably know there is a lot to backup.
+The author uses the `--cache-directory-tagging` option in his [backup definitions](#backup-definition-example).
 
-The indicators are not shown if dar-backup is run from systemd or if it is used in terminal multiplexers like `tmux` or `screen`. So no polluting of journald logs.
+The effect is that directories with the [CACHEDIR.TAG](https://bford.info/cachedir/) file are not backed up. Those directories contain content fetched from the net, which is of an ephemeral nature and probably not what you want to back up.
+
+If the option is not in the backup definition, the cache directories are backed up as any other.
 
 ### Shell autocompletion
 
@@ -2418,7 +2557,6 @@ pytest                   # run the test suite
 
 - 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`
 
@@ -2453,40 +2591,135 @@ One backup definition per file
 | [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
+### Test coverage
+
+#### Test selection with markers
+
+The test suite is annotated with these markers:
+
+- `unit` (fast, pure logic)
+- `component` (subprocess boundary with mocks/lightweight commands)
+- `integration` (end-to-end workflows; external tools)
+- `slow` (long-running/heavier integration)
+- `live_discord` (sends real webhook messages; opt-in only)
+
+#### Common runs
+
+```bash
+# Fast local loop (unit + component)
+pytest -m "unit or component"
+
+# Integration (exclude slow + live webhook)
+pytest -m "integration and not slow and not live_discord"
+
+# Slow-only
+pytest -m slow
 
-Running
+# Full suite (default pytest.ini already excludes live_discord)
+pytest -m "not live_discord"
+
+# Live webhook (requires DAR_BACKUP_DISCORD_WEBHOOK_URL)
+pytest -m live_discord
+```
+
+#### Run all tests
 
 ```bash
-pytest --cov=dar_backup tests/
+pytest
 ```
 
-Results for version 1.0.0 in this report:
+Results for version 1.1.0 (pre-release, Feb 1, 2026) in this report:
 
 ```text
-====================================== tests coverage ======================================
-_____________________ coverage: platform linux, python 3.12.3-final-0 ______________________
+===================================== test session starts =====================================
+platform linux -- Python 3.12.3, pytest-8.4.0, pluggy-1.6.0
+rootdir: /home/pj/git/dar-backup/v2
+configfile: pytest.ini
+testpaths: tests
+plugins: anyio-4.9.0, timeout-2.4.0, cov-6.1.1, mock-3.15.1
+timeout: 1800.0s
+timeout method: signal
+timeout func_only: False
+collected 559 items / 1 deselected / 558 selected                                             
+
+tests/test_add_old_archive_confirmation.py ....                                         [  0%]
+tests/test_alternate_reference_archive.py ...                                           [  1%]
+tests/test_autocompletion_install.py ...                                                [  1%]
+tests/test_binary_info.py ......                                                        [  2%]
+tests/test_bitrot.py ..                                                                 [  3%]
+tests/test_clean_log.py ....................                                            [  6%]
+tests/test_cleanup.py ...............................                                   [ 12%]
+tests/test_command_runner.py .........................................                  [ 19%]
+tests/test_config_comments.py .                                                         [ 19%]
+tests/test_config_settings.py ..............                                            [ 22%]
+tests/test_create_backup_command.py ...                                                 [ 22%]
+tests/test_create_full_diff_incr_backup.py ..........                                   [ 24%]
+tests/test_dar_backup.py .......................................................        [ 34%]
+tests/test_dar_backup_additional_coverage.py .......................                    [ 38%]
+tests/test_dar_backup_startup.py ..                                                     [ 39%]
+tests/test_darrc.py ..                                                                  [ 39%]
+tests/test_demo.py .............                                                        [ 41%]
+tests/test_discord_webhook.py ..                                                        [ 42%]
+tests/test_filter_darrc_file.py .                                                       [ 42%]
+tests/test_generic_backup_command_execution.py .                                        [ 42%]
+tests/test_get_config_file.py .......                                                   [ 43%]
+tests/test_gpt_file_compression.py .                                                    [ 43%]
+tests/test_gpt_tests.py .......                                                         [ 45%]
+tests/test_installer.py ..................                                              [ 48%]
+tests/test_links.py .                                                                   [ 48%]
+tests/test_list_definitions.py .                                                        [ 48%]
+tests/test_listing.py ...                                                               [ 49%]
+tests/test_logging_trace.py ..                                                          [ 49%]
+tests/test_manager.py ................................................................. [ 61%]
+                                                                                        [ 61%]
+tests/test_manager_coverage.py ..................................                       [ 67%]
+tests/test_par2.py .                                                                    [ 67%]
+tests/test_par2_manifest.py .                                                           [ 67%]
+tests/test_par2_multi_definitions.py .                                                  [ 67%]
+tests/test_par2_overrides.py .                                                          [ 68%]
+tests/test_pitr.py ..............................................                       [ 76%]
+tests/test_pitr_integration.py .....                                                    [ 77%]
+tests/test_postreq.py .                                                                 [ 77%]
+tests/test_preflight.py ...                                                             [ 77%]
+tests/test_prereq.py .                                                                  [ 78%]
+tests/test_readme_changelog.py ..........                                               [ 79%]
+tests/test_restore.py ....                                                              [ 80%]
+tests/test_run_command.py ......s                                                       [ 81%]
+tests/test_sanity_checks.py .................                                           [ 84%]
+tests/test_space_definition.py .                                                        [ 85%]
+tests/test_startup_cleanup.py .......                                                   [ 86%]
+tests/test_status_indicators.py .......                                                 [ 87%]
+tests/test_stress.py .                                                                  [ 87%]
+tests/test_systemd_unit_generation.py ..........                                        [ 89%]
+tests/test_trace_logging.py ..                                                          [ 89%]
+tests/test_util.py ..........................................                           [ 97%]
+tests/test_util_completers.py ..........                                                [ 99%]
+tests/test_verbose.py ...                                                               [ 99%]
+tests/test_verify_cleanup.py .                                                          [100%]
+
+======================================= tests coverage ========================================
+_______________________ coverage: platform linux, python 3.12.3-final-0 _______________________
 
 Name                                   Stmts   Miss Branch BrPart  Cover
 ------------------------------------------------------------------------
-src/dar_backup/__about__.py                2      0      0      0   100%
+src/dar_backup/__about__.py                3      0      0      0   100%
 src/dar_backup/__init__.py                 0      0      0      0   100%
-src/dar_backup/clean_log.py               76     15     40      7    81%
-src/dar_backup/cleanup.py                203     16     66      7    91%
-src/dar_backup/command_runner.py         129     16     26      5    86%
-src/dar_backup/config_settings.py         73      3     18      1    96%
-src/dar_backup/dar_backup.py             551     28    180     21    93%
-src/dar_backup/dar_backup_systemd.py      56      7     10      2    86%
-src/dar_backup/demo.py                    92     20     26      6    75%
+src/dar_backup/clean_log.py              114     10     46      2    91%
+src/dar_backup/cleanup.py                294     42    100      9    87%
+src/dar_backup/command_runner.py         231     20     82     10    90%
+src/dar_backup/config_settings.py        162      9     62     10    92%
+src/dar_backup/dar_backup.py            1027     55    420     49    92%
+src/dar_backup/dar_backup_systemd.py      56      1     10      1    97%
+src/dar_backup/demo.py                   100      1     34      2    98%
 src/dar_backup/exceptions.py               2      0      0      0   100%
-src/dar_backup/installer.py              107     14     46      9    82%
-src/dar_backup/manager.py                427     42    152     15    90%
-src/dar_backup/rich_progress.py           70      7     30      4    89%
-src/dar_backup/util.py                   339     41     88     21    85%
+src/dar_backup/installer.py              120      4     54      4    95%
+src/dar_backup/manager.py               1105     91    454     38    91%
+src/dar_backup/rich_progress.py           70      2     30      3    95%
+src/dar_backup/util.py                   521     43    142     24    90%
 ------------------------------------------------------------------------
-TOTAL                                   2127    209    682     98    89%
-Coverage XML written to file coverage.xml
-======================== 257 passed, 1 skipped in 223.21s (0:03:43) ========================
+TOTAL                                   3805    278   1434    152    91%
+Coverage XML written to file /tmp/coverage.xml
+================== 557 passed, 1 skipped, 1 deselected in 409.66s (0:06:49) ===================
 ```
 
 ### Dar-backup options
@@ -2558,6 +2791,13 @@ Available options:
 -l, --list-catalogs                  List catalogs in databases for all backup definitions.
 --list-archive-contents <archive>    List the contents of an archive’s catalog by archive name.
 --find-file <file>                   Search catalogs for a specific file.
+--restore-path <path> [<path> ...]   Restore specific path(s) (Point-in-Time Recovery).
+--when <timestamp>                   Date/time for restoration (used with --restore-path).
+--target <path>                      Target directory for restoration (default: current dir).
+--pitr-report                        Report PITR archive chain for --restore-path/--when without restoring.
+--pitr-report-first                  Run PITR chain report before restore and abort if missing archives.
+--relocate-archive-path <old> <new>  Rewrite archive path prefix in the catalog DB (requires --backup-def).
+--relocate-archive-path-dry-run      Show archive path changes without applying them (use with --relocate-archive-path).
 --verbose                            Enable verbose output.
 --log-level <level>                  Set log level (`debug` or `trace`, default is `info`).
 
@@ -2754,10 +2994,48 @@ PAR2_RUN_VERIFY = true
 #
 #[etc]
 # Keep global PAR2 settings but tweak ratios for this backup definition
-# RATIO is i percent number
+# RATIO is given in percent (%)
 #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)
+
+#### 1.0.2
+
+##### Trace Logging
+
+To support debugging without cluttering the main log file, a secondary trace log is now created (e.g., `dar-backup.trace.log`).
+This file captures all `DEBUG` level messages and full exception stack traces.
+
+You can configure its rotation in the `[MISC]` section:
+
+- `TRACE_LOG_MAX_BYTES`: Max size of the trace log file in bytes. Default is `10485760` (10 MB).
+- `TRACE_LOG_BACKUP_COUNT`: Number of rotated trace log files to keep. Default is `1`.
+
+Example:
+
+```ini
+[MISC]
+TRACE_LOG_MAX_BYTES = 10485760
+TRACE_LOG_BACKUP_COUNT = 1
+```
+
+##### Command output Capture
+
+- New optional `[MISC]` setting: `COMMAND_CAPTURE_MAX_BYTES` (default 102400).
+  - Limits how much stdout/stderr is kept in memory per command while still logging full output.
+  - Set to `0` to disable buffering entirely. Command output is still streamed to dar-backup-commands.log
+  - If set to `0`, the calling function cannot rely on output from the executed command. The exit value is the only result provided.
+
+Example:
+
+```ini
+[MISC]
+COMMAND_CAPTURE_MAX_BYTES = 102400
+```
+
+#### 1.1.0
+
+COMMAND_TIMEOUT_SECS=-1 now disables timeout for commands executed.

dar_backup-1.1.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+dar_backup/.darrc,sha256=-aerqivZmOsW_XBCh9IfbYTUvw0GkzDSr3Vx4GcNB1g,2113
+dar_backup/__about__.py,sha256=DYQe7Z3Iqf23m_tT6w_2w8TNZxvVTYCEbt1HJwr0C4M,370
+dar_backup/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dar_backup/clean_log.py,sha256=Uf6MjpS_v1IVZdfx7ogRo6j5EIscdxjLImn8GKZo_rc,7038
+dar_backup/cleanup.py,sha256=Hds6q-3w5RAg69280JmofaoPtuSVLoOJTvTX_i8Veyw,19106
+dar_backup/command_runner.py,sha256=tqOwm-eaghS5jkwlwbaN1Wl9bO1WNlqk-zrIRdnp2Rs,15067
+dar_backup/config_settings.py,sha256=t3lFbYZ6XCnvKIU2EEpqJUW7OAz3rNb5iuCisW3D2mg,12698
+dar_backup/dar-backup.conf,sha256=ejucmhEbSdqFU4JEVfrWbFj9H6U87TWSnhex3LraEUY,2124
+dar_backup/dar-backup.conf.j2,sha256=kD13msmP2IXLjnJ9lZmqtLTnsUZq1EkPZAI1LlOkYXo,3852
+dar_backup/dar_backup.py,sha256=ai4miv7S3W2sE5NwN6A-OaHifp2wRvJyMbGcYKPngXM,71183
+dar_backup/dar_backup_systemd.py,sha256=BWy5tvjq4Gex1YleQhQH57b_nFhSVhKUF_cLvSlDMkw,3874
+dar_backup/demo.py,sha256=DONTzskD5lq6CSeHQUf_kOQ5ntekn6t-keOszgtUocI,8228
+dar_backup/demo_backup_def.j2,sha256=hQW2Glp0QGV3Kt8cwjS0mpOCdyzjVlpgbgL6LpXTKJA,1793
+dar_backup/exceptions.py,sha256=dBQwgKUilgfb1Tnlm_m1Dl1IqoY75L0n1uRkm0DBVTk,158
+dar_backup/installer.py,sha256=yJ0xXi24C1Vo6gnj2BlhV1X55ZIG5t21t8tNKTYSclM,7616
+dar_backup/manager.py,sha256=g-EzgAZiDLgDPmpLi30Ss5gkKytiLTx-WiN4R4cKHuM,65924
+dar_backup/rich_progress.py,sha256=SfwFxebBl6jnDQMUQr4McknkW1yQWaJVo1Ju1OD3okA,3221
+dar_backup/util.py,sha256=pq-SIAI_Tt4C9LiFfHxwTWmSAAkhgdE5QtS4IgYjqdY,38594
+dar_backup-1.1.0.dist-info/METADATA,sha256=-reQRtVee46ypbaT8Rhm5icV29y74GficyFzh7GVqr8,133833
+dar_backup-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+dar_backup-1.1.0.dist-info/entry_points.txt,sha256=pOK9M8cHeAcGIatrYzkm_1O89kPk0enyYONALYjFBx4,286
+dar_backup-1.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+dar_backup-1.1.0.dist-info/RECORD,,