Recent commits to derivepassphrase.git (e737a9ebaaf48e2b741791cc730b36ca30b7bbf2)

Move the tests for the stubbed SSH agent socket to the machinery tests

2025-11-30T14:23:54+01:00

Even though the stubbed SSH agent socket exists to test the
`derivepassphrase.ssh_agent` module, it is still a piece of testing
machinery at its core, and thus belongs in the same place as the other
testing machinery tests belong.  Additionally, although the "basic"
tests for the `derivepassphrase.ssh_agent` module are already a giant
mixed bag of non-heavy-duty tests that all involve functionality from
the `derivepassphrase.ssh_agent` module, the stubbed SSH agent socket
tests differ from the other tests insofar as the other tests focus on
establishing correctness of the `derivepassphrase.ssh_agent` machinery,
whereas the stubbed SSH agent socket tests focus on the stubbed SSH
agent socket.  This, too, suggests that the stubbed SSH agent socket
tests do not belong in the same test module as the
`derivepassphrase.ssh_agent` tests.
</pre>

Add module docstrings for the tests hierarchy.

2025-11-30T13:54:36+01:00

Consistently add docstrings to all modules in the tests hierarchy that
would appear in the (developer setup) documentation.
</pre>

Add a changelog entry for the test suite refactoring

2025-11-30T10:08:07+01:00

</pre>

Format and lint all files

2025-11-30T09:35:38+01:00

</pre>

Fix type errors due to click 8.2.0

2025-11-29T22:35:16+01:00

`click` 8.2.0 broke compatibility in an unexpectingly violent way,
removing previously public symbols without any transition period.  Thus,
the code may or may not type check, depending on which version of
`click` is installed.  We thus disable type checking or otherwise type
check on a more coarse level whereever we used one of the now-removed
symbols.
</pre>

Fix typing of the dummy vault configuration settings in the constructor

2025-11-27T21:59:27+01:00

One of our tests, a "manual sanity-check" kind of test, tries to use the
`tests.data.DUMMY_CONFIG_SETTINGS` symbol as keyword arguments in the
`vault.Vault` constructor.  This appeared to work with older `mypy`
versions, but now raises an error about extra keys in the symbol that
the constructor does not accept as keyword arguments.  (Because the
dummy config settings are actually typed as vault config "services"
settings, which *do* allow more settings than the constructor uses as
arguments.)

So, we now arrange for a second symbol with effectively the same
contents as the dummy config settings, but explicitly typed as
constructor arguments, to be used in the "manual sanity-check" test
instead.

(Implementation-wise, we introduce a new base type
`_types.VaultConstructorArgs`, and let
`_types.VaultConfigServicesSettings` inherit from that.  This is easier
than attempting to constrain the latter type after the fact.  We
introduce the new base type directly in the `_types` module, even though
it is otherwise only used in the tests, because the derived type (from
the `_types` module) also needs access during construction.)
</pre>

Add CPython 3.14 to the list of test environments

2025-11-26T21:02:16+01:00

By now, CPython 3.14 has been released, as has a more recent version of
`hatch` that knows where to obtain CPython 3.14.  It is thus viable to
officially test with CPython 3.14 with only standard `hatch` installs.
</pre>

Fix more broken tests on The Annoying OS

2025-11-26T20:50:58+01:00

The broken tests relate to SSH agent handling.  We now have a fake SSH
agent, and I mistakenly believed that because this agent is always
available, tests no longer needed to ensure agent accessibility; the
fake agent would always be available.  But that's not how the SSH agent
test fixture works: you still need to explicitly *request* the agent as
part of your setup.  Otherwise you will run into the usual "no agent
could be located" or "no agent is supported on this system" error
situations (which is exactly what was happening on The Annoying OS).
The only thing that really changed is that we now know that *some* of
the test fixture instances (the ones with fake agents) will not
auto-skip due to lack of support.
</pre>

Fix broken links in the documentation caused by renaming or splitting modules

2025-11-26T20:49:34+01:00

</pre>

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>