NEWS 72 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324
  1. 1.8.10
  2. * #656 (beta): Add a "spot" consistency check that compares file counts and contents between your
  3. source files and the latest archive, ensuring they fall within configured tolerances. This can
  4. catch problems like incorrect excludes, inadvertent deletes, files changed by malware, etc. See
  5. the documentation for more information:
  6. https://torsion.org/borgmatic/docs/how-to/deal-with-very-large-backups/#spot-check
  7. * #779: When "--match-archives *" is used with "check" action, don't skip Borg's orphaned objects
  8. check.
  9. * #842: When a command hook exits with a soft failure, ping the log and finish states for any
  10. configured monitoring hooks.
  11. * #843: Add documentation link to Loki dashboard for borgmatic:
  12. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#loki-hook
  13. * #847: Fix "--json" error when Borg includes non-JSON warnings in JSON output.
  14. * #848: SECURITY: Mask the password when logging a MongoDB dump or restore command.
  15. * Fix handling of the NO_COLOR environment variable to ignore an empty value.
  16. * Add documentation about backing up containerized databases by configuring borgmatic to exec into
  17. a container to run a dump command:
  18. https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#containers
  19. 1.8.9
  20. * #311: Add custom dump/restore command options for MySQL and MariaDB.
  21. * #811: Add an "access_token" option to the ntfy monitoring hook for authenticating
  22. without username/password.
  23. * #827: When the "--json" flag is given, suppress console escape codes so as not to
  24. interfere with JSON output.
  25. * #829: Fix "--override" values containing deprecated section headers not actually overriding
  26. configuration options under deprecated section headers.
  27. * #835: Add support for the NO_COLOR environment variable. See the documentation for more
  28. information:
  29. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#colored-output
  30. * #839: Add log sending for the Apprise logging hook, enabled by default. See the documentation for
  31. more information:
  32. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#apprise-hook
  33. * #839: Document a potentially breaking shell quoting edge case within error hooks:
  34. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#error-hooks
  35. * #840: When running the "rcreate" action and the repository already exists but with a different
  36. encryption mode than requested, error.
  37. * Switch from Drone to Gitea Actions for continuous integration.
  38. * Rename scripts/run-end-to-end-dev-tests to scripts/run-end-to-end-tests and use it in both dev
  39. and CI for better dev-CI parity.
  40. * Clarify documentation about restoring a database: borgmatic does not create the database upon
  41. restore.
  42. 1.8.8
  43. * #370: For the PostgreSQL hook, pass the "PGSSLMODE" environment variable through to Borg when the
  44. database's configuration omits the "ssl_mode" option.
  45. * #818: Allow the "--repository" flag to match across multiple configuration files.
  46. * #820: Fix broken repository detection in the "rcreate" action with Borg 1.4. The issue did not
  47. occur with other versions of Borg.
  48. * #822: Fix broken escaping logic in the PostgreSQL hook's "pg_dump_command" option.
  49. * SECURITY: Prevent additional shell injection attacks within the PostgreSQL hook.
  50. 1.8.7
  51. * #736: Store included configuration files within each backup archive in support of the "config
  52. bootstrap" action. Previously, only top-level configuration files were stored.
  53. * #798: Elevate specific Borg warnings to errors or squash errors to
  54. * warnings. See the documentation for more information:
  55. https://torsion.org/borgmatic/docs/how-to/customize-warnings-and-errors/
  56. * #810: SECURITY: Prevent shell injection attacks within the PostgreSQL hook, the MongoDB hook, the
  57. SQLite hook, the "borgmatic borg" action, and command hook variable/constant interpolation.
  58. * #814: Fix a traceback when providing an invalid "--override" value for a list option.
  59. 1.8.6
  60. * #767: Add an "--ssh-command" flag to the "config bootstrap" action for setting a custom SSH
  61. command, as no configuration is available (including the "ssh_command" option) until
  62. bootstrapping completes.
  63. * #794: Fix a traceback when the "repositories" option contains both strings and key/value pairs.
  64. * #800: Add configured repository labels to the JSON output for all actions.
  65. * #802: The "check --force" flag now runs checks even if "check" is in "skip_actions".
  66. * #804: Validate the configured action names in the "skip_actions" option.
  67. * #807: Stream SQLite databases directly to Borg instead of dumping to an intermediate file.
  68. * When logging commands that borgmatic executes, log the environment variables that
  69. borgmatic sets for those commands. (But don't log their values, since they often contain
  70. passwords.)
  71. 1.8.5
  72. * #701: Add a "skip_actions" option to skip running particular actions, handy for append-only or
  73. checkless configurations. See the documentation for more information:
  74. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#skipping-actions
  75. * #701: Deprecate the "disabled" value for the "checks" option in favor of the new "skip_actions"
  76. option.
  77. * #745: Constants now apply to included configuration, not just the file doing the includes. As a
  78. side effect of this change, constants no longer apply to option names and only substitute into
  79. configuration values.
  80. * #779: Add a "--match-archives" flag to the "check" action for selecting the archives to check,
  81. overriding the existing "archive_name_format" and "match_archives" options in configuration.
  82. * #779: Only parse "--override" values as complex data types when they're for options of those
  83. types.
  84. * #782: Fix environment variable interpolation within configured repository paths.
  85. * #782: Add configuration constant overriding via the existing "--override" flag.
  86. * #783: Upgrade ruamel.yaml dependency to support version 0.18.x.
  87. * #784: Drop support for Python 3.7, which has been end-of-lifed.
  88. 1.8.4
  89. * #715: Add a monitoring hook for sending backup status to a variety of monitoring services via the
  90. Apprise library. See the documentation for more information:
  91. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#apprise-hook
  92. * #748: When an archive filter causes no matching archives for the "rlist" or "info"
  93. actions, warn the user and suggest how to remove the filter.
  94. * #768: Fix a traceback when an invalid command-line flag or action is used.
  95. * #771: Fix normalization of deprecated sections ("location:", "storage:", "hooks:", etc.) to
  96. support empty sections without erroring.
  97. * #774: Disallow the "--dry-run" flag with the "borg" action, as borgmatic can't guarantee the Borg
  98. command won't have side effects.
  99. 1.8.3
  100. * #665: BREAKING: Simplify logging logic as follows: Syslog verbosity is now disabled by
  101. default, but setting the "--syslog-verbosity" flag enables it regardless of whether you're at an
  102. interactive console. Additionally, "--log-file-verbosity" and "--monitoring-verbosity" now
  103. default to 1 (info about steps borgmatic is taking) instead of 0. And both syslog logging and
  104. file logging can be enabled simultaneously.
  105. * #743: Add a monitoring hook for sending backup status and logs to Grafana Loki. See the
  106. documentation for more information:
  107. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#loki-hook
  108. * #753: When "archive_name_format" is not set, filter archives using the default archive name
  109. format.
  110. * #754: Fix error handling to log command output as one record per line instead of truncating
  111. too-long output and swallowing the end of some Borg error messages.
  112. * #757: Update documentation so "sudo borgmatic" works for pipx borgmatic installations.
  113. * #761: Fix for borgmatic not stopping Borg immediately when the user presses ctrl-C.
  114. * Update documentation to recommend installing/upgrading borgmatic with pipx instead of pip. See the
  115. documentation for more information:
  116. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#installation
  117. https://torsion.org/borgmatic/docs/how-to/upgrade/#upgrading-borgmatic
  118. 1.8.2
  119. * #345: Add "key export" action to export a copy of the repository key for safekeeping in case
  120. the original goes missing or gets damaged.
  121. * #727: Add a MariaDB database hook that uses native MariaDB commands instead of the deprecated
  122. MySQL ones. Be aware though that any existing backups made with the "mysql_databases:" hook are
  123. only restorable with a "mysql_databases:" configuration.
  124. * #738: Fix for potential data loss (data not getting restored) in which the database "restore"
  125. action didn't actually restore anything and indicated success anyway.
  126. * Remove the deprecated use of the MongoDB hook's "--db" flag for database restoration.
  127. * Add source code reference documentation for getting oriented with the borgmatic code as a
  128. developer: https://torsion.org/borgmatic/docs/reference/source-code/
  129. 1.8.1
  130. * #326: Add documentation for restoring a database to an alternate host:
  131. https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#restore-to-an-alternate-host
  132. * #697: Add documentation for "bootstrap" action:
  133. https://torsion.org/borgmatic/docs/how-to/extract-a-backup/#extract-the-configuration-files-used-to-create-an-archive
  134. * #725: Add "store_config_files" option for disabling the automatic backup of configuration files
  135. used by the "config bootstrap" action.
  136. * #728: Fix for "prune" action error when using the "keep_exclude_tags" option.
  137. * #730: Fix for Borg's interactive prompt on the "check --repair" action automatically getting
  138. answered "NO" even when the "check_i_know_what_i_am_doing" option isn't set.
  139. * #732: Include multiple configuration files with a single "!include". See the documentation for
  140. more information:
  141. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#multiple-merge-includes
  142. * #734: Omit "--glob-archives" or "--match-archives" Borg flag when its value would be "*" (meaning
  143. all archives).
  144. 1.8.0
  145. * #575: BREAKING: For the "borgmatic borg" action, instead of implicitly injecting
  146. repository/archive into the resulting Borg command-line, pass repository to Borg via an
  147. environment variable and make archive available for explicit use in your commands. See the
  148. documentation for more information:
  149. https://torsion.org/borgmatic/docs/how-to/run-arbitrary-borg-commands/
  150. * #719: Fix an error when running "borg key export" through borgmatic.
  151. * #720: Fix an error when dumping a database and the "exclude_nodump" option is set.
  152. * #724: Add "check_i_know_what_i_am_doing" option to bypass Borg confirmation prompt when running
  153. "check --repair".
  154. * When merging two configuration files, error gracefully if the two files do not adhere to the same
  155. format.
  156. * #721: Remove configuration sections ("location:", "storage:", "hooks:", etc.), while still
  157. keeping deprecated support for them. Now, all options are at the same level, and you don't need
  158. to worry about commenting/uncommenting section headers when you change an option (if you remove
  159. your sections first).
  160. * #721: BREAKING: The retention prefix and the consistency prefix can no longer have different
  161. values (unless one is not set).
  162. * #721: BREAKING: The storage umask and the hooks umask can no longer have different values (unless
  163. one is not set).
  164. * BREAKING: Flags like "--config" that previously took multiple values now need to be given once
  165. per value, e.g. "--config first.yaml --config second.yaml" instead of "--config first.yaml
  166. second.yaml". This prevents argument parsing errors on ambiguous commands.
  167. * BREAKING: Remove the deprecated (and silently ignored) "--successful" flag on the "list" action,
  168. as newer versions of Borg list successful (non-checkpoint) archives by default.
  169. * All deprecated configuration option values now generate warning logs.
  170. * Remove the deprecated (and non-functional) "--excludes" flag in favor of excludes within
  171. configuration.
  172. * Fix an error when logging too-long command output during error handling. Now, long command output
  173. is truncated before logging.
  174. 1.7.15
  175. * #326: Add configuration options and command-line flags for backing up a database from one
  176. location while restoring it somewhere else.
  177. * #399: Add a documentation troubleshooting note for MySQL/MariaDB authentication errors.
  178. * #529: Remove upgrade-borgmatic-config command for upgrading borgmatic 1.1.0 INI-style
  179. configuration.
  180. * #529: Deprecate generate-borgmatic-config in favor of new "config generate" action.
  181. * #529: Deprecate validate-borgmatic-config in favor of new "config validate" action.
  182. * #697, #712, #716: Extract borgmatic configuration from backup via new "config bootstrap"
  183. action—even when borgmatic has no configuration yet!
  184. * #669: Add sample systemd user service for running borgmatic as a non-root user.
  185. * #711, #713: Fix an error when "data" check time files are accessed without getting upgraded
  186. first.
  187. 1.7.14
  188. * #484: Add a new verbosity level (-2) to disable output entirely (for console, syslog, log file,
  189. or monitoring), so not even errors are shown.
  190. * #688: Tweak archive check probing logic to use the newest timestamp found when multiple exist.
  191. * #659: Add Borg 2 date-based matching flags to various actions for archive selection.
  192. * #703: Fix an error when loading the configuration schema on Fedora Linux.
  193. * #704: Fix "check" action error when repository and archive checks are configured but the archive
  194. check gets skipped due to the configured frequency.
  195. * #706: Fix "--archive latest" on "list" and "info" actions that only worked on the first of
  196. multiple configured repositories.
  197. 1.7.13
  198. * #375: Restore particular PostgreSQL schemas from a database dump via "borgmatic restore --schema"
  199. flag. See the documentation for more information:
  200. https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#restore-particular-schemas
  201. * #678: Fix error from PostgreSQL when dumping a database with a "format" of "plain".
  202. * #678: Fix PostgreSQL hook to support "psql_command" and "pg_restore_command" options containing
  203. commands with arguments.
  204. * #678: Fix calls to psql in PostgreSQL hook to ignore "~/.psqlrc", whose settings can break
  205. database dumping.
  206. * #680: Add support for logging each log line as a JSON object via global "--log-json" flag.
  207. * #682: Fix "source_directories_must_exist" option to expand globs and tildes in source directories.
  208. * #684: Rename "master" development branch to "main" to use more inclusive language. You'll need to
  209. update your development checkouts accordingly.
  210. * #686: Add fish shell completion script so you can tab-complete on the borgmatic command-line. See
  211. the documentation for more information:
  212. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#shell-completion
  213. * #687: Fix borgmatic error when not finding the configuration schema for certain "pip install
  214. --editable" development installs.
  215. * #688: Fix archive checks being skipped even when particular archives haven't been checked
  216. recently. This occurred when using multiple borgmatic configuration files with different
  217. "archive_name_format"s, for instance.
  218. * #691: Fix error in "borgmatic restore" action when the configured repository path is relative
  219. instead of absolute.
  220. * #694: Run "borgmatic borg" action without capturing output so interactive prompts and flags like
  221. "--progress" still work.
  222. 1.7.12
  223. * #413: Add "log_file" context to command hooks so your scripts can consume the borgmatic log file.
  224. See the documentation for more information:
  225. https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
  226. * #666, #670: Fix error when running the "info" action with the "--match-archives" or "--archive"
  227. flags. Also fix the "--match-archives"/"--archive" flags to correctly override the
  228. "match_archives" configuration option for the "transfer", "list", "rlist", and "info" actions.
  229. * #668: Fix error when running the "prune" action with both "archive_name_format" and "prefix"
  230. options set.
  231. * #672: Selectively shallow merge certain mappings or sequences when including configuration files.
  232. See the documentation for more information:
  233. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#shallow-merge
  234. * #672: Selectively omit list values when including configuration files. See the documentation for
  235. more information:
  236. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#list-merge
  237. * #673: View the results of configuration file merging via "validate-borgmatic-config --show" flag.
  238. See the documentation for more information:
  239. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#debugging-includes
  240. * Add optional support for running end-to-end tests and building documentation with rootless Podman
  241. instead of Docker.
  242. 1.7.11
  243. * #479, #588: BREAKING: Automatically use the "archive_name_format" option to filter which archives
  244. get used for borgmatic actions that operate on multiple archives. Override this behavior with the
  245. new "match_archives" option in the storage section. This change is "breaking" in that it silently
  246. changes which archives get considered for "rlist", "prune", "check", etc. See the documentation
  247. for more information:
  248. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#archive-naming
  249. * #479, #588: The "prefix" options have been deprecated in favor of the new "archive_name_format"
  250. auto-matching behavior and the "match_archives" option.
  251. * #658: Add "--log-file-format" flag for customizing the log message format. See the documentation
  252. for more information:
  253. https://torsion.org/borgmatic/docs/how-to/inspect-your-backups/#logging-to-file
  254. * #662: Fix regression in which the "check_repositories" option failed to match repositories.
  255. * #663: Fix regression in which the "transfer" action produced a traceback.
  256. * Add spellchecking of source code during test runs.
  257. 1.7.10
  258. * #396: When a database command errors, display and log the error message instead of swallowing it.
  259. * #501: Optionally error if a source directory does not exist via "source_directories_must_exist"
  260. option in borgmatic's location configuration.
  261. * #576: Add support for "file://" paths within "repositories" option.
  262. * #612: Define and use custom constants in borgmatic configuration files. See the documentation for
  263. more information:
  264. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#constant-interpolation
  265. * #618: Add support for BORG_FILES_CACHE_TTL environment variable via "borg_files_cache_ttl" option
  266. in borgmatic's storage configuration.
  267. * #623: Fix confusing message when an error occurs running actions for a configuration file.
  268. * #635: Add optional repository labels so you can select a repository via "--repository yourlabel"
  269. at the command-line. See the configuration reference for more information:
  270. https://torsion.org/borgmatic/docs/reference/configuration/
  271. * #649: Add documentation on backing up a database running in a container:
  272. https://torsion.org/borgmatic/docs/how-to/backup-your-databases/#containers
  273. * #655: Fix error when databases are configured and a source directory doesn't exist.
  274. * Add code style plugins to enforce use of Python f-strings and prevent single-letter variables.
  275. To join in the pedantry, refresh your test environment with "tox --recreate".
  276. * Rename scripts/run-full-dev-tests to scripts/run-end-to-end-dev-tests and make it run end-to-end
  277. tests only. Continue using tox to run unit and integration tests.
  278. 1.7.9
  279. * #295: Add a SQLite database dump/restore hook.
  280. * #304: Change the default action order when no actions are specified on the command-line to:
  281. "create", "prune", "compact", "check". If you'd like to retain the old ordering ("prune" and
  282. "compact" first), then specify actions explicitly on the command-line.
  283. * #304: Run any command-line actions in the order specified instead of using a fixed ordering.
  284. * #564: Add "--repository" flag to all actions where it makes sense, so you can run borgmatic on
  285. a single configured repository instead of all of them.
  286. * #628: Add a Healthchecks "log" state to send borgmatic logs to Healthchecks without signalling
  287. success or failure.
  288. * #647: Add "--strip-components all" feature on the "extract" action to remove leading path
  289. components of files you extract. Must be used with the "--path" flag.
  290. * Add support for Python 3.11.
  291. 1.7.8
  292. * #620: With the "create" action and the "--list" ("--files") flag, only show excluded files at
  293. verbosity 2.
  294. * #621: Add optional authentication to the ntfy monitoring hook.
  295. * With the "create" action, only one of "--list" ("--files") and "--progress" flags can be used.
  296. This lines up with the new behavior in Borg 2.0.0b5.
  297. * Internally support new Borg 2.0.0b5 "--filter" status characters / item flags for the "create"
  298. action.
  299. * Fix the "create" action with the "--dry-run" flag querying for databases when a PostgreSQL/MySQL
  300. "all" database is configured. Now, these queries are skipped due to the dry run.
  301. * Add "--repository" flag to the "rcreate" action to optionally select one configured repository to
  302. create.
  303. * Add "--progress" flag to the "transfer" action, new in Borg 2.0.0b5.
  304. * Add "checkpoint_volume" configuration option to creates checkpoints every specified number of
  305. bytes during a long-running backup, new in Borg 2.0.0b5.
  306. 1.7.7
  307. * #642: Add MySQL database hook "add_drop_database" configuration option to control whether dumped
  308. MySQL databases get dropped right before restore.
  309. * #643: Fix for potential data loss (data not getting backed up) when dumping large "directory"
  310. format PostgreSQL/MongoDB databases. Prior to the fix, these dumps would not finish writing to
  311. disk before Borg consumed them. Now, the dumping process completes before Borg starts. This only
  312. applies to "directory" format databases; other formats still stream to Borg without using
  313. temporary disk space.
  314. * Fix MongoDB "directory" format to work with mongodump/mongorestore without error. Prior to this
  315. fix, only the "archive" format worked.
  316. 1.7.6
  317. * #393, #438, #560: Optionally dump "all" PostgreSQL/MySQL databases to separate files instead of
  318. one combined dump file, allowing more convenient restores of individual databases. You can enable
  319. this by specifying the database dump "format" option when the database is named "all".
  320. * #602: Fix logs that interfere with JSON output by making warnings go to stderr instead of stdout.
  321. * #622: Fix traceback when include merging configuration files on ARM64.
  322. * #629: Skip warning about excluded special files when no special files have been excluded.
  323. * #630: Add configuration options for database command customization: "list_options",
  324. "restore_options", and "analyze_options" for PostgreSQL, "restore_options" for MySQL, and
  325. "restore_options" for MongoDB.
  326. 1.7.5
  327. * #311: Override PostgreSQL dump/restore commands via configuration options.
  328. * #604: Fix traceback when a configuration section is present but lacking any options.
  329. * #607: Clarify documentation examples for include merging and deep merging.
  330. * #611: Fix "data" consistency check to support "check_last" and consistency "prefix" options.
  331. * #613: Clarify documentation about multiple repositories and separate configuration files.
  332. 1.7.4
  333. * #596: Fix special file detection erroring when broken symlinks are encountered.
  334. * #597, #598: Fix regression in which "check" action errored on certain systems ("Cannot determine
  335. Borg repository ID").
  336. 1.7.3
  337. * #357: Add "break-lock" action for removing any repository and cache locks leftover from Borg
  338. aborting.
  339. * #360: To prevent Borg hangs, unconditionally delete stale named pipes before dumping databases.
  340. * #587: When database hooks are enabled, auto-exclude special files from a "create" action to
  341. prevent Borg from hanging. You can override/prevent this behavior by explicitly setting the
  342. "read_special" option to true.
  343. * #587: Warn when ignoring a configured "read_special" value of false, as true is needed when
  344. database hooks are enabled.
  345. * #589: Update sample systemd service file to allow system "idle" (e.g. a video monitor turning
  346. off) while borgmatic is running.
  347. * #590: Fix for potential data loss (data not getting backed up) when the "patterns_from" option
  348. was used with "source_directories" (or the "~/.borgmatic" path existed, which got injected into
  349. "source_directories" implicitly). The fix is for borgmatic to convert "source_directories" into
  350. patterns whenever "patterns_from" is used, working around a Borg bug:
  351. https://github.com/borgbackup/borg/issues/6994
  352. * #590: In "borgmatic create --list" output, display which files get excluded from the backup due
  353. to patterns or excludes.
  354. * #591: Add support for Borg 2's "--match-archives" flag. This replaces "--glob-archives", which
  355. borgmatic now treats as an alias for "--match-archives". But note that the two flags have
  356. slightly different syntax. See the Borg 2 changelog for more information:
  357. https://borgbackup.readthedocs.io/en/2.0.0b3/changes.html#version-2-0-0b3-2022-10-02
  358. * Fix for "borgmatic --archive latest" not finding the latest archive when a verbosity is set.
  359. 1.7.2
  360. * #577: Fix regression in which "borgmatic info --archive ..." showed repository info instead of
  361. archive info with Borg 1.
  362. * #582: Fix hang when database hooks are enabled and "patterns" contains a parent directory of
  363. "~/.borgmatic".
  364. 1.7.1
  365. * #542: Make the "source_directories" option optional. This is useful for "check"-only setups or
  366. using "patterns" exclusively.
  367. * #574: Fix for potential data loss (data not getting backed up) when the "patterns" option was
  368. used with "source_directories" (or the "~/.borgmatic" path existed, which got injected into
  369. "source_directories" implicitly). The fix is for borgmatic to convert "source_directories" into
  370. patterns whenever "patterns" is used, working around a Borg bug:
  371. https://github.com/borgbackup/borg/issues/6994
  372. 1.7.0
  373. * #463: Add "before_actions" and "after_actions" command hooks that run before/after all the
  374. actions for each repository. These new hooks are a good place to run per-repository steps like
  375. mounting/unmounting a remote filesystem.
  376. * #463: Update documentation to cover per-repository configurations:
  377. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/
  378. * #557: Support for Borg 2 while still working with Borg 1. This includes new borgmatic actions
  379. like "rcreate" (replaces "init"), "rlist" (list archives in repository), "rinfo" (show repository
  380. info), and "transfer" (for upgrading Borg repositories). For the most part, borgmatic tries to
  381. smooth over differences between Borg 1 and 2 to make your upgrade process easier. However, there
  382. are still a few cases where Borg made breaking changes. See the Borg 2.0 changelog for more
  383. information: https://www.borgbackup.org/releases/borg-2.0.html
  384. * #557: If you install Borg 2, you'll need to manually upgrade your existing Borg 1 repositories
  385. before use. Note that Borg 2 stable is not yet released as of this borgmatic release, so don't
  386. use Borg 2 for production until it is! See the documentation for more information:
  387. https://torsion.org/borgmatic/docs/how-to/upgrade/#upgrading-borg
  388. * #557: Rename several configuration options to match Borg 2: "remote_rate_limit" is now
  389. "upload_rate_limit", "numeric_owner" is "numeric_ids", and "bsd_flags" is "flags". borgmatic
  390. still works with the old options.
  391. * #557: Remote repository paths without the "ssh://" syntax are deprecated but still supported for
  392. now. Remote repository paths containing "~" are deprecated in borgmatic and no longer work in
  393. Borg 2.
  394. * #557: Omitting the "--archive" flag on the "list" action is deprecated when using Borg 2. Use
  395. the new "rlist" action instead.
  396. * #557: The "--dry-run" flag can now be used with the "rcreate"/"init" action.
  397. * #565: Fix handling of "repository" and "data" consistency checks to prevent invalid Borg flags.
  398. * #566: Modify "mount" and "extract" actions to require the "--repository" flag when multiple
  399. repositories are configured.
  400. * #571: BREAKING: Remove old-style command-line action flags like "--create, "--list", etc. If
  401. you're already using actions like "create" and "list" instead, this change should not affect you.
  402. * #571: BREAKING: Rename "--files" flag on "prune" action to "--list", as it lists archives, not
  403. files.
  404. * #571: Add "--list" as alias for "--files" flag on "create" and "export-tar" actions.
  405. * Add support for disabling TLS verification in Healthchecks monitoring hook with "verify_tls"
  406. option.
  407. 1.6.6
  408. * #559: Update documentation about configuring multiple consistency checks or multiple databases.
  409. * #560: Fix all database hooks to error when the requested database to restore isn't present in the
  410. Borg archive.
  411. * #561: Fix command-line "--override" flag to continue supporting old configuration file formats.
  412. * #563: Fix traceback with "create" action and "--json" flag when a database hook is configured.
  413. 1.6.5
  414. * #553: Fix logging to include the full traceback when Borg experiences an internal error, not just
  415. the first few lines.
  416. * #554: Fix all monitoring hooks to warn if the server returns an HTTP 4xx error. This can happen
  417. with Healthchecks, for instance, when using an invalid ping URL.
  418. * #555: Fix environment variable plumbing so options like "encryption_passphrase" and
  419. "encryption_passcommand" in one configuration file aren't used for other configuration files.
  420. 1.6.4
  421. * #546, #382: Keep your repository passphrases and database passwords outside of borgmatic's
  422. configuration file with environment variable interpolation. See the documentation for more
  423. information: https://torsion.org/borgmatic/docs/how-to/provide-your-passwords/
  424. 1.6.3
  425. * #541: Add "borgmatic list --find" flag for searching for files across multiple archives, useful
  426. for hunting down that file you accidentally deleted so you can extract it. See the documentation
  427. for more information:
  428. https://torsion.org/borgmatic/docs/how-to/inspect-your-backups/#searching-for-a-file
  429. * #543: Add a monitoring hook for sending push notifications via ntfy. See the documentation for
  430. more information: https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#ntfy-hook
  431. * Fix Bash completion script to no longer alter your shell's settings (complain about unset
  432. variables or error on pipe failures).
  433. * Deprecate "borgmatic list --successful" flag, as listing only non-checkpoint (successful)
  434. archives is now the default in newer versions of Borg.
  435. 1.6.2
  436. * #523: Reduce the default consistency check frequency and support configuring the frequency
  437. independently for each check. Also add "borgmatic check --force" flag to ignore configured
  438. frequencies. See the documentation for more information:
  439. https://torsion.org/borgmatic/docs/how-to/deal-with-very-large-backups/#check-frequency
  440. * #536: Fix generate-borgmatic-config to support more complex schema changes like the new
  441. Healthchecks configuration options when the "--source" flag is used.
  442. * #538: Add support for "borgmatic borg debug" command.
  443. * #539: Add "generate-borgmatic-config --overwrite" flag to replace an existing destination file.
  444. * Add Bash completion script so you can tab-complete the borgmatic command-line. See the
  445. documentation for more information:
  446. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#shell-completion
  447. 1.6.1
  448. * #294: Add Healthchecks monitoring hook "ping_body_limit" option to configure how many bytes of
  449. logs to send to the Healthchecks server.
  450. * #402: Remove the error when "archive_name_format" is specified but a retention prefix isn't.
  451. * #420: Warn when an unsupported variable is used in a hook command.
  452. * #439: Change connection failures for monitoring hooks (Healthchecks, Cronitor, PagerDuty, and
  453. Cronhub) to be warnings instead of errors. This way, the monitoring system failing does not block
  454. backups.
  455. * #460: Add Healthchecks monitoring hook "send_logs" option to enable/disable sending borgmatic
  456. logs to the Healthchecks server.
  457. * #525: Add Healthchecks monitoring hook "states" option to only enable pinging for particular
  458. monitoring states (start, finish, fail).
  459. * #528: Improve the error message when a configuration override contains an invalid value.
  460. * #531: BREAKING: When deep merging common configuration, merge colliding list values by appending
  461. them. Previously, one list replaced the other.
  462. * #532: When a configuration include is a relative path, load it from either the current working
  463. directory or from the directory containing the file doing the including. Previously, only the
  464. working directory was used.
  465. * Add a randomized delay to the sample systemd timer to spread out the load on a server.
  466. * Change the configuration format for borgmatic monitoring hooks (Healthchecks, Cronitor,
  467. PagerDuty, and Cronhub) to specify the ping URL / integration key as a named option. The intent
  468. is to support additional options (some in this release). This change is backwards-compatible.
  469. * Add emojis to documentation table of contents to make it easier to find particular how-to and
  470. reference guides at a glance.
  471. 1.6.0
  472. * #381: BREAKING: Greatly simplify configuration file reuse by deep merging when including common
  473. configuration. See the documentation for more information:
  474. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#include-merging
  475. * #473: BREAKING: Instead of executing "before" command hooks before all borgmatic actions run (and
  476. "after" hooks after), execute these hooks right before/after the corresponding action. E.g.,
  477. "before_check" now runs immediately before the "check" action. This better supports running
  478. timing-sensitive tasks like pausing containers. Side effect: before/after command hooks now run
  479. once for each configured repository instead of once per configuration file. Additionally, the
  480. "repositories" interpolated variable has been changed to "repository", containing the path to the
  481. current repository for the hook. See the documentation for more information:
  482. https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
  483. * #513: Add mention of sudo's "secure_path" option to borgmatic installation documentation.
  484. * #515: Fix "borgmatic borg key ..." to pass parameters to Borg in the correct order.
  485. * #516: Fix handling of TERM signal to exit borgmatic, not just forward the signal to Borg.
  486. * #517: Fix borgmatic exit code (so it's zero) when initial Borg calls fail but later retries
  487. succeed.
  488. * Change Healthchecks logs truncation size from 10k bytes to 100k bytes, corresponding to that
  489. same change on Healthchecks.io.
  490. 1.5.24
  491. * #431: Add "working_directory" option to support source directories with relative paths.
  492. * #444: When loading a configuration file that is unreadable due to file permissions, warn instead
  493. of erroring. This supports running borgmatic as a non-root user with configuration in ~/.config
  494. even if there is an unreadable global configuration file in /etc.
  495. * #469: Add "repositories" context to "before_*" and "after_*" command action hooks. See the
  496. documentation for more information:
  497. https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
  498. * #486: Fix handling of "patterns_from" and "exclude_from" options to error instead of warning when
  499. referencing unreadable files and "create" action is run.
  500. * #507: Fix Borg usage error in the "compact" action when running "borgmatic --dry-run". Now, skip
  501. "compact" entirely during a dry run.
  502. 1.5.23
  503. * #394: Compact repository segments and free space with new "borgmatic compact" action. Borg 1.2+
  504. only. Also run "compact" by default when no actions are specified, as "prune" in Borg 1.2 no
  505. longer frees up space unless "compact" is run.
  506. * #394: When using the "atime", "bsd_flags", "numeric_owner", or "remote_rate_limit" options,
  507. tailor the flags passed to Borg depending on the Borg version.
  508. * #480, #482: Fix traceback when a YAML validation error occurs.
  509. 1.5.22
  510. * #288: Add database dump hook for MongoDB.
  511. * #470: Move mysqldump options to the beginning of the command due to MySQL bug 30994.
  512. * #471: When command-line configuration override produces a parse error, error cleanly instead of
  513. tracebacking.
  514. * #476: Fix unicode error when restoring particular MySQL databases.
  515. * Drop support for Python 3.6, which has been end-of-lifed.
  516. * Add support for Python 3.10.
  517. 1.5.21
  518. * #28: Optionally retry failing backups via "retries" and "retry_wait" configuration options.
  519. * #306: Add "list_options" MySQL configuration option for passing additional arguments to MySQL
  520. list command.
  521. * #459: Add support for old version (2.x) of jsonschema library.
  522. 1.5.20
  523. * Re-release with correct version without dev0 tag.
  524. 1.5.19
  525. * #387: Fix error when configured source directories are not present on the filesystem at the time
  526. of backup. Now, Borg will complain, but the backup will still continue.
  527. * #455: Mention changing borgmatic path in cron documentation.
  528. * Update sample systemd service file with more granular read-only filesystem settings.
  529. * Move Gitea and GitHub hosting from a personal namespace to an organization for better
  530. collaboration with related projects.
  531. * 1k ★s on GitHub!
  532. 1.5.18
  533. * #389: Fix "message too long" error when logging to rsyslog.
  534. * #440: Fix traceback that can occur when dumping a database.
  535. 1.5.17
  536. * #437: Fix error when configuration file contains "umask" option.
  537. * Remove test dependency on vim and /dev/urandom.
  538. 1.5.16
  539. * #379: Suppress console output in sample crontab and systemd service files.
  540. * #407: Fix syslog logging on FreeBSD.
  541. * #430: Fix hang when restoring a PostgreSQL "tar" format database dump.
  542. * Better error messages! Switch the library used for validating configuration files (from pykwalify
  543. to jsonschema).
  544. * Link borgmatic Ansible role from installation documentation:
  545. https://torsion.org/borgmatic/docs/how-to/set-up-backups/#other-ways-to-install
  546. 1.5.15
  547. * #419: Document use case of running backups conditionally based on laptop power level:
  548. https://torsion.org/borgmatic/docs/how-to/backup-to-a-removable-drive-or-an-intermittent-server/
  549. * #425: Run arbitrary Borg commands with new "borgmatic borg" action. See the documentation for
  550. more information: https://torsion.org/borgmatic/docs/how-to/run-arbitrary-borg-commands/
  551. 1.5.14
  552. * #390: Add link to Hetzner storage offering from the documentation.
  553. * #398: Clarify canonical home of borgmatic in documentation.
  554. * #406: Clarify that spaces in path names should not be backslashed in path names.
  555. * #423: Fix error handling to error loudly when Borg gets killed due to running out of memory!
  556. * Fix build so as not to attempt to build and push documentation for a non-main branch.
  557. * "Fix" build failure with Alpine Edge by switching from Edge to Alpine 3.13.
  558. * Move #borgmatic IRC channel from Freenode to Libera Chat due to Freenode takeover drama.
  559. IRC connection info: https://torsion.org/borgmatic/#issues
  560. 1.5.13
  561. * #373: Document that passphrase is used for Borg keyfile encryption, not just repokey encryption.
  562. * #404: Add support for ruamel.yaml 0.17.x YAML parsing library.
  563. * Update systemd service example to return a permission error when a system call isn't permitted
  564. (instead of terminating borgmatic outright).
  565. * Drop support for Python 3.5, which has been end-of-lifed.
  566. * Add support for Python 3.9.
  567. * Update versions of test dependencies (test_requirements.txt and test containers).
  568. * Only support black code formatter on Python 3.8+. New black dependencies make installation
  569. difficult on older versions of Python.
  570. * Replace "improve this documentation" form with link to support and ticket tracker.
  571. 1.5.12
  572. * Fix for previous release with incorrect version suffix in setup.py. No other changes.
  573. 1.5.11
  574. * #341: Add "temporary_directory" option for changing Borg's temporary directory.
  575. * #352: Lock down systemd security settings in sample systemd service file.
  576. * #355: Fix traceback when a database hook value is null in a configuration file.
  577. * #361: Merge override values when specifying the "--override" flag multiple times. The previous
  578. behavior was to take the value of the last "--override" flag only.
  579. * #367: Fix traceback when upgrading old INI-style configuration with upgrade-borgmatic-config.
  580. * #368: Fix signal forwarding from borgmatic to Borg resulting in recursion traceback.
  581. * #369: Document support for Borg placeholders in repository names.
  582. 1.5.10
  583. * #347: Add hooks that run for the "extract" action: "before_extract" and "after_extract".
  584. * #350: Fix traceback when a configuration directory is non-readable due to directory permissions.
  585. * Add documentation navigation links on left side of all documentation pages.
  586. * Clarify documentation on configuration overrides, specifically the portion about list syntax:
  587. http://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#configuration-overrides
  588. * Clarify documentation overview of monitoring options:
  589. http://torsion.org/borgmatic/docs/how-to/monitor-your-backups/
  590. 1.5.9
  591. * #300: Add "borgmatic export-tar" action to export an archive to a tar-formatted file or stream.
  592. * #339: Fix for intermittent timing-related test failure of logging function.
  593. * Clarify database documentation about excluding named pipes and character/block devices to prevent
  594. hangs.
  595. * Add documentation on how to make backups redundant with multiple repositories:
  596. https://torsion.org/borgmatic/docs/how-to/make-backups-redundant/
  597. 1.5.8
  598. * #336: Fix for traceback when running Cronitor, Cronhub, and PagerDuty monitor hooks.
  599. 1.5.7
  600. * #327: Fix broken pass-through of BORG_* environment variables to Borg.
  601. * #328: Fix duplicate logging to Healthchecks and send "after_*" hooks output to Healthchecks.
  602. * #331: Add SSL support to PostgreSQL database configuration.
  603. * #333: Fix for potential data loss (data not getting backed up) when borgmatic omitted configured
  604. source directories in certain situations. Specifically, this occurred when two source directories
  605. on different filesystems were related by parentage (e.g. "/foo" and "/foo/bar/baz") and the
  606. one_file_system option was enabled.
  607. * Update documentation code fragments theme to better match the rest of the page.
  608. * Improve configuration reference documentation readability via more aggressive word-wrapping in
  609. configuration schema descriptions.
  610. 1.5.6
  611. * #292: Allow before_backup and similar hooks to exit with a soft failure without altering the
  612. monitoring status on Healthchecks or other providers. Support this by waiting to ping monitoring
  613. services with a "start" status until after before_* hooks finish. Failures in before_* hooks
  614. still trigger a monitoring "fail" status.
  615. * #316: Fix hang when a stale database dump named pipe from an aborted borgmatic run remains on
  616. disk.
  617. * #323: Fix for certain configuration options like ssh_command impacting Borg invocations for
  618. separate configuration files.
  619. * #324: Add "borgmatic extract --strip-components" flag to remove leading path components when
  620. extracting an archive.
  621. * Tweak comment indentation in generated configuration file for clarity.
  622. * Link to Borgmacator GNOME AppIndicator from monitoring documentation.
  623. 1.5.5
  624. * #314: Fix regression in support for PostgreSQL's "directory" dump format. Unlike other dump
  625. formats, the "directory" dump format does not stream directly to/from Borg.
  626. * #315: Fix enabled database hooks to implicitly set one_file_system configuration option to true.
  627. This prevents Borg from reading devices like /dev/zero and hanging.
  628. * #316: Fix hang when streaming a database dump to Borg with implicit duplicate source directories
  629. by deduplicating them first.
  630. * #319: Fix error message when there are no MySQL databases to dump for "all" databases.
  631. * Improve documentation around the installation process. Specifically, making borgmatic commands
  632. runnable via the system PATH and offering a global install option.
  633. 1.5.4
  634. * #310: Fix legitimate database dump command errors (exit code 1) not being treated as errors by
  635. borgmatic.
  636. * For database dumps, replace the named pipe on every borgmatic run. This prevent hangs on stale
  637. pipes left over from previous runs.
  638. * Fix error handling to handle more edge cases when executing commands.
  639. 1.5.3
  640. * #258: Stream database dumps and restores directly to/from Borg without using any additional
  641. filesystem space. This feature is automatic, and works even on restores from archives made with
  642. previous versions of borgmatic.
  643. * #293: Documentation on macOS launchd permissions issues with work-around for Full Disk Access.
  644. * Remove "borgmatic restore --progress" flag, as it now conflicts with streaming database restores.
  645. 1.5.2
  646. * #301: Fix MySQL restore error on "all" database dump by excluding system tables.
  647. * Fix PostgreSQL restore error on "all" database dump by using "psql" for the restore instead of
  648. "pg_restore".
  649. 1.5.1
  650. * #289: Tired of looking up the latest successful archive name in order to pass it to borgmatic
  651. actions? Me too. Now you can specify "--archive latest" to all actions that accept an archive
  652. flag.
  653. * #290: Fix the "--stats" and "--files" flags so that they yield output at verbosity 0.
  654. * Reduce the default verbosity of borgmatic logs sent to Healthchecks monitoring hook. Now, it's
  655. warnings and errors only. You can increase the verbosity via the "--monitoring-verbosity" flag.
  656. * Add security policy documentation in SECURITY.md.
  657. 1.5.0
  658. * #245: Monitor backups with PagerDuty hook integration. See the documentation for more
  659. information: https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#pagerduty-hook
  660. * #255: Add per-action hooks: "before_prune", "after_prune", "before_check", and "after_check".
  661. * #274: Add ~/.config/borgmatic.d as another configuration directory default.
  662. * #277: Customize Healthchecks log level via borgmatic "--monitoring-verbosity" flag.
  663. * #280: Change "exclude_if_present" option to support multiple filenames that indicate a directory
  664. should be excluded from backups, rather than just a single filename.
  665. * #284: Backup to a removable drive or intermittent server via "soft failure" feature. See the
  666. documentation for more information:
  667. https://torsion.org/borgmatic/docs/how-to/backup-to-a-removable-drive-or-an-intermittent-server/
  668. * #287: View consistency check progress via "--progress" flag for "check" action.
  669. * For "create" and "prune" actions, no longer list files or show detailed stats at any verbosities
  670. by default. You can opt back in with "--files" or "--stats" flags.
  671. * For "list" and "info" actions, show repository names even at verbosity 0.
  672. 1.4.22
  673. * #276, #285: Disable colored output when "--json" flag is used, so as to produce valid JSON output.
  674. * After a backup of a database dump in directory format, properly remove the dump directory.
  675. * In "borgmatic --help", don't expand $HOME in listing of default "--config" paths.
  676. 1.4.21
  677. * #268: Override particular configuration options from the command-line via "--override" flag. See
  678. the documentation for more information:
  679. https://torsion.org/borgmatic/docs/how-to/make-per-application-backups/#configuration-overrides
  680. * #270: Only trigger "on_error" hooks and monitoring failures for "prune", "create", and "check"
  681. actions, and not for other actions.
  682. * When pruning with verbosity level 1, list pruned and kept archives. Previously, this information
  683. was only shown at verbosity level 2.
  684. 1.4.20
  685. * Fix repository probing during "borgmatic init" to respect verbosity flag and remote_path option.
  686. * #249: Update Healthchecks/Cronitor/Cronhub monitoring integrations to fire for "check" and
  687. "prune" actions, not just "create".
  688. 1.4.19
  689. * #259: Optionally change the internal database dump path via "borgmatic_source_directory" option
  690. in location configuration section.
  691. * #271: Support piping "borgmatic list" output to grep by logging certain log levels to console
  692. stdout and others to stderr.
  693. * Retain colored output when piping or redirecting in an interactive terminal.
  694. * Add end-to-end tests for database dump and restore. These are run on developer machines with
  695. Docker Compose for approximate parity with continuous integration tests.
  696. 1.4.18
  697. * Fix "--repository" flag to accept relative paths.
  698. * Fix "borgmatic umount" so it only runs Borg once instead of once per repository / configuration
  699. file.
  700. * #253: Mount whole repositories via "borgmatic mount" without any "--archive" flag.
  701. * #269: Filter listed paths via "borgmatic list --path" flag.
  702. 1.4.17
  703. * #235: Pass extra options directly to particular Borg commands, handy for Borg options that
  704. borgmatic does not yet support natively. Use "extra_borg_options" in the storage configuration
  705. section.
  706. * #266: Attempt to repair any inconsistencies found during a consistency check via
  707. "borgmatic check --repair" flag.
  708. 1.4.16
  709. * #256: Fix for "before_backup" hook not triggering an error when the command contains "borg" and
  710. has an exit code of 1.
  711. * #257: Fix for garbled Borg file listing when using "borgmatic create --progress" with
  712. verbosity level 1 or 2.
  713. * #260: Fix for missing Healthchecks monitoring payload or HTTP 500 due to incorrect unicode
  714. encoding.
  715. 1.4.15
  716. * Fix for database dump removal incorrectly skipping some database dumps.
  717. * #123: Support for mounting an archive as a FUSE filesystem via "borgmatic mount" action, and
  718. unmounting via "borgmatic umount". See the documentation for more information:
  719. https://torsion.org/borgmatic/docs/how-to/extract-a-backup/#mount-a-filesystem
  720. 1.4.14
  721. * Show summary log errors regardless of verbosity level, and log the "summary:" header with a log
  722. level based on the contained summary logs.
  723. 1.4.13
  724. * Show full error logs at "--verbosity 0" so you can see command output without upping the
  725. verbosity level.
  726. 1.4.12
  727. * #247: With "borgmatic check", consider Borg warnings as errors.
  728. * Dial back the display of inline error logs a bit, so failed command output doesn't appear
  729. multiple times in the logs (well, except for the summary).
  730. 1.4.11
  731. * #241: When using the Healthchecks monitoring hook, include borgmatic logs in the payloads for
  732. completion and failure pings.
  733. * With --verbosity level 1 or 2, show error logs both inline when they occur and in the summary
  734. logs at the bottom. With lower verbosity levels, suppress the summary and show error logs when
  735. they occur.
  736. 1.4.10
  737. * #246: Fix for "borgmatic restore" showing success and incorrectly extracting archive files, even
  738. when no databases are configured to restore. As this can overwrite files from the archive and
  739. lead to data loss, please upgrade to get the fix before using "borgmatic restore".
  740. * Reopen the file given by "--log-file" flag if an external program rotates the log file while
  741. borgmatic is running.
  742. 1.4.9
  743. * #228: Database dump hooks for MySQL/MariaDB, so you can easily dump your databases before backups
  744. run.
  745. * #243: Fix repository does not exist error with "borgmatic extract" when repository is remote.
  746. 1.4.8
  747. * Monitor backups with Cronhub hook integration. See the documentation for more information:
  748. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronhub-hook
  749. * Fix Healthchecks/Cronitor hooks to skip actions when the borgmatic "--dry-run" flag is used.
  750. 1.4.7
  751. * #238: In documentation, clarify when Healthchecks/Cronitor hooks fire in relation to other hooks.
  752. * #239: Upgrade your borgmatic configuration to get new options and comments via
  753. "generate-borgmatic-config --source". See the documentation for more information:
  754. https://torsion.org/borgmatic/docs/how-to/upgrade/#upgrading-your-configuration
  755. 1.4.6
  756. * Verbosity level "-1" for even quieter output: Errors only (#236).
  757. 1.4.5
  758. * Log to file instead of syslog via command-line "--log-file" flag (#233).
  759. 1.4.4
  760. * #234: Support for Borg --keep-exclude-tags and --exclude-nodump options.
  761. 1.4.3
  762. * Monitor backups with Cronitor hook integration. See the documentation for more information:
  763. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#cronitor-hook
  764. 1.4.2
  765. * Extract files to a particular directory via "borgmatic extract --destination" flag.
  766. * Rename "borgmatic extract --restore-path" flag to "--path" to reduce confusion with the separate
  767. "borgmatic restore" action. Any uses of "--restore-path" will continue working.
  768. 1.4.1
  769. * #229: Restore backed up PostgreSQL databases via "borgmatic restore" action. See the
  770. documentation for more information:
  771. https://torsion.org/borgmatic/docs/how-to/backup-your-databases/
  772. * Documentation on how to develop borgmatic's documentation:
  773. https://torsion.org/borgmatic/docs/how-to/develop-on-borgmatic/#documentation-development
  774. 1.4.0
  775. * #225: Database dump hooks for PostgreSQL, so you can easily dump your databases before backups
  776. run.
  777. * #230: Rename "borgmatic list --pattern-from" flag to "--patterns-from" to match Borg.
  778. 1.3.26
  779. * #224: Fix "borgmatic list --successful" with a slightly better heuristic for listing successful
  780. (non-checkpoint) archives.
  781. 1.3.25
  782. * #223: Dead man's switch to detect when backups start failing silently, implemented via
  783. healthchecks.io hook integration. See the documentation for more information:
  784. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#healthchecks-hook
  785. * Documentation on monitoring and alerting options for borgmatic backups:
  786. https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/
  787. * Automatically rewrite links when developing on documentation locally.
  788. 1.3.24
  789. * #86: Add "borgmatic list --successful" flag to only list successful (non-checkpoint) archives.
  790. * Add a suggestion form to all documentation pages, so users can submit ideas for improving the
  791. documentation.
  792. * Update documentation link to community Arch Linux borgmatic package.
  793. 1.3.23
  794. * #174: More detailed error alerting via runtime context available in "on_error" hook.
  795. 1.3.22
  796. * #144: When backups to one of several repositories fails, keep backing up to the other
  797. repositories and report errors afterwards.
  798. 1.3.21
  799. * #192: User-defined hooks for global setup or cleanup that run before/after all actions. See the
  800. documentation for more information:
  801. https://torsion.org/borgmatic/docs/how-to/add-preparation-and-cleanup-steps-to-backups/
  802. 1.3.20
  803. * #205: More robust sample systemd service: boot delay, network dependency, lowered CPU/IO
  804. priority, etc.
  805. * #221: Fix "borgmatic create --progress" output so that it updates on the console in real-time.
  806. 1.3.19
  807. * #219: Fix visibility of "borgmatic prune --stats" output.
  808. 1.3.18
  809. * #220: Fix regression of argument parsing for default actions.
  810. 1.3.17
  811. * #217: Fix error with "borgmatic check --only" command-line flag with "extract" consistency check.
  812. 1.3.16
  813. * #210: Support for Borg check --verify-data flag via borgmatic "data" consistency check.
  814. * #210: Override configured consistency checks via "borgmatic check --only" command-line flag.
  815. * When generating sample configuration with generate-borgmatic-config, add a space after each "#"
  816. comment indicator.
  817. 1.3.15
  818. * #208: Fix for traceback when the "checks" option has an empty value.
  819. * #209: Bypass Borg error about a moved repository via "relocated_repo_access_is_ok" option in
  820. borgmatic storage configuration section.
  821. * #213: Reorder arguments passed to Borg to fix duplicate directories when using Borg patterns.
  822. * #214: Fix for hook erroring with exit code 1 not being interpreted as an error.
  823. 1.3.14
  824. * #204: Do not treat Borg warnings (exit code 1) as failures.
  825. * When validating configuration files, require strings instead of allowing any scalar type.
  826. 1.3.13
  827. * #199: Add note to documentation about using spaces instead of tabs for indentation, as YAML does
  828. not allow tabs.
  829. * #203: Fix compatibility with ruamel.yaml 0.16.x.
  830. * If a "prefix" option in borgmatic's configuration has an empty value (blank or ""), then disable
  831. default prefix.
  832. 1.3.12
  833. * Only log to syslog when run from a non-interactive console (e.g. a cron job).
  834. * Remove unicode byte order mark from syslog output so it doesn't show up as a literal in rsyslog
  835. output. See discussion on #197.
  836. 1.3.11
  837. * #193: Pass through several "borg list" and "borg info" flags like --short, --format, --sort-by,
  838. --first, --last, etc. via borgmatic command-line flags.
  839. * Add borgmatic info --repository and --archive command-line flags to display info for individual
  840. repositories or archives.
  841. * Support for Borg --noatime, --noctime, and --nobirthtime flags via corresponding options in
  842. borgmatic configuration location section.
  843. 1.3.10
  844. * #198: Fix for Borg create error output not showing up at borgmatic verbosity level zero.
  845. 1.3.9
  846. * #195: Switch to command-line actions as more traditional sub-commands, e.g. "borgmatic create",
  847. "borgmatic prune", etc. However, the classic dashed options like "--create" still work!
  848. 1.3.8
  849. * #191: Disable console color via "color" option in borgmatic configuration output section.
  850. 1.3.7
  851. * #196: Fix for unclear error message for invalid YAML merge include.
  852. * #197: Don't color syslog output.
  853. * Change default syslog verbosity to show errors only.
  854. 1.3.6
  855. * #53: Log to syslog in addition to existing console logging. Add --syslog-verbosity flag to
  856. customize the log level. See the documentation for more information:
  857. https://torsion.org/borgmatic/docs/how-to/inspect-your-backups/
  858. * #178: Look for .yml configuration file extension in addition to .yaml.
  859. * #189: Set umask used when executing hooks via "umask" option in borgmatic hooks section.
  860. * Remove Python cache files before each Tox run.
  861. * Add #borgmatic Freenode IRC channel to documentation.
  862. * Add Borg/borgmatic hosting providers section to documentation.
  863. * Add files for building documentation into a Docker image for web serving.
  864. * Upgrade project build server from Drone 0.8 to 1.1.
  865. * Build borgmatic documentation during continuous integration.
  866. * We're nearly at 500 ★s on GitHub. We can do this!
  867. 1.3.5
  868. * #153: Support for various Borg directory environment variables (BORG_CONFIG_DIR, BORG_CACHE_DIR,
  869. etc.) via options in borgmatic's storage configuration.
  870. * #177: Fix for regression with missing verbose log entries.
  871. 1.3.4
  872. * Part of #125: Color borgmatic (but not Borg) output when using an interactive terminal.
  873. * #166: Run tests for all installed versions of Python.
  874. * #168: Update README with continuous integration badge.
  875. * #169: Automatically sort Python imports in code.
  876. * Document installing borgmatic with pip install --user instead of a system Python install.
  877. * Get more reproducible builds by pinning the versions of pip and tox used to run tests.
  878. * Factor out build/test configuration from tox.ini file.
  879. 1.3.3
  880. * Add validate-borgmatic-config command, useful for validating borgmatic config generated by
  881. configuration management or even edited by hand.
  882. 1.3.2
  883. * #160: Fix for hooks executing when using --dry-run. Now hooks are skipped during a dry run.
  884. 1.3.1
  885. * #155: Fix for invalid JSON output when using multiple borgmatic configuration files.
  886. * #157: Fix for seemingly random filename ordering when running through a directory of
  887. configuration files.
  888. * Fix for empty JSON output when using --create --json.
  889. * Now capturing Borg output only when --json flag is used. Previously, borgmatic delayed Borg
  890. output even without the --json flag.
  891. 1.3.0
  892. * #148: Configuration file includes and merging via "!include" tag to support reuse of common
  893. options across configuration files.
  894. 1.2.18
  895. * #147: Support for Borg create/extract --numeric-owner flag via "numeric_owner" option in
  896. borgmatic's location section.
  897. 1.2.17
  898. * #140: List the files within an archive via --list --archive option.
  899. 1.2.16
  900. * #119: Include a sample borgmatic configuration file in the documentation.
  901. * #123: Support for Borg archive restoration via borgmatic --extract command-line flag.
  902. * Refactor documentation into multiple separate pages for clarity and findability.
  903. * Organize options within command-line help into logical groups.
  904. * Exclude tests from distribution packages.
  905. 1.2.15
  906. * #127: Remove date echo from schema example, as it's not a substitute for real logging.
  907. * #132: Leave exclude_patterns glob expansion to Borg, since doing it in borgmatic leads to
  908. confusing behavior.
  909. * #136: Handle and format validation errors raised during argument parsing.
  910. * #138: Allow use of --stats flag when --create or --prune flags are implied.
  911. 1.2.14
  912. * #103: When generating sample configuration with generate-borgmatic-config, document the defaults
  913. for each option.
  914. * #116: When running multiple configuration files, attempt all configuration files even if one of
  915. them errors. Log a summary of results at the end.
  916. * Add borgmatic --version command-line flag to get the current installed version number.
  917. 1.2.13
  918. * #100: Support for --stats command-line flag independent of --verbosity.
  919. * #117: With borgmatic --init command-line flag, proceed without erroring if a repository already
  920. exists.
  921. 1.2.12
  922. * #110: Support for Borg repository initialization via borgmatic --init command-line flag.
  923. * #111: Update Borg create --filter values so a dry run lists files to back up.
  924. * #113: Update README with link to a new/forked Docker image.
  925. * Prevent deprecated --excludes command-line option from being used.
  926. * Refactor README a bit to flow better for first-time users.
  927. * Update README with a few additional borgmatic packages (Debian and Ubuntu).
  928. 1.2.11
  929. * #108: Support for Borg create --progress via borgmatic command-line flag.
  930. 1.2.10
  931. * #105: Support for Borg --chunker-params create option via "chunker_params" option in borgmatic's
  932. storage section.
  933. 1.2.9
  934. * #102: Fix for syntax error that occurred in Python 3.5 and below.
  935. * Make automated tests support running in Python 3.5.
  936. 1.2.8
  937. * #73: Enable consistency checks for only certain repositories via "check_repositories" option in
  938. borgmatic's consistency configuration. Handy for large repositories that take forever to check.
  939. * Include link to issue tracker within various command output.
  940. * Run continuous integration tests on a matrix of Python and Borg versions.
  941. 1.2.7
  942. * #98: Support for Borg --keep-secondly prune option.
  943. * Use Black code formatter and Flake8 code checker as part of running automated tests.
  944. * Add an end-to-end automated test that actually integrates with Borg.
  945. * Set up continuous integration for borgmatic automated tests on projects.evoworx.org.
  946. 1.2.6
  947. * Fix generated configuration to also include a "keep_daily" value so pruning works out of the
  948. box.
  949. 1.2.5
  950. * #57: When generating sample configuration with generate-borgmatic-config, comment out all
  951. optional configuration so as to streamline the initial configuration process.
  952. 1.2.4
  953. * Fix for archive checking traceback due to parameter mismatch.
  954. 1.2.3
  955. * #64, #90, #92: Rewrite of logging system. Now verbosity flags passed to Borg are derived from
  956. borgmatic's log level. Note that the output of borgmatic might slightly change.
  957. * Part of #80: Support for Borg create --read-special via "read_special" option in borgmatic's
  958. location configuration.
  959. * #87: Support for Borg create --checkpoint-interval via "checkpoint_interval" option in
  960. borgmatic's storage configuration.
  961. * #88: Fix declared pykwalify compatibility version range in setup.py to prevent use of ancient
  962. versions of pykwalify with large version numbers.
  963. * #89: Pass --show-rc option to Borg when at highest verbosity level.
  964. * #94: Support for Borg --json option via borgmatic command-line to --create archives.
  965. 1.2.2
  966. * #85: Fix compatibility issue between pykwalify and ruamel.yaml 0.15.52, which manifested in
  967. borgmatic as a pykwalify RuleError.
  968. 1.2.1
  969. * Skip before/after backup hooks when only doing --prune, --check, --list, and/or --info.
  970. * #71: Support for XDG_CONFIG_HOME environment variable for specifying alternate user ~/.config/
  971. path.
  972. * #74, #83: Support for Borg --json option via borgmatic command-line to --list archives or show
  973. archive --info in JSON format, ideal for programmatic consumption.
  974. * #38, #76: Upgrade ruamel.yaml compatibility version range and fix support for Python 3.7.
  975. * #77: Skip non-"*.yaml" config filenames in /etc/borgmatic.d/ so as not to parse backup files,
  976. editor swap files, etc.
  977. * #81: Document user-defined hooks run before/after backup, or on error.
  978. * Add code style guidelines to the documentation.
  979. 1.2.0
  980. * #61: Support for Borg --list option via borgmatic command-line to list all archives.
  981. * #61: Support for Borg --info option via borgmatic command-line to display summary information.
  982. * #62: Update README to mention other ways of installing borgmatic.
  983. * Support for Borg --prefix option for consistency checks via "prefix" option in borgmatic's
  984. consistency configuration.
  985. * Add introductory screencast link to documentation.
  986. * #59: Ignore "check_last" and consistency "prefix" when "archives" not in consistency checks.
  987. * #60: Add "Persistent" flag to systemd timer example.
  988. * #63: Support for Borg --nobsdflags option to skip recording bsdflags (e.g. NODUMP, IMMUTABLE) in
  989. archive.
  990. * #69: Support for Borg prune --umask option using value of existing "umask" option in borgmatic's
  991. storage configuration.
  992. * Update tox.ini to only assume Python 3.x instead of Python 3.4 specifically.
  993. * Add ~/.config/borgmatic/config.yaml to default configuration path probing.
  994. * Document how to develop on and contribute to borgmatic.
  995. 1.1.15
  996. * Support for Borg BORG_PASSCOMMAND environment variable to read a password from an external file.
  997. * Fix for Borg create error when using borgmatic's --dry-run and --verbosity options together.
  998. Work-around for behavior introduced in Borg 1.1.3: https://github.com/borgbackup/borg/issues/3298
  999. * #55: Fix for missing tags/releases on Gitea and GitHub project hosting.
  1000. * #56: Support for Borg --lock-wait option for the maximum wait for a repository/cache lock.
  1001. * #58: Support for using tilde in exclude_patterns to reference home directory.
  1002. 1.1.14
  1003. * #49: Fix for typo in --patterns-from option.
  1004. * #47: Support for Borg --dry-run option via borgmatic command-line.
  1005. 1.1.13
  1006. * #54: Fix for incorrect consistency check flags passed to Borg when all three checks ("repository",
  1007. "archives", and "extract") are specified in borgmatic configuration.
  1008. * #48: Add "local_path" to configuration for specifying an alternative Borg executable path.
  1009. * #49: Support for Borg experimental --patterns-from and --patterns options for specifying mixed
  1010. includes/excludes.
  1011. * Moved issue tracker from Taiga to integrated Gitea tracker at
  1012. https://projects.torsion.org/borgmatic-collective/borgmatic/issues
  1013. 1.1.12
  1014. * #46: Declare dependency on pykwalify 1.6 or above, as older versions yield "Unknown key: version"
  1015. rule errors.
  1016. * Support for Borg --keep-minutely prune option.
  1017. 1.1.11
  1018. * #26: Add "ssh_command" to configuration for specifying a custom SSH command or options.
  1019. * Fix for incorrect /etc/borgmatic.d/ configuration path probing on macOS. This problem manifested
  1020. as an error on startup: "[Errno 2] No such file or directory: '/etc/borgmatic.d'".
  1021. 1.1.10
  1022. * Pass several Unix signals through to child processes like Borg. This means that Borg now properly
  1023. shuts down if borgmatic is terminated (e.g. due to a system suspend).
  1024. * #30: Support for using tilde in repository paths to reference home directory.
  1025. * #43: Support for Borg --files-cache option for setting the files cache operation mode.
  1026. * #45: Support for Borg --remote-ratelimit option for limiting upload rate.
  1027. * Log invoked Borg commands when at highest verbosity level.
  1028. 1.1.9
  1029. * #17, #39: Support for user-defined hooks before/after backup, or on error.
  1030. * #34: Improve clarity of logging spew at high verbosity levels.
  1031. * #30: Support for using tilde in source directory path to reference home directory.
  1032. * Require "prefix" in retention section when "archive_name_format" is set. This is to avoid
  1033. accidental pruning of archives with a different archive name format. For similar reasons, default
  1034. "prefix" to "{hostname}-" if not specified.
  1035. * Convert main source repository from Mercurial to Git.
  1036. * Update dead links to Borg documentation.
  1037. 1.1.8
  1038. * #40: Fix to make /etc/borgmatic/config.yaml optional rather than required when using the default
  1039. config paths.
  1040. 1.1.7
  1041. * #29: Add "archive_name_format" to configuration for customizing archive names.
  1042. * Fix for traceback when "exclude_from" value is empty in configuration file.
  1043. * When pruning, make highest verbosity level list archives kept and pruned.
  1044. * Clarification of Python 3 pip usage in documentation.
  1045. 1.1.6
  1046. * #13, #36: Support for Borg --exclude-from, --exclude-caches, and --exclude-if-present options.
  1047. 1.1.5
  1048. * #35: New "extract" consistency check that performs a dry-run extraction of the most recent
  1049. archive.
  1050. 1.1.4
  1051. * #18: Added command-line flags for performing a borgmatic run with only pruning, creating, or
  1052. checking enabled. This supports use cases like running consistency checks from a different cron
  1053. job with a different frequency, or running pruning with a different verbosity level.
  1054. 1.1.3
  1055. * #15: Support for running multiple config files in /etc/borgmatic.d/ from a single borgmatic run.
  1056. * Fix for generate-borgmatic-config writing config with invalid one_file_system value.
  1057. 1.1.2
  1058. * #33: Fix for passing check_last as integer to subprocess when calling Borg.
  1059. 1.1.1
  1060. * Part of #33: Fix for upgrade-borgmatic-config converting check_last option as a string instead of
  1061. an integer.
  1062. * Fix for upgrade-borgmatic-config erroring when consistency checks option is not present.
  1063. 1.1.0
  1064. * Switched config file format to YAML. Run upgrade-borgmatic-config to upgrade.
  1065. * Added generate-borgmatic-config command for initial config creation.
  1066. * Dropped Python 2 support. Now Python 3 only.
  1067. * #19: Fix for README mention of sample files not included in package.
  1068. * #23: Sample files for triggering borgmatic from a systemd timer.
  1069. * Support for backing up to multiple repositories.
  1070. * To free up space, now pruning backups prior to creating a new backup.
  1071. * Enabled test coverage output during tox runs.
  1072. * Added logo.
  1073. 1.0.3
  1074. * #22: Fix for verbosity flag not actually causing verbose output.
  1075. 1.0.2
  1076. * #21: Fix for traceback when remote_path option is missing.
  1077. 1.0.1
  1078. * #20: Support for Borg's --remote-path option to use an alternate Borg
  1079. executable. See sample/config.
  1080. 1.0.0
  1081. * Attic is no longer supported, as there hasn't been any recent development on
  1082. it. Dropping Attic support will allow faster iteration on Borg-specific
  1083. features. If you're still using Attic, this is a good time to switch to Borg!
  1084. * Project renamed from atticmatic to borgmatic. See the borgmatic README for
  1085. information on upgrading.
  1086. 0.1.8
  1087. * Fix for handling of spaces in source_directories which resulted in backup up everything.
  1088. * Fix for broken links to Borg documentation.
  1089. * At verbosity zero, suppressing Borg check stderr spew about "Checking segments".
  1090. * Support for Borg --one-file-system.
  1091. * Support for Borg create --umask.
  1092. * Support for file globs in source_directories.
  1093. 0.1.7
  1094. * #12: Fixed parsing of punctuation in configuration file.
  1095. * Better error message when configuration file is missing.
  1096. 0.1.6
  1097. * #10: New configuration option for the encryption passphrase.
  1098. * #11: Support for Borg's new archive compression feature.
  1099. 0.1.5
  1100. * Changes to support release on PyPI. Now pip installable by name!
  1101. 0.1.4
  1102. * Adding test that setup.py version matches release version.
  1103. 0.1.3
  1104. * #2: Add support for "borg check --last N" to Borg backend.
  1105. 0.1.2
  1106. * As a convenience to new users, allow a missing default excludes file.
  1107. * New issue tracker, linked from documentation.
  1108. 0.1.1
  1109. * Adding borgmatic cron example, and updating documentation to refer to it.
  1110. 0.1.0
  1111. * New "borgmatic" command to support Borg backup software, a fork of Attic.
  1112. 0.0.7
  1113. * Flag for multiple levels of verbosity: some, and lots.
  1114. * Improved mocking of Python builtins in unit tests.
  1115. 0.0.6
  1116. * New configuration section for customizing which Attic consistency checks run, if any.
  1117. 0.0.5
  1118. * Fixed regression with --verbose output being buffered. This means dropping the helpful error
  1119. message introduced in 0.0.4.
  1120. 0.0.4
  1121. * Now using tox to run tests against multiple versions of Python in one go.
  1122. * Helpful error message about how to create a repository if one is missing.
  1123. * Troubleshooting section with steps to deal with broken pipes.
  1124. * Nosetests config file (setup.cfg) with defaults.
  1125. 0.0.3
  1126. * After pruning, run attic's consistency checks on all archives.
  1127. * Integration tests for argument parsing.
  1128. * Documentation updates about repository encryption.
  1129. 0.0.2
  1130. * Configuration support for additional attic prune flags: keep_within, keep_hourly, keep_yearly,
  1131. and prefix.
  1132. 0.0.1
  1133. * Initial release.