This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# `getpass` — Entrada de contraseña portátil

Código fuente: Lib/getpass.py

El módulo `getpass` proporciona dos funciones:

`getpass.``getpass`(prompt='Password: ', stream=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).

  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í.

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.

  Esta función verifica las variables de entorno `LOGNAME`, `USER`, `LNAME` and `USERNAME`, en orden, y retorna el valor del primero que se establece en un cadena no vacía. Si no se establece ninguno, el nombre de inicio de sesión de la base de datos de contraseñas se retorna en los sistemas que admiten el módulo `pwd`; de lo contrario, se lanza una excepción.

  En general, esta función debería preferirse respecto a `os.getlogin()`.