getpass — Portable password input

Вихідний код: Lib/getpass.py


Availability: not WASI.

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

The getpass module provides two functions:

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

Запитувати в користувача пароль без луни. Користувач отримує запит за допомогою рядка prompt, який за замовчуванням має значення 'Пароль:'. В Unix підказка записується у файлоподібний об’єкт stream за допомогою обробника помилок заміни, якщо потрібно. stream за замовчуванням використовується для керуючого терміналу (/dev/tty) або, якщо він недоступний, для sys.stderr (цей аргумент ігнорується в 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.

If echo-free input is unavailable, getpass() falls back to printing a warning message to stream and reading from sys.stdin and issuing a GetPassWarning.

Примітка

If you call getpass() from within IDLE, the input may be done in the terminal you launched IDLE from rather than the idle window itself.

Примітка

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.

Змінено в версії 3.14: Added the echo_char parameter for keyboard feedback.

exception getpass.GetPassWarning

Підклас UserWarning видається, коли введення пароля може повторюватися.

getpass.getuser()

Повернути «ім’я для входу» користувача.

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().

Змінено в версії 3.13: Previously, various exceptions beyond just OSError were raised.