Repository navigation
[Docs][Python] Document that .pxi doctests are tested via lib.pyx #49503
Description
Describe the enhancement requested
Running python -m pytest --doctest-cython directly on .pxi can't work because Cython .pxi files are included in lib.pyx at compile time.
In order to run doctests on .pxi files, doctest should be run on lib.pyx where they are compiled into, with python -m pytest --doctest-cython path-to/lib.pyx.
Also the errors will surface under lib.pyx, not the original .pxi filename.
We should add this info to the documentation:
https://arrow.apache.org/docs/developers/python/development.html#doctest
Component(s)
Python, Documentation
Activity
apacheGH-49503: [Python][Doc] Document that .pxi doctests are tested …
bhavanaeh commentedon Mar 15, 2026
Hi, I took a stab at this, PR here
docs(python): document .pxi doctests testing via lib.pyx
docs(python): Document that .pxi doctests are tested via lib.pyx
apacheGH-49503: [Docs][Python] Document that .pxi doctests are tested…
GH-49503: [Docs][Python] Documenting .pxi doctests are tested via lib…
AlenkaF commentedon Mar 20, 2026
Issue resolved by pull request 49515
#49515
apacheGH-49503: [Docs][Python] Documenting .pxi doctests are tested v…
apacheGH-49503: [Docs][Python] Documenting .pxi doctests are tested v…