base64 — Кодировки данных Base16, Base32, Base64, Base85

Исходный код: Lib/base64.py

Этот модуль предоставляет функции для кодирования двоичных данных в печатные символы ASCII и декодирования таких кодировок обратно в двоичные данные. Он предоставляет функции кодирования и декодирования для кодировок, определённых в RFC 3548, который определяет алгоритмы Base16, Base32 и Base64, а также для фактически стандартных кодировок Ascii85 и Base85.

Кодировки RFC 3548 подходят для кодирования двоичных данных, чтобы их можно было безопасно отправлять по электронной почте, использовать в качестве частей URL-адресов или включать в часть запроса HTTP POST. Алгоритм кодирования отличается от программы uuencode.

Этот модуль предоставляет два интерфейса. Современный интерфейс поддерживает кодирование объектов, подобных байтам в ASCII bytes и декодирование объектов, подобных байтам или строк, содержащих ASCII, в bytes. Поддерживаются оба алфавита Base-64, определённые в RFC 3548 (обычный, и безопасный для URL и файловой системы).

Устаревший интерфейс не поддерживает декодирование из строк, но предоставляет функции кодирования и декодирования в и из объектов файлов. Он поддерживает только стандартный алфавит Base64 и добавляет новые строки каждые 76 символов в соответствии с RFC 2045. Обратите внимание, что если вам нужна поддержка RFC 2045, вам, вероятно, следует обратиться к пакету email вместо этого.

Современный интерфейс предоставляет:

base64.b64encode(s, altchars=None)

Кодирует объект, подобный байтам s с помощью Base64 и возвращает закодированные bytes.

Необязательные altchars должны быть объектом, подобным байтам длиной не менее 2 (дополнительные символы игнорируются), которые задают альтернативный алфавит для символов + и /. Это позволяет приложению, например, генерировать строки Base64, безопасные для URL или файловой системы. По умолчанию используется None, для которого используется стандартный алфавит Base64.

base64.b64decode(s, altchars=None, validate=False)

Декодирует закодированную в Base64 объект, подобный байтам или ASCII-строку s и возвращает декодированные bytes.

Необязательные altchars должны быть объектом, подобным байтам или ASCII-строкой длиной не менее 2 (дополнительные символы игнорируются), который задаёт альтернативный алфавит, используемый вместо символов + и /.

Исключение binascii.Error поднимается, если s имеет неправильную длину.

Если validate равно False (по умолчанию), символы, которые не находятся ни в обычном алфавите Base-64, ни в альтернативном алфавите, отбрасываются перед проверкой заполнения. Если validate равно True, эти небуквенные символы в входных данных приведут к исключению binascii.Error.

base64.standard_b64encode(s)

Кодирует объект, подобный байтам s с использованием стандартного алфавита Base64 и возвращает закодированные bytes.

base64.standard_b64decode(s)

Декодирует объект, подобный байтам или ASCII-строку s с использованием стандартного алфавита Base64 и возвращает декодированные bytes.

base64.urlsafe_b64encode(s)

Кодирует объект, подобный байтам s с использованием алфавита, безопасного для URL и файловой системы, который заменяет - вместо + и _ вместо / в стандартном алфавите Base64 и возвращает закодированные bytes. Результат может всё ещё содержать =.

base64.urlsafe_b64decode(s)

Декодирует объект, подобный байтам или ASCII-строку s с использованием алфавита, безопасного для URL и файловой системы, который заменяет - вместо + и _ вместо / в стандартном алфавите Base64 и возвращает декодированные bytes.

base64.b32encode(s)

Кодирует объект, подобный байтам s с помощью Base32 и возвращает закодированные bytes.

base64.b32decode(s, casefold=False, map01=None)

Декодирует закодированную в Base32 объект, подобный байтам или ASCII-строку s и возвращает декодированные bytes.

Необязательный casefold — флаг, определяющий, допускается ли ввод в нижнем регистре. По соображениям безопасности по умолчанию используется False.

RFC 3548 допускает необязательное отображение цифры 0 (ноль) на букву О (о), и необязательное отображение цифры 1 (единица) на букву I (ай) или букву L (эл). Необязательный аргумент map01, если он не None, определяет, на какую букву должна быть отображена цифра 1 (если map01 не None, цифра 0 всегда отображается на букву О). По соображениям безопасности по умолчанию используется None, так что цифры 0 и 1 не допускаются во входных данных.

Исключение binascii.Error поднимается, если s имеет неправильную длину или если во входных данных присутствуют небуквенные символы.

base64.b16encode(s)

