##// END OF EJS Templates
interfaces: mark a few dirstate methods abstract...
interfaces: mark a few dirstate methods abstract I'm not sure what's going on here, but when enabling pytype checking on this package, it spits out the following errors: File "/mnt/c/Users/Matt/hg/mercurial/interfaces/dirstate.py", line 136, in changing_parents: bad return type [bad-return-type] Expected: Iterator Actually returned: None Attributes of protocol Iterator are not implemented on None: __next__ File "/mnt/c/Users/Matt/hg/mercurial/interfaces/dirstate.py", line 145, in changing_files: bad return type [bad-return-type] Expected: Iterator Actually returned: None Attributes of protocol Iterator are not implemented on None: __next__ I guess technically that's true, because these methods only have a doc comment, and don't explicitly return something or unconditionally raise an error. The strange thing is that both before and after this change, the *.pyi file that is generated is unchanged, and contains: def changing_files(self, repo) -> contextlib._GeneratorContextManager: ... def changing_parents(self, repo) -> contextlib._GeneratorContextManager: ... I'm not sure if the `@abstractmethod` should be the most inner or most outer decoration. We'll roll the dice with being the innermost, because that's how `@abstractproperty` says it should be used in conjunction with `@property`. We should probably make all of the methods without an actual body abstract, like was done for some `mercurial.wireprototypes` classes in fd200f5bcaea. But let's hold off for now and do that enmass later.

File last commit:

