oh quick question about the docs: should the docs for the python_test_utils[1] say

although it behaves identically to the python_tests target generator and you can safely use that instead

instead of

although it behaves identically to the python_sources target generator and you can safely use that instead

It has the same default sources as python_tests just adding conftest:

expected_file_extensions = (".py", "")  # Note that this does not include `.pyi`.
    default = ("test_*.py", "*_test.py", "tests.py")

class PythonTestUtilsGeneratingSourcesField(PythonGeneratingSourcesBase):
    default = ("conftest.py", "test_*.pyi", "*_test.pyi", "tests.pyi")

[1] https://www.pantsbuild.org/docs/reference-python_test_utils#codesourcescode

It's correct - it is generating a

python_source

target per entry of

sources

. That's because

conftest.py

and

test_foo.pyi

are not actually tests - they should not be executed via Pytest

ah - I guess based on that statement I would also expect it to pick up any other python sources even if they aren't named conftest that makes sense now but maybe could be more explained in the docs

ohhh "identically" is poor word choice, good feedback!

oh yeah that is much clearer

How is this? https://github.com/pantsbuild/pants/pull/14739