"getpass" --- Portable password input
*************************************

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

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

Availability: not WASI.

This module does not work or is not available on WebAssembly. See
Plataformas WebAssembly for more information.

El módulo "getpass" proporciona dos funciones:

getpass.getpass(prompt='Password: ', stream=None, *, echo_char=None)

   Solicita al usuario una contraseña sin hacer eco. Se solicita al
   usuario mediante la cadena *prompt*, que por defecto es "'Password:
   '". En Unix, el indicador se escribe en el objeto similar a un
   archivo *stream* usando el controlador de errores de reemplazo si
   es necesario. *stream* toma por defecto el terminal de control
   ("/dev/tty") o si no está disponible para "sys.stderr" (este
   argumento se ignora en Windows).

   The *echo_char* argument controls how user input is displayed while
   typing. If *echo_char* is "None" (default), input remains hidden.
   Otherwise, *echo_char* must be a single printable ASCII character
   and each typed character is replaced by it. For example,
   "echo_char='*'" will display asterisks instead of the actual input.

   Si la entrada sin *echo* no está disponible, getpass() recurre a
   imprimir un mensaje de advertencia en *stream* y leer de
   "sys.stdin" y lanza un "GetPassWarning".

   Nota:

     Si llama a getpass desde IDLE, la entrada puede realizarse en la
     terminal desde la que inició IDLE en lugar de en la ventana
     inactiva en sí.

   Nota:

     On Unix systems, when *echo_char* is set, the terminal will be
     configured to operate in *noncanonical mode*. In particular, this
     means that line editing shortcuts such as "Ctrl"+"U" will not
     work and may insert unexpected characters into the input.

   Distinto en la versión 3.14: Added the *echo_char* parameter for
   keyboard feedback.

exception getpass.GetPassWarning

   Una subclase "UserWarning" lanzada cuando la entrada de la
   contraseña puede repetirse.

getpass.getuser()

   Retorna el "nombre de inicio de sesión" del usuario.

   This function checks the environment variables "LOGNAME", "USER",
   "LNAME" and "USERNAME", in order, and returns the value of the
   first one which is set to a non-empty string.  If none are set, the
   login name from the password database is returned on systems which
   support the "pwd" module, otherwise, an "OSError" is raised.

   In general, this function should be preferred over "os.getlogin()".

   Distinto en la versión 3.13: Previously, various exceptions beyond
   just "OSError" were raised.
