"getpass" --- 可攜式密碼輸入工具
********************************

**原始碼：**Lib/getpass.py

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

可用性: not WASI.

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

"getpass" 模組 (module) 提供了兩個函式：

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*. Common terminal
     control characters are supported:

     * "Ctrl"+"A" - Move cursor to beginning of line

     * "Ctrl"+"E" - Move cursor to end of line

     * "Ctrl"+"K" - Kill (delete) from cursor to end of line

     * "Ctrl"+"U" - Kill (delete) entire line

     * "Ctrl"+"W" - Erase previous word

     * "Ctrl"+"V" - Insert next character literally (quote)

     * "Backspace"/"DEL" - Delete character before cursor

     These shortcuts work by reading the terminal's configured control
     character mappings from termios settings.

   在 3.14 版的變更: Added the *echo_char* parameter for keyboard
   feedback.

   在 3.15 版的變更: When using non-empty *echo_char* on Unix,
   keyboard shortcuts (including cursor movement and line editing) are
   now properly handled using the terminal's control character
   configuration.

exception getpass.GetPassWarning

   當密碼輸入可能被回音時會發出的 "UserWarning" 子類別。

getpass.getuser()

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

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

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

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