Модуль uu в Python, кодировка uuencode

Кодирует и декодирует файлы в формате uuencode

Модуль uu кодирует и декодирует файлы в формате uuencode, позволяя передавать произвольные двоичные данные по соединениям только ASCII. Везде, где ожидается аргумент файла, методы принимают файлоподобный объект.

Для обратной совместимости также принимается строка, содержащая путь, и соответствующий файл будет открыт для чтения и записи.

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

ВНИМАНИЕ! Модуль uu будет удален из стандартной библиотеки с версии Python 3.11.

Причина удаления: Модуль uu предоставляет формат uuencode, который представляет собой старый двоичный формат кодирования электронной почты с 1980 года. Формат uu был заменен на MIME. Кодек uu также предоставляется модулем стандартной библиотеки Python binascii.

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

• uu.encode() кодирует файл,
• uu.decode() декодирует файл,
• Исключение:
  • uu.Error вызывается функцией uu.decode(),

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

Функция uu.encode() кодирует файл in_file в выходной файл out_file с кодировкой uuencoded.

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

Если аргумент backtick=True, то нули вместо пробелов будут представлены символом '`'.

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

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

Функция uu.decode() декодирует файл in_file в формате uuencoded, помещая результат в файл out_file.

Если out_file - это путь, то при создании файла, режим mode используется для установки битов разрешений.

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

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

uu.Error:

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