Recent commits to derivepassphrase.git (af0cd7e9e4b0c823bf1385d6942ef7ba44f53649)

Merge topic branch 'split-cli-module' into master

2025-01-29T22:30:02+01:00

* t/split-cli-module:
  Document the trimming of the `cli` module in the changelog
  Split off cli_helpers and cli_machinery internal modules
  Move CLI messages module into a new `_internals` subpackage
</pre>

Document the trimming of the `cli` module in the changelog

2025-01-29T22:29:01+01:00

</pre>

Split off cli_helpers and cli_machinery internal modules

2025-01-29T22:23:26+01:00

Split off the `logging` and `click` support code (the "machinery") and
the command-specific helper functions (the "helpers") into separate
modules under `derivepassphrase._internals`.  Change all functions,
classes and attributes within those new modules to be public with
respect to the module, since the module itself is already non-public.

Also document all previously undocumented classes and functions:
`cli_helpers.ORIGIN`, `cli_helpers.check_for_misleading_passphrase`,
`cli_helpers.key_to_phrase` and `cli_helpers.print_config_as_sh_script`.
Add a better default value (`cli_helpers.default_error_callback`) for
the `error_callback` parameter of `cli_helpers.key_to_phrase`, and
document that too.  Finally, since the shell completion parts are now
split across two modules, add an explicit TODO to the
`cli_machinery.ZshComplete` class to add context.
</pre>

Move CLI messages module into a new `_internals` subpackage

2025-01-29T20:34:40+01:00

Also adjust the headings in the development build of the documentation
to clearly mark internal documentation as internal.

(The absolute imports within the CLI messages module make the move
itself relatively painless: only the callers need to be adjusted to the
new path.)
</pre>

Merge topic branch 'vault-module-api' into master

2025-01-29T16:35:02+01:00

* t/vault-module-api:
  Document API changes in the vault module
  Adjust coverage on vault tests for error-only code paths
  Adjust docstrings for vault "symbol" character class
  Make the vault UUID and CHARSETS attributes public
  Let `Vault` accept Buffer-type values wherever it accepts bytes
</pre>

Document API changes in the vault module

2025-01-29T16:34:22+01:00

</pre>

Adjust coverage on vault tests for error-only code paths

2025-01-29T15:36:12+01:00

Code paths in the tests that only do error handling due to factors
beyond their control (here: unsatisfied hypothesis assumptions, or
re-raising the error) should not be counted towards coverage.
</pre>

Adjust docstrings for vault "symbol" character class

2025-01-29T15:33:36+01:00

The "dash" class is a subset of "symbol", so we can't talk about "all
hitherto unlisted ASCII printable characters", but should list the
exceptions explicitly.
</pre>

Make the vault UUID and CHARSETS attributes public

2025-01-29T15:28:07+01:00

They are constants, they are not priviledged information, and having to
keep indirectly referring to them instead of directly is rather
irritating.
</pre>

Let `Vault` accept Buffer-type values wherever it accepts bytes

2025-01-29T15:07:21+01:00

Any method that accepts `bytes` and `bytearray` now also accepts
arbitrary Buffer-type classes such as `memoryview` and `array.array`.
The return values (mostly `bytes`, sometimes `bytearray`) remain
unchanged.
</pre>