InstallationΒΆ

Quick startΒΆ

Add the library to your project with uv:

$ uv add extra-platforms

Or inspect the current environment straight from your terminal with the bundled CLI:

$ uvx extra-platforms

Try itΒΆ

You can try Extra Platforms right now in your terminal, without installing any dependency or virtual env thanks to uvx:

$ uvx extra-platforms
$ uvx extra-platforms@14.0.1
$ uvx --from git+https://github.com/kdeldycke/extra-platforms -- extra-platforms

Try the libraryΒΆ

You can also try the library itself in an interactive Python shell without installing anything on your system:

$ uvx --with extra-platforms python
>>> from extra_platforms import current_platform, BSD, UNIX, LINUX
>>> current_platform()
Platform(id='macos', name='macOS')
>>> current_platform() in BSD
True
>>> current_platform() in UNIX
True
>>> current_platform() in LINUX
False

Install methodsΒΆ

This package is available on PyPI and in several OS distributions, so you can install the latest stable release with your favorite package manager:

Easiest way is to install uv, then add it to your project:

$ uv add extra-platforms

Or to install the CLI system-wide with uv tool:

$ uv tool install extra-platforms

You can install the latest stable release and its dependencies with a simple pip call:

$ python -m pip install extra-platforms

If you have difficulties to use pip, see pip’s own installation instructions.

pipx is a great way to install the CLI globally:

$ pipx install extra-platforms

A python-extra-platforms package is available on AUR and can be installed with any AUR helper:

$ yay -S python-extra-platforms
$ paru -S python-extra-platforms

Extra Platforms is available in GNU Guix:

$ guix install python-extra-platforms

Tip

The package landed in Guix on 2026-06-28. If guix install cannot find it yet, refresh your channels first with guix pull.

The py-extra-platforms port is available in MacPorts, with one port per Python version. Pick the one matching your interpreter, like py313-extra-platforms for Python 3.13:

$ sudo port install py313-extra-platforms

The python-extra-platforms package is available on openSUSE Tumbleweed:

$ sudo zypper install python3-extra-platforms

The sysutils/py-extra-platforms package is available in pkgsrc for NetBSD and all other platforms supported by pkgsrc:

$ pkgin install py313-extra-platforms

Or build it from source:

$ cd /usr/pkgsrc/sysutils/py-extra-platforms
$ make install clean

For the Pytest decorators, install the pytest extra: uv pip install 'extra-platforms[pytest]'.

Support envelopeΒΆ

The compatibility table below keeps the support envelope of extra-platforms. Outside of it, these are obsolete:

  • Python versions before 3.8 (2019-10-14)

Python compatibilityΒΆ

Each cell holds one of three states:

  • βœ…: the release declares support for that Python.

  • ❌: the requires-python of the release rules that Python out.

  • –: the release neither claimed nor forbade that Python, usually because that Python was not out yet when the release declared its requirements.

See three states, two sources. The table keeps the support envelope of extra-platforms, so the oldest releases drop off as the oldest supported Python moves up.

extra-platforms ↴ \ Python β†’

3.15

3.14

3.13

3.12

3.11

3.10

3.9

3.8

14.x

βœ…

βœ…

βœ…

βœ…

βœ…

❌

❌

❌

13.10.1 β†’ 13.13.x

βœ…

βœ…

βœ…

βœ…

βœ…

βœ…

❌

❌

5.0.x β†’ 13.10.0

–

βœ…

βœ…

βœ…

βœ…

βœ…

❌

❌

4.x

–

βœ…

βœ…

βœ…

βœ…

❌

❌

❌

3.x

–

–

βœ…

βœ…

βœ…

❌

❌

❌

1.4.x β†’ 2.1.x

–

–

βœ…

βœ…

βœ…

βœ…

❌

❌

1.3.x

–

–

–

βœ…

βœ…

βœ…

βœ…

❌

1.0.x β†’ 1.2.x

–

–

–

βœ…

βœ…

βœ…

βœ…

βœ…

Release verificationΒΆ

The PyPI distributions carry their own PEP 740 attestations, visible and verifiable on the PyPI project page.

DependenciesΒΆ

extra-platforms has no runtime dependency. The dependency graph on the packaging page covers the extras and development groups.

NamingΒΆ

Tip

I wanted to call this package platforms, but it’s already taken on PyPI. So I went with extra-platforms instead, to mark its affiliation with Click Extra.