pytest

このエラーは、Pluggy 1.7.0 でドキュメントをビルドする際（例：pytest で tox -e docs を実行）に発生します。これは、PluginManager.list_plugin_distinfo の docstring が非公開で文書化されていないクラス pluggy._compat.DistFacade を参照しており、-W によってその警告が失敗として扱われることが原因です。修正方法：Sphinx の conf.py の nitpick_ignore にこの非公開クラスを追加します：

nitpick_ignore = [
    # ... 既存のエントリー ...
    ("py:class", "pluggy._compat.DistFacade"),
]

これにより、Pluggy をピン留めしたりダウングレードしたりすることなく、他のすべてのターゲットに対する厳密な参照チェックを維持できます。注意：Pluggy 1.6.0 へのダウングレードは有効な回避策ではありません。他の非公開の Pluggy 型参照の警告が発生するためです。

pytest.approx() は、タプルのリストのようなネストされたデータ構造 (例: pytest.approx([(2.0, 2.0)])) をサポートしていません。pytest <= 9.1.1 では、アサーションのレポート中に紛らわしい AttributeError: 'tuple' object has no attribute 'expected' が発生します。

回避策:
1. 比較する前に構造をフラット化する: assert [x for t in sut() for x in t] == pytest.approx([2.0, 2.0])
2. 要素を個別に比較する: result = sut(); assert result[0] == pytest.approx((2.0, 2.0)) (数値のみのフラットなタプル/リスト 1 つであればサポートされています)
3. 数値の 2 次元データには、approx が処理できる numpy 配列を使用してください。

pytest 9.2+ (PR #14934 による修正) にアップグレードしても、ネストされた構造が動作するようになるわけではありませんが、不可解な AttributeError が明確なエラー TypeError: pytest.approx() does not support nested data structures に置き換わります。上記のように比較の構造を変更する必要は依然としてあります。

これは pytest 8.0.2 および関連バージョンにおけるバグです：ExceptionInfo.for_later() は例外がキャプチャされる前に ExceptionInfo を生成し、その assertion striptext を一切設定しないため、exconly(tryshort=True) は AssertionError: プレフィックスを保持したままになります。

例外の値を直接使用してください：

with pytest.raises(AssertionError) as exc_info:
    raise AssertionError("message")

message = str(exc_info.value)
assert message == "message"

exconly() の動作を維持する必要がある場合は、キャプチャされた例外から ExceptionInfo を再構築してください：

from pytest import ExceptionInfo

message = ExceptionInfo.from_exception(
    exc_info.value
).exconly(tryshort=True)

Python 3.9 以降で使用できる文字列による回避策は次のとおりです：

message = str(exc_info.value).removeprefix("AssertionError: ")

pytest 8.3+ では、抽象テストクラスはコレクション時にスキップされます。TestFoo クラスは継承された test_foo メソッドを実装していないため抽象クラスのままとなっており、pytest はそこから何も収集せずに暗黙的にスキップします。

未実装の抽象メソッドを確認してください:

python -c "import your_test_module; print(your_test_module.TestFoo.__abstractmethods__)"

これは {'test_foo'} と出力されるはずです。具象テストクラスですべての抽象メソッドを実装して修正します:

class TestFoo(AbstractTestFoo):
    def test_foo(self):
        assert True

その後、pytest を再度実行してください。クラスが意図的に抽象クラスである場合、または収集されるべきでない場合は、名前が Test で始まらないように変更するか、__test__ = False を設定してください。暗黙的にスキップされる抽象クラスに対する pytest の警告は、issue #13546 およびドラフト PR #15082 で追跡されていました。

TestFoo は test_foo を実装せずに継承しているため、依然として抽象クラスのままです。Pytest は収集時に抽象クラスをスキップするため、テストインスタンスもテストメソッドも収集されません。具象サブクラスでこの抽象メソッドを実装してください：

class TestFoo(AbstractTestFoo):
    def test_foo(self):
        assert True  # ここにテストを書く

次のコマンドで収集を確認してください：

pytest --collect-only

これで TestFoo::test_foo が一覧に表示されるはずです。pytest 9.1.1 では、この状態はサイレントにスキップされます。収集時に失敗したり警告を発したりする動作は、提案された変更にすぎませんでした。