MySQLdb.converters
index
MySQLdb/converters.py

MySQLdb type conversion module
 
This module handles all the type conversions for MySQL. If the default
type conversions aren't what you need, you can make your own. The
dictionary conversions maps some kind of type to a conversion function
which returns the corresponding value:
 
Key: FIELD_TYPE.* (from MySQLdb.constants)
 
Conversion function:
 
    Arguments: string
 
    Returns: Python object
 
Key: Python type object (from types) or class
 
Conversion function:
 
    Arguments: Python object of indicated type or class AND 
               conversion dictionary
 
    Returns: SQL literal value
 
    Notes: Most conversion functions can ignore the dictionary, but
           it is a required parameter. It is necessary for converting
           things like sequences and instances.
 
Don't modify conversions if you can avoid it. Instead, make copies
(with the copy() method), modify the copies, and then pass them to
MySQL.connect().

 
Modules
       
MySQLdb.constants.FIELD_TYPE
MySQLdb.constants.FLAG
array
types

 
Functions
       
Bool2Str(s, d)
Float2Str(o, d)
Instance2Str(o, d)
Convert an Instance to a string representation.  If the __str__()
method produces acceptable output, then you don't need to add the
class to conversions; it will be handled by the default
converter. If the exact class is not found in d, it will use the
first class it can find for which o is an instance.
Long2Int = Thing2Str(s, d)
Convert something into a string via str().
None2NULL(o, d)
Convert None to NULL.
Set2Str(s, d)
Str2Set(s)
Thing2Literal(o, d)
Convert something into a SQL string literal.  If using
MySQL-3.23 or newer, string_literal() is a method of the
_mysql.MYSQL object, and this function will be overridden with
that method when the connection is created.
Thing2Str(s, d)
Convert something into a string via str().
Unicode2Str(s, d)
Convert a unicode object to a string using the default encoding.
This is only used as a placeholder for the real function, which
is connection-dependent.
array2Str(o, d)
char_array(s)
escape(...)
escape(obj, dict) -- escape any special characters in object obj
using mapping dict to provide quoting functions for each type.
Returns a SQL literal string.
escape_dict(...)
escape_sequence(d, dict) -- escape any special characters in
dictionary d using mapping dict to provide quoting functions for each type.
Returns a dictionary of escaped items.
escape_sequence(...)
escape_sequence(seq, dict) -- escape any special characters in sequence
seq using mapping dict to provide quoting functions for each type.
Returns a tuple of escaped items.
localtime(...)
localtime([seconds]) -> (tm_year,tm_mon,tm_day,tm_hour,tm_min,tm_sec,tm_wday,tm_yday,tm_isdst)
 
Convert seconds since the Epoch to a time tuple expressing local time.
When 'seconds' is not passed in, convert the current time instead.
string_literal(...)
string_literal(obj) -- converts object obj into a SQL string literal.
This means, any special SQL characters are escaped, and it is enclosed
within single quotes. In other words, it performs:
 
"'%s'" % escape_string(str(obj))
 
Use connection.string_literal(obj), if you use it at all.
_mysql.string_literal(obj) cannot handle character sets.

 
Data
        NULL = 'NULL'
conversions = {0: <class 'decimal.Decimal'>, 1: <type 'int'>, 2: <type 'int'>, 3: <type 'long'>, 4: <type 'float'>, 5: <type 'float'>, 7: <function mysql_timestamp_converter>, 8: <type 'long'>, 9: <type 'int'>, 10: <function Date_or_None>, ...}