uu — Кодирование и декодирование файлов uuencode

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

Утратил актуальность с версии 3.11, будет удален в версии 3.13: Модуль uu устарел (подробнее см. PEP 594). base64 - это современная альтернатива.


Этот модуль кодирует и декодирует файлы в формате uuencode, позволяя передавать произвольные двоичные данные по соединениям, поддерживающим только ASCII. Везде, где ожидается аргумент file, методы принимают объект, подобный файлу. Для обеспечения обратной совместимости также допускается строка, содержащая имя пути, и соответствующий файл будет открыт для чтения и записи; имя пути '-' понимается как стандартный ввод или вывод. Однако этот интерфейс устарел; вызывающей стороне лучше самой открыть файл и убедиться, что при необходимости в Windows установлен режим 'rb' или 'wb'.

Этот код был подготовлен Лэнсом Эллингхаусом и изменен Джеком Янсеном.

Модуль uu определяет следующие функции:

uu.encode(in_file, out_file, name=None, mode=None, *, backtick=False)

Файл Uuencode in_file преобразуется в файл out_file. Файл uuencoded будет иметь заголовок, в котором будут указаны имя и режим в качестве значений по умолчанию для результатов декодирования файла. Значения по умолчанию берутся из in_file или '-' и 0o666 соответственно. Если значение backtick равно true, нули отображаются через '`' вместо пробелов.

Изменено в версии 3.7: Добавлен параметр backtick.

uu.decode(in_file, out_file=None, mode=None, quiet=False)

Этот вызов декодирует uuencoded файл in_file, помещая результат в файл out_file. Если out_file является именем пути, mode используется для установки битов разрешений, если файл должен быть создан. Значения по умолчанию для out_file и mode взяты из заголовка uuencode. Однако, если файл, указанный в заголовке, уже существует, возникает значение uu.Error.

decode() может вывести предупреждение о стандартной ошибке, если ввод был произведен с помощью неправильного uuencoded, и Python может исправить эту ошибку. Установка значения quiet в значение true отключает это предупреждение.

exception uu.Error

Подкласс Exception, это может быть вызвано uu.decode() в различных ситуациях, таких как описанные выше, но также включающих плохо отформатированный заголовок или усеченный входной файл.

См.также

Модуль binascii

Модуль поддержки, содержащий преобразования из ASCII в двоичный код и из двоичного кода в ASCII.

Вернуться на верх