91f40f3f78
gh-96168: Improve sqlite3 dict_factory example ( #96457 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-09-01 23:47:59 +02:00
f7e7bf161a
gh-96414: Inline code examples in sqlite3 docs ( #96442 )
2022-08-31 07:54:54 +02:00
7b01ce7953
Docs: normalise sqlite3 placeholder how-to heading ( #96413 )
2022-08-30 22:44:14 +02:00
6d403e264a
Docs: normalize SQL style in sqlite3 docs ( #96403 )
2022-08-30 00:50:42 +02:00
bf9259776d
gh-95432: Add doctests for the sqlite3 docs ( #96225 )
...
As a consequence of the added test, this commit also includes
fixes for broken examples.
- Add separate namespace for trace tests bco. module level callback
- Move more backup and cursor examples under separate namespaces
2022-08-29 10:52:39 +02:00
6bda5b85b5
gh-94635: Frame sqlite3 how-to headings as such & move default adapters to reference ( #96136 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-24 09:14:14 +02:00
d6259c58cb
gh-96096: Add undocumented SQLITE_OK/DENY/IGNORE sqlite3 constants ( #96134 )
...
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-23 08:51:20 +02:00
04c73e5efb
gh-95432: Add doctest for sqlite3 tutorial ( #96193 )
2022-08-23 08:48:13 +02:00
18b1782192
gh-96121: Merge sqlite3.Row examples into sqlite3.Row class doc ( #96122 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-22 10:03:24 +02:00
ee9f22d346
Docs: Fix markup of module name in sqlite3 docs ( #96115 )
2022-08-19 10:18:08 +02:00
303ef0913e
Doc: Use consistent markup for example Point class in sqlite3 ( #96095 )
2022-08-19 09:41:16 +02:00
1a140af40b
Docs: group sqlite3.Connection attributes and methods ( #96090 )
2022-08-19 09:30:41 +02:00
ede771cdf9
gh-94635: Remove sqlite3 doc introduction heading ( #96089 )
2022-08-19 09:21:11 +02:00
91afe66707
Docs: Escape lone stars in sqlite3 docs ( #96081 )
2022-08-18 20:39:36 +02:00
c87ea10fc9
gh-95271: Rework sqlite3 tutorial ( #95749 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-18 20:36:20 +02:00
e6623e7083
gh-95273: Improve sqlite3.complete_statement docs ( #95840 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-12 01:05:12 +02:00
41c939cb35
gh-95273: Reorganize sqlite3 doc module level funcs and vars ( #95626 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-08 21:25:35 +02:00
56af5a200d
gh-94635: Fixup sqlite3 'Introduction' seealso note ( #95751 )
...
In gh-95269, the seealso note incorrectly ended up in
the 'Tutorial' section.
2022-08-06 23:30:26 +02:00
44f1f63ad5
Docs: sqlite3 docs fixup ( #95681 )
...
- Disable links to the module itself
- Fix link indent
- Consistent ref markup
2022-08-05 00:06:46 +02:00
b24e8b28a7
gh-95271: Extract placeholders howto from sqlite3 tutorial ( #95522 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-04 22:41:18 +02:00
12d92c733c
gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods ( #95530 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-08-04 21:58:10 +02:00
962acd4468
Docs: fix two typos in the sqlite3 docs ( #95661 )
...
- statment => statement
- transaciton => transaction
2022-08-04 20:25:53 +02:00
4d02572f8c
gh-95273: Align sqlite3 const doc refs with the devguide recommendations ( #95525 )
2022-08-03 22:21:15 +02:00
89f5229328
Docs: fix incorrect formatting in sqlite3 CLI docs ( #95581 )
2022-08-03 00:17:09 +02:00
bc7c7cd18a
gh-77617: Add sqlite3 command-line interface ( #95026 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-08-01 12:25:16 +02:00
1e6b63542e
gh-95273: Clarify when sqlite_* attributes are added to sqlite3 exceptions ( #95523 )
2022-08-01 11:15:07 +02:00
6c439b978b
gh-94635: Add Reference, How-to, and Concepts headings to sqlite3 docs ( #94636 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-31 01:24:15 +02:00
d92b19e1b5
gh-95273: Relocate sqlite3 enable load extension note ( #95430 )
2022-07-29 21:27:15 +02:00
2fbee85931
gh-95432: Fixup sqlite3 tutorial example ( #95431 )
...
- the insert statement should have five placeholders, not four
- missing ... in the multiline row list
2022-07-29 14:31:41 +02:00
e003b64f40
gh-95273: Improve sqlite3 class descriptions ( #95379 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-29 11:53:23 +02:00
f0bf7956e6
gh-95273: Move sqlite3 executemany examples from reference to tutorial ( #95351 )
2022-07-29 09:42:22 +02:00
e9c8de669d
gh-95273: Condense sqlite3 executescript example ( #95383 )
2022-07-29 09:40:44 +02:00
ea269b9a38
Docs: Fix refs & tweak wording in sqlite3 'Using shortcut methods'
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-28 07:38:36 +02:00
2361908a9d
gh-95273: Normalise sqlite3 reference wording ( #95274 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-27 15:24:13 +02:00
2b37395612
gh-94630: Fixup sqlite3 argument spec docs for connection execute* methods ( #95319 )
2022-07-27 14:46:21 +02:00
2e35a13e46
gh-94635: Add sqlite3 'Introduction' and 'Tutorial' doc headings ( #95269 )
2022-07-27 07:43:24 +02:00
5012bedc7c
gh-95235: Add explicit parameter list to some sqlite3 methods ( #95240 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-26 08:29:18 +02:00
ac6a94c669
gh-95235: Document undocumented parameters in sqlite3 functions and methods ( #95236 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-25 18:46:55 +02:00
f9b3706df6
gh-81040: Improve sqlite3.Cursor.rowcount docs ( #94940 )
2022-07-22 09:34:39 +02:00
6dadf6ca01
gh-90016: Deprecate default sqlite3 adapters and converters ( #94276 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-20 21:37:59 +02:00
9ea72e9d8d
Docs: fix typo in sqlite3.rst ( #94798 )
...
Colum -> Column
2022-07-14 23:47:46 +02:00
e5b841a403
gh-94622: Add more references to the sqlite3 types anchor ( #94623 )
2022-07-08 02:38:38 +02:00
fb6dccae34
gh-94321: Document sqlite3.PrepareProtocol ( #94620 )
2022-07-08 00:33:17 +02:00
3eb2b9634f
gh-94628: Add explicit parameter list to sqlite3.connect docs ( #94629 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-07 09:00:20 +02:00
94988603f3
gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols ( #94631 )
2022-07-07 01:13:30 +02:00
760b8cf0c8
gh-94017: Improve clarity of sqlite3 transaction handling docs ( #94320 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-06 22:59:07 +02:00
3440d197a5
Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551)
...
Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021
2022-07-05 11:16:10 +02:00
cc81962e69
Doc: fix sqlite3 blob reference anchor ( #94505 )
2022-07-02 08:35:48 +02:00
bd3c1c187e
gh-90016: Reword sqlite3 adapter/converter docs ( #93095 )
...
Also add adapters and converter recipes.
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com
2022-06-25 22:06:06 +02:00
8e08978141
gh-61162: Clarify sqlite3 connection context manager docs (GH-93890)
...
Explicitly note that transactions are only closed if there is an open
transation at `__exit__`, and that transactions are not implicitly
opened during `__enter__`.
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Automerge-Triggered-By: GH:erlend-aasland
2022-06-19 13:17:43 -07:00
6446592c89
gh-93925: Improve clarity of sqlite3 commit/rollback, and close docs ( #93926 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-06-19 21:17:28 +02:00
ce4d11f98b
gh-93857: Fix broken audit-event targets in sqlite3 docs ( #93859 )
...
Corrected targets for the following audit-events:
- sqlite3.enable_load_extension => sqlite3.Connection.enable_load_extension
- sqlite3.load_extension => sqlite3.Connection.load_extension
2022-06-15 16:01:27 +02:00
d31834688b
gh-87260: Update sqlite3 signature docs to reflect actual implementation ( #93840 )
...
Align the docs for the following methods with the actual implementation:
- sqlite3.complete_statement()
- sqlite3.Connection.create_function()
- sqlite3.Connection.create_aggregate()
- sqlite3.Connection.set_progress_handler()
2022-06-15 12:28:24 +02:00
ffc58a9710
gh-93370: Deprecate sqlite3.version and sqlite3.version_info ( #93482 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
2022-06-08 01:34:50 +02:00
bb0b768946
gh-89018: Improve documentation of `sqlite3` exceptions ( #27645 )
...
- Order exceptions as in PEP 249
- Reword descriptions, so they match the current behaviour
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-06-06 23:47:15 +02:00
7ee19e2715
gh-92780: Improve sqlite3.Connection.create_collation docs ( #92790 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-18 13:44:16 +02:00
29afb7d2ef
gh-69093: Add indexing and slicing support to sqlite3.Blob ( #91599 )
...
Authored-by: Aviv Palivoda <palaviv@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@innova.no>
2022-04-21 18:45:16 -07:00
017f07a229
gh-90923: Improve sqlite3.Connection.execute* docs ( #91643 )
...
- Drop 'nonstandard'; it does not add any value
- Try to be more concise
- Make return value a little more explicit
2022-04-17 14:12:55 -07:00
95573ade42
gh-69093: sqlite3 blob doc amendments (GH-91561)
...
- document that you cannot open a blob handle in a WITHOUT ROWID table
- document the blobopen() positional arguments in the same order as they
appear
- relocate sqlite3.Blob section
2022-04-16 06:28:38 -07:00
a861756675
gh-69093: Add context manager support to sqlite3.Blob (GH-91562)
2022-04-15 21:21:12 -07:00
ee475430d4
gh-69093: Support basic incremental I/O to blobs in `sqlite3` (GH-30680)
...
Authored-by: Aviv Palivoda <palaviv@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@innova.no>
Co-authored-by: palaviv <palaviv@gmail.com>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-14 17:02:56 -07:00
9ebcece82f
gh-79097: Add support for aggregate window functions in sqlite3 (GH-20903)
2022-04-11 17:55:59 -07:00
a7551247e7
bpo-41930: Add support for SQLite serialise/deserialise API (GH-26728)
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-04-05 07:15:25 -07:00
6881ea936e
bpo-47126: Update to canonical PEP URLs specified by PEP 676 (GH-32124)
2022-03-30 12:00:27 +01:00
2d5835a019
sqlite3: normalise pre-acronym determiners (GH-31772)
...
For consistency, replace "a SQL" with "an SQL".
2022-03-10 17:52:47 -08:00
e801e88744
bpo-45138: Revert GH-28240: Expand traced SQL statements (GH-31788)
...
This reverts commit d1777515f9
2022-03-09 09:39:49 -08:00
d1777515f9
bpo-45138: Expand traced SQL statements in `sqlite3` trace callback (GH-28240)
2022-03-08 18:46:40 -08:00
b33a1ae703
Docstring: replace pysqlite with sqlite3 (GH-31758)
...
Replace two instances of "pysqlite" with "sqlite3" in sqlite3
docstrings. Also reword "is a no-op" to "does nothing" for clarity.
2022-03-08 18:45:48 -08:00
bdf2ab1887
bpo-46402: Promote SQLite URI tricks in `sqlite3` docs (GH-30660)
...
Provide some examples of URI parameters in sqlite connect().
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
2022-01-18 07:37:02 -05:00
b6aa38f1ca
bpo-46261: Update `sqlite3.Cursor.lastrowid` docs (GH-30407)
2022-01-08 21:17:09 +02:00
c4a69a4ad0
bpo-45828: Use unraisable exceptions within sqlite3 callbacks (FH-29591)
2021-11-29 15:22:32 +00:00
6c5a312fb6
bpo-45677: Reword first section of `sqlite3` docs ( #29326 )
...
* bpo-45677: Avoid addressing the reader as 'you' in sqlite3 docs
* Adjust wording
* Adjust wording again
* Typo
* Update Doc/library/sqlite3.rst
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
* Address review: adjust wording
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Lib/sqlite3/__init__.py
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Lib/sqlite3/__init__.py
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/library/sqlite3.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Apply Alex' suggestion, and apply 80 char limit to PR
* Minor adjustment
Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2021-11-15 14:22:42 -08:00
c273986711
bpo-45613: Set `sqlite3.threadsafety` dynamically (GH-29227)
...
Use the compile-time selected default SQLite threaded mode to set the
DB-API 2.0 attribute 'threadsafety'
Mappings:
- SQLITE_THREADSAFE=0 => threadsafety=0
- SQLITE_THREADSAFE=1 => threadsafety=3
- SQLITE_THREADSAFE=2 => threadsafety=1
2021-11-03 21:01:37 +00:00
b6b38a8226
bpo-45243: Add support for setting/getting `sqlite3` connection limits (GH-28463)
2021-11-01 22:50:53 +00:00
3877fc02f7
bpo-45335: Add note to `sqlite3` docs about "timestamp" converter (GH-29200)
2021-10-29 22:17:22 +02:00
88d8a1a340
bpo-45608: Document missing `sqlite3` DB-API attributes and methods (GH-29219)
2021-10-28 21:35:51 +02:00
1dac95c814
sqlite3: Modernize documentation around unicode and bytes. (GH-28652)
2021-10-01 14:37:56 +02:00
36122e1814
bpo-41203: Replace Mac OS X and OS X with macOS (GH-28515)
...
Replace old names when they refer to actual versions of macOS.
Keep historical names in references to older versions.
Co-authored-by: Patrick Reader <_@pxeger.com>
2021-09-22 20:33:36 +03:00
51056b40e7
bpo-45089: Improve sqlite3 trace callback docs (GH-28238)
...
- Add link to str object and sqlite3 transaction control
- Mention that exceptions are not propagated
2021-09-15 20:39:05 +02:00
86d8b46523
bpo-16379: expose SQLite error codes and error names in `sqlite3` (GH-27786)
2021-08-30 19:32:21 +01:00
5269c09145
bpo-44688: Remove ASCII limitation from `sqlite3` collation names (GH-27395)
2021-07-29 09:47:56 +02:00
fbe87023bf
Fix typo in sqlite3.rst (GH-27415)
...
preceeding -> preceding
2021-07-28 16:10:48 +02:00
1ca27f2647
bpo-44639: fix typo in sqlite.rst (transation => transaction) (GH-27145)
...
To my understanding, this is supposed to say "transaction".
See the relevant source:
a158b20019/Modules/_sqlite/connection.c (L1434-L1467)
2021-07-14 14:39:54 -07:00
b19f455339
bpo-44491: Allow clearing the sqlite3 authoriser callback (GH-26863)
2021-06-24 15:35:57 +01:00
f461a7fc3f
bpo-42862: Use functools.lru_cache iso. _sqlite.Cache in sqlite3 module (GH-24203)
...
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
2021-06-03 20:59:26 +01:00
9014437573
bpo-30593: Doc'ed that executescript() disregards isolation level (GH-26220)
2021-05-19 10:05:48 +03:00
7244c0060d
bpo-43762: Add audit events for loading of sqlite3 extensions (GH-25246)
2021-04-27 00:16:46 +01:00
3386ca0b36
bpo-20364: Improve sqlite3 placeholder docs (GH-25003)
2021-04-14 15:28:55 +03:00
85918e4ab6
bpo-43774: Add more links to configure options (GH-25363)
2021-04-12 23:27:35 +02:00
62a03cd490
bpo-43446: Fix markup in sqlite3 footnote (GH-24806)
2021-03-10 01:41:41 +02:00
40d1b831ec
bpo-43396: Normalise naming in sqlite3 doc examples (GH-24746)
2021-03-04 17:46:14 +02:00
e603443642
bpo-43059: Remove reference to legacy external sqlite3 repository (GH-24364)
2021-01-31 07:19:07 +02:00
f9949f82e1
bpo-38413: Remove outdated section about multithreading in sqlite3 (GH-23159)
2021-01-06 02:18:46 +02:00
cf0b23908c
bpo-40810: Require SQLite 3.7.15 (GH-24106)
2021-01-06 02:02:43 +02:00
abba83b4b9
bpo-42755: Fix sqlite3.Connection.backup docs (GH-23965)
...
The `pages` argument default value now reflects the implementation.
2020-12-27 22:35:17 +00:00
09a36cdfb7
bpo-41724: Explain when the conversion is not possible with detect_types enabled (GH-23855)
...
* Explain when the conversion is not possible with detect_types enabled
2020-12-19 17:52:39 -05:00
207c321f13
bpo-40744: Drop support for SQLite pre 3.7.3 (GH-20909)
...
Remove code required to support SQLite pre 3.7.3.
Co-written-by: Berker Peksag <berker.peksag@gmail.com>
Co-written-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
2020-09-07 22:26:54 +01:00
441416c9a0
Fix typo in sqlite3 documentation (GH-19965)
...
*first* is repeated twice.
2020-05-06 16:51:43 -03:00
b146568dfc
bpo-39652: Truncate the column name after '[' only if PARSE_COLNAMES is set. (GH-18942)
2020-03-21 15:53:28 +02:00
44f91c388a
bpo-37390: Add audit event table to documentations (GH-14406)
...
Also updates some (unreleased) event names to be consistent with the others.
2019-06-27 10:47:59 -07:00
Erlend E. Aasland
Erlend E. Aasland
C.A.M. Gerlach
ceh
Ikko Ashimine
Ned Batchelder
Kalyan
Hugo van Kemenade
Ian Fisher
Julien Palard
Serhiy Storchaka
Jack DeVries
Victor Stinner
Kamil Turek
L
Vladimir
sblondon
Naglis
Steve Dower