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

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

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

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

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

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

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

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

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() может вывести предупреждение в стандартный поток ошибок, если вход был сгенерирован некорректным uuencoder'ом, и Python смог исправить эту ошибку. Установка значения quiet в true позволит избежать этого предупреждения.

exception uu.Error

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