"uu" --- Codifica y decodifica archivos UUEncode
************************************************

**Código fuente:** Lib/uu.py

Obsoleto desde la versión 3.11, se eliminará en la versión 3.13: El
módulo "uu" fue declarado obsoleto (ver **PEP 594** por detalles).
"base64" es una alternativa moderna.

======================================================================

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.
