traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

sqlite3: Port documentation changes from the 2.7 branch 

Issue #13491.
This commit is contained in:
Petri Lehtinen 2012-03-01 21:18:34 +02:00
parent bbe2f60b3c
commit 4d2bfb5e08
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Doc/library/sqlite3.rst
View File

@ -3,7 +3,7 @@
.. module:: sqlite3 .. module:: sqlite3
:synopsis: A DB-API 2.0 implementation using SQLite 3.x. :synopsis: A DB-API 2.0 implementation using SQLite 3.x.
.. sectionauthor:: Gerhard Häring <gh@ghaering.de> .. sectionauthor:: Gerhard Häring <gh@ghaering.de>
SQLite is a C library that provides a lightweight disk-based database that SQLite is a C library that provides a lightweight disk-based database that
@ -20,6 +20,7 @@ To use the module, you must first create a :class:`Connection` object that
represents the database. Here the data will be stored in the represents the database. Here the data will be stored in the
:file:`/tmp/example` file:: :file:`/tmp/example` file::
import sqlite3
conn = sqlite3.connect('/tmp/example') conn = sqlite3.connect('/tmp/example')
You can also supply the special name ``:memory:`` to create a database in RAM. You can also supply the special name ``:memory:`` to create a database in RAM.
@ -56,7 +57,7 @@ example::
# Never do this -- insecure! # Never do this -- insecure!
symbol = 'IBM' symbol = 'IBM'
c.execute("... where symbol = '%s'" % symbol) c.execute("select * from stocks where symbol = '%s'" % symbol)
# Do this instead # Do this instead
t = (symbol,) t = (symbol,)
@ -64,7 +65,7 @@ example::
# Larger example # Larger example
for t in [('2006-03-28', 'BUY', 'IBM', 1000, 45.00), for t in [('2006-03-28', 'BUY', 'IBM', 1000, 45.00),
('2006-04-05', 'BUY', 'MSOFT', 1000, 72.00), ('2006-04-05', 'BUY', 'MSFT', 1000, 72.00),
('2006-04-06', 'SELL', 'IBM', 500, 53.00), ('2006-04-06', 'SELL', 'IBM', 500, 53.00),
]: ]:
c.execute('insert into stocks values (?,?,?,?,?)', t) c.execute('insert into stocks values (?,?,?,?,?)', t)
@ -271,7 +272,6 @@ Connection Objects
calling the cursor method, then calls the cursor's :meth:`executemany calling the cursor method, then calls the cursor's :meth:`executemany
<Cursor.executemany>` method with the parameters given. <Cursor.executemany>` method with the parameters given.
.. method:: Connection.executescript(sql_script) .. method:: Connection.executescript(sql_script)
This is a nonstandard shortcut that creates an intermediate cursor object by This is a nonstandard shortcut that creates an intermediate cursor object by
@ -376,22 +376,22 @@ Connection Objects
aggregates or whole new virtual table implementations. One well-known aggregates or whole new virtual table implementations. One well-known
extension is the fulltext-search extension distributed with SQLite. extension is the fulltext-search extension distributed with SQLite.
Loadable extensions are disabled by default. See [#f1]_.
.. versionadded:: 3.2 .. versionadded:: 3.2
.. literalinclude:: ../includes/sqlite3/load_extension.py .. literalinclude:: ../includes/sqlite3/load_extension.py
Loadable extensions are disabled by default. See [#f1]_.
.. method:: Connection.load_extension(path) .. method:: Connection.load_extension(path)
This routine loads a SQLite extension from a shared library. You have to This routine loads a SQLite extension from a shared library. You have to
enable extension loading with :meth:`enable_load_extension` before you can enable extension loading with :meth:`enable_load_extension` before you can
use this routine. use this routine.
.. versionadded:: 3.2
Loadable extensions are disabled by default. See [#f1]_. Loadable extensions are disabled by default. See [#f1]_.
.. versionadded:: 3.2
.. attribute:: Connection.row_factory .. attribute:: Connection.row_factory
You can change this attribute to a callable that accepts the cursor and the You can change this attribute to a callable that accepts the cursor and the