mysqlx-connector-python 8.3.0__py2.py3-none-any.whl

mysqlx/types.py

@@ -0,0 +1,92 @@
+"""
+Type hint aliases hub
+"""
+
+import typing
+
+from datetime import datetime, timedelta
+from decimal import Decimal
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple, Type, Union
+
+if hasattr(typing, "TypeAlias"):
+    # pylint: disable=no-name-in-module
+    from typing import TypeAlias  # type: ignore[attr-defined]
+else:
+    try:
+        from typing_extensions import TypeAlias
+    except ModuleNotFoundError:
+        # pylint: disable=reimported
+        from typing import Any as TypeAlias
+
+
+if TYPE_CHECKING:
+    from google.protobuf.message import Message as ProtoMessage
+
+    # pylint: disable=redefined-builtin
+    from .connection import Connection, Session, SocketStream
+    from .crud import DatabaseObject, Schema
+    from .dbdoc import DbDoc
+    from .errors import (
+        DatabaseError,
+        DataError,
+        Error,
+        IntegrityError,
+        InterfaceError,
+        InternalError,
+        NotSupportedError,
+        OperationalError,
+        PoolError,
+        ProgrammingError,
+        TimeoutError,
+    )
+    from .expr import ExprParser
+    from .protobuf import Message as XdevMessage
+    from .result import BaseResult, Column
+    from .statement import Statement
+
+
+StrOrBytes = Union[str, bytes]
+
+BuildScalarTypes = Optional[Union[str, bytes, bool, int, float]]
+BuildExprTypes = Union[
+    "XdevMessage", "ExprParser", Dict[str, Any], "DbDoc", List, Tuple, BuildScalarTypes
+]
+ColumnType: TypeAlias = "Column"
+ConnectionType: TypeAlias = "Connection"
+DatabaseTargetType: TypeAlias = "DatabaseObject"
+ErrorClassTypes = Union[
+    Type["Error"],
+    Type["InterfaceError"],
+    Type["DatabaseError"],
+    Type["InternalError"],
+    Type["OperationalError"],
+    Type["ProgrammingError"],
+    Type["IntegrityError"],
+    Type["DataError"],
+    Type["NotSupportedError"],
+    Type["PoolError"],
+    Type["TimeoutError"],
+]
+ErrorTypes = Union[
+    "Error",
+    "InterfaceError",
+    "DatabaseError",
+    "InternalError",
+    "OperationalError",
+    "ProgrammingError",
+    "IntegrityError",
+    "DataError",
+    "NotSupportedError",
+    "PoolError",
+    "TimeoutError",
+]
+EscapeTypes = Optional[Union[int, float, Decimal, StrOrBytes]]
+FieldTypes = Optional[Union[int, float, str, bytes, Decimal, datetime, timedelta]]
+MessageType: TypeAlias = "XdevMessage"
+ProtobufMessageType: TypeAlias = "ProtoMessage"
+ProtobufMessageCextType = Dict[str, Any]
+ResultBaseType: TypeAlias = "BaseResult"
+SchemaType: TypeAlias = "Schema"
+SessionType: TypeAlias = "Session"
+SocketType: TypeAlias = "SocketStream"
+StatementType: TypeAlias = "Statement"

mysqlx/utils.py

@@ -0,0 +1,136 @@
+# Copyright (c) 2009, 2023, 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 also distributed 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 included with
+# MySQL.
+#
+# 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
+
+"""Utilities."""
+
+import os
+import subprocess
+import sys
+
+from typing import Dict, Optional, Tuple
+
+
+def _parse_os_release() -> Dict[str, str]:
+    """Parse the contents of /etc/os-release file.
+
+    Returns:
+        A dictionary containing release information.
+    """
+    distro: Dict[str, str] = {}
+    os_release_file = os.path.join("/etc", "os-release")
+    if not os.path.exists(os_release_file):
+        return distro
+    with open(os_release_file, encoding="utf-8") as file_obj:
+        for line in file_obj:
+            key_value = line.split("=")
+            if len(key_value) != 2:
+                continue
+            key = key_value[0].lower()
+            value = key_value[1].rstrip("\n").strip('"')
+            distro[key] = value
+    return distro
+
+
+def _parse_lsb_release() -> Dict[str, str]:
+    """Parse the contents of /etc/lsb-release file.
+
+    Returns:
+        A dictionary containing release information.
+    """
+    distro = {}
+    lsb_release_file = os.path.join("/etc", "lsb-release")
+    if os.path.exists(lsb_release_file):
+        with open(lsb_release_file, encoding="utf-8") as file_obj:
+            for line in file_obj:
+                key_value = line.split("=")
+                if len(key_value) != 2:
+                    continue
+                key = key_value[0].lower()
+                value = key_value[1].rstrip("\n").strip('"')
+                distro[key] = value
+    return distro
+
+
+def _parse_lsb_release_command() -> Optional[Dict[str, str]]:
+    """Parse the output of the lsb_release command.
+
+    Returns:
+        A dictionary containing release information.
+    """
+    distro = {}
+    with open(os.devnull, "w", encoding="utf-8") as devnull:
+        try:
+            stdout = subprocess.check_output(("lsb_release", "-a"), stderr=devnull)
+        except OSError:
+            return None
+        lines = stdout.decode(sys.getfilesystemencoding()).splitlines()
+        for line in lines:
+            key_value = line.split(":")
+            if len(key_value) != 2:
+                continue
+            key = key_value[0].replace(" ", "_").lower()
+            value = key_value[1].strip("\t")
+            distro[key] = value
+    return distro
+
+
+def linux_distribution() -> Tuple[str, str, str]:
+    """Tries to determine the name of the Linux OS distribution name.
+
+    First tries to get information from ``/etc/os-release`` file.
+    If fails, tries to get the information of ``/etc/lsb-release`` file.
+    And finally the information of ``lsb-release`` command.
+
+    Returns:
+        A tuple with (`name`, `version`, `codename`)
+    """
+    distro: Optional[Dict[str, str]] = _parse_lsb_release()
+    if distro:
+        return (
+            distro.get("distrib_id", ""),
+            distro.get("distrib_release", ""),
+            distro.get("distrib_codename", ""),
+        )
+
+    distro = _parse_lsb_release_command()
+    if distro:
+        return (
+            distro.get("distributor_id", ""),
+            distro.get("release", ""),
+            distro.get("codename", ""),
+        )
+
+    distro = _parse_os_release()
+    if distro:
+        return (
+            distro.get("name", ""),
+            distro.get("version_id", ""),
+            distro.get("version_codename", ""),
+        )
+
+    return ("", "", "")

mysqlx/version.py

@@ -0,0 +1,46 @@
+# Copyright (c) 2012, 2023, Oracle and/or its affiliates. All rights reserved.
+#
+# 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 also distributed 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 included with
+# MySQL.
+#
+# 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
+
+"""MySQL Connector/Python version information
+
+The file version.py gets installed and is available after installation
+as mysqlx.version.
+"""
+
+VERSION = (8, 3, 0, "", 1)
+
+# pylint: disable=consider-using-f-string
+if VERSION[3] and VERSION[4]:
+    VERSION_TEXT = "{0}.{1}.{2}{3}{4}".format(*VERSION)
+else:
+    VERSION_TEXT = "{0}.{1}.{2}".format(*VERSION[0:3])
+# pylint: enable=consider-using-f-string
+
+VERSION_EXTRA = ""
+LICENSE = "GPLv2 with FOSS License Exception"
+EDITION = ""  # Added in package names, after the version