信頼できるひとつの例
ケースは入力、期待結果、名前、任意の説明を持ちます。エディタのdocstring、モック照合、実装チェックは同じケースを参照します。
例を関数先頭へ置くことで、コードレビュー時にも仕様と実装を同じ画面で確認できます。
3つの動作モード
未指定時は安全なproductionです。Pythonから設定する場合は、補完と型チェックが効くconfigure(mode=Mode.TEST)・Mode.MOCK・Mode.PRODUCTIONを推奨します。短い文字列指定も互換のため利用できます。testまたはmockは、対象モジュールのimportより前に指定します。
- mock: givenが一致したケースの固定値を返す
- test: 本物の関数を実行し、returnsと比較する
- production（既定）: デコレータをパススルーし、仕様ブロックをスキップする
pytestとの関係
niltestは代表例を近くに置くための補助ツールです。境界値の網羅、fixture、統合テスト、例外の詳細検証にはpytestを併用してください。