Changelog

4.1.1 (unreleased)

Important

This version is not released yet and is under active development.

4.1.0 (2025-10-21)

  • Add new invalidate_caches() method to invalidate internal caches used for platform detection.

  • Remove dependency on boltons.

  • Add all Operating System :: trove classifiers.

  • Add all platform names as package keywords.

4.0.0 (2025-10-21)

  • Fix detection of GNU/Hurd. Closes #308.

  • Move all typing-related imports behind a hard-coded TYPE_CHECKING guard to avoid runtime imports.

  • Remove maximum capped version of all dependencies (relax all ~= specifiers to >=). This gives more freedom to downstream and upstream packagers. Document each minimal version choice.

  • Add official support of Python 3.14.

  • Run tests on Python 3.15.

  • Skip tests on Python 3.12 and 3.13 to reduce CI load.

  • Use astral-sh/setup-uv action to install uv instead of manually installing it with pip.

  • Run tests on macos-26 and macos-15-intel runners.

  • Remove tests on EOL’ed windows-2019 and macos-13.

  • Support GitHub admonitions in Sphinx/MyST documentation.

3.2.3 (2025-08-05)

  • Add detection of macOS Tahoe (v26.x).

3.2.2 (2025-05-24)

  • Fix detection of UNKNOWN_CI.

3.2.1 (2025-05-17)

  • Add convenient ALL_PLATFORMS_WITHOUT_CI group to exclude all CI systems from ALL_PLATFORMS.

3.2.0 (2025-05-16)

  • Add detection of CI systems: GITHUB_CI, GITLAB_CI and UNKNOWN_CI.

  • Add new CI group to group all CI platforms.

  • Move OS families diagrams to group documentation page.

  • Remove ALL_PLATFORMS from Sankey diagram.

  • Run tests on windows-11-arm runners.

  • Remove tests on EOL ubuntu-20-04.

3.1.0 (2025-03-04)

  • Allow platform ID membership test on groups.

  • Add items() method to Group.

  • Allow None values in nested references to platforms and groups.

  • Keep initial order of data from platforms_from_ids() and groups_from_ids() results.

  • Allow arbitrary arguments number in Group._extract_platforms().

3.0.0 (2025-03-02)

  • Allow set operations to resolve group and Platform IDs.

  • Make resolution of platform and group IDs case-insensitive.

  • Only runs website tests on Linux to prevent DOSing them.

  • Drop supports for Python 3.10.

  • Remove tomli dependency.

2.1.0 (2025-02-20)

  • Add new platforms_from_ids and groups_from_ids methods to retrieve platforms and groups from a collection of IDs.

  • Allow a platform to be fetched by its ID from a group with the group[platform_id] item getter syntax.

  • Add new ALL_PLATFORM_IDS, ALL_GROUP_IDS and ALL_IDS constants.

  • Removes ALL_OS_LABELS.

  • Add windows-2025 to the test matrix.

  • Mark Python 3.14 tests as stable.

2.0.0 (2024-12-27)

  • Add detection of Nobara.

  • Fix current_os() to always return a single platform. Closes #158.

  • Add new current_platforms() method to return all platforms matching the current environment.

  • Generate a pair of Pytest @skip_<id>/@unless_<id> decorators for each platform and group.

  • Change all group membership check utilities to be functions instead of variables. You now have to call is_<group_id>() instead of is_<group_id>.

  • Cache the result of is_<group_id>() group membership check utilities.

  • Do not call all detection heuristics on module import. Instead, call them lazily when needed.

  • Make URLs required on all platforms.

  • Invite users in error messages and logs to contribute back edge-cases to improve detection heuristics.

  • Upload test results to coverage.

1.7.0 (2024-12-02)

  • Display the hierarchy of non-overlapping groups as a mindmap.

  • Add URL on all platforms.

  • Add detection of openSUSE Tumbleweed. Closes #133.

  • Do not allow icons on platforms and groups to be empty.

  • Run tests in parallel to speed up CI.

1.6.0 (2024-11-11)

  • Add a new copy() method to Group.

  • New target_pool parameter on reduce method let you specify the subset of groups to reduce platforms to.

  • Remove CURRENT_OS_ID and CURRENT_OS_LABEL.

1.5.0 (2024-11-10)

  • Allow union, intersection, difference and symmetric difference of Group.

  • Implements <=, <, >=, >, |, &, - and ^ operators for Group.

  • Deduplicate platforms on Group instantiation.

  • Allow testing for membership of individual platform in Group.

1.4.0 (2024-10-21)

  • Allow set comparison between groups and single platform.

  • Add detection of Tuxedo OS. Closes #93.

  • Add support for Python 3.13.

  • Drop supports for Python 3.9.

  • Run jobs on ubuntu-24.04 instead of ubuntu-22.04.

  • Run tests on macos-15. Remove tests on macos-12.

  • Run tests on Python 3.14-dev.

1.3.1 (2024-09-18)

  • Fix conflicting detection heuristics for Linux distributions. Closes #72.

  • Fix fetching of macOS version for releases without build number (like 15.0).

1.3.0 (2024-09-11)

  • Add detection of all versions of macOS and Windows. Closes #55.

  • Drop supports for Python 3.8.

  • Add is_<group_id> booleans to module root to test the membership of the current platform to that group.

  • Rename ALL_LINUX group to LINUX.

  • Rename ALL_WINDOWS group to ANY_WINDOWS.

1.2.1 (2024-09-04)

  • Fix changelog update.

1.2.0 (2024-08-24)

  • Add new LINUX_LIKE family that merge ALL_LINUX and LINUX_LAYERS groups.

1.1.1 (2024-08-21)

  • Run tests on ubuntu-24.04 and macos-12.

  • Add missing typed marker.

1.1.0 (2024-08-20)

  • Add documentation.

  • Expose all utilities at root level.

  • Split code.

1.0.2 (2024-08-19)

  • Re-release.

1.0.1 (2024-08-19)

  • Add pytest utilities.

  • Reorganize code.

  • Fix tests.

1.0.0 (2024-08-18)

  • First version as a stand alone package extracted from click-extra.