1  import sys
   2  from _typeshed import StrPath
   3  from typing import IO, Any, Container, Iterable, Optional, Sequence, Type, TypeVar, overload
   4  from typing_extensions import Literal
   5  
   6  class NullTranslations:
   7      def __init__(self, fp: Optional[IO[str]] = ...) -> None: ...
   8      def _parse(self, fp: IO[str]) -> None: ...
   9      def add_fallback(self, fallback: NullTranslations) -> None: ...
  10      def gettext(self, message: str) -> str: ...
  11      def lgettext(self, message: str) -> str: ...
  12      def ngettext(self, msgid1: str, msgid2: str, n: int) -> str: ...
  13      def lngettext(self, msgid1: str, msgid2: str, n: int) -> str: ...
  14      if sys.version_info >= (3, 8):
  15          def pgettext(self, context: str, message: str) -> str: ...
  16          def npgettext(self, context: str, msgid1: str, msgid2: str, n: int) -> str: ...
  17      def info(self) -> Any: ...
  18      def charset(self) -> Any: ...
  19      def output_charset(self) -> Any: ...
  20      def set_output_charset(self, charset: str) -> None: ...
  21      def install(self, names: Optional[Container[str]] = ...) -> None: ...
  22  
  23  class GNUTranslations(NullTranslations):
  24      LE_MAGIC: int
  25      BE_MAGIC: int
  26      CONTEXT: str
  27      VERSIONS: Sequence[int]
  28  
  29  def find(domain: str, localedir: Optional[StrPath] = ..., languages: Optional[Iterable[str]] = ..., all: bool = ...) -> Any: ...
  30  
  31  _T = TypeVar("_T")
  32  @overload
  33  def translation(
  34      domain: str,
  35      localedir: Optional[StrPath] = ...,
  36      languages: Optional[Iterable[str]] = ...,
  37      class_: None = ...,
  38      fallback: bool = ...,
  39      codeset: Optional[str] = ...,
  40  ) -> NullTranslations: ...
  41  @overload
  42  def translation(
  43      domain: str,
  44      localedir: Optional[StrPath] = ...,
  45      languages: Optional[Iterable[str]] = ...,
  46      class_: Type[_T] = ...,
  47      fallback: Literal[False] = ...,
  48      codeset: Optional[str] = ...,
  49  ) -> _T: ...
  50  @overload
  51  def translation(
  52      domain: str,
  53      localedir: Optional[StrPath] = ...,
  54      languages: Optional[Iterable[str]] = ...,
  55      class_: Type[_T] = ...,
  56      fallback: Literal[True] = ...,
  57      codeset: Optional[str] = ...,
  58  ) -> Any: ...
  59  def install(
  60      domain: str, localedir: Optional[StrPath] = ..., codeset: Optional[str] = ..., names: Optional[Container[str]] = ...
  61  ) -> None: ...
  62  def textdomain(domain: Optional[str] = ...) -> str: ...
  63  def bindtextdomain(domain: str, localedir: Optional[StrPath] = ...) -> str: ...
  64  def bind_textdomain_codeset(domain: str, codeset: Optional[str] = ...) -> str: ...
  65  def dgettext(domain: str, message: str) -> str: ...
  66  def ldgettext(domain: str, message: str) -> str: ...
  67  def dngettext(domain: str, msgid1: str, msgid2: str, n: int) -> str: ...
  68  def ldngettext(domain: str, msgid1: str, msgid2: str, n: int) -> str: ...
  69  def gettext(message: str) -> str: ...
  70  def lgettext(message: str) -> str: ...
  71  def ngettext(msgid1: str, msgid2: str, n: int) -> str: ...
  72  def lngettext(msgid1: str, msgid2: str, n: int) -> str: ...
  73  
  74  if sys.version_info >= (3, 8):
  75      def pgettext(context: str, message: str) -> str: ...
  76      def dpgettext(domain: str, context: str, message: str) -> str: ...
  77      def npgettext(context: str, msgid1: str, msgid2: str, n: int) -> str: ...
  78      def dnpgettext(domain: str, context: str, msgid1: str, msgid2: str, n: int) -> str: ...
  79  
  80  Catalog = translation
  81