https://git.schokokeks.org/derivepassphrase.git/tree/8f9fa0e9819f814b7638a3dd8f705ac6b84d2611 Recent commits feed provided by GitList. `click` already includes shell completion out of the box, so what remained to be done was to tell `click` what kind of values the arguments expect: * The `path` argument for `derivepassphrase export vault` will be completed with a filename or the string `VAULT_PATH`. Because this is not (as a whole) a supported standard category of completion items, we must generate the completion items ourselves in this case, including the partial filtering of results. * The `path` argument to the `--import` and `--export` options of `derivepassphrase vault` will be completed with a filename. `click` handles this for us. * The `service` argument to `devirepassphrase vault` will be completed with a service name, which we must manually extract and filter. The shell completion has so far only been tested interactively; in particular, it is currently excluded from coverage testing. https://git.schokokeks.org/derivepassphrase.git/commit/8f9fa0e9819f814b7638a3dd8f705ac6b84d2611 software@the13thletter.info (Marco Ricci) Wed, 01 Jan 2025 00:21:55 +0100 8f9fa0e9819f814b7638a3dd8f705ac6b84d2611 https://git.schokokeks.org/derivepassphrase.git/commit/a254e71ee699f479fa70264f7d1a8110cb4777f5 software@the13thletter.info (Marco Ricci) Wed, 01 Jan 2025 00:17:17 +0100 a254e71ee699f479fa70264f7d1a8110cb4777f5 Exclude further machinery from coverage that isn't meant to be tested. https://git.schokokeks.org/derivepassphrase.git/commit/220d71df817f2662308efab15e98f138fd6dde18 software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 23:58:59 +0100 220d71df817f2662308efab15e98f138fd6dde18 Reimplement the machinery for displaying help texts and version information, supporting translatable strings. Besides the one-line help texts for the `--help` and `--version` options, the version information text is a translatable string itself, in case the name and version number should be rearranged, or prefixed or suffixed, or whatever. https://git.schokokeks.org/derivepassphrase.git/commit/f6e66845b1b4c889aae2f7833678eed2e49c5ae6 software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 22:30:36 +0100 f6e66845b1b4c889aae2f7833678eed2e49c5ae6 Apparently, we overlooked this in 59d73c8320650a6bcb77eed759c694949d350cdb. https://git.schokokeks.org/derivepassphrase.git/commit/b225fb3b9cf104a042d810a2b82cd484cc7d5f33 software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 22:18:29 +0100 b225fb3b9cf104a042d810a2b82cd484cc7d5f33 Remove the `args` argument to the error callback and to the underlying `logging` function, forcing logger to skip log message interpolation in any case. https://git.schokokeks.org/derivepassphrase.git/commit/0e31ed481bf84684233c909ae8f559c360386fb1 software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 22:08:02 +0100 0e31ed481bf84684233c909ae8f559c360386fb1 https://git.schokokeks.org/derivepassphrase.git/commit/73f1128336d79d6f1ee0d8d783d58d6c6d629cc3 software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 18:40:01 +0100 73f1128336d79d6f1ee0d8d783d58d6c6d629cc3 To be used together with the gettext toolset. Many things are hard-coded. https://git.schokokeks.org/derivepassphrase.git/commit/357468984efebf66365a5dfac75010d7120e42ce software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 16:03:01 +0100 357468984efebf66365a5dfac75010d7120e42ce https://git.schokokeks.org/derivepassphrase.git/commit/dc3b7bab8ee8b59e7a1d60315b59e296dce51f2e software@the13thletter.info (Marco Ricci) Tue, 31 Dec 2024 16:03:01 +0100 dc3b7bab8ee8b59e7a1d60315b59e296dce51f2e We implement the translations in a deferred manner, via objects that stringify to their correct translation. Since `click` 8.1, help texts are (mostly) stored first and processed only when the help page is emitted. Accordingly, this system can be adapted to support our translatable strings: we need only ensure the help text is stringified just before it is formatted and emitted. This in turn can be achieved by reimplementing the help page assembly and formatting in a custom `click.Command` class, as has already been done to implement help/option group support. Once this is in place, it remains to exchange all inline help texts with the corresponding translatable string, and adapt the tests to the new messages. While most of the changes are straightforward, some subtleties remain. First, the help texts are now supplied as (separately translatable) paragraphs to the `click.command` decorator, instead of being extracted from the respective function docstring. The docstrings in return have been shortened down. Second, since the new capabilities are implemented via custom `click.Command`, `click.MultiCommand` and `click.Option` subclasses, every option and command must derive from one of these classes. This necessitates the creation of an empty `StandardOption` class for options without an option group, and making `_DefaultToVaultGroup` a subclass of `CommandWithHelpGroups`. Third, since the `click.Option` class actually processes its help text eagerly, the subclass must hide the (non-string) help text from the `click.Option` constructor and later restore it. Finally, while the tests currently pass as before, they now implicitly rely on *not* loading any translations. Furthermore, there is no mechanism in place with which to isolate the translation system from the user's environment for testing purposes, nor is there a (controlled) mechanism to test `derivepassphrase` under a different language. Once there are actual translations, future commits will need to establish such a missing mechanism for translation loading/switching/forcing. https://git.schokokeks.org/derivepassphrase.git/commit/59d73c8320650a6bcb77eed759c694949d350cdb software@the13thletter.info (Marco Ricci) Mon, 30 Dec 2024 23:45:01 +0100 59d73c8320650a6bcb77eed759c694949d350cdb