r52756:f4733654 default
r53328:2c8c46c3 default
Show More
i18n.py
127 lines | 4.0 KiB | text/x-python | PythonLexer
Martin Geisler
put license and copyright info into comment blocks
r8226 # i18n.py - internationalization support for mercurial
#
Raphaël Gomès
contributor: change mentions of mpm to olivia...
r47575 # Copyright 2005, 2006 Olivia Mackall <olivia@selenic.com>
Martin Geisler
put license and copyright info into comment blocks
r8226 #
# This software may be used and distributed according to the terms of the
Matt Mackall
Update license to GPLv2+
r10263 # GNU General Public License version 2 or any later version.
Benoit Boissinot
i18n first part: make '_' available for files who need it
r1400
Matt Harbison
typing: add `from __future__ import annotations` to most files...
r52756 from __future__ import annotations
Gregory Szorc
i18n: use absolute_import
r25955
import gettext as gettextmod
import locale
import os
import sys
pytype: import typing directly...
r52178 from typing import (
Matt Harbison
typing: add type hints to `i18n._msgcache`...
r52610 Dict,
pytype: import typing directly...
r52178 List,
)
Martin von Zweigbergk
i18n: get datapath directly from resourceutil...
r44069 from .utils import resourceutil
Pulkit Goyal
py3: convert to unicode to pass into encode()...
r30050 from . import (
encoding,
pycompat,
)
Martin Geisler
i18n: lookup .mo files in private locale/ directory...
r7650
# modelled after templater.templatepath:
Augie Fackler
i18n: use getattr instead of hasattr...
r14975 if getattr(sys, 'frozen', None) is not None:
Pulkit Goyal
py3: replace sys.executable with pycompat.sysexecutable...
r30669 module = pycompat.sysexecutable
Martin Geisler
i18n: lookup .mo files in private locale/ directory...
r7650 else:
Pulkit Goyal
py3: use pycompat.fsencode() to convert __file__ to bytes...
r31074 module = pycompat.fsencode(__file__)
Martin Geisler
i18n: lookup .mo files in private locale/ directory...
r7650
Yuya Nishihara
i18n: detect UI language without POSIX-style locale variable on Windows (BC)...
r21987 _languages = None
Augie Fackler
formatting: blacken the codebase...
r43346 if (
pycompat.iswindows
Augie Fackler
formatting: byteify all mercurial/ and hgext/ string literals...
r43347 and b'LANGUAGE' not in encoding.environ
and b'LC_ALL' not in encoding.environ
and b'LC_MESSAGES' not in encoding.environ
and b'LANG' not in encoding.environ
Augie Fackler
formatting: blacken the codebase...
r43346 ):
Yuya Nishihara
i18n: detect UI language without POSIX-style locale variable on Windows (BC)...
r21987 # Try to detect UI language by "User Interface Language Management" API
# if no locale variables are set. Note that locale.getdefaultlocale()
# uses GetLocaleInfo(), which may be different from UI language.
# (See http://msdn.microsoft.com/en-us/library/dd374098(v=VS.85).aspx )
try:
import ctypes
Augie Fackler
formatting: blacken the codebase...
r43346
Matt Harbison
typing: add type annotations to mercurial/i18n.py...
r47388 # pytype: disable=module-attr
Yuya Nishihara
i18n: detect UI language without POSIX-style locale variable on Windows (BC)...
r21987 langid = ctypes.windll.kernel32.GetUserDefaultUILanguage()
Matt Harbison
typing: add type annotations to mercurial/i18n.py...
r47388 # pytype: enable=module-attr
Yuya Nishihara
i18n: detect UI language without POSIX-style locale variable on Windows (BC)...
r21987 _languages = [locale.windows_locale[langid]]
except (ImportError, AttributeError, KeyError):
# ctypes not found or unknown langid
pass
Mads Kiilerich
i18n: use datapath for i18n like for templates and help...
r22638
Martin von Zweigbergk
i18n: get datapath directly from resourceutil...
r44069 datapath = pycompat.fsdecode(resourceutil.datapath)
localedir = os.path.join(datapath, 'locale')
t = gettextmod.translation('hg', localedir, _languages, fallback=True)
try:
Matt Harbison
typing: add type annotations to mercurial/i18n.py...
r47388 _ugettext = t.ugettext # pytype: disable=attribute-error
Martin von Zweigbergk
i18n: get datapath directly from resourceutil...
r44069 except AttributeError:
_ugettext = t.gettext
Martin Geisler
i18n: encode output in user's local encoding...
r7651
Augie Fackler
formatting: blacken the codebase...
r43346
Matt Harbison
typing: add type hints to `i18n._msgcache`...
r52610 _msgcache: Dict[
bytes, Dict[bytes, bytes]
] = {} # encoding: {message: translation}
Augie Fackler
i18n: cache the result of every gettext call...
r23031
Augie Fackler
formatting: blacken the codebase...
r43346
pytype: move some type comment to proper annotation...
r52180 def gettext(message: bytes) -> bytes:
Martin Geisler
i18n: encode output in user's local encoding...
r7651 """Translate message.
The message is looked up in the catalog to get a Unicode string,
which is encoded in the local encoding before being returned.
Important: message is restricted to characters in the encoding
given by sys.getdefaultencoding() which is most likely 'ascii'.
"""
# If message is None, t.ugettext will return u'None' as the
# translation whereas our callers expect us to return None.
Mads Kiilerich
i18n: use datapath for i18n like for templates and help...
r22638 if message is None or not _ugettext:
Martin Geisler
i18n: encode output in user's local encoding...
r7651 return message
Yuya Nishihara
i18n: cache translated messages per encoding...
r34661 cache = _msgcache.setdefault(encoding.encoding, {})
if message not in cache:
Gregory Szorc
py3: use str instead of pycompat.unicode...
r49789 if type(message) is str:
Augie Fackler
i18n: cache the result of every gettext call...
r23031 # goofy unicode docstrings in test
pytype: convert type comment for inline variable too...
r52181 paragraphs: List[str] = message.split(u'\n\n')
Augie Fackler
i18n: cache the result of every gettext call...
r23031 else:
Yuya Nishihara
py3: get around unicode docstrings in test-encoding-textwrap.t and test-help.t...
r40290 # should be ascii, but we have unicode docstrings in test, which
# are converted to utf-8 bytes on Python 3.
Augie Fackler
formatting: byteify all mercurial/ and hgext/ string literals...
r43347 paragraphs = [p.decode("utf-8") for p in message.split(b'\n\n')]
Augie Fackler
i18n: cache the result of every gettext call...
r23031 # Be careful not to translate the empty string -- it holds the
# meta data of the .po file.
Gregory Szorc
i18n: use unicode literal...
r29415 u = u'\n\n'.join([p and _ugettext(p) or u'' for p in paragraphs])
Augie Fackler
i18n: cache the result of every gettext call...
r23031 try:
# encoding.tolocal cannot be used since it will first try to
# decode the Unicode string. Calling u.decode(enc) really
# means u.encode(sys.getdefaultencoding()).decode(enc). Since
# the Python encoding defaults to 'ascii', this fails if the
# translated string use non-ASCII characters.
Pulkit Goyal
py3: convert to unicode to pass into encode()...
r30050 encodingstr = pycompat.sysstr(encoding.encoding)
Yuya Nishihara
i18n: cache translated messages per encoding...
r34661 cache[message] = u.encode(encodingstr, "replace")
Augie Fackler
i18n: cache the result of every gettext call...
r23031 except LookupError:
# An unknown encoding results in a LookupError.
Yuya Nishihara
i18n: cache translated messages per encoding...
r34661 cache[message] = message
return cache[message]
Martin Geisler
i18n: encode output in user's local encoding...
r7651
Augie Fackler
formatting: blacken the codebase...
r43346
Brodie Rao
HGPLAIN: allow exceptions to plain mode, like i18n, via HGPLAINEXCEPT...
r13849 def _plain():
Augie Fackler
formatting: blacken the codebase...
r43346 if (
Augie Fackler
formatting: byteify all mercurial/ and hgext/ string literals...
r43347 b'HGPLAIN' not in encoding.environ
and b'HGPLAINEXCEPT' not in encoding.environ
Augie Fackler
formatting: blacken the codebase...
r43346 ):
Brodie Rao
HGPLAIN: allow exceptions to plain mode, like i18n, via HGPLAINEXCEPT...
r13849 return False
Augie Fackler
formatting: byteify all mercurial/ and hgext/ string literals...
r43347 exceptions = encoding.environ.get(b'HGPLAINEXCEPT', b'').strip().split(b',')
return b'i18n' not in exceptions
Brodie Rao
HGPLAIN: allow exceptions to plain mode, like i18n, via HGPLAINEXCEPT...
r13849
Augie Fackler
formatting: blacken the codebase...
r43346
Brodie Rao
HGPLAIN: allow exceptions to plain mode, like i18n, via HGPLAINEXCEPT...
r13849 if _plain():
pytype: move some type comment to proper annotation...
r52180
def _(message: bytes) -> bytes:
return message
Brodie Rao
ui: add HGPLAIN environment variable for easier scripting...
r10455 else:
_ = gettext