Recent commits to derivepassphrase.git (f2585c5ec1b1cb0f5bc7a2d924e294497696d9d6)

Fix tests for rephrased "Cannot update the %s settings" message

2025-01-11T18:51:01+01:00

The rephrasing was introduced in
1b29904d789be7742119bfa06ce11aa5b7ffb6f9.
</pre>

Fix translation string formatting of preformatted paragraphs

2025-01-11T16:33:03+01:00

Due to a sign error, the paragraph content was being dropped.

And since we now actively include translation strings with preformatted
paragraphs, include coverage tracking for this case.
</pre>

Make debug and info messages from exporter subcommands translatable

2025-01-11T16:28:48+01:00

We add all debug and info messages from the `derivepassphrase export
vault` subcommand to the translatable strings enums.  We also improve
several debug messages from the "inline calculation" style to the more
easily translatable "tabular listing of relevant data" style.

Two unimportant info messages were dropped:

  * Attempting to parse as v0.2 configuration
  * Attempting to parse as v0.3 configuration
</pre>

Overhaul all other manpages and copyedit everything for consistency

2025-01-11T15:38:02+01:00

The top-level `derivepassphrase` command, and the subcommands `export`
and `export vault` now have proper manpages (both manpage and online
formats) similar to `derivepassphrase vault`.

All manpages document the `--help`, `--version`, `--debug`, `--verbose`
and `--quiet` options.  If a command only delegates to subcommands,
a SUBCOMMANDS section is now present, and the DESCRIPTION section has
the subcommand listing deduplicated.  The COMPATIBILITY section details
compatibility only for this command, and refers to subcommand manpages
as necessary.

The new manpages do not tabulate their diagnostics yet, nor do they
include examples.
</pre>

Move manpage directory out of docs, to top-level

2025-01-08T14:52:31+01:00

The `docs` directory contains sources for the documentation website, to
be uploaded to the WWW.  While also "online" documentation (in the sense
that they are browsable on the customer's computer system), manpages are
not typically distributed online (in the WWW sense).

Besides, the `docs` directory already contains a rendering of the
manpage.
</pre>

Merge topic branch 'usage-fixes' into master

2025-01-07T23:42:07+01:00

* t/usage-fixes:
  Incorporate revised wording from the manpage into the README
</pre>

Incorporate revised wording from the manpage into the README

2025-01-07T23:36:49+01:00

The revised wording spells out the strength guarantee of the derivation
scheme and the purpose of the configuration file more explicitly.

We intentionally keep the introductory sentences (one-line description
and first sentence of the first explanatory paragraph) different,
because they have different contexts to work with; in particular, the
manpage contains a synopsis section and can refer to the SERVICE metavar
in its one-line description, whereas the README cannot, and should also
mention SSH keys early.
</pre>

Fix omissions of `tomli` (Python 3.9 and 3.10) and PyPy in the README

2025-01-07T23:27:39+01:00

</pre>

Add remaining re-linting changes (part 2 of 2)

2025-01-07T22:44:39+01:00

The remaining re-linting changes pertain to new linting codes:

  * TC006/runtime-cast-value (formerly TCH006) suggests that cast calls
    use stringified type declarations.  Implemented.

  * B033/duplicate-value requires sets not to contain duplicate values.
    This is used in the `_types.js_truthiness` function to both test
    against and to document all of the falsy values except NaN.
    Ignored.

  * RUF043/pytest-raises-ambiguous-pattern requires patterns in the
    `match` argument of `pytest.raises` to be either raw strings, or
    passed through `re.escape`.  Implemented.

  * RUF046/unnecessary-cast-to-int forbids explicitly casting the result
    of `math.ceil` to int.  I believe `mypy`/`typeshed` originally had
    problems with this, but this no longer appears to be the case.
    Implemented.
</pre>

Update ruff to v0.8.x, reformat and re-lint (part 1 of 2)

2025-01-07T22:44:39+01:00

We update `ruff` to v0.8.x and reformat the sources.  Most
conspicuously, `assert` statements typically no longer break the
condition to test, and rather push the error message to the next line
instead.  Also, some implicit string concatenations are undone if they
*do* fit onto a single line.

We also re-lint the sources, and commit part of the linting fixes.
Specifically, omissions in the docstring (raised exceptions, return
values) are now marked as linting errors on the docstring itself,
instead of at the omitted object (`raise` or `return` statement).
Alternatively, we add the missing info to the docstring.  We also commit
linting fixes regarding improper usage of underscores in variable names
(leading underscore instead of trailing underscore on temporary
variables).  Finally, we correct some improper calls to the logging
system (root logger instead of application logger).
</pre>