cpython/Doc/lib/libgetpass.tex
Thomas Wouters 49fd7fa443 Merge p3yk branch with the trunk up to revision 45595. This breaks a fair
number of tests, all because of the codecs/_multibytecodecs issue described
here (it's not a Py3K issue, just something Py3K discovers):
http://mail.python.org/pipermail/python-dev/2006-April/064051.html

Hye-Shik Chang promised to look for a fix, so no need to fix it here. The
tests that are expected to break are:

test_codecencodings_cn
test_codecencodings_hk
test_codecencodings_jp
test_codecencodings_kr
test_codecencodings_tw
test_codecs
test_multibytecodec

This merge fixes an actual test failure (test_weakref) in this branch,
though, so I believe merging is the right thing to do anyway.
2006-04-21 10:40:58 +00:00

36 lines
1.3 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\optional{, stream}}}
Prompt the user for a password without echoing. The user is
prompted using the string \var{prompt}, which defaults to
\code{'Password: '}. On \UNIX, the prompt is written to the
file-like object \var{stream}, which defaults to
\code{sys.stdout} (this argument is ignored on Windows).
Availability: Macintosh, \UNIX, Windows.
\versionadded[The \var{stream} parameter]{2.5}
\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}