93 lines
3.2 KiB
Python
93 lines
3.2 KiB
Python
# Copyright (c) 2009, 2024, Oracle and/or its affiliates.
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License, version 2.0, as
|
|
# published by the Free Software Foundation.
|
|
#
|
|
# This program is designed to work with certain software (including
|
|
# but not limited to OpenSSL) that is licensed under separate terms,
|
|
# as designated in a particular file or component or in included license
|
|
# documentation. The authors of MySQL hereby grant you an
|
|
# additional permission to link the program and your derivative works
|
|
# with the separately licensed software that they have either included with
|
|
# the program or referenced in the documentation.
|
|
#
|
|
# Without limiting anything contained in the foregoing, this file,
|
|
# which is part of MySQL Connector/Python, is also subject to the
|
|
# Universal FOSS Exception, version 1.0, a copy of which can be found at
|
|
# http://oss.oracle.com/licenses/universal-foss-exception.
|
|
#
|
|
# This program is distributed in the hope that it will be useful, but
|
|
# WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
# See the GNU General Public License, version 2.0, for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software Foundation, Inc.,
|
|
# 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
"""
|
|
This module implements some constructors and singletons as required by the
|
|
DB API v2.0 (PEP-249).
|
|
"""
|
|
|
|
# Python Db API v2
|
|
# pylint: disable=invalid-name
|
|
apilevel: str = "2.0"
|
|
"""This attribute is a string that indicates the supported DB API level."""
|
|
|
|
threadsafety: int = 1
|
|
"""This attribute is an integer that indicates the supported level of thread safety
|
|
provided by Connector/Python."""
|
|
|
|
paramstyle: str = "pyformat"
|
|
"""This attribute is a string that indicates the Connector/Python default
|
|
parameter style."""
|
|
|
|
import datetime
|
|
import time
|
|
|
|
from typing import Tuple
|
|
|
|
from . import constants
|
|
|
|
|
|
class _DBAPITypeObject:
|
|
def __init__(self, *values: int) -> None:
|
|
self.values: Tuple[int, ...] = values
|
|
|
|
def __eq__(self, other: object) -> bool:
|
|
return other in self.values
|
|
|
|
def __ne__(self, other: object) -> bool:
|
|
return other not in self.values
|
|
|
|
|
|
Date = datetime.date
|
|
Time = datetime.time
|
|
Timestamp = datetime.datetime
|
|
|
|
|
|
def DateFromTicks(ticks: int) -> datetime.date:
|
|
"""Construct an object holding a date value from the given ticks value."""
|
|
return Date(*time.localtime(ticks)[:3])
|
|
|
|
|
|
def TimeFromTicks(ticks: int) -> datetime.time:
|
|
"""Construct an object holding a time value from the given ticks value."""
|
|
return Time(*time.localtime(ticks)[3:6])
|
|
|
|
|
|
def TimestampFromTicks(ticks: int) -> datetime.datetime:
|
|
"""Construct an object holding a time stamp from the given ticks value."""
|
|
return Timestamp(*time.localtime(ticks)[:6])
|
|
|
|
|
|
Binary = bytes
|
|
|
|
STRING = _DBAPITypeObject(*constants.FieldType.get_string_types())
|
|
BINARY = _DBAPITypeObject(*constants.FieldType.get_binary_types())
|
|
NUMBER = _DBAPITypeObject(*constants.FieldType.get_number_types())
|
|
DATETIME = _DBAPITypeObject(*constants.FieldType.get_timestamp_types())
|
|
ROWID = _DBAPITypeObject()
|