Skip to content

Synced docs and docstring for sysconfig.get_platform #135530

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Sep 16, 2025
Merged

Synced docs and docstring for sysconfig.get_platform #135530

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
0964298
Added missing macos return to sysconfig.get_platform()
ivanbelenky Jun 15, 2025
7ab7580
updated with exhaustive list and tests for >=11
ivanbelenky Jun 15, 2025
5db6178
removed exhaustive list for macOS
ivanbelenky Jun 16, 2025
cb393a0
removed windows configs + format change
ivanbelenky Jun 17, 2025
f159723
missing non posix example or removal
ivanbelenky Jun 20, 2025
0548360
remove Non POSIX
ivanbelenky Jun 20, 2025
d7a2364
windows
ivanbelenky Jun 20, 2025
3aa49e4
Update Doc/library/sysconfig.rst
ivanbelenky Jun 20, 2025
3805299
Update Lib/sysconfig/__init__.py
ivanbelenky Jun 20, 2025
56d56e3
sync on Doc
ivanbelenky Jun 20, 2025
a8424a8
Merge branch 'main' into add-macos-docs-get_platform
ned-deily Sep 16, 2025
fb9e7a6
include example of macOS universal2 as a platform
ned-deily Sep 16, 2025
d366d63
include example in sysconfig docstring
ned-deily Sep 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 12 additions & 8 deletions Doc/library/sysconfig.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -380,24 +380,28 @@ Other functions
exact information included depends on the OS; e.g., on Linux, the kernel
version isn't particularly important.

Examples of returned values:
Returned values:

Examples of Linux returned values:

- linux-i586
- linux-i686
- linux-alpha (?)
- solaris-2.6-sun4u

Windows will return one of:
Windows platforms:

- win32 (32-bit Windows)
- win-amd64 (64-bit Windows on AMD64, aka x86_64, Intel64, and EM64T)
- win-arm64 (64-bit Windows on ARM64, aka AArch64)
- win32 (all others - specifically, sys.platform is returned)
- win-arm32 (32-bit Windows on ARM)

Examples of macOS returned values:

macOS can return:
- macosx-10.13-x86_64
- macosx-11-universal2
- macosx-15.5-arm64

- macosx-10.6-ppc
- macosx-10.4-ppc64
- macosx-10.3-i386
- macosx-10.4-fat

For other non-POSIX platforms, currently just returns :data:`sys.platform`.

Expand Down
31 changes: 22 additions & 9 deletions Lib/sysconfig/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -638,17 +638,30 @@ def get_platform():
exact information included depends on the OS; on Linux, the kernel version
isn't particularly important.

Examples of returned values:
linux-i586
linux-alpha (?)
solaris-2.6-sun4u
Returned values:

Windows will return one of:
win-amd64 (64-bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)
win-arm64 (64-bit Windows on ARM64 (aka AArch64)
win32 (all others - specifically, sys.platform is returned)
Examples of Linux returned values:

For other non-POSIX platforms, currently just returns 'sys.platform'.
- linux-i586
- linux-i686
- linux-alpha (?)
- solaris-2.6-sun4u

Windows platforms:

- win32 (32-bit Windows)
- win-amd64 (64-bit Windows on AMD64, aka x86_64, Intel64, and EM64T)
- win-arm64 (64-bit Windows on ARM64, aka AArch64)
- win-arm32 (32-bit Windows on ARM)

Examples of macOS returned values:

- macosx-10.13-x86_64
- macosx-11-universal2
- macosx-15.5-arm64


For other non-POSIX platforms, currently just returns :data:`sys.platform`.

"""
if os.name == 'nt':
Expand Down
7 changes: 7 additions & 0 deletions Lib/test/test_sysconfig.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -352,6 +352,13 @@ def test_get_platform(self):

self.assertEqual(get_platform(), 'macosx-10.4-%s' % arch)

for macver in range(11, 16):
_osx_support._remove_original_values(get_config_vars())
get_config_vars()['CFLAGS'] = ('-fno-strict-overflow -Wsign-compare -Wunreachable-code'
'-arch arm64 -fno-common -dynamic -DNDEBUG -g -O3 -Wall')
get_config_vars()['MACOSX_DEPLOYMENT_TARGET'] = f"{macver}.0"
self.assertEqual(get_platform(), 'macosx-%d.0-arm64' % macver)

# linux debian sarge
os.name = 'posix'
sys.version = ('2.3.5 (#1, Jul 4 2007, 17:28:59) '
Expand Down
Loading