uu — Codifica y decodifica archivos UUEncode

Código fuente: Lib/uu.py

Este módulo codifica y decodifica archivos en formato UUEncode, permitiendo la transmisión de datos binarios arbitrarios sobre conexiones de solo ASCII. Allí donde se espera un archivo como argumento, los métodos aceptan un objeto similar a un archivo. Por compatibilidad con versiones anteriores, una cadena que contenga un nombre de ruta también es aceptada, y el archivo correspondiente será abierto para lectura y escritura; el nombre de ruta '-' es entendido como la entrada o salida estándar. Sin embargo, esta interface es obsoleta; es mejor que el invocador abra el archivo por sí mismo y asegurarse de que, cuando se requiera, el modo sea 'rb' o 'wb' en Windows.

Este código fue contribuido por Lance Ellinghouse y modificado por Jack Jansen.

El módulo uu define las siguientes funciones:

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

Codificar con UUEncode el archivo in_file en el archivo out_file. El archivo codificado con UUEncode tendrá un encabezado especificando name y mode como valores por defecto para los resultados de la decodificación del archivo. Los valores por defecto iniciales son tomados de in_file, o '-' y 0o666 respectivamente. Si backtick es verdadero, los ceros son representados por '`' en lugar de espacios.

Distinto en la versión 3.7: Agregado el parámetro backtick.

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

Esta invocación decodifica el archivo codificado en UUEncode in_file y coloca el resultado en el archivo out_file. Si out_file es un nombre de ruta, mode es usado para establecer los bits de permiso si el archivo debe ser creado. Valores por defecto para out_file y mode se toman del encabezado UUEncode. Sin embargo, si el archivo especificado en el encabezado existe, se genera un uu.Error.

decode() puede imprimir una advertencia a error estándar si la entrada fue producida por un UUEncoder incorrecto y Python pudo recobrarse de ese error. Si se establece quiet a un valor verdadero se suprime esta advertencia.

exception uu.Error

Subclase de Exception, esta puede ser generada por uu.decode() en diversas situaciones, como las descriptas arriba, pero también si se incluye un encabezado mal formado o un archivo de entrada truncado.

Ver también

Módulo binascii

Módulo de soporte que contiene conversiones de ASCII a binario y de binario a ASCII.