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.