summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorPetri Lehtinen <petri@digip.org>2012-02-02 18:59:48 (GMT)
committerPetri Lehtinen <petri@digip.org>2012-02-02 18:59:50 (GMT)
commit9713321f46769f41f653a752ec348cec766e633e (patch)
tree657778bca14237ae70d61ad4e54fdc3497acb761
parent03c29f90c37870d3a0a65524373acb5008fa7a11 (diff)
downloadcpython-9713321f46769f41f653a752ec348cec766e633e.zip
cpython-9713321f46769f41f653a752ec348cec766e633e.tar.gz
cpython-9713321f46769f41f653a752ec348cec766e633e.tar.bz2
Document absoluteness of sys.executable
Closes #13402.
-rw-r--r--Doc/library/sys.rst6
-rw-r--r--Lib/test/test_sys.py3
-rw-r--r--Misc/NEWS2
-rw-r--r--Python/sysmodule.c2
4 files changed, 10 insertions, 3 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 18f916b..d611acf 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -202,8 +202,10 @@ always available.
.. data:: executable
- A string giving the name of the executable binary for the Python interpreter, on
- systems where this makes sense.
+ A string giving the absolute path of the executable binary for the Python
+ interpreter, on systems where this makes sense. If Python is unable to retrieve
+ the real path to its executable, :data:`sys.executable` will be an empty string
+ or ``None``.
.. function:: exit([arg])
diff --git a/Lib/test/test_sys.py b/Lib/test/test_sys.py
index db27cdf..5d3404f 100644
--- a/Lib/test/test_sys.py
+++ b/Lib/test/test_sys.py
@@ -532,6 +532,9 @@ class SysModuleTest(unittest.TestCase):
self.assertEqual(out, b'?')
def test_executable(self):
+ # sys.executable should be absolute
+ self.assertEqual(os.path.abspath(sys.executable), sys.executable)
+
# Issue #7774: Ensure that sys.executable is an empty string if argv[0]
# has been set to an non existent program name and Python is unable to
# retrieve the real program name
diff --git a/Misc/NEWS b/Misc/NEWS
index aa05096..0f0479c 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -454,6 +454,8 @@ Extension Modules
Documentation
-------------
+- Issue #13402: Document absoluteness of sys.executable.
+
- Issue #13883: PYTHONCASEOK also used on OS X and OS/2.
- Issue #12949: Document the kwonlyargcount argument for the PyCode_New
diff --git a/Python/sysmodule.c b/Python/sysmodule.c
index 73dc0dd..8a659c5 100644
--- a/Python/sysmodule.c
+++ b/Python/sysmodule.c
@@ -1263,7 +1263,7 @@ version_info -- version information as a named tuple\n\
hexversion -- version information encoded as a single integer\n\
copyright -- copyright notice pertaining to this interpreter\n\
platform -- platform identifier\n\
-executable -- pathname of this Python interpreter\n\
+executable -- absolute path of the executable binary of the Python interpreter\n\
prefix -- prefix used to find the Python library\n\
exec_prefix -- prefix used to find the machine-specific Python library\n\
float_repr_style -- string indicating the style of repr() output for floats\n\