Current Dir: /snap/core22/2955/usr/lib/python3.10/encodings/
[DIR] __pycache__ [ delete | rename ]
[FILE] aliases.py [ edit | delete | rename ]
[FILE] ascii.py [ edit | delete | rename ]
[FILE] base64_codec.py [ edit | delete | rename ]
[FILE] big5.py [ edit | delete | rename ]
[FILE] big5hkscs.py [ edit | delete | rename ]
[FILE] bz2_codec.py [ edit | delete | rename ]
[FILE] charmap.py [ edit | delete | rename ]
[FILE] cp037.py [ edit | delete | rename ]
[FILE] cp273.py [ edit | delete | rename ]
[FILE] cp424.py [ edit | delete | rename ]
[FILE] cp437.py [ edit | delete | rename ]
[FILE] cp500.py [ edit | delete | rename ]
[FILE] cp720.py [ edit | delete | rename ]
[FILE] cp737.py [ edit | delete | rename ]
[FILE] cp775.py [ edit | delete | rename ]
[FILE] cp850.py [ edit | delete | rename ]
[FILE] cp852.py [ edit | delete | rename ]
[FILE] cp855.py [ edit | delete | rename ]
[FILE] cp856.py [ edit | delete | rename ]
[FILE] cp857.py [ edit | delete | rename ]
[FILE] cp858.py [ edit | delete | rename ]
[FILE] cp860.py [ edit | delete | rename ]
[FILE] cp861.py [ edit | delete | rename ]
[FILE] cp862.py [ edit | delete | rename ]
[FILE] cp863.py [ edit | delete | rename ]
[FILE] cp864.py [ edit | delete | rename ]
[FILE] cp865.py [ edit | delete | rename ]
[FILE] cp866.py [ edit | delete | rename ]
[FILE] cp869.py [ edit | delete | rename ]
[FILE] cp874.py [ edit | delete | rename ]
[FILE] cp875.py [ edit | delete | rename ]
[FILE] cp932.py [ edit | delete | rename ]
[FILE] cp949.py [ edit | delete | rename ]
[FILE] cp950.py [ edit | delete | rename ]
[FILE] cp1006.py [ edit | delete | rename ]
[FILE] cp1026.py [ edit | delete | rename ]
[FILE] cp1125.py [ edit | delete | rename ]
[FILE] cp1140.py [ edit | delete | rename ]
[FILE] cp1250.py [ edit | delete | rename ]
[FILE] cp1251.py [ edit | delete | rename ]
[FILE] cp1252.py [ edit | delete | rename ]
[FILE] cp1253.py [ edit | delete | rename ]
[FILE] cp1254.py [ edit | delete | rename ]
[FILE] cp1255.py [ edit | delete | rename ]
[FILE] cp1256.py [ edit | delete | rename ]
[FILE] cp1257.py [ edit | delete | rename ]
[FILE] cp1258.py [ edit | delete | rename ]
[FILE] euc_jisx0213.py [ edit | delete | rename ]
[FILE] euc_jis_2004.py [ edit | delete | rename ]
[FILE] euc_jp.py [ edit | delete | rename ]
[FILE] euc_kr.py [ edit | delete | rename ]
[FILE] gb2312.py [ edit | delete | rename ]
[FILE] gb18030.py [ edit | delete | rename ]
[FILE] gbk.py [ edit | delete | rename ]
[FILE] hex_codec.py [ edit | delete | rename ]
[FILE] hp_roman8.py [ edit | delete | rename ]
[FILE] hz.py [ edit | delete | rename ]
[FILE] idna.py [ edit | delete | rename ]
[FILE] iso2022_jp.py [ edit | delete | rename ]
[FILE] iso2022_jp_1.py [ edit | delete | rename ]
[FILE] iso2022_jp_2.py [ edit | delete | rename ]
[FILE] iso2022_jp_3.py [ edit | delete | rename ]
[FILE] iso2022_jp_2004.py [ edit | delete | rename ]
[FILE] iso2022_jp_ext.py [ edit | delete | rename ]
[FILE] iso2022_kr.py [ edit | delete | rename ]
[FILE] iso8859_1.py [ edit | delete | rename ]
[FILE] iso8859_2.py [ edit | delete | rename ]
[FILE] iso8859_3.py [ edit | delete | rename ]
[FILE] iso8859_4.py [ edit | delete | rename ]
[FILE] iso8859_5.py [ edit | delete | rename ]
[FILE] iso8859_6.py [ edit | delete | rename ]
[FILE] iso8859_7.py [ edit | delete | rename ]
[FILE] iso8859_8.py [ edit | delete | rename ]
[FILE] iso8859_9.py [ edit | delete | rename ]
[FILE] iso8859_10.py [ edit | delete | rename ]
[FILE] iso8859_11.py [ edit | delete | rename ]
[FILE] iso8859_13.py [ edit | delete | rename ]
[FILE] iso8859_14.py [ edit | delete | rename ]
[FILE] iso8859_15.py [ edit | delete | rename ]
[FILE] iso8859_16.py [ edit | delete | rename ]
[FILE] johab.py [ edit | delete | rename ]
[FILE] koi8_r.py [ edit | delete | rename ]
[FILE] koi8_t.py [ edit | delete | rename ]
[FILE] koi8_u.py [ edit | delete | rename ]
[FILE] kz1048.py [ edit | delete | rename ]
[FILE] latin_1.py [ edit | delete | rename ]
[FILE] mac_arabic.py [ edit | delete | rename ]
[FILE] mac_croatian.py [ edit | delete | rename ]
[FILE] mac_cyrillic.py [ edit | delete | rename ]
[FILE] mac_farsi.py [ edit | delete | rename ]
[FILE] mac_greek.py [ edit | delete | rename ]
[FILE] mac_iceland.py [ edit | delete | rename ]
[FILE] mac_latin2.py [ edit | delete | rename ]
[FILE] mac_roman.py [ edit | delete | rename ]
[FILE] mac_romanian.py [ edit | delete | rename ]
[FILE] mac_turkish.py [ edit | delete | rename ]
[FILE] mbcs.py [ edit | delete | rename ]
[FILE] oem.py [ edit | delete | rename ]
[FILE] palmos.py [ edit | delete | rename ]
[FILE] ptcp154.py [ edit | delete | rename ]
[FILE] punycode.py [ edit | delete | rename ]
[FILE] quopri_codec.py [ edit | delete | rename ]
[FILE] raw_unicode_escape.py [ edit | delete | rename ]
[FILE] rot_13.py [ edit | delete | rename ]
[FILE] shift_jis.py [ edit | delete | rename ]
[FILE] shift_jisx0213.py [ edit | delete | rename ]
[FILE] shift_jis_2004.py [ edit | delete | rename ]
[FILE] tis_620.py [ edit | delete | rename ]
[FILE] undefined.py [ edit | delete | rename ]
[FILE] unicode_escape.py [ edit | delete | rename ]
[FILE] utf_7.py [ edit | delete | rename ]
[FILE] utf_8.py [ edit | delete | rename ]
[FILE] utf_8_sig.py [ edit | delete | rename ]
[FILE] utf_16.py [ edit | delete | rename ]
[FILE] utf_16_be.py [ edit | delete | rename ]
[FILE] utf_16_le.py [ edit | delete | rename ]
[FILE] utf_32.py [ edit | delete | rename ]
[FILE] utf_32_be.py [ edit | delete | rename ]
[FILE] utf_32_le.py [ edit | delete | rename ]
[FILE] uu_codec.py [ edit | delete | rename ]
[FILE] zlib_codec.py [ edit | delete | rename ]
[FILE] __init__.py [ edit | delete | rename ]
Viewing: /snap/core22/2955/usr/lib/python3.10/encodings/__init__.py
""" Standard "encodings" Package
Standard Python encoding modules are stored in this package
directory.
Codec modules must have names corresponding to normalized encoding
names as defined in the normalize_encoding() function below, e.g.
'utf-8' must be implemented by the module 'utf_8.py'.
Each codec module must export the following interface:
* getregentry() -> codecs.CodecInfo object
The getregentry() API must return a CodecInfo object with encoder, decoder,
incrementalencoder, incrementaldecoder, streamwriter and streamreader
attributes which adhere to the Python Codec Interface Standard.
In addition, a module may optionally also define the following
APIs which are then used by the package's codec search function:
* getaliases() -> sequence of encoding name strings to use as aliases
Alias names returned by getaliases() must be normalized encoding
names as defined by normalize_encoding().
Written by Marc-Andre Lemburg (mal@lemburg.com).
(c) Copyright CNRI, All Rights Reserved. NO WARRANTY.
"""#"
import codecs
import sys
from . import aliases
_cache = {}
_unknown = '--unknown--'
_import_tail = ['*']
_aliases = aliases.aliases
class CodecRegistryError(LookupError, SystemError):
pass
def normalize_encoding(encoding):
""" Normalize an encoding name.
Normalization works as follows: all non-alphanumeric
characters except the dot used for Python package names are
collapsed and replaced with a single underscore, e.g. ' -;#'
becomes '_'. Leading and trailing underscores are removed.
Note that encoding names should be ASCII only.
"""
if isinstance(encoding, bytes):
encoding = str(encoding, "ascii")
chars = []
punct = False
for c in encoding:
if c.isalnum() or c == '.':
if punct and chars:
chars.append('_')
if c.isascii():
chars.append(c)
punct = False
else:
punct = True
return ''.join(chars)
def search_function(encoding):
# Cache lookup
entry = _cache.get(encoding, _unknown)
if entry is not _unknown:
return entry
# Import the module:
#
# First try to find an alias for the normalized encoding
# name and lookup the module using the aliased name, then try to
# lookup the module using the standard import scheme, i.e. first
# try in the encodings package, then at top-level.
#
norm_encoding = normalize_encoding(encoding)
aliased_encoding = _aliases.get(norm_encoding) or \
_aliases.get(norm_encoding.replace('.', '_'))
if aliased_encoding is not None:
modnames = [aliased_encoding,
norm_encoding]
else:
modnames = [norm_encoding]
for modname in modnames:
if not modname or '.' in modname:
continue
try:
# Import is absolute to prevent the possibly malicious import of a
# module with side-effects that is not in the 'encodings' package.
mod = __import__('encodings.' + modname, fromlist=_import_tail,
level=0)
except ImportError:
# ImportError may occur because 'encodings.(modname)' does not exist,
# or because it imports a name that does not exist (see mbcs and oem)
pass
else:
break
else:
mod = None
try:
getregentry = mod.getregentry
except AttributeError:
# Not a codec module
mod = None
if mod is None:
# Cache misses
_cache[encoding] = None
return None
# Now ask the module for the registry entry
entry = getregentry()
if not isinstance(entry, codecs.CodecInfo):
if not 4 <= len(entry) <= 7:
raise CodecRegistryError('module "%s" (%s) failed to register'
% (mod.__name__, mod.__file__))
if not callable(entry[0]) or not callable(entry[1]) or \
(entry[2] is not None and not callable(entry[2])) or \
(entry[3] is not None and not callable(entry[3])) or \
(len(entry) > 4 and entry[4] is not None and not callable(entry[4])) or \
(len(entry) > 5 and entry[5] is not None and not callable(entry[5])):
raise CodecRegistryError('incompatible codecs in module "%s" (%s)'
% (mod.__name__, mod.__file__))
if len(entry)<7 or entry[6] is None:
entry += (None,)*(6-len(entry)) + (mod.__name__.split(".", 1)[1],)
entry = codecs.CodecInfo(*entry)
# Cache the codec registry entry
_cache[encoding] = entry
# Register its aliases (without overwriting previously registered
# aliases)
try:
codecaliases = mod.getaliases()
except AttributeError:
pass
else:
for alias in codecaliases:
if alias not in _aliases:
_aliases[alias] = modname
# Return the registry entry
return entry
# Register the search_function in the Python codec registry
codecs.register(search_function)
if sys.platform == 'win32':
def _alias_mbcs(encoding):
try:
import _winapi
ansi_code_page = "cp%s" % _winapi.GetACP()
if encoding == ansi_code_page:
import encodings.mbcs
return encodings.mbcs.getregentry()
except ImportError:
# Imports may fail while we are shutting down
pass
codecs.register(_alias_mbcs)