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.