mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-04 03:44:55 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

Issue #12326: document the recommended idiom for checking sys.platform on Unix systems.

Browse source 
Also, point to the various alternatives.
This commit is contained in:
Antoine Pitrou 2011-07-09 15:54:23 +02:00
parent 00ebeb540f
commit a83cdaae89
2 changed files with 19 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

7
Doc/library/os.rst
View file

@ -61,6 +61,13 @@ Notes on the availability of these functions:
names have currently been registered: ``'posix'``, ``'nt'``, ``'mac'``,
``'os2'``, ``'ce'``, ``'java'``.
.. seealso::
:attr:`sys.platform` has a finer granularity. :func:`os.uname` gives
system-dependent version information.
The :mod:`platform` module provides detailed checks for the
system's identity.
.. _os-filenames:

12
Doc/library/sys.rst
View file

@ -714,6 +714,12 @@ always available.
For Unix systems, this is the lowercased OS name as returned by ``uname -s``
with the first part of the version as returned by ``uname -r`` appended,
e.g. ``'sunos5'`` or ``'linux2'``, *at the time when Python was built*.
Unless you want to test for a specific system version, it is therefore
recommended to use the following idiom::
if sys.platform.startswith('linux'):
# Linux-specific code here...
For other systems, the values are:
================ ===========================
@ -726,6 +732,12 @@ always available.
OS/2 EMX ``'os2emx'``
================ ===========================
.. seealso::
:attr:`os.name` has a coarser granularity. :func:`os.uname` gives
system-dependent version information.
The :mod:`platform` module provides detailed checks for the
system's identity.
.. data:: prefix