Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 1 | """Utilities to get a password and/or the current user name. |
| 2 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 3 | getpass(prompt[, stream]) - Prompt for a password, with echo turned off. |
| 4 | getuser() - Get the user name from the environment or password database. |
| 5 | |
| 6 | GetPassWarning - This UserWarning is issued when getpass() cannot prevent |
| 7 | echoing of the password contents while reading. |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 8 | |
Jeremy Hylton | 88d2330 | 1999-10-18 22:25:22 +0000 | [diff] [blame] | 9 | On Windows, the msvcrt module will be used. |
| 10 | On the Mac EasyDialogs.AskPassword is used, if available. |
| 11 | |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 12 | """ |
| 13 | |
Guido van Rossum | 98d9fd3 | 2000-02-28 15:12:25 +0000 | [diff] [blame] | 14 | # Authors: Piers Lauder (original) |
| 15 | # Guido van Rossum (Windows support and cleanup) |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 16 | # Gregory P. Smith (tty support & GetPassWarning) |
Guido van Rossum | 98d9fd3 | 2000-02-28 15:12:25 +0000 | [diff] [blame] | 17 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 18 | import os, sys, warnings |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 19 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 20 | __all__ = ["getpass","getuser","GetPassWarning"] |
| 21 | |
| 22 | |
| 23 | class GetPassWarning(UserWarning): pass |
| 24 | |
Skip Montanaro | eccd02a | 2001-01-20 23:34:12 +0000 | [diff] [blame] | 25 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 26 | def unix_getpass(prompt='Password: ', stream=None): |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 27 | """Prompt for a password, with echo turned off. |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 28 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 29 | Args: |
| 30 | prompt: Written on stream to ask for the input. Default: 'Password: ' |
| 31 | stream: A writable file object to display the prompt. Defaults to |
| 32 | the tty. If no tty is available defaults to sys.stderr. |
| 33 | Returns: |
| 34 | The seKr3t input. |
| 35 | Raises: |
| 36 | EOFError: If our input tty or stdin was closed. |
| 37 | GetPassWarning: When we were unable to turn echo off on the input. |
| 38 | |
| 39 | Always restores terminal settings before returning. |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 40 | """ |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 41 | fd = None |
| 42 | tty = None |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 43 | try: |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 44 | # Always try reading and writing directly on the tty first. |
| 45 | fd = os.open('/dev/tty', os.O_RDWR|os.O_NOCTTY) |
| 46 | tty = os.fdopen(fd, 'w+', 1) |
| 47 | input = tty |
| 48 | if not stream: |
| 49 | stream = tty |
| 50 | except EnvironmentError as e: |
| 51 | # If that fails, see if stdin can be controlled. |
| 52 | try: |
| 53 | fd = sys.stdin.fileno() |
| 54 | except: |
| 55 | passwd = fallback_getpass(prompt, stream) |
| 56 | input = sys.stdin |
| 57 | if not stream: |
| 58 | stream = sys.stderr |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 59 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 60 | if fd is not None: |
| 61 | passwd = None |
| 62 | try: |
| 63 | old = termios.tcgetattr(fd) # a copy to save |
| 64 | new = old[:] |
| 65 | new[3] &= ~termios.ECHO # 3 == 'lflags' |
| 66 | try: |
| 67 | termios.tcsetattr(fd, termios.TCSADRAIN, new) |
| 68 | passwd = _raw_input(prompt, stream, input=input) |
| 69 | finally: |
| 70 | termios.tcsetattr(fd, termios.TCSADRAIN, old) |
| 71 | except termios.error as e: |
| 72 | if passwd is not None: |
| 73 | # _raw_input succeeded. The final tcsetattr failed. Reraise |
| 74 | # instead of leaving the terminal in an unknown state. |
| 75 | raise |
| 76 | # We can't control the tty or stdin. Give up and use normal IO. |
| 77 | # fallback_getpass() raises an appropriate warning. |
| 78 | del input, tty # clean up unused file objects before blocking |
| 79 | passwd = fallback_getpass(prompt, stream) |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 80 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 81 | stream.write('\n') |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 82 | return passwd |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 83 | |
| 84 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 85 | def win_getpass(prompt='Password: ', stream=None): |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 86 | """Prompt for password with echo off, using Windows getch().""" |
Guido van Rossum | 60250e2 | 2001-08-30 15:07:44 +0000 | [diff] [blame] | 87 | if sys.stdin is not sys.__stdin__: |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 88 | return fallback_getpass(prompt, stream) |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 89 | import msvcrt |
| 90 | for c in prompt: |
Christian Heimes | 0ec88b3 | 2007-12-10 17:02:00 +0000 | [diff] [blame] | 91 | msvcrt.putwch(c) |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 92 | pw = "" |
| 93 | while 1: |
Christian Heimes | 0ec88b3 | 2007-12-10 17:02:00 +0000 | [diff] [blame] | 94 | c = msvcrt.getwch() |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 95 | if c == '\r' or c == '\n': |
| 96 | break |
| 97 | if c == '\003': |
| 98 | raise KeyboardInterrupt |
| 99 | if c == '\b': |
| 100 | pw = pw[:-1] |
| 101 | else: |
| 102 | pw = pw + c |
Christian Heimes | 0ec88b3 | 2007-12-10 17:02:00 +0000 | [diff] [blame] | 103 | msvcrt.putwch('\r') |
| 104 | msvcrt.putwch('\n') |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 105 | return pw |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 106 | |
| 107 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 108 | def fallback_getpass(prompt='Password: ', stream=None): |
| 109 | warnings.warn("Can not control echo on the terminal.", GetPassWarning, |
| 110 | stacklevel=2) |
| 111 | if not stream: |
| 112 | stream = sys.stderr |
| 113 | print("Warning: Password input may be echoed.", file=stream) |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 114 | return _raw_input(prompt, stream) |
Guido van Rossum | 1a7bab0 | 1998-07-28 19:28:43 +0000 | [diff] [blame] | 115 | |
| 116 | |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 117 | def _raw_input(prompt="", stream=None, input=None): |
Neal Norwitz | ce96f69 | 2006-03-17 06:49:51 +0000 | [diff] [blame] | 118 | # This doesn't save the string in the GNU readline history. |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 119 | if not stream: |
| 120 | stream = sys.stderr |
| 121 | if not input: |
| 122 | input = sys.stdin |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 123 | prompt = str(prompt) |
| 124 | if prompt: |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 125 | stream.write(prompt) |
Guido van Rossum | cfb8333 | 2008-01-01 16:30:47 +0000 | [diff] [blame] | 126 | stream.flush() |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 127 | line = input.readline() |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 128 | if not line: |
| 129 | raise EOFError |
| 130 | if line[-1] == '\n': |
| 131 | line = line[:-1] |
| 132 | return line |
Guido van Rossum | fb9b7fd | 1998-04-13 20:22:21 +0000 | [diff] [blame] | 133 | |
| 134 | |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 135 | def getuser(): |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 136 | """Get the username from the environment or password database. |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 137 | |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 138 | First try various environment variables, then the password |
| 139 | database. This works on Windows as long as USERNAME is set. |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 140 | |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 141 | """ |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 142 | |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 143 | import os |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 144 | |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 145 | for name in ('LOGNAME', 'USER', 'LNAME', 'USERNAME'): |
| 146 | user = os.environ.get(name) |
| 147 | if user: |
| 148 | return user |
Guido van Rossum | b5903ac | 1998-04-09 20:37:16 +0000 | [diff] [blame] | 149 | |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 150 | # If this fails, the exception will "explain" why |
| 151 | import pwd |
| 152 | return pwd.getpwuid(os.getuid())[0] |
Jeremy Hylton | 88d2330 | 1999-10-18 22:25:22 +0000 | [diff] [blame] | 153 | |
| 154 | # Bind the name getpass to the appropriate function |
| 155 | try: |
Fred Drake | 1191d01 | 2001-02-27 21:23:31 +0000 | [diff] [blame] | 156 | import termios |
Neal Norwitz | 201626e | 2002-11-20 23:15:54 +0000 | [diff] [blame] | 157 | # it's possible there is an incompatible termios from the |
| 158 | # McMillan Installer, make sure we have a UNIX-compatible termios |
| 159 | termios.tcgetattr, termios.tcsetattr |
| 160 | except (ImportError, AttributeError): |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 161 | try: |
| 162 | import msvcrt |
| 163 | except ImportError: |
| 164 | try: |
| 165 | from EasyDialogs import AskPassword |
| 166 | except ImportError: |
Christian Heimes | 81ee3ef | 2008-05-04 22:42:01 +0000 | [diff] [blame] | 167 | getpass = fallback_getpass |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 168 | else: |
| 169 | getpass = AskPassword |
| 170 | else: |
| 171 | getpass = win_getpass |
Jeremy Hylton | 88d2330 | 1999-10-18 22:25:22 +0000 | [diff] [blame] | 172 | else: |
Tim Peters | 07e99cb | 2001-01-14 23:47:14 +0000 | [diff] [blame] | 173 | getpass = unix_getpass |