uu — Кодирует и декодирует uuencode файлы

Модуль кодирует и декодирует файлы в формате 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 истинно, нули представлены '`' вместо пробелов.

Изменено в версии 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.

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

exception uu.Error

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

См.также

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