https://git.schokokeks.org/derivepassphrase.git/tree/5507510b6e8800ac739fd5ce5de3b3a6d771dce4 Recent commits feed provided by GitList. Use examples in doctests where it makes didactical sense. https://git.schokokeks.org/derivepassphrase.git/commit/5507510b6e8800ac739fd5ce5de3b3a6d771dce4 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 23:28:32 +0100 5507510b6e8800ac739fd5ce5de3b3a6d771dce4 Now that the constructor for translatable string enum values is homogeneous, split the constructor into a curried two-step function call. This should hopefully look much better visually separated when rendered in the API documentation than the current solution, because the rendering normalizes the multiline strings into single-line strings with escape sequences. (This commit only splits the arguments into the two-step function call; the arguments have not yet been trimmed or normalized.) https://git.schokokeks.org/derivepassphrase.git/commit/3d077627bc7f337b394d9a265c54b6042df3f4e8 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 22:44:58 +0100 3d077627bc7f337b394d9a265c54b6042df3f4e8 https://git.schokokeks.org/derivepassphrase.git/commit/8075959562a0ba81ec2468af6e470e85f720f5df software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 18:05:33 +0100 8075959562a0ba81ec2468af6e470e85f720f5df Use an ID system similar to the trove classifiers used the Python packaging authority. (Enum members were not reordered according to this new ID system.) https://git.schokokeks.org/derivepassphrase.git/commit/0e8eaab68ebf814292a967aecf1315839baadd4d software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 17:36:18 +0100 0e8eaab68ebf814292a967aecf1315839baadd4d We do need to keep track of the trimming status when adding those variants to the cache, because the debug output formatter will discover the trimmed fields in the template anyway and otherwise attempt to emit them. So store the set of trimmed fields in the cache for each message, and pass it on to the formatter. We will assume that if a field gets trimmed, then it had a `None` value, which is true for all the fields we currently support trimming. https://git.schokokeks.org/derivepassphrase.git/commit/ede0e19df43c7bfd4d20199f918afc62df29e3b0 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 17:28:25 +0100 ede0e19df43c7bfd4d20199f918afc62df29e3b0 Copyright messages and the creation date will bear the source date epoch value. https://git.schokokeks.org/derivepassphrase.git/commit/61a16b1ca63e9019311836f286b6c2ae713710fd software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 16:16:12 +0100 61a16b1ca63e9019311836f286b6c2ae713710fd Save for a few factory functions to make enum definitions more readable, the normalization machinery for translatable strings belongs in their class. I originally coded this separately because I mistakenly believed that `typing.NamedTuple` classes cannot contain methods of their own. https://git.schokokeks.org/derivepassphrase.git/commit/e7887804003dc277a9095956ffb7a44cb90608f4 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 15:49:08 +0100 e7887804003dc277a9095956ffb7a44cb90608f4 The debug translations object and the `.po` file writer now properly support translation strings with the filename portion trimmed. Effectively, these are separate translation strings, and as such they need separate cache entries and separate `.po` entries. To fully support this, the translatable string itself now knows how to trim the filename replacement field, which the debug translations object now honors. The `.po` writer still needs the enum name to construct the message ID, but now it takes an optional transformed string to use instead of the enum value, if given. One additional minor fix to the debug translator: some of the emitted translated messages interpolate other translated messages (such as metavars). Thus when interpolating arguments, if the argument is a translated string, then stringify it before interpolation. This avoids printing the `repr` of the inner translated string, which is otherwise very common for debug translation output. https://git.schokokeks.org/derivepassphrase.git/commit/c0b2e8ab4fd0a0ff9dd1a158502d4f70c85d7721 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 14:50:03 +0100 c0b2e8ab4fd0a0ff9dd1a158502d4f70c85d7721 Introduce a `DebugTranslations` object that returns the enum name of the given message as its translation, including the parameters to be interpolated. Rename the `_format_pot_file` to `_format_po_file` and expand it to emit either a template file or a debug translation `.po` file. This differs slightly in the header, and in whether the translations are empty by default or filled in with the enum name. The ad-hoc command-line interface now accepts options to select the template or the debug translation, and a way to explicitly override the declared version of the `.po` template. Because of negative experience with the `poedit` translations editor, the message-ID (enum name) is no longer embedded as a (pseudo-)location of the message string, but rather embedded as a translators' comment. https://git.schokokeks.org/derivepassphrase.git/commit/7986212a1f6a9ab0b4ba5d983e8a9846c90b47ea software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 14:19:27 +0100 7986212a1f6a9ab0b4ba5d983e8a9846c90b47ea This is getting annoying to type, and error-prone to update. https://git.schokokeks.org/derivepassphrase.git/commit/7483aceb6e937bda5c0128129a4076b4df197d06 software@the13thletter.info (Marco Ricci) Mon, 13 Jan 2025 14:09:49 +0100 7483aceb6e937bda5c0128129a4076b4df197d06