Welcome to oursql’s documentation!¶

oursql is a new set of MySQL bindings for python 2.4+, including python 3.x. Here’s a short list of reasons why you should use oursql over MySQLdb:

oursql has real parameterization, sending the SQL and data to MySQL completely separately.
oursql allows text or binary data to be streamed into the database and streamed out of the database, instead of requiring everything to be buffered in the client.
oursql can both insert rows lazily and fetch rows lazily.
oursql has unicode support on by default.
oursql supports python 2.4 through 2.7 without any deprecation warnings on 2.6+ (see PEP 218) and without completely failing on 2.7 (see PEP 328).
oursql runs natively on python 3.x.
oursql is licensed under the BSD license.

Anyone encountering bugs or any unexpected behavior in oursql should (please!) post a bug report on the launchpad site.