Кодирует объект, подобный байтам s с помощью Base16 и возвращает закодированные bytes.

base64.b16decode(s, casefold=False)

Декодирует закодированную в Base16 объект, подобный байтам или ASCII-строку s и возвращает декодированные bytes.

Необязательный casefold — флаг, определяющий, допускается ли ввод в нижнем регистре. По соображениям безопасности по умолчанию используется False.

Исключение binascii.Error поднимается, если s имеет неправильную длину или если во входных данных присутствуют небуквенные символы.

base64.a85encode(b, *, foldspaces=False, wrapcol=0, pad=False, adobe=False)

Кодировать объект-подобный байтам b с помощью Ascii85 и вернуть закодированный bytes.

foldspaces — необязательный флаг, использующий специальную короткую последовательность ‘y’ вместо 4 последовательных пробелов (ASCII 0x20), как поддерживается в ‘btoa’. Эта функция не поддерживается «стандартным» кодированием Ascii85.

wrapcol управляет добавлением символов новой строки (b'\n') в вывод. Если это ненулевое значение, каждая строка вывода будет иметь не более этого количества символов.

pad управляет тем, будет ли входной поток заполнен до кратного 4 перед кодированием. Обратите внимание, что реализация btoa всегда заполняет.

adobe управляет тем, будет ли закодированная последовательность байтов обрамляться <~ и ~>, что используется в реализации Adobe.

Новая функция в версии 3.4.

base64.a85decode(b, *, foldspaces=False, adobe=False, ignorechars=b' \t\n\r\v')

Декодировать закодированный в Ascii85 объект-подобный байтам или строку ASCII b и вернуть декодированный bytes.

foldspaces — флаг, указывающий, следует ли принимать короткую последовательность ‘y’ как сокращение для 4 последовательных пробелов (ASCII 0x20). Эта функция не поддерживается «стандартным» кодированием Ascii85.

adobe управляет тем, находится ли входная последовательность в формате Adobe Ascii85 (т.е. обрамлена в <~ и ~>).

ignorechars должен быть объектом-подобным байтам или строкой ASCII, содержащей символы, которые следует игнорировать из входных данных. Это должно содержать только символы пробелов, и по умолчанию содержит все символы пробелов в ASCII.

Новая функция в версии 3.4.

base64.b85encode(b, pad=False)

Кодировать объект-подобный байтам b с помощью base85 (как используется, например, в двоичных дифференциалах в стиле git) и вернуть закодированный bytes.

Если pad имеет значение true, вход заполняется b'\0' так, чтобы его длина была кратна 4 байтам перед кодированием.

Новая функция в версии 3.4.

base64.b85decode(b)

Декодировать закодированный в base85 объект-подобный байтам или строку ASCII b и вернуть декодированный bytes. Заполнение неявно удаляется, если необходимо.

Новая функция в версии 3.4.

Легальный интерфейс:

base64.decode(input, output)

Декодировать содержимое двоичного файла input и записать полученные двоичные данные в файл output. input и output должны быть объектами файла. input будет читаться до тех пор, пока input.readline() не вернет пустой объект байтов.

base64.decodebytes(s)

Декодировать объект-подобный байтам s, который должен содержать одну или несколько строк данных, закодированных в base64, и вернуть декодированный bytes.

Новая функция в версии 3.1.

base64.decodestring(s)

Устаревший псевдоним decodebytes().

Устарело начиная с версии 3.1.

base64.encode(input, output)

Кодировать содержимое двоичного файла input и записать полученные закодированные в base64 данные в файл output. input и output должны быть объектами файла. input будет читаться до тех пор, пока input.read() не вернет пустой объект байтов. encode() вставляет символ новой строки (b'\n') после каждых 76 байтов вывода, а также гарантирует, что вывод всегда заканчивается символом новой строки, в соответствии с RFC 2045 (MIME).

base64.encodebytes(s)

Кодировать объект-подобный байтам s, который может содержать произвольные двоичные данные, и вернуть bytes, содержащий закодированные в base64 данные, с символами новой строки (b'\n') после каждых 76 байтов вывода и гарантируя, что есть конечная новая строка, в соответствии с RFC 2045 (MIME).

Новая функция в версии 3.1.

base64.encodestring(s)

Устаревший псевдоним encodebytes().

Устарело начиная с версии 3.1.

Пример использования модуля:

>>> import base64
>>> encoded = base64.b64encode(b'data to be encoded')
>>> encoded
b'ZGF0YSB0byBiZSBlbmNvZGVk'
>>> data = base64.b64decode(encoded)
>>> data
b'data to be encoded'