"netrc" --- procesado del fichero netrc
***************************************

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

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

La clase "netrc" analiza y encapsula el formato del fichero netrc,
usado por el programa Unix **ftp** y otros clientes FTP.

class netrc.netrc([file])

   Una instancia de "netrc" o una instancia de una subclase encapsula
   la información del fichero netrc. El argumento de inicialización,
   si está presente, especifica el fichero a analizar. Si no se pasan
   argumentos, se leerá el fichero ".netrc" del directorio home del
   usuario -- determinado por "os.path.expanduser()". De lo contrario,
   se lanzará una excepción "FileNotFoundError". Los errores de
   análisis lanzarán una excepción "NetrcParseError" con información
   de diagnóstico que incluye nombre del fichero, número de línea y
   token de finalización. Si no se especifica ningún argumento en un
   sistema POSIX, la presencia de contraseñas en el fichero ".netrc"
   lanzará una excepción "NetrcParseError" si la propiedad del fichero
   o los permisos son inseguros (el propietario del fichero es
   distinto del usuario que ejecuta el proceso, o puede ser leído o
   escrito por cualquier otro usuario). Esto implementa un nivel de
   seguridad equivalente al de ftp y otros programas que usan
   ".netrc".

   Distinto en la versión 3.4: Añadida la comprobación de permisos
   POSIX.

   Distinto en la versión 3.7: "os.path.expanduser()" se usa para
   encontrar la localización del fichero ".netrc" cuando *file* no se
   pasa como argumento.

   Distinto en la versión 3.10: "netrc" prueba la codificación UTF-8
   antes de usar la codificación específica de la configuración
   regional.

exception netrc.NetrcParseError

   Excepción lanzada por la clase "netrc" cuando se encuentran errores
   sintácticos en el texto origen. Las instancias de esta excepción
   ofrecen tres atributos interesantes:  "msg" es una explicación
   textual del error, "filename" es el nombre del fichero origen, y
   "lineno" indica el número de línea en el que se encontró el error.


Objetos netrc
=============

Una instancia "netrc" tiene los siguientes métodos:

netrc.authenticators(host)

   Retorna una 3-tupla "(login, account, password)" para autenticarse
   contra *host*. Si el fichero netrc no contiene una entrada para el
   host dado, retorna una tupla asociada con la entrada por defecto.
   Si no están disponibles ni el host correspondiente ni la entrada
   por defecto, retorna "None".

netrc.__repr__()

   Vuelca los datos de la clase como una cadena de caracteres en el
   formato de un fichero netrc. (Esto descarta comentarios y puede
   reordenar las entradas.)

Las instancias de "netrc" tienen variables de instancia públicas:

netrc.hosts

   Diccionario que asocia nombres de hosts a tuplas "(login, account,
   password)". La entrada por defecto, si existe, está representada
   como un pseudo-host por ese nombre.

netrc.macros

   Diccionario que asocia nombres de macros a listas de cadenas de
   caracteres.

Nota:

  Las contraseñas están limitadas a un subconjunto del conjunto de
  caracteres ASCII. En las contraseñas se permiten todos los símbolos
  de puntuación ASCII. Sin embargo, no se permiten espacios en blanco
  ni caracteres no imprimibles. Esto es una limitación de la manera en
  que se analiza el fichero .netrc y puede que se elimine en el
  futuro.
