uu — Кодировать и декодировать файлы uuencode

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

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

Код был внесен Лэнсом Эллингхаузом (Lance Ellinghouse) и модифицирован Джеком Янсеном (Jack Jansen).

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

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

Uuencode file in_file to file out_file. Uuencoded файл будет иметь заголовок, определяющий name и mode по умолчанию для результатов декодирования файла. Значения по умолчанию берутся из in_file или '-' и 0o666 соответственно. Если backtick имеет значение true, нули представляются '`', а не пробелами.

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

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

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

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

exception uu.Error

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

См.также

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