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

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

Не рекомендуется, начиная с версии 3.11: Модуль uu является устаревшим (подробнее см. PEP 594). base64 является современной альтернативой.


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

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

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

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

Uuencode файл in_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)

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

Uuencode файл in_file в файл out_file. В uuencoded файле будет заголовок, указывающий name и mode в качестве значений по умолчанию для результатов декодирования файла. Значения по умолчанию берутся из in_file, или decode() и соответственно. Если backtick равен true, то нули представляются вместо пробелов.

exception uu.Error

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

См.также

Модуль binascii

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

Вернуться на верх