dar-backup 1.0.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

dar_backup/Changelog.md

@@ -1,6 +1,69 @@
 <!-- markdownlint-disable MD024 -->
 # dar-backup Changelog
 
+## v2-1.0.2 - 2026-01-25
+
+### Added
+
+- Streaming restore-test sampling using reservoir sampling to avoid holding full file lists in memory.
+- Configurable command output capture cap (`COMMAND_CAPTURE_MAX_BYTES`, default 100 KB) to limit in-memory stdout/stderr while still logging full output.
+- Streaming list output for `dar-backup --list-contents` and `manager --list-archive-contents` to avoid large in-memory buffers.
+- Test coverage additions for config parsing, util helpers, restore-test sampling edge cases, par2 slice helpers, and get_backed_up_files error paths.
+- Tests for missing source files during restore verification and for par2 generation order after verification.
+- CommandRunner test coverage for sanitize failure notes, text/binary output handling, timeouts, Popen failures, and TTY restore logic.
+- Tests for COMMAND_CAPTURE_MAX_BYTES defaults (0 and 1k) and binary stdout/stderr capture with truncation and log_output disabled.
+- Manager test coverage for create-db guardrails and catalog listing parsing/sorting across runner/subprocess paths.
+- Cleanup now reports PREREQ/POSTREQ failures cleanly and sends Discord failure notifications when configured.
+- New trace logger that always logs at DEBUG and captures stacktraces if they happens. Default max size is 10MB + 1 rollover file.
+
+### Changed
+
+- BUGFIX: Ensure existing files are removed before restore verification to prevent false positives.
+- Clears out restore-test directory on program start to ensure a clean slate.
+- Restore-test selection now streams DAR XML listings and samples candidates without loading all entries into RAM.
+- `get_backed_up_files` uses incremental XML parsing to reduce memory use for large archives.
+- Restore verification now logs a warning and continues when a source or restored file is missing during comparison.
+- CommandRunner supports per-command capture cap overrides (disable cap with `capture_output_limit_bytes=-1`).
+- Cleanup now rejects unsafe archive names when `--cleanup-specific-archives` is used to prevent accidental deletions.
+- Removed deprecated PAR2 layout/mode settings and simplified PAR2 cleanup to delete all matching .par2 artifacts.
+- Config templates/docs updated to drop PAR2_LAYOUT/PAR2_MODE references.
+- [Snyk] Python 3.11 required in pyproject.toml. Snyk has flagged a vulnerabilly in an xml parser that requires the bump to 3.11.
+- Config parsing errors now emit concise messages (no stack trace) and trigger Discord failure notifications in CLI tools.
+
+## 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 +427,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 -->