Skip to content

Conversation

@konstin
Copy link
Contributor

@konstin konstin commented Nov 21, 2025

Following https://discuss.python.org/t/document-that-macos-platform-tags-use-minor-version-0-for-macos-11/104616:

  • Document that for macOS 11 and later, the platform tag is macosx_{x}_0_{arch}
  • Document that platform tags may change over time

Fixes #1933


📚 Documentation preview 📚: https://python-packaging-user-guide--1958.org.readthedocs.build/en/1958/

@konstin konstin changed the title xDocument macosx_0_{y}_{arch} pattern Document macosx_0_{y}_{arch} pattern for macOS 11+ Nov 21, 2025
Comment on lines +85 to +88
.. important::
Platform tags are dependent on the versioning of the operating system or
platform they represent and may change over time as the underlying platform
changes its versioning.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically, some parts are bound by PEPs while others were defined by packaging, while again others are defined here at all (e.g., BSDs), but platforms authors are not bound by PEPs and may make changes counter to PEP assumptions. The new macOS versioning is an example of where Apple made a change counter to packaging spec assumptions, and packaging had to adapt.

Copy link
Member

@webknjaz webknjaz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good but I'd like to have another approving review since I'm not a macOS user.

@webknjaz webknjaz requested review from di and notatallshaw November 21, 2025 13:32
Copy link
Member

@di di left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

@rgommers rgommers left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This all looks good and correct to me, thanks @konstin.

@ned-deily
Copy link

Shouldn't the title be:

Document macosx_{y}_0_{arch} pattern for macOS 11+

@di di changed the title Document macosx_0_{y}_{arch} pattern for macOS 11+ Document macosx_10_{y}_{arch} pattern for macOS 11+ Nov 21, 2025
@di di changed the title Document macosx_10_{y}_{arch} pattern for macOS 11+ Document macosx_{x}_0_{arch} pattern for macOS 11+ Nov 21, 2025
@di
Copy link
Member

di commented Nov 21, 2025

I think it was meant to be Document macosx_{x}_0_{arch} pattern for macOS 11+, I've updated it accordingly.

@webknjaz webknjaz enabled auto-merge November 21, 2025 23:33
Following https://discuss.python.org/t/document-that-macos-platform-tags-use-minor-version-0-for-macos-11/104616:

 * Document that for macOS 11 and later, the platform tag is `macosx_0_{y}_{arch}`
 * Document that platform tags may change over time.
@webknjaz webknjaz force-pushed the konsti/document-macos-change branch from 895c88b to 761f6bd Compare November 21, 2025 23:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify allowed minor version of macos tags

5 participants