https://git.schokokeks.org/derivepassphrase.git/tree/fe7b6349a5c5781a4d1b1ecf16d976e43d0e7f95 Recent commits feed provided by GitList. 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 The revised wording spells out the strength guarantee of the derivation scheme and the purpose of the configuration file more explicitly. We intentionally keep the introductory sentences (one-line description and first sentence of the first explanatory paragraph) different, because they have different contexts to work with; in particular, the manpage contains a synopsis section and can refer to the SERVICE metavar in its one-line description, whereas the README cannot, and should also mention SSH keys early. https://git.schokokeks.org/derivepassphrase.git/commit/43032ef813ac40a46e08eda067e015fafaa1475b software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 23:36:49 +0100 43032ef813ac40a46e08eda067e015fafaa1475b https://git.schokokeks.org/derivepassphrase.git/commit/305e91f7e73693f0950def7f377273cad6286bb9 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 23:27:39 +0100 305e91f7e73693f0950def7f377273cad6286bb9 The remaining re-linting changes pertain to new linting codes: * TC006/runtime-cast-value (formerly TCH006) suggests that cast calls use stringified type declarations. Implemented. * B033/duplicate-value requires sets not to contain duplicate values. This is used in the `_types.js_truthiness` function to both test against and to document all of the falsy values except NaN. Ignored. * RUF043/pytest-raises-ambiguous-pattern requires patterns in the `match` argument of `pytest.raises` to be either raw strings, or passed through `re.escape`. Implemented. * RUF046/unnecessary-cast-to-int forbids explicitly casting the result of `math.ceil` to int. I believe `mypy`/`typeshed` originally had problems with this, but this no longer appears to be the case. Implemented. https://git.schokokeks.org/derivepassphrase.git/commit/b3fcb7eb5a39c0982bbcf859a7bfc0a3647093e4 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 22:44:39 +0100 b3fcb7eb5a39c0982bbcf859a7bfc0a3647093e4 We update `ruff` to v0.8.x and reformat the sources. Most conspicuously, `assert` statements typically no longer break the condition to test, and rather push the error message to the next line instead. Also, some implicit string concatenations are undone if they *do* fit onto a single line. We also re-lint the sources, and commit part of the linting fixes. Specifically, omissions in the docstring (raised exceptions, return values) are now marked as linting errors on the docstring itself, instead of at the omitted object (`raise` or `return` statement). Alternatively, we add the missing info to the docstring. We also commit linting fixes regarding improper usage of underscores in variable names (leading underscore instead of trailing underscore on temporary variables). Finally, we correct some improper calls to the logging system (root logger instead of application logger). https://git.schokokeks.org/derivepassphrase.git/commit/3d73e3e0b1e20782bbbea8fa8f5cd113b10757f2 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 22:44:39 +0100 3d73e3e0b1e20782bbbea8fa8f5cd113b10757f2 https://git.schokokeks.org/derivepassphrase.git/commit/0674f72ee86cfcb17b37361c0f0d5918cadce843 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 22:44:39 +0100 0674f72ee86cfcb17b37361c0f0d5918cadce843 * t/i18n-fixes: Add more translator's comments Fix missing context in CANNOT_UNDERSTAND_AGENT translatable string Fix phrasing of "Cannot update %s settings" message https://git.schokokeks.org/derivepassphrase.git/commit/650c227a80754abd94c88c77b7a1768905798e02 software@the13thletter.info (Marco Ricci) Tue, 07 Jan 2025 22:44:15 +0100 650c227a80754abd94c88c77b7a1768905798e02