Releases ======== Latest development release -------------------------- | Version: 1.38.2 | Released: 2024-01-01 1.39 (2024-??-??) ----------------- - Add date of last check to output of info command. - Miscellaneous refinements. 1.38 (2023-11-04) ----------------- - Added ‘last checked date’ reporting to :ref:`due command`. - Do not run :ref:`check --repair ` and :ref:`compact ` commands if `--dry-run` is requested. - Pass output of *Borg* *create* command to hooks to allow it to be reported to healthchecks.io_. 1.37 (2023-05-18) ----------------- - Add missing dependency. 1.36 (2023-05-15) ----------------- This release provides new mechanisms that allow you to monitor your pruning and compaction operations to help assure that these activities are not neglected. Both a prune and a compact operation must be performed to release disk space by eliminating expired archives. The combination of these to operations is referred to by *Emborg* as a squeeze. - specifying an integer for ``--date`` now finds archive by index. - :ref:`due ` and :ref:`info ` commands now report the latest :ref:`prune ` and :ref:`compact ` operations as well as the latest :ref:`create ` operation. .. note:: If you use :ref:`emborg-overdue ` from the client you will need to change the paths you specify in *overdue.conf*. They now need to end in ``.latest.nt`` rather than ``.lastbackup``. .. note:: If you use :ref:`borg space`, you will need to upgrade to version 2. 1.35 (2023-03-20) ----------------- - Improved the time resolution in :ref:`due ` command. - Added *si* format to :ref:`manifest ` command. - Allow *config_dir* to be specified through API. 1.34 (2022-11-03) ----------------- - Added ability to apply the :ref:`info ` command to a particular archive. 1.33 (2022-10-22) ----------------- - Added :ref:`compare ` command. - Added :ref:`manage_diffs_cmd` and :ref:`report_diffs_cmd` settings. - Allow ~/.config/emborg to always hold settings files if user prefers. 1.32 (2022-04-01) ----------------- - Fixed issues associated with :ref:`compact_after_delete` setting. 1.31 (2022-03-21) ----------------- - Enhanced *Emborg* to support new Borg 1.2 features. - Added :ref:`compact command ` - Added :ref:`compact_after_delete`, :ref:`chunker_params`, :ref:`sparse`, :ref:`threshold`, :ref:`upload_ratelimit`, :ref:`upload_buffer` settings. - Added the :ref:`run_before_borg and run_after_borg ` settings. - Added the ``--cache-only`` option and the ability to delete multiple archives at one time to the :ref:`delete command `. 1.30 (2022-01-04) ----------------- - Fix some issues with relative paths. 1.29 (2021-12-18) ----------------- - Do not signal failure to hooks if Borg completes normally, even if there were warnings. - Return an exit status of 1 if *Emborg* runs to completion but with exceptions, and 2 if it cannot complete normally due to a error or errors. 1.28 (2021-11-06) ----------------- - Suppress log file generation for :ref:`configs `, :ref:`due `, :ref:`help `, :ref:`log `, :ref:`settings ` and :ref:`version ` commands. - Add *version* to the API. 1.27 (2021-09-21) ----------------- - Improve the logging for composite configurations. - Add support for `Borg-Space `_, a utility that allows you to track and plot disk space usage for your *Borg* repositories over time. 1.26 (2021-09-03) ----------------- - Improve the tests. - Allow access to names of child configs through API. 1.25 (2021-08-28) ----------------- - Added the :ref:`compare command `. - Added the :ref:`manage_diffs_cmd` and :ref:`report_diffs_cmd` settings. - Added the :ref:`run_before_first_backup ` and :ref:`run_after_last_backup ` settings. - Allow files listed by :ref:`manifest ` command to be constrained to those contained within a path. - Allow relative dates to be specified on the :ref:`extract `, :ref:`manifest `, :ref:`mount ` and :ref:`restore ` commands. - Allow *BORG_PASSPHRASE*, *BORG_PASSPHRASE_FD*, or *BORG_PASSCOMMAND* to dominate over *Emborg* passphrase settings. 1.24 (2021-07-05) ----------------- - Added *healthchecks_url* and *cronhub_url* settings. 1.23 (2021-07-01) ----------------- - Fix missing dependency. 1.22 (2021-06-21) ----------------- - Added support for `healthchecks.io `_ monitoring service. - Added support for `cronhub.io `_ monitoring service. 1.21 (2021-03-11) ----------------- - Made extensive changes to :ref:`manifest ` command to make it more flexible - colorized the output based on file health (green implies healthy, red implies unhealthy) - added ``--no-color`` option to :ref:`manifest ` to suppress colorization - added :ref:`colorscheme` setting. - added :ref:`manifest_default_format` setting. - added support for *Borg* *list* command field names for both reporting and sorting. - added *Emborg* variants to some of the *Borg* field names. - added ``--show-formats`` command line option. - added ``--format`` command line option. - added ``--sort-by-field`` command line option. - change predefined formats to use fields that render faster .. warning:: These changes are not backward compatible. If you have a :ref:`manifest_formats` setting from a previous version, it may need to be updated. - It is now an error for :ref:`prefix` setting to contain ``{{now}}``. - :ref:`Settings ` command will now print a single setting value if its name is given. 1.20 (2021-02-13) ----------------- - Add ``--progress`` command-line option and :ref:`show_progress` option to the :ref:`create ` command. 1.19 (2021-01-02) ----------------- - Added ``--list`` command-line option to the :ref:`prune ` command. 1.18 (2020-07-19) ----------------- - Added ``--repo`` option to :ref:`delete ` command. - Added ``--relocated`` global command-line option. - *Emborg* now automatically confirms to *Borg* that you know what you are doing when you delete a repository or repair an archive. 1.17 (2020-04-15) ----------------- - :ref:`Borg ` command allows archive to be added to ``@repo``. - Added :ref:`encoding` setting. 1.16 (2020-03-17) ----------------- - Refinements and bug fixes. 1.15 (2020-03-06) ----------------- - Improve messaging from *emborg-overdue* - :ref:`Configs ` command now outputs default configuration too. - Some commands now use first subconfig when run with a composite configuration rather than terminating with an error. - Added :ref:`show_stats` setting. - Added ``--stats`` option to :ref:`create `, :ref:`delete ` and :ref:`prune ` commands. - Added ``--list`` option to :ref:`create `, :ref:`extract ` and :ref:`restore ` commands. - Added sorting and formatting options to :ref:`manifest ` command. - Added :ref:`manifest_formats` setting. - Renamed ``--trial-run`` option to ``--dry-run`` to be more consistent with *Borg*. - Add *files* and *f* aliases to :ref:`manifest ` command. - Added :ref:`working_dir` setting. - Added :ref:`do_not_expand` setting. - Added :ref:`exclude_nodump` setting - Added :ref:`patterns` and :ref:`patterns_from` settings. - *Emborg* lock file is now ignored if the process it references is no longer running - Support ``--repair`` option on :ref:`check command `. 1.14 (2019-12-31) ----------------- - Remove debug message accidentally left in *emborg-overdue* 1.13 (2019-12-31) ----------------- - Enhance *emborg-overdue* to work on clients as well as servers 1.12 (2019-12-25) ----------------- - Added :ref:`default_mount_point` setting. - Fixed some issues with :ref:`borg ` command. - Added ``--oldest`` option to :ref:`due ` command. 1.11 (2019-11-27) ----------------- - Bug fix release. 1.10 (2019-11-11) ----------------- - Bug fix release. 1.9 (2019-11-08) ---------------- - Added ability to check individual archives to the :ref:`check ` command. - Made latest archive the default for :ref:`check ` command. - Allow :ref:`exclude_from ` setting to be a list of file names. 1.8 (2019-10-12) ---------------- - Remove duplicated commands. 1.7 (2019-10-07) ---------------- - Fixed bug that involved the Boolean Borg settings (:ref:`one_file_system `, :ref:`exclude_caches `, ...) 1.6 (2019-10-04) ---------------- - Added :ref:`restore ` command. - Added :ref:`verbose ` setting. 1.5 (2019-09-30) ---------------- - Added composite configurations. - Added support for multiple backup configurations in a single repository. - Added :ref:`prefix ` and :ref:`exclude_from ` settings. - Provide default value for :ref:`archive ` setting. - Add ``--all`` command line option to :ref:`mount ` command. - Add ``--include-external`` command line option to :ref:`check `, :ref:`list `, :ref:`mount `, and :ref:`prune ` commands. - Add ``--sort`` command line option to :ref:`manifest ` command. - Add ``--latest`` command line option to :ref:`delete ` command. - Added ``--quiet`` command line option - :ref:`umount ` command now deletes directory used as mount point. - Moved log files to ~/.local/share/emborg (run 'mv ~/.config/emborg/\*.{log,lastbackup}\* ~/.local/share/emborg' before using this version). 1.4 (2019-04-24) ---------------- - Added *ssh_command* setting - Added ``--fast`` option to :ref:`info ` command - Added *emborg-overdue* executable - Allow :ref:`run_before_backup ` and :ref:`run_after_backup ` to be simple strings 1.3 (2019-01-16) ---------------- - Added the raw :ref:`borg ` command. 1.2 (2019-01-16) ---------------- - Added the :ref:`borg_executable ` and :ref:`passcommand ` settings. 1.1 (2019-01-13) ---------------- - Improved and documented API. - Creates the settings directory if it is missing and add example files. - Added ``--mute`` command line option. - Support multiple email addresses in :ref:`notify `. - Added warning if settings file is world readable and contains a passphrase. 1.0 (2019-01-09) ---------------- - Added :ref:`remote_path ` setting. - Formal public release. 0.3 (2018-12-25) ---------------- - Initial public release (beta). 0.0 (2018-12-05) ---------------- - Initial release (alpha).