Decode Kit

我永遠記不起來這些編碼解碼要怎麼用每次設編碼器的名稱和對應函起來了。每個函式都顧名思義非常直觀，Codec 類別則是統一調用。

decode_kit

CLASS	DESCRIPTION
Codec	字符編碼/解碼系統，支持自定義編碼器與解碼器。
CodecError	編碼錯誤的例外類別

FUNCTION	DESCRIPTION
encode_to_base64	文字轉Base64
decode_from_base64	Base64解碼
encode_to_hex	文字轉十六進位
decode_from_hex	十六進位解碼
encode_to_percent	文字轉百分比編碼
decode_from_percent	百分比解碼
encode_to_unicode_escape	文字轉Unicode
decode_from_unicode_escape	Unicode解碼
encode_dict	字典值轉Unicode
decode_dict	字典值Unicode解碼

Codec

字符編碼/解碼系統，支持自定義編碼器與解碼器。

Supported Encoding Methods

• base64
• percent
• hex
• unicode
• dict

Class Variables

• ENCODERS (dict): 預設編碼器的名稱和對應函數
• DECODERS (dict): 預設解碼器的名稱和對應函數
• CODEC (str): 預設字符編碼格式，預設為 'utf-8'

Class Methods

• encode(data, codec, char_sets=CODEC): 將資料編碼為指定格式
• decode(data, codec, char_sets=CODEC): 將資料解碼為原始格式
• register(name, encoder, decoder): 註冊新的編碼器與解碼器

Usage

# 使用Base64進行編碼與解碼
text = 'Hello, World!'
encoded = Codec.encode(text, 'base64')
print(encoded)  # 編碼後的Base64字串
decoded = Codec.decode(encoded, 'base64')
print(decoded)  # 還原後的原始字串


# 註冊自定義編碼器與解碼器
def custom_encode(data: str) -> str:
    return data[::-1]  # 字符串反轉


def custom_decode(data: str) -> str:
    return data[::-1]  # 字符串反轉


Codec.register('reverse', custom_encode, custom_decode)

# 使用自定義的反轉編碼器
custom_encoded = Codec.encode('Hello', 'reverse')
print(custom_encoded)  # "olleH"
custom_decoded = Codec.decode(custom_encoded, 'reverse')
print(custom_decoded)  # "Hello"

METHOD	DESCRIPTION
encode	資料編碼
decode	資料解碼
register	註冊編碼/解碼

encode

encode(data: str | dict, codec: str, char_sets: str = CODEC) -> str | dict

資料編碼

decode

decode(data: str | dict, codec: str, char_sets: str = CODEC) -> str | dict

資料解碼

register

register(name: str, encoder: Callable, decoder: Callable) -> None

註冊編碼/解碼

CodecError

編碼錯誤的例外類別

encode_to_base64

encode_to_base64(text: str, char_sets: str = DEFAULT_CODEC) -> str

文字轉Base64

decode_from_base64

decode_from_base64(base64_text: str, char_sets: str = DEFAULT_CODEC) -> str

Base64解碼

encode_to_hex

encode_to_hex(text: str, char_sets: str = DEFAULT_CODEC) -> str

文字轉十六進位

decode_from_hex

decode_from_hex(hex_text: str, char_sets: str = DEFAULT_CODEC) -> str

十六進位解碼

encode_to_percent

encode_to_percent(text: str) -> str

文字轉百分比編碼

decode_from_percent

decode_from_percent(text: str) -> str

百分比解碼

encode_to_unicode_escape

encode_to_unicode_escape(text: str, char_sets: str = DEFAULT_CODEC) -> str

文字轉Unicode

decode_from_unicode_escape

decode_from_unicode_escape(escape_text: str, char_sets: str = DEFAULT_CODEC) -> str

Unicode解碼

encode_dict

encode_dict(data: dict[str, Any], char_sets: str = DEFAULT_CODEC) -> dict[str, Any]

字典值轉Unicode

decode_dict

decode_dict(data: dict[str, Any], char_sets: str = DEFAULT_CODEC) -> dict[str, Any]

字典值Unicode解碼