summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorBarry Warsaw <barry@python.org>2018-01-24 17:51:29 (GMT)
committerGitHub <noreply@github.com>2018-01-24 17:51:29 (GMT)
commitd499031f5f33c3ef71be7c81ef52eee6b47c42e1 (patch)
tree7998708eb21596ed635b2427b862b9c226d279a9 /Doc
parent22feeb88b473b288950cdb2f6c5d28692274b5f9 (diff)
downloadcpython-d499031f5f33c3ef71be7c81ef52eee6b47c42e1.zip
cpython-d499031f5f33c3ef71be7c81ef52eee6b47c42e1.tar.gz
cpython-d499031f5f33c3ef71be7c81ef52eee6b47c42e1.tar.bz2
bpo-32651 Recommend getpass.getuser() (#5301)
* bpo-32651 - In the documentation for os.getlogin(), recommend getpass.getuser()
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/getpass.rst10
-rw-r--r--Doc/library/os.rst9
2 files changed, 11 insertions, 8 deletions
diff --git a/Doc/library/getpass.rst b/Doc/library/getpass.rst
index 5eb9f04..82b1191 100644
--- a/Doc/library/getpass.rst
+++ b/Doc/library/getpass.rst
@@ -42,8 +42,10 @@ The :mod:`getpass` module provides two functions:
Return the "login name" of the user.
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 :mod:`pwd` module, otherwise, an exception is raised.
+ :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 :mod:`pwd` module, otherwise, an exception is
+ raised.
+ In general, this function should be preferred over :func:`os.getlogin()`.
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index ee08853..9cb34de 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -325,10 +325,11 @@ process and user.
.. function:: getlogin()
Return the name of the user logged in on the controlling terminal of the
- process. For most purposes, it is more useful to use the environment
- variables :envvar:`LOGNAME` or :envvar:`USERNAME` to find out who the user
- is, or ``pwd.getpwuid(os.getuid())[0]`` to get the login name of the current
- real user id.
+ process. For most purposes, it is more useful to use
+ :func:`getpass.getuser` since the latter checks the environment variables
+ :envvar:`LOGNAME` or :envvar:`USERNAME` to find out who the user is, and
+ falls back to ``pwd.getpwuid(os.getuid())[0]`` to get the login name of the
+ current real user id.
Availability: Unix, Windows.