v17.0.0.rc0

• Fixed mboxrd serialization bug where lines beginning with From: (and other
  From-prefixed tokens) were incorrectly quoted.
  Only lines beginning with From (with a trailing space) are now quoted, as required by the mboxrd format.
• Bumped imap metadata format version to 3.1. Existing version 3 files are migrated on load using the previous deserialization logic.

German Localization

This release adds German (de) localization (thanks to @kennymc-c), adding to Italian which was recently released.

i18n Support

This release adds internationalisation to support to the setup system and error messages.

Currently, the supported languages are English and Italian.

Add more logging to Thunderbird exporter

Added more logging to the Thunderbird export utility to aid debugging failures.

Fix Bug With Account Locking on macOS

Handle getting the process start time on macOS.

Exclusively Lock Accounts During Operations that Update the Backup

Changed

• The Account local_path is now a required parameter.
• Accounts are locked during operations that modify them: backup, restore, copy,
  mirror, migrate, ignore history.
• Ruby 3.0 and 3.1 are no longer supported.

Added

• Ruby 4.0 to the CI matrix

Add an ERB Configuration Option

This release adds an --erb-configuration option to allow the use of ERB templating instead of a plain JSON configuration file.

This allows a way to keep passwords, and other sensitive information out of configuration files.

An ERB template file (config.json.erb) might look like:

    {                                                                              
      "accounts": [
        {              
          "username": "user@example.com", 
          "password": "<%= ENV['IMAP_PASSWORD'] %>",
          "server": "imap.example.com"
        }                                                                          
      ]
    }                  

N.B. As the Ruby code in the ERB blocks is executed, this approach introduces the risk of arbitrary code execution, so an ERB template configuration modifiable by a third party should be carefully vetted before being used.

Add Account Status Support for Managing Decommissioned Accounts

Implements support for setting accounts to "archived" or "offline" status to prevent decommissioned accounts from being included in regular backups while still allowing migration operations.

Skip GMail's "Noselect" folders

Ignore GMail's non-folders, i.e. "[Gmail]".

Introduce the `copy` command

Added

• Added the new imap-backup copy command to replace the existing
  migrate and mirror commands. The new command is simpler
  than the exiting commands, while maintaining the principal functionality
  that was previously available. migrate and mirror are now deprecated
  and will be removed in a future release.

Changed

• The library now uses logger and ostruct as external dependencies
  as they have been extracted from the Ruby standard library.