git.schokokeks.org
Repositories
Help
Report an Issue
derivepassphrase.git
Code
Commits
Branches
Tags
Suche
Strukturansicht:
f2b427b
Branches
Tags
documentation-tree
master
unstable/modularize-and-refactor-test-machinery
unstable/ssh-agent-socket-providers
wishlist
0.1.0
0.1.1
0.1.2
0.1.3
0.2.0
0.3.0
0.3.1
0.3.2
0.3.3
0.4.0
0.5.1
0.5.2
derivepassphrase.git
tests
__init__.py
Split the top-level `tests` module into subpackages
Marco Ricci
commited
f2b427b
at 2025-08-08 22:58:18
__init__.py
Blame
History
Raw
# SPDX-FileCopyrightText: 2025 Marco Ricci <software@the13thletter.info> # # SPDX-License-Identifier: Zlib """The `derivepassphrase` test suite. Overview ======== The `derivepassphrase` test suite contains testing support code and the actual unit- and integration-test functions. Layout (test functions) ======================= `derivepassphrase` uses `pytest`, `coverage` and `hypothesis` for testing. Tests are auto-discovered using `pytest`'s test collection machinery and configuration system, and may use `hypothesis` for parametrization. Layout (support code) ===================== The testing support code is divided into five modules in two subpackages: `tests.data`, `tests.data.callables`, `tests.machinery`, `tests.machinery.pytest` and `tests.machinery.hypothesis`. They have strict import requirements: any module in this list may only import data and functionality from modules earlier in this list. * The package `tests.data` includes static test data, types, and associated lightweight machinery (think: accessors, categorization functions, and the like). * The package `tests.data.callables` includes functions that operate on test data, or that alternatively implement stubbed versions of proper `derivepassphrase` functionality. This includes test doubles, if they do not depend on the presence of certain test machinery. Data is only included in this module (instead of in `tests.data`) if it depends on the functions in this module. * The package `tests.machinery` includes data and functions that is not specific to any test system, but which nonetheless is of little value outside of such a system. This includes "fakes", i.e. reasonably complete reimplementations of existing `derivepassphrase` functionality, for comparison or "switching out" purposes. * The package `tests.machinery.pytest` includes `pytest`-specific data and functions, such as marks and parametrization sets. * The package `tests.machinery.hypothesis` includes `hypothesis`-specific data and functions, such as `hypothesis` strategies. """
