Recent commits to derivepassphrase.git (751f013f7398e98809cba085cb1b1fcd11ce5f66) https://git.schokokeks.org/derivepassphrase.git/tree/751f013f7398e98809cba085cb1b1fcd11ce5f66 Recent commits feed provided by GitList. Make `T_Buffer` type variable visible at runtime again Apparently this is necessary to keep the class properly importable: subclassing `typing.Generic` with a runtime-invisible type variable or with a string fails. https://git.schokokeks.org/derivepassphrase.git/commit/751f013f7398e98809cba085cb1b1fcd11ce5f66 software@the13thletter.info (Marco Ricci) Mon, 20 Jan 2025 15:21:59 +0100 751f013f7398e98809cba085cb1b1fcd11ce5f66 Adapt "storeroom" tests to use new names for helper functions The names changed in d58a3abf705eba597a358c323416c325aa649a02, but the tests were still using the old names. Oops. https://git.schokokeks.org/derivepassphrase.git/commit/c66ee5857ee1cea525f7d94596154bd3c80b31ca software@the13thletter.info (Marco Ricci) Mon, 20 Jan 2025 15:10:25 +0100 c66ee5857ee1cea525f7d94596154bd3c80b31ca Add CLI messages module to documentation The "submodule `cli`" will be expanded to a "subpackage `cli`", and `_cli_msg` will be a "virtual submodule" until it is appropriately renamed and relocated into the semantic module hierarchy. https://git.schokokeks.org/derivepassphrase.git/commit/71a8045507fde0fb3734c2c12aa2c204d3cb121b software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 23:56:09 +0100 71a8045507fde0fb3734c2c12aa2c204d3cb121b Add docstrings for CLI messages module Also rename the `_Commented` pseudo-decorator function to `commented`, and the `_TranslatedStringConstructor` protocol (a typo) to `TranslatableStringConstructor`. https://git.schokokeks.org/derivepassphrase.git/commit/ff715a44ba1a9a34bc3c8fa39b12f0b433fc8536 software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 23:56:09 +0100 ff715a44ba1a9a34bc3c8fa39b12f0b433fc8536 Reformat changelog preamble, and mention exceptions to the public API Reformat the changelog preamble into admonitions, instead of a small-print disclaimer-like paragraph. The text largely stays the same, but for the public API, add (module, class) attributes and mention that there are documented implementation details not considered to be part of the public API. https://git.schokokeks.org/derivepassphrase.git/commit/99ab8fabfc2746dac02e8c8a20ee25855f7e55ab software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 22:53:14 +0100 99ab8fabfc2746dac02e8c8a20ee25855f7e55ab Convert the Deprecated section to an admonition The Deprecated section has always been non-standard, and `mkdocstrings-python` recently removed explicit support for this. The recommended alternative is an explicit admonition in section notation (i.e., a section named Warning, or Danger, or whatever), which is still very readable in the docstring and conveys a clear intention. References: [mkdocstrings/python#227](https://github.com/mkdocstrings/python/issues/227). https://git.schokokeks.org/derivepassphrase.git/commit/e6bd089f21c6d89687b7d9141c9135068bb7141a software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 21:46:23 +0100 e6bd089f21c6d89687b7d9141c9135068bb7141a Rename and expose the Buffer-ish TypeVar for prettier documentation Choose the more public name `T_Buffer`, and document this type variable, so that the affected other types' documentation will be easier to read. https://git.schokokeks.org/derivepassphrase.git/commit/354af83ba78530801cc5966490ecf8235295eb82 software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 21:23:12 +0100 354af83ba78530801cc5966490ecf8235295eb82 Make the "storeroom" module's helper functions private but documented https://git.schokokeks.org/derivepassphrase.git/commit/d58a3abf705eba597a358c323416c325aa649a02 software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 21:10:38 +0100 d58a3abf705eba597a358c323416c325aa649a02 Move vault config exporter functions to the top For both the `storeroom` and the `vault_native` modules, move the exporter function to the top of the module. https://git.schokokeks.org/derivepassphrase.git/commit/aa6e4e0a9e54fc22e0184c4ed2d6afa8e04b6a6b software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 21:10:38 +0100 aa6e4e0a9e54fc22e0184c4ed2d6afa8e04b6a6b Expose the `EVP_BytesToKey` implementation at class level This implementation ought to appear in the documentation, which it cannot if it stays an inner function. https://git.schokokeks.org/derivepassphrase.git/commit/771ed1642991e626046bfbb0a5d101a9895d8f98 software@the13thletter.info (Marco Ricci) Sun, 19 Jan 2025 21:10:38 +0100 771ed1642991e626046bfbb0a5d101a9895d8f98