@mytec: pushed back before 1.1

backend/venv/lib/python3.12/site-packages/pymongo/typings.py

@@ -0,0 +1,78 @@
+# Copyright 2022-Present MongoDB, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Type aliases used by PyMongo"""
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    TypeVar,
+    Union,
+)
+
+from bson.typings import _DocumentOut, _DocumentType, _DocumentTypeArg
+
+if TYPE_CHECKING:
+    from pymongo.asynchronous.bulk import _AsyncBulk
+    from pymongo.asynchronous.client_bulk import _AsyncClientBulk
+    from pymongo.asynchronous.client_session import AsyncClientSession
+    from pymongo.asynchronous.mongo_client import AsyncMongoClient
+    from pymongo.asynchronous.pool import AsyncConnection
+    from pymongo.collation import Collation
+    from pymongo.synchronous.bulk import _Bulk
+    from pymongo.synchronous.client_bulk import _ClientBulk
+    from pymongo.synchronous.client_session import ClientSession
+    from pymongo.synchronous.mongo_client import MongoClient
+    from pymongo.synchronous.pool import Connection
+
+
+# Common Shared Types.
+_Address = Tuple[str, Optional[int]]
+_CollationIn = Union[Mapping[str, Any], "Collation"]
+_Pipeline = Sequence[Mapping[str, Any]]
+ClusterTime = Mapping[str, Any]
+
+_T = TypeVar("_T")
+
+# Type hinting types for compatibility between async and sync classes
+_AgnosticMongoClient = Union["AsyncMongoClient", "MongoClient"]  # type: ignore[type-arg]
+_AgnosticConnection = Union["AsyncConnection", "Connection"]
+_AgnosticClientSession = Union["AsyncClientSession", "ClientSession"]
+_AgnosticBulk = Union["_AsyncBulk", "_Bulk"]
+_AgnosticClientBulk = Union["_AsyncClientBulk", "_ClientBulk"]
+
+
+def strip_optional(elem: Optional[_T]) -> _T:
+    """This function is to allow us to cast all the elements of an iterator from Optional[_T] to _T
+    while inside a list comprehension.
+    """
+    assert elem is not None
+    return elem
+
+
+__all__ = [
+    "_DocumentOut",
+    "_DocumentType",
+    "_DocumentTypeArg",
+    "_Address",
+    "_CollationIn",
+    "_Pipeline",
+    "strip_optional",
+    "_AgnosticMongoClient",
+]