# `getpass` --- 可攜式密碼輸入工具

原始碼：Lib/getpass.py

可用性: not WASI.

此模組在 WebAssembly 平台上不起作用或無法使用。更多資訊請參閱 WebAssembly 平台。

The `getpass` module provides two functions:

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

  提示使用者輸入一個密碼且不會有回音 (echo)。使用者會看到字串 prompt 作為提示，其預設值為 `'Password: '`。在 Unix 上，如有必要的話會使用替換錯誤處理函式 (replace error handler) 寫入到類檔案物件 (file-like object) stream中。stream 預設為主控終端機 (controlling terminal) (`/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.

  如果無回音輸入 (echo-free input) 無法使用則 getpass() 將回退為印出一條警告訊息到 stream，並從 `sys.stdin` 讀取且同時發出 `GetPassWarning`。

  備註

  如果你從 IDLE 內部呼叫 getpass，輸入可能會在你啟動 IDLE 的終端機中完成，而非在 IDLE 視窗中。

  備註

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

  回傳使用者的"登入名稱"。

  此函式會按順序檢查環境變數 `LOGNAME`、`USER`、`LNAME` 和 `USERNAME`，並回傳其中第一個被設定成非空字串的值。如果均未設定，則在支援 `pwd` 模組的系統上將會回傳來自密碼資料庫的登入名稱，否則將引發一個 `OSError` 例外。

  大部分情況下，此函式應該要比 `os.getlogin()` 優先使用。

  在 3.13 版的變更: 在過去，除了 `OSError` 外還會引發各種例外。