1berry/cpython
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

gh-94321: Document sqlite3.PrepareProtocol (#94620)

Browse Source
This commit is contained in:
Erlend Egeberg Aasland 2022-07-08 00:33:17 +02:00 committed by GitHub
parent 71697664d7
commit fb6dccae34
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Doc/library/sqlite3.rst
View File

@ -1139,6 +1139,16 @@ Blob Objects
end). end).
PrepareProtocol Objects
-----------------------
.. class:: PrepareProtocol
The PrepareProtocol type's single purpose is to act as a :pep:`246` style
adaption protocol for objects that can :ref:`adapt themselves
<sqlite3-conform>` to :ref:`native SQLite types <sqlite3-types>`.
.. _sqlite3-exceptions: .. _sqlite3-exceptions:
Exceptions Exceptions
@ -1297,6 +1307,8 @@ As an application developer, it may make more sense to take direct control by
registering custom adapter functions. registering custom adapter functions.
.. _sqlite3-conform:
Letting your object adapt itself Letting your object adapt itself
"""""""""""""""""""""""""""""""" """"""""""""""""""""""""""""""""

2
Misc/NEWS.d/next/Documentation/2022-07-07-08-42-05.gh-issue-94321.pmCIPb.rst Normal file
View File

@ -0,0 +1,2 @@
Document the :pep:`246` style protocol type
:class:`sqlite3.PrepareProtocol`.

3
Modules/_sqlite/prepare_protocol.c
View File

@ -46,10 +46,13 @@ pysqlite_prepare_protocol_dealloc(pysqlite_PrepareProtocol *self)
Py_DECREF(tp); Py_DECREF(tp);
} }
PyDoc_STRVAR(doc, "PEP 246 style object adaption protocol type.");
static PyType_Slot type_slots[] = { static PyType_Slot type_slots[] = {
{Py_tp_dealloc, pysqlite_prepare_protocol_dealloc}, {Py_tp_dealloc, pysqlite_prepare_protocol_dealloc},
{Py_tp_init, pysqlite_prepare_protocol_init}, {Py_tp_init, pysqlite_prepare_protocol_init},
{Py_tp_traverse, pysqlite_prepare_protocol_traverse}, {Py_tp_traverse, pysqlite_prepare_protocol_traverse},
{Py_tp_doc, (void *)doc},
{0, NULL}, {0, NULL},
}; };