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)

Этот вызов декодирует закодированный в формате 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() в различных ситуациях, таких как описанные выше, а также при некорректном формате заголовка или усечённом входном файле.