__init__.py 3.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. """MySQLdb - A DB API v2.0 compatible interface to MySQL.
  2. This package is a wrapper around _mysql, which mostly implements the
  3. MySQL C API.
  4. connect() -- connects to server
  5. See the C API specification and the MySQL documentation for more info
  6. on other items.
  7. For information on how MySQLdb handles type conversion, see the
  8. MySQLdb.converters module.
  9. """
  10. __revision__ = """$Revision$"""[11:-2]
  11. from MySQLdb.release import __version__, version_info, __author__
  12. import _mysql
  13. if version_info != _mysql.version_info:
  14. raise ImportError("this is MySQLdb version %s, but _mysql is version %r" %
  15. (version_info, _mysql.version_info))
  16. threadsafety = 1
  17. apilevel = "2.0"
  18. paramstyle = "format"
  19. from _mysql import *
  20. from MySQLdb.constants import FIELD_TYPE
  21. from MySQLdb.times import Date, Time, Timestamp, \
  22. DateFromTicks, TimeFromTicks, TimestampFromTicks
  23. try:
  24. frozenset
  25. except NameError:
  26. from sets import ImmutableSet as frozenset
  27. class DBAPISet(frozenset):
  28. """A special type of set for which A == x is true if A is a
  29. DBAPISet and x is a member of that set."""
  30. def __eq__(self, other):
  31. if isinstance(other, DBAPISet):
  32. return not self.difference(other)
  33. return other in self
  34. STRING = DBAPISet([FIELD_TYPE.ENUM, FIELD_TYPE.STRING,
  35. FIELD_TYPE.VAR_STRING])
  36. BINARY = DBAPISet([FIELD_TYPE.BLOB, FIELD_TYPE.LONG_BLOB,
  37. FIELD_TYPE.MEDIUM_BLOB, FIELD_TYPE.TINY_BLOB])
  38. NUMBER = DBAPISet([FIELD_TYPE.DECIMAL, FIELD_TYPE.DOUBLE, FIELD_TYPE.FLOAT,
  39. FIELD_TYPE.INT24, FIELD_TYPE.LONG, FIELD_TYPE.LONGLONG,
  40. FIELD_TYPE.TINY, FIELD_TYPE.YEAR])
  41. DATE = DBAPISet([FIELD_TYPE.DATE, FIELD_TYPE.NEWDATE])
  42. TIME = DBAPISet([FIELD_TYPE.TIME])
  43. TIMESTAMP = DBAPISet([FIELD_TYPE.TIMESTAMP, FIELD_TYPE.DATETIME])
  44. DATETIME = TIMESTAMP
  45. ROWID = DBAPISet()
  46. def test_DBAPISet_set_equality():
  47. assert STRING == STRING
  48. def test_DBAPISet_set_inequality():
  49. assert STRING != NUMBER
  50. def test_DBAPISet_set_equality_membership():
  51. assert FIELD_TYPE.VAR_STRING == STRING
  52. def test_DBAPISet_set_inequality_membership():
  53. assert FIELD_TYPE.DATE != STRING
  54. def Binary(x):
  55. return str(x)
  56. def Connect(*args, **kwargs):
  57. """Factory function for connections.Connection."""
  58. from MySQLdb.connections import Connection
  59. return Connection(*args, **kwargs)
  60. connect = Connection = Connect
  61. __all__ = [ 'BINARY', 'Binary', 'Connect', 'Connection', 'DATE',
  62. 'Date', 'Time', 'Timestamp', 'DateFromTicks', 'TimeFromTicks',
  63. 'TimestampFromTicks', 'DataError', 'DatabaseError', 'Error',
  64. 'FIELD_TYPE', 'IntegrityError', 'InterfaceError', 'InternalError',
  65. 'MySQLError', 'NULL', 'NUMBER', 'NotSupportedError', 'DBAPISet',
  66. 'OperationalError', 'ProgrammingError', 'ROWID', 'STRING', 'TIME',
  67. 'TIMESTAMP', 'Warning', 'apilevel', 'connect', 'connections',
  68. 'constants', 'converters', 'cursors', 'debug', 'escape', 'escape_dict',
  69. 'escape_sequence', 'escape_string', 'get_client_info',
  70. 'paramstyle', 'string_literal', 'threadsafety', 'version_info']