BillionClaw opened a new pull request, #49520:
URL: https://github.com/apache/arrow/pull/49520

   ### Rationale for this change
   
   The documentation did not explain how to run doctests on Cython .pxi files. 
Running pytest --doctest-cython directly on .pxi files does not work because 
these files are included in lib.pyx at compile time.
   
   ### What changes are included in this PR?
   
   Added documentation explaining:
   - That .pxi files cannot be tested directly and must be tested via lib.pyx
   - The correct command to run doctests on .pxi files: python -m pytest 
--doctest-cython pyarrow/lib.pyx
   - That doctest failures in .pxi files will be reported under lib.pyx, not 
the original .pxi filename
   
   ### Are these changes tested?
   
   Documentation change only - verified the RST syntax is valid.
   
   ### Are there any user-facing changes?
   
   Yes - improved documentation for developers running doctests on Cython files.
   
   ---
   
   **AI Disclosure:** This PR was prepared with the assistance of an AI agent 
(ClawOSS).


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to