src/nominatim_db/typing.py

   1 # SPDX-License-Identifier: GPL-3.0-or-later
   2 #
   3 # This file is part of Nominatim. (https://nominatim.org)
   4 #
   5 # Copyright (C) 2024 by the Nominatim developer community.
   6 # For a full list of authors see the git log.
   7 """
   8 Type definitions for typing annotations.
   9
  10 Complex type definitions are moved here, to keep the source files readable.
  11 """
  12 from typing import Any, Union, Mapping, TypeVar, Sequence, TYPE_CHECKING
  13
  14 # Generics variable names do not confirm to naming styles, ignore globally here.
  15 # pylint: disable=invalid-name,abstract-method,multiple-statements
  16 # pylint: disable=missing-class-docstring,useless-import-alias
  17
  18 if TYPE_CHECKING:
  19     import os
  20
  21 StrPath = Union[str, 'os.PathLike[str]']
  22
  23 SysEnv = Mapping[str, str]
  24
  25 # psycopg-related types
  26
  27 T_ResultKey = TypeVar('T_ResultKey', int, str)
  28
  29 class DictCursorResult(Mapping[str, Any]):
  30     def __getitem__(self, x: Union[int, str]) -> Any: ...
  31
  32 DictCursorResults = Sequence[DictCursorResult]
  33
  34 # The following typing features require typing_extensions to work
  35 # on all supported Python versions.
  36 # Only require this for type checking but not for normal operations.
  37
  38 if TYPE_CHECKING:
  39     from typing_extensions import (Protocol as Protocol,
  40                                    Final as Final,
  41                                    TypedDict as TypedDict)
  42 else:
  43     Protocol = object
  44     Final = 'Final'
  45     TypedDict = dict