Recent commits to derivepassphrase.git (2cc4e4fffab112760803e80084f665d87b468069)

Refactor vault config validity checking and falsy value cleanup functions

2025-01-21T21:02:31+01:00

Introduce a new workhorse class that provides the validity checking and
the falsy value cleanup functionality.  The existing top-level functions
are now mere facades.  The primary reason is to keep the complexity and
the nesting level of these functions low-ish: they still trigger linting
errors that need to be silenced, but the nesting is tamer, and some
common functionality (e.g., tree traversal) can be usefully extracted.
</pre>

Check at runtime if deprecated keyword arguments are used

2025-01-21T21:02:31+01:00

The `warnings.deprecated` decorator sadly does not do anything at
runtime if merely one of several overloads is deprecated.  And it seems
to fail even if the deprecated signature is actively used; see
`_types.is_vault_config`.  Implement a known working solution to check
if the deprecated keyword argument was supplied.

(No tests yet, so excluded from coverage.)
</pre>

Merge topic branch 'pathlib' into master

2025-01-20T18:00:28+01:00

* t/pathlib:
  Use `pathlib` for path or filename operations
</pre>

Use `pathlib` for path or filename operations

2025-01-20T18:00:12+01:00

The interface was already supported by all the user-facing code
(interestingly enough) and by almost all of the internal code.  Using
`pathlib.Path` objects directly instead of manually dealing with string
or byte string collections does cut down on a lot of the otherwise
explicit bookkeeping and context management.

Some changes to the tests are necessary because other (or more)
functions need to be mocked, or other ways of testing successful or
ensuring unsuccessful operations are needed.
</pre>

Merge topic branch 'documentation-fixes' into master

2025-01-20T15:27:30+01:00

* t/documentation-fixes:
  Make `T_Buffer` type variable visible at runtime again
  Adapt "storeroom" tests to use new names for helper functions
</pre>

Make `T_Buffer` type variable visible at runtime again

2025-01-20T15:21:59+01:00

Apparently this is necessary to keep the class properly importable:
subclassing `typing.Generic` with a runtime-invisible type variable or
with a string fails.
</pre>

Adapt "storeroom" tests to use new names for helper functions

2025-01-20T15:10:25+01:00

The names changed in d58a3abf705eba597a358c323416c325aa649a02, but the
tests were still using the old names.  Oops.
</pre>

Merge topic branch 'documentation-fixes' into master

2025-01-19T23:57:06+01:00

* t/documentation-fixes:
  Add CLI messages module to documentation
  Add docstrings for CLI messages module
  Reformat changelog preamble, and mention exceptions to the public API
  Convert the Deprecated section to an admonition
  Rename and expose the Buffer-ish TypeVar for prettier documentation
  Make the "storeroom" module's helper functions private but documented
  Move vault config exporter functions to the top
  Expose the `EVP_BytesToKey` implementation at class level
  Fix the parsing of options to `mkdocstrings` in the reference pages
  Document internal functions of the vault config exporter
  Consolidate ExportVaultConfigDataFunction documentation
  Reset excluded doc files for offline documentation builds
  Remove license text from some docstrings in `derivepassphrase.cli`
  Copyedit "altered versions" license FAQ
  Fix links and other wrapping-related formatting in changelog
</pre>

Add CLI messages module to documentation

2025-01-19T23:56:09+01:00

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.
</pre>

Add docstrings for CLI messages module

2025-01-19T23:56:09+01:00

Also rename the `_Commented` pseudo-decorator function to `commented`,
and the `_TranslatedStringConstructor` protocol (a typo) to
`TranslatableStringConstructor`.
</pre>