venv active

2026-08-26 12:06:39 +02:00
parent b6737d9968
commit 29861506d4
578 changed files with 209234 additions and 1 deletions
@@ -0,0 +1,111 @@
+from mariadb.constants import FIELD_TYPE
+import time
+import datetime
+
+apilevel = '2.0'
+
+paramstyle = 'qmark'
+
+threadsafety = True
+
+
+class DbApiType(frozenset):
+    """
+    Immutable set for type checking
+
+    By default the following sets are defined:
+
+    - BINARY: for binary field types
+    - NUMBER: for numeric field types
+    - STRING: for character based (string) field types
+    - DATE: for date field type(s)
+    - DATETIME: for datetime and timestamp field type(s)
+    - TIME: for time field type(s)
+    - TIMESTAMP: for datetime and timestamp field type(s)
+
+
+    Example:
+    >>> FIELD_TYPE.GEOMETRY == mariadb.BINARY
+    True
+    >>> FIELD_TYPE.FLOAT == mariadb.BINARY
+    False
+    """
+
+    def __eq__(self, field_type):
+        if (isinstance(field_type, DbApiType)):
+            return not self.difference(field_type)
+        return field_type in self
+
+
+BINARY = DbApiType([FIELD_TYPE.GEOMETRY,
+                    FIELD_TYPE.LONG_BLOB,
+                    FIELD_TYPE.MEDIUM_BLOB,
+                    FIELD_TYPE.TINY_BLOB,
+                    FIELD_TYPE.BLOB])
+
+STRING = DbApiType([FIELD_TYPE.ENUM,
+                    FIELD_TYPE.JSON,
+                    FIELD_TYPE.STRING,
+                    FIELD_TYPE.VARCHAR,
+                    FIELD_TYPE.VAR_STRING])
+
+NUMBER = DbApiType([FIELD_TYPE.DECIMAL,
+                    FIELD_TYPE.DOUBLE,
+                    FIELD_TYPE.FLOAT,
+                    FIELD_TYPE.INT24,
+                    FIELD_TYPE.LONG,
+                    FIELD_TYPE.LONGLONG,
+                    FIELD_TYPE.NEWDECIMAL,
+                    FIELD_TYPE.SHORT,
+                    FIELD_TYPE.TINY,
+                    FIELD_TYPE.YEAR])
+
+DATE = DbApiType([FIELD_TYPE.DATE])
+TIME = DbApiType([FIELD_TYPE.TIME])
+DATETIME = TIMESTAMP = DbApiType([FIELD_TYPE.DATETIME,
+                                 FIELD_TYPE.TIMESTAMP])
+ROWID = DbApiType()
+
+
+def Binary(object):
+    """Constructs an object capable of holding a binary value."""
+    return bytes(object)
+
+
+def Date(year, month, day):
+    """Constructs an object holding a date value."""
+    return datetime.date(year, month, day)
+
+
+def Time(hour, minute, second):
+    """Constructs an object holding a time value."""
+    return datetime.time(hour, minute, second)
+
+
+def Timestamp(year, month, day, hour, minute, second):
+    """Constructs an object holding a datetime value."""
+    return datetime.datetime(year, month, day, hour, minute, second)
+
+
+def DateFromTicks(ticks):
+    """Constructs an object holding a date value from the given ticks value
+       (number of seconds since the epoch).
+       For more information see the documentation of the standard Python
+       time module."""
+    return Date(*time.localtime(ticks)[:3])
+
+
+def TimeFromTicks(ticks):
+    """Constructs an object holding a time value from the given ticks value
+       (number of seconds since the epoch).
+       For more information see the documentation of the standard Python
+       time module."""
+    return Time(*time.localtime(ticks)[3:6])
+
+
+def TimestampFromTicks(ticks):
+    """Constructs an object holding a datetime value from the given ticks value
+       (number of seconds since the epoch).
+       For more information see the documentation of the standard Python
+       time module."""
+    return datetime.datetime(*time.localtime(ticks)[:6])