Recent commits to derivepassphrase.git (34d0f5f5b758821133cfe59446fa344978d6f763)

Split the basic command-line tests, again

2025-11-26T20:46:42+01:00

(This is part 11 of a series of refactorings for the test suite.)

Split the basic command-line tests into four thematic groups, in four
separate test files:

  * tests for common subsystems of the `derivepassphrase` CLI, plus
    miscellaneous basic tests

  * basic tests for the `derivepassphrase vault` CLI

  * tests for the configuration management options of the
    `derivepassphrase vault` CLI

  * tests for the note handling machinery of the `derivepassphrase
    vault` CLI

Also update the documentation to reflect the module split.
</pre>

Fix missing documentation in the test suite

2025-08-31T21:24:09+02:00

Update the documentation (files, navigation) to reflect the test files
split and the introduction of the `tests.data` and `tests.machinery`
packages.  Additionally, turn the package descriptions in the `tests`
module docstring into proper hyperlinks.
</pre>

Fix some documentation issues with the heavy-duty command-line inteface tests

2025-08-31T21:18:26+02:00

Fix both docstrings and inline commentary.
</pre>

Refactor the heavy-duty command-line interface tests

2025-08-31T21:09:13+02:00

(This is part 10 of a series of refactorings for the test suite.)

In the heavy-duty command-line tests, factor out common test setups and
common hypothesis strategies.  In particular, share the hypothesis
strategies and the skeletal procedure for both affected state machines
because they offer more or less the same transition rules.

For the hypothesis test machinery, fix some types and some import
aliases that affect the heavy-duty command-line tests.
</pre>

Refactor the "all CLIs" command-line interface tests

2025-08-29T20:00:38+02:00

(This is part 9 of a series of refactorings for the test suite.)

In the "all CLIs" tests for the command-line interface, factor out the
common test operation for the "help text" and "version output" tests.
Both sets of tests are identical for all command-line interface entry
points, save for the command-line and the expected lines/data in the
output.

Furthermore, use a helper function to make the `KnownLineType` enum
definition more pleasant to read.
</pre>

Refactor the basic command-line interface tests

2025-08-29T19:45:20+02:00

(This is part 8 of a series of refactorings for the test suite.)

In the basic tests, factor out the common test operation or the common
environment setup for each group of related tests, whichever is more
feasible.  For some groups of related tests, if there were similar tests
that differed only in details or in parametrization data, combine them
under a new parameter set, if necessary.

Both the test file and the commit should be further split up, but I am
not yet sure how.
</pre>

Fix miscellaneous imports, types and hyperlinks in the CLI machinery and tests

2025-08-29T19:32:37+02:00

(This is part 7 of a series of refactorings for the test suite.)

In the command-line interface tests, remove unnecessary imports/aliasing
of module-level constants, and add typing casts for our own constants
where the syntactical type is not the nominal type.  Furthermore, for
both the command-line interface machinery and the command-line interface
tests, update the hyperlinks to our issue tracker to the equivalent
wishlist entry in the documentation, and update the commentary on the
completion machinery for the Z Shell, removing links to now-resolved
issues in favor of reporting the version number of `click` in which the
issues were fixed.
</pre>

Refactor the testing machinery tests

2025-08-22T19:50:46+02:00

(This is part 6 of a series of refactorings for the test suite.)

Assign all tests to a common class, then elide common parts in the test
names and docstrings.

Also factor out the OpenSSH cipher blocksize for the "none" cipher into
a separate constant, and use that constant in lieu of magic numbers
throughout the helper functions.  We correct one instance of where
double the block size is used, which (if memory serves correctly) was
due to a stylistic difference between OpenSSH- and Pageant-generated
keys, but both conforming to the specification.  These differences are
removed in the canonicalization step anyway, but the double-sized block
size is probably confusing to read if you don't already anticipate the
canonicalization step.
</pre>

Refactor the SSH agent tests

2025-08-17T18:00:57+02:00

(This is part 5 of a series of refactorings for the test suite.)

In the basic tests, for the stubbed SSH agent socket and the agent error
response tests, factor out the common environment setup for the
respective group (in particular, the multiple copies of the fake
`request` function from the SSH agent client).  Combine the SSH agent
data signing tests for suitable and unsuitable keys into a single, more
heavily parametrized test.  (The combined test is branchier, but more
straightforward for discerning the differences between the two types of
keys.)  Also fix some miscellaneous errors: the IDs in the
`RESOLVE_CHAINS` parametrization, and the order of contexts in the
`test_request_error_responses` method.

Further concerning the basic tests, add an explicit test for the
`list-extended@putty.projects.tartarus.org` extension (which the
extended stubbed SSH agent implements to signal support for
deterministic DSA signatures, in a lackluster attempt to masquerade as
Pageant).  Also address a TODO in the test for SSH key selection
concerning degenerate key lists.

In the test data, add an extra comment on how suitable and unsuitable
SSH test keys are determined, and add a function signature for the
SSH agent client `request` function.

In the heavy-duty tests, merely add missing `draw` labels.
</pre>

Refactor the `exporter` tests

2025-08-17T16:42:24+02:00

(This is part 4 of a series of refactorings for the test suite.)

For the `export vault` command-line interface tests, split the tests
into tests for command-line argument support, tests for various
command-line or format-related errors, and the already existing groups
for "storeroom" and "vault v0.2"/"vault v0.3" format tests.  For the
former two groups, factor out the common test operation, which in both
cases is the whole test content, though with differing call conventions.
For the latter two groups, factor out the common environment setup
instead.

For the `exporter` subpackage tests, collect the data generation
strategies in a common class `Strategies` (similar to the `Parametrize`
class).  Split the existing `TestUtilities` class into
a `TestCLIUtilities` and a `TestExportVaultConfigDataHandlerRegistry`
class, and factor out the common environment setup for each respective
group.  Rename the `TestCLI` class into `TestGenericVaultCLIErrors`, and
factor out the common environment setup and the CLI call function.
</pre>