getpass --- Nhập mật khẩu di động

Source code: Lib/getpass.py


sẵn có: not WASI.

Mô-đun này không hoạt động hoặc không có trên WebAssembly. Xem Nền tảng WebAssugging để biết thêm thông tin.

Mô-đun getpass cung cấp hai chức năng:

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

Nhắc người dùng nhập mật khẩu mà không lặp lại. Người dùng được nhắc sử dụng chuỗi prompt, mặc định là 'Password: '. Trên Unix, lời nhắc được ghi vào đối tượng giống như tệp stream bằng cách sử dụng trình xử lý lỗi thay thế nếu cần. stream mặc định là thiết bị đầu cuối điều khiển (/dev/tty) hoặc nếu điều đó không khả dụng đối với sys.stderr (đối số này bị bỏ qua trên Windows).

Đối số echo_char kiểm soát cách hiển thị thông tin nhập của người dùng khi nhập. Nếu echo_charNone (mặc định), đầu vào vẫn bị ẩn. Nếu không, echo_char phải là một ký tự ASCII có thể in được và mỗi ký tự gõ vào sẽ được thay thế bằng ký tự đó. Ví dụ: echo_char='*' sẽ hiển thị dấu hoa thị thay vì đầu vào thực tế.

Nếu đầu vào không có tiếng vang không khả dụng, getpass() sẽ quay lại in thông báo cảnh báo tới stream và đọc từ sys.stdin rồi đưa ra GetPassWarning.

Ghi chú

Nếu bạn gọi getpass từ bên trong IDLE, việc nhập liệu có thể được thực hiện trong thiết bị đầu cuối mà bạn đã khởi chạy IDLE thay vì chính cửa sổ nhàn rỗi.

Ghi chú

Trên hệ thống Unix, khi echo_char được đặt, thiết bị đầu cuối sẽ được cấu hình để hoạt động trong noncanonical mode. Đặc biệt, điều này có nghĩa là các phím tắt chỉnh sửa dòng như Ctrl+U sẽ không hoạt động và có thể chèn các ký tự không mong muốn vào đầu vào.

Thay đổi trong phiên bản 3.14: Đã thêm tham số echo_char cho phản hồi bàn phím.

exception getpass.GetPassWarning

Một lớp con UserWarning được cấp khi việc nhập mật khẩu có thể bị lặp lại.

getpass.getuser()

Trả về "tên đăng nhập" của người dùng.

Hàm này kiểm tra các biến môi trường LOGNAME, USER, LNAMEUSERNAME theo thứ tự và trả về giá trị của biến đầu tiên được đặt thành một chuỗi không trống. Nếu không được đặt, tên đăng nhập từ cơ sở dữ liệu mật khẩu sẽ được trả về trên các hệ thống hỗ trợ mô-đun pwd, nếu không, OSError sẽ được nâng lên.

Nói chung, chức năng này nên được ưu tiên hơn os.getlogin().

Thay đổi trong phiên bản 3.13: Trước đây, nhiều trường hợp ngoại lệ khác ngoài OSError đã được nêu ra.