https://git.schokokeks.org/derivepassphrase.git/tree/9b9febbf4861ef7d6917367965677a58fd7ce1ad Recent commits feed provided by GitList. https://git.schokokeks.org/derivepassphrase.git/commit/9b9febbf4861ef7d6917367965677a58fd7ce1ad software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 20:06:57 +0100 9b9febbf4861ef7d6917367965677a58fd7ce1ad For each test calling an export handler directly, also perform the test when calling the export handler dispatcher. https://git.schokokeks.org/derivepassphrase.git/commit/d25cdbdd2494feabfb29e8d8a6d8f695475bf7a2 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 19:04:57 +0100 d25cdbdd2494feabfb29e8d8a6d8f695475bf7a2 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. https://git.schokokeks.org/derivepassphrase.git/commit/0ecb8a91d39b699816e21d6e215878ddc50252e3 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 19:04:57 +0100 0ecb8a91d39b699816e21d6e215878ddc50252e3 This is a breaking API change, because some function return types have been widened. https://git.schokokeks.org/derivepassphrase.git/commit/a9bd473172968db23d6b79c7a12ad7bdb9203d3c software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 19:04:57 +0100 a9bd473172968db23d6b79c7a12ad7bdb9203d3c The rephrasing was introduced in 1b29904d789be7742119bfa06ce11aa5b7ffb6f9. https://git.schokokeks.org/derivepassphrase.git/commit/f2585c5ec1b1cb0f5bc7a2d924e294497696d9d6 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 18:51:01 +0100 f2585c5ec1b1cb0f5bc7a2d924e294497696d9d6 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. https://git.schokokeks.org/derivepassphrase.git/commit/70be2295f958ed99bac34e2adc469d6d94a68a11 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 16:33:03 +0100 70be2295f958ed99bac34e2adc469d6d94a68a11 We add all debug and info messages from the `derivepassphrase export vault` subcommand to the translatable strings enums. We also improve several debug messages from the "inline calculation" style to the more easily translatable "tabular listing of relevant data" style. Two unimportant info messages were dropped: * Attempting to parse as v0.2 configuration * Attempting to parse as v0.3 configuration https://git.schokokeks.org/derivepassphrase.git/commit/fe7b6349a5c5781a4d1b1ecf16d976e43d0e7f95 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 16:28:48 +0100 fe7b6349a5c5781a4d1b1ecf16d976e43d0e7f95 The top-level `derivepassphrase` command, and the subcommands `export` and `export vault` now have proper manpages (both manpage and online formats) similar to `derivepassphrase vault`. All manpages document the `--help`, `--version`, `--debug`, `--verbose` and `--quiet` options. If a command only delegates to subcommands, a SUBCOMMANDS section is now present, and the DESCRIPTION section has the subcommand listing deduplicated. The COMPATIBILITY section details compatibility only for this command, and refers to subcommand manpages as necessary. The new manpages do not tabulate their diagnostics yet, nor do they include examples. https://git.schokokeks.org/derivepassphrase.git/commit/a8c8e836c3a10834415a51e15a8cfadb1c752334 software@the13thletter.info (Marco Ricci) Sat, 11 Jan 2025 15:38:02 +0100 a8c8e836c3a10834415a51e15a8cfadb1c752334 The `docs` directory contains sources for the documentation website, to be uploaded to the WWW. While also "online" documentation (in the sense that they are browsable on the customer's computer system), manpages are not typically distributed online (in the WWW sense). Besides, the `docs` directory already contains a rendering of the manpage. https://git.schokokeks.org/derivepassphrase.git/commit/50a83cf2b55863760234c34f54c0ed8e69d30ac2 software@the13thletter.info (Marco Ricci) Wed, 08 Jan 2025 14:52:31 +0100 50a83cf2b55863760234c34f54c0ed8e69d30ac2 * t/usage-fixes: Incorporate revised wording from the manpage into the README https://git.schokokeks.org/derivepassphrase.git/commit/2b1ca491019b2366b079155ad2a40353814c21e2 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 23:42:07 +0100 2b1ca491019b2366b079155ad2a40353814c21e2