Recent commits to derivepassphrase.git (7483aceb6e937bda5c0128129a4076b4df197d06)

Hide translation template enums behind a type alias

2025-01-13T14:09:49+01:00

This is getting annoying to type, and error-prone to update.
</pre>

Merge topic branch 'harmonize-exporter-interface' into master

2025-01-13T12:40:34+01:00

* t/harmonize-exporter-interface:
  Add changelog entry for export handler interface harmonization
  Test the export handler dispatcher as well as the handlers directly
  Harmonize the interface for both vault config export handlers
  Accept all bytes-like objects as byte strings in the export subcommand
</pre>

Add changelog entry for export handler interface harmonization

2025-01-11T20:06:57+01:00

</pre>

Test the export handler dispatcher as well as the handlers directly

2025-01-11T19:04:57+01:00

For each test calling an export handler directly, also perform the test
when calling the export handler dispatcher.
</pre>

Harmonize the interface for both vault config export handlers

2025-01-11T19:04:57+01:00

Harmonize the interface for the `storeroom` and the `vault_native`
config export handlers.  Specifically, introduce a common interface
`exporter.ExportVaultConfigDataFunction` which all such handlers must
adhere to, as well as a registry of handlers and a decorator for
registering handlers immediately upon definition.  A new top-level
function `exporter.export_vault_config_data` adhering to this interface
will dispatch to the correct implementation, based on the handler
registry; its use is recommended over calling the handlers directly.

Though it is not encoded in the programmatic interface definition, the
intent is to use common exceptions and exception messages for common
failure modes.  (The intended meanings of the exceptions are listed in
the docstring of `exporter.export_vault_config_data`.)  Specifically,
introduce a new error message constant for when a given handler name is
not registered in the registry, and an exception class
`exporter.NotAVaultConfigError` for when the target path cannot be
decrypted and decoded in the requested vault config encoding format with
the given or inferred storage master key.  Also update some outdated or
wrong aspects of the handler docstrings.

Additionally, the registry is empty upon definition to avoild circular
imports.  A separate call to the
`exporter.find_vault_config_data_handlers` function is necessary to
populate the standard set of handlers.
`exporter.export_vault_config_data` will call this automatically.

Because of this updated interface, the
`vault_native.export_vault_native_data` handler no longer supports
specifying multiple formats to try.  The caller in
`derivepassphrase.cli` already handles trying multiple formats natively,
but additionally no longer dispatches to the handler functions itself,
relying on `exporter.export_vault_config_data` for this task instead.

Finally, update the tests to include the handler registry, the
decorator, the change of parameter names and the change in handling
attempting multiple formats.
</pre>

Accept all bytes-like objects as byte strings in the export subcommand

2025-01-11T19:04:57+01:00

This is a breaking API change, because some function return types have
been widened.
</pre>

Merge topic branch 'usage-fixes' into master

2025-01-11T18:54:56+01:00

* t/usage-fixes:
  Fix tests for rephrased "Cannot update the %s settings" message
</pre>

Fix tests for rephrased "Cannot update the %s settings" message

2025-01-11T18:51:01+01:00

The rephrasing was introduced in
1b29904d789be7742119bfa06ce11aa5b7ffb6f9.
</pre>

Merge topic branch 'usage-fixes' into master

2025-01-11T16:39:58+01:00

* t/usage-fixes:
  Fix translation string formatting of preformatted paragraphs
  Make debug and info messages from exporter subcommands translatable
</pre>

Fix translation string formatting of preformatted paragraphs

2025-01-11T16:33:03+01:00

Due to a sign error, the paragraph content was being dropped.

And since we now actively include translation strings with preformatted
paragraphs, include coverage tracking for this case.
</pre>