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

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

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

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

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

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

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

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

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

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

exception uu.Error

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