X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/f22fa992f7975757d84ae17e42ff98c15f7a572b..4efad0bb95024e2082f73b4ae33613ef8f6ebef3:/nominatim/typing.py diff --git a/nominatim/typing.py b/nominatim/typing.py index abecc53d..7914d731 100644 --- a/nominatim/typing.py +++ b/nominatim/typing.py @@ -9,19 +9,44 @@ Type definitions for typing annotations. Complex type definitions are moved here, to keep the source files readable. """ -from typing import Union, TypeVar, TYPE_CHECKING +from typing import Any, Union, Mapping, TypeVar, Sequence, TYPE_CHECKING -# Generics varaible names do not confirm to naming styles, ignore globally here. -# pylint: disable=invalid-name +# Generics variable names do not confirm to naming styles, ignore globally here. +# pylint: disable=invalid-name,abstract-method,multiple-statements +# pylint: disable=missing-class-docstring,useless-import-alias if TYPE_CHECKING: import psycopg2.sql import psycopg2.extensions + import psycopg2.extras import os StrPath = Union[str, 'os.PathLike[str]'] +SysEnv = Mapping[str, str] + # psycopg2-related types Query = Union[str, bytes, 'psycopg2.sql.Composable'] + +T_ResultKey = TypeVar('T_ResultKey', int, str) + +class DictCursorResult(Mapping[str, Any]): + def __getitem__(self, x: Union[int, str]) -> Any: ... + +DictCursorResults = Sequence[DictCursorResult] + T_cursor = TypeVar('T_cursor', bound='psycopg2.extensions.cursor') + +# The following typing features require typing_extensions to work +# on all supported Python versions. +# Only require this for type checking but not for normal operations. + +if TYPE_CHECKING: + from typing_extensions import (Protocol as Protocol, + Final as Final, + TypedDict as TypedDict) +else: + Protocol = object + Final = 'Final' + TypedDict = dict