mirror of
https://github.com/python/cpython.git
synced 2024-12-01 11:15:56 +01:00
c37b65ee10
parameters (like \UNIX) are commonly entered using an empty group to separate the markup from a following inter-word space; this is not needed when the next character is punctuation, or the markup is the last thing in the enclosing group. These cases were marked inconsistently; the empty group is now *only* used when needed.
33 lines
1.1 KiB
TeX
33 lines
1.1 KiB
TeX
\section{\module{getpass}
|
|
--- Portable password input}
|
|
|
|
\declaremodule{standard}{getpass}
|
|
\modulesynopsis{Portable reading of passwords and retrieval of the userid.}
|
|
\moduleauthor{Piers Lauder}{piers@cs.su.oz.au}
|
|
% Windows (& Mac?) support by Guido van Rossum.
|
|
\sectionauthor{Fred L. Drake, Jr.}{fdrake@acm.org}
|
|
|
|
|
|
The \module{getpass} module provides two functions:
|
|
|
|
|
|
\begin{funcdesc}{getpass}{\optional{prompt}}
|
|
Prompt the user for a password without echoing. The user is
|
|
prompted using the string \var{prompt}, which defaults to
|
|
\code{'Password: '}.
|
|
Availability: Macintosh, \UNIX, Windows.
|
|
\end{funcdesc}
|
|
|
|
|
|
\begin{funcdesc}{getuser}{}
|
|
Return the ``login name'' of the user.
|
|
Availability: \UNIX, Windows.
|
|
|
|
This function checks the environment variables \envvar{LOGNAME},
|
|
\envvar{USER}, \envvar{LNAME} and \envvar{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 \refmodule{pwd} module,
|
|
otherwise, an exception is raised.
|
|
\end{funcdesc}
|