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

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

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

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

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

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

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

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

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

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

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

exception uu.Error

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