L1L`XPL0IT

✏️ Edit: punycode.py

📁 /snap/core24/current/lib/python3.12/encodings/punycode.py

""" Codec for the Punicode encoding, as specified in RFC 3492

Written by Martin v. Löwis.
"""

import codecs

##################### Encoding #####################################

def segregate(str):
    """3.1 Basic code point segregation"""
    base = bytearray()
    extended = set()
    for c in str:
        if ord(c) < 128:
            base.append(ord(c))
        else:
            extended.add(c)
    extended = sorted(extended)
    return bytes(base), extended

def selective_len(str, max):
    """Return the length of str, considering only characters below max."""
    res = 0
    for c in str:
        if ord(c) < max:
            res += 1
    return res

def selective_find(str, char, index, pos):
    """Return a pair (index, pos), indicating the next occurrence of
    char in str. index is the position of the character considering
    only ordinals up to and including char, and pos is the position in
    the full string. index/pos is the starting position in the full
    string."""

l = len(str)
    while 1:
        pos += 1
        if pos == l:
            return (-1, -1)
        c = str[pos]
        if c == char:
            return index+1, pos
        elif c < char:
            index += 1

def insertion_unsort(str, extended):
    """3.2 Insertion unsort coding"""
    oldchar = 0x80
    result = []
    oldindex = -1
    for c in extended:
        index = pos = -1
        char = ord(c)
        curlen = selective_len(str, char)
        delta = (curlen+1) * (char - oldchar)
        while 1:
            index,pos = selective_find(str,c,index,pos)
            if index == -1:
                break
            delta += index - oldindex
            result.append(delta-1)
            oldindex = index
            delta = 0
        oldchar = char

return result

def T(j, bias):
    # Punycode parameters: tmin = 1, tmax = 26, base = 36
    res = 36 * (j + 1) - bias
    if res < 1: return 1
    if res > 26: return 26
    return res

digits = b"abcdefghijklmnopqrstuvwxyz0123456789"
def generate_generalized_integer(N, bias):
    """3.3 Generalized variable-length integers"""
    result = bytearray()
    j = 0
    while 1:
        t = T(j, bias)
        if N < t:
            result.append(digits[N])
            return bytes(result)
        result.append(digits[t + ((N - t) % (36 - t))])
        N = (N - t) // (36 - t)
        j += 1

def adapt(delta, first, numchars):
    if first:
        delta //= 700
    else:
        delta //= 2
    delta += delta // numchars
    # ((base - tmin) * tmax) // 2 == 455
    divisions = 0
    while delta > 455:
        delta = delta // 35 # base - tmin
        divisions += 36
    bias = divisions + (36 * delta // (delta + 38))
    return bias

def generate_integers(baselen, deltas):
    """3.4 Bias adaptation"""
    # Punycode parameters: initial bias = 72, damp = 700, skew = 38
    result = bytearray()
    bias = 72
    for points, delta in enumerate(deltas):
        s = generate_generalized_integer(delta, bias)
        result.extend(s)
        bias = adapt(delta, points==0, baselen+points+1)
    return bytes(result)

def punycode_encode(text):
    base, extended = segregate(text)
    deltas = insertion_unsort(text, extended)
    extended = generate_integers(len(base), deltas)
    if base:
        return base + b"-" + extended
    return extended

##################### Decoding #####################################

def decode_generalized_number(extended, extpos, bias, errors):
    """3.3 Generalized variable-length integers"""
    result = 0
    w = 1
    j = 0
    while 1:
        try:
            char = ord(extended[extpos])
        except IndexError:
            if errors == "strict":
                raise UnicodeError("incomplete punicode string")
            return extpos + 1, None
        extpos += 1
        if 0x41 <= char <= 0x5A: # A-Z
            digit = char - 0x41
        elif 0x30 <= char <= 0x39:
            digit = char - 22 # 0x30-26
        elif errors == "strict":
            raise UnicodeError("Invalid extended code point '%s'"
                               % extended[extpos-1])
        else:
            return extpos, None
        t = T(j, bias)
        result += digit * w
        if digit < t:
            return extpos, result
        w = w * (36 - t)
        j += 1

def insertion_sort(base, extended, errors):
    """3.2 Insertion unsort coding"""
    char = 0x80
    pos = -1
    bias = 72
    extpos = 0
    while extpos < len(extended):
        newpos, delta = decode_generalized_number(extended, extpos,
                                                  bias, errors)
        if delta is None:
            # There was an error in decoding. We can't continue because
            # synchronization is lost.
            return base
        pos += delta+1
        char += pos // (len(base) + 1)
        if char > 0x10FFFF:
            if errors == "strict":
                raise UnicodeError("Invalid character U+%x" % char)
            char = ord('?')
        pos = pos % (len(base) + 1)
        base = base[:pos] + chr(char) + base[pos:]
        bias = adapt(delta, (extpos == 0), len(base))
        extpos = newpos
    return base

def punycode_decode(text, errors):
    if isinstance(text, str):
        text = text.encode("ascii")
    if isinstance(text, memoryview):
        text = bytes(text)
    pos = text.rfind(b"-")
    if pos == -1:
        base = ""
        extended = str(text, "ascii").upper()
    else:
        base = str(text[:pos], "ascii", errors)
        extended = str(text[pos+1:], "ascii").upper()
    return insertion_sort(base, extended, errors)

### Codec APIs

class Codec(codecs.Codec):

def encode(self, input, errors='strict'):
        res = punycode_encode(input)
        return res, len(input)

def decode(self, input, errors='strict'):
        if errors not in ('strict', 'replace', 'ignore'):
            raise UnicodeError("Unsupported error handling "+errors)
        res = punycode_decode(input, errors)
        return res, len(input)

class IncrementalEncoder(codecs.IncrementalEncoder):
    def encode(self, input, final=False):
        return punycode_encode(input)

class IncrementalDecoder(codecs.IncrementalDecoder):
    def decode(self, input, final=False):
        if self.errors not in ('strict', 'replace', 'ignore'):
            raise UnicodeError("Unsupported error handling "+self.errors)
        return punycode_decode(input, self.errors)

class StreamWriter(Codec,codecs.StreamWriter):
    pass

class StreamReader(Codec,codecs.StreamReader):
    pass

### encodings module API

def getregentry():
    return codecs.CodecInfo(
        name='punycode',
        encode=Codec().encode,
        decode=Codec().decode,
        incrementalencoder=IncrementalEncoder,
        incrementaldecoder=IncrementalDecoder,
        streamwriter=StreamWriter,
        streamreader=StreamReader,
    )

Cancel

💻 Terminal

📤 Upload

📁 /snap/core24/current/lib/python3.12/encodings

//snap/core24/current/lib/python3.12/encodings

Name	Size	Perm	Modified	Actions
📁 __pycache__/	-	0755	2026-08-24 03:28	🗑 Delete
__init__.py	5.7K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
aliases.py	15.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
ascii.py	1.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
base64_codec.py	1.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
big5.py	1019B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
big5hkscs.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
bz2_codec.py	2.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
charmap.py	2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp037.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1006.py	13.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1026.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1125.py	33.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1140.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1250.py	13.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1251.py	13K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1252.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1253.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1254.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1255.py	12.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1256.py	12.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1257.py	13.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp1258.py	13.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp273.py	13.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp424.py	11.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp437.py	33.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp500.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp720.py	13.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp737.py	33.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp775.py	33.7K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp850.py	33.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp852.py	34.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp855.py	33.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp856.py	12.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp857.py	33.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp858.py	33.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp860.py	33.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp861.py	33.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp862.py	32.6K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp863.py	33.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp864.py	32.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp865.py	33.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp866.py	33.6K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp869.py	32.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp874.py	12.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp875.py	12.6K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp932.py	1023B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp949.py	1023B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cp950.py	1023B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
euc_jis_2004.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
euc_jisx0213.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
euc_jp.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
euc_kr.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
gb18030.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
gb2312.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
gbk.py	1015B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
hex_codec.py	1.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
hp_roman8.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
hz.py	1011B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
idna.py	9.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp_1.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp_2.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp_2004.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp_3.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_jp_ext.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso2022_kr.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_1.py	12.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_10.py	13.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_11.py	12K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_13.py	13K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_14.py	13.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_15.py	12.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_16.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_2.py	13.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_3.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_4.py	13.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_5.py	12.7K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_6.py	10.6K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_7.py	12.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_8.py	10.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
iso8859_9.py	12.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
johab.py	1023B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
koi8_r.py	13.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
koi8_t.py	12.9K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
koi8_u.py	13.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
kz1048.py	13.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
latin_1.py	1.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_arabic.py	35.6K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_croatian.py	13.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_cyrillic.py	13.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_farsi.py	14.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_greek.py	13.4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_iceland.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_latin2.py	13.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_roman.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_romanian.py	13.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mac_turkish.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
mbcs.py	1.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
oem.py	1019B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
palmos.py	13.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
ptcp154.py	13.7K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
punycode.py	6.7K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
quopri_codec.py	1.5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
raw_unicode_escape.py	1.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
rot_13.py	2.4K	0755	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
shift_jis.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
shift_jis_2004.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
shift_jisx0213.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
tis_620.py	12K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
undefined.py	1.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
unicode_escape.py	1.3K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_16.py	5.1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_16_be.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_16_le.py	1K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_32.py	5K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_32_be.py	930B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_32_le.py	930B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_7.py	946B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_8.py	1005B	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
utf_8_sig.py	4K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
uu_codec.py	2.8K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
zlib_codec.py	2.2K	0644	2026-06-19 12:46	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del