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.