File: libgetpass.tex

package info (click to toggle)
python2.5-doc 2.5-4
  • links: PTS
  • area: contrib
  • in suites: etch, etch-m68k
  • size: 7,816 kB
  • ctags: 2,720
  • sloc: python: 5,817; perl: 3,674; sh: 2,110; makefile: 1,355; xml: 836; lisp: 836; ansic: 719; sed: 2
file content (36 lines) | stat: -rw-r--r-- 1,350 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
\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.
  \versionchanged[The \var{stream} parameter was added]{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}