cpython

History

Dong-hee Na b58bc8c2a9 gh-104469: Update README.txt for _testcapi (gh-104529) * gh-104469: Update README.txt for _testcapi Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com> Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>		2023-05-17 12:56:20 +09:00
..
clinic	gh-104469: Convert _testcapi/watchers.c to use Argument Clinic (#104503 )	2023-05-15 22:59:41 +02:00
README.txt	gh-104469: Update README.txt for _testcapi (gh-104529)	2023-05-17 12:56:20 +09:00
buffer.c	gh-102500: Implement PEP 688 (#102521 )	2023-05-04 07:59:46 -07:00
code.c	gh-101101: Fix test_code_extra to reset value for refleak test (gh-102350)	2023-03-02 20:32:05 +09:00
datetime.c	gh-99300: Replace Py_INCREF() with Py_NewRef() (#99513 )	2022-11-16 10:39:47 +01:00
docstring.c	gh-93649: Split memory and docstring tests from _testcapimodule.c (#99517 )	2022-11-16 14:09:10 +01:00
exceptions.c	gh-102755: PyErr_DisplayException only in ABI >= 3.12. Tests cover PyErr_Display as well (GH-102849)	2023-03-21 10:36:18 +01:00
float.c	gh-104469 Convert _testcapi/float.c to use AC (gh-104470)	2023-05-15 12:44:00 +09:00
gc.c	gh-93649: Split gc- and allocation tests from _testcapimodule.c (GH-104403)	2023-05-12 10:26:07 +01:00
getargs.c	gh-99240: Reset pointer to NULL when the pointed memory is freed in argument parsing (#99890 )	2022-12-17 12:07:44 +05:30
heaptype.c	gh-103509: PEP 697 -- Limited C API for Extending Opaque Types (GH-103511)	2023-05-04 09:56:53 +02:00
heaptype_relative.c	gh-103509: PEP 697 -- Limited C API for Extending Opaque Types (GH-103511)	2023-05-04 09:56:53 +02:00
immortal.c	Trim trailing whitespace and test on CI (#104275 )	2023-05-08 17:03:52 +03:00
long.c	gh-99537: Use Py_SETREF() function in longobject C code (#99655 )	2022-11-22 13:04:19 +01:00
mem.c	GH-101291: Rearrange the size bits in PyLongObject (GH-102464)	2023-03-22 14:49:51 +00:00
parts.h	gh-93649: Split gc- and allocation tests from _testcapimodule.c (GH-104403)	2023-05-12 10:26:07 +01:00
pyos.c	GH-94808: Cover `PyOS_mystrnicmp` and `PyOS_mystricmp` (gh-102469)	2023-03-22 20:35:27 +09:00
pytime.c	gh-93649: Split pytime and datetime tests from _testcapimodule.c (#99494 )	2022-11-15 08:17:52 +01:00
structmember.c	gh-47146: Soft-deprecate structmember.h, expose its contents via Python.h (GH-99014)	2022-11-22 08:25:43 +01:00
testcapi_long.h	gh-93649: Split float/long tests from _testcapimodule.c (GH-99549)	2022-11-17 00:56:56 -08:00
unicode.c	gh-99593: Add tests for Unicode C API (part 2) (#99868 )	2023-05-04 15:25:09 +00:00
vectorcall.c	gh-99300: Use Py_NewRef() in Modules/ directory (#99440 )	2022-11-13 16:04:33 +01:00
vectorcall_limited.c	gh-98586: Add vector call APIs to the Limited API (GH-98587)	2022-10-27 11:45:42 +02:00
watchers.c	gh-104469: Convert _testcapi/watchers.c to use Argument Clinic (#104503 )	2023-05-15 22:59:41 +02:00

README.txt

Tests in this directory are compiled into the _testcapi extension.
The main file for the extension is Modules/_testcapimodule.c, which
calls `_PyTestCapi_Init_*` from these functions.

General guideline when writing test code for C API.
* Use Argument Clinic to minimise the amount of boilerplate code.
* Add a newline between the argument spec and the docstring.
* If a test description is needed, make sure the added docstring clearly and succinctly describes purpose of the function.
* DRY, use the clone feature of Argument Clinic.
* Try to avoid adding new interned strings; reuse existing parameter names if possible. Use the `as` feature of Argument Clinic to override the C variable name, if needed.