Installation¶
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
pipx is a great way to install the CLI globally:
$ pipx install extra-platforms
You can install the latest stable release and its dependencies with a simple pip call:
$ python -m pip install extra-platforms
See also pip installation instructions.
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 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
Python compatibility¶
The table below shows which Python versions each extra-platforms release range supports, derived from each git tag’s pyproject.toml. It refreshes automatically through click-extra’s {matrix} directive, which repomatic’s update-docs job reruns to keep it in sync with new releases.
|
Released |
|
|
|
|
|
|
|
|---|---|---|---|---|---|---|---|---|
|
2025-11-03 |
❌ |
❌ |
✅ |
✅ |
✅ |
✅ |
✅ |
|
2025-10-21 |
❌ |
❌ |
❌ |
✅ |
✅ |
✅ |
✅ |
|
2025-03-02 |
❌ |
❌ |
❌ |
✅ |
✅ |
✅ |
❌ |
|
2024-10-21 |
❌ |
❌ |
✅ |
✅ |
✅ |
✅ |
❌ |
|
2024-09-11 |
❌ |
✅ |
✅ |
✅ |
✅ |
❌ |
❌ |
|
2024-08-18 |
✅ |
✅ |
✅ |
✅ |
✅ |
❌ |
❌ |
Try it now¶
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@13.3.0
$ uvx --from git+https://github.com/kdeldycke/extra-platforms -- extra-platforms
$ uvx --from file:///Users/me/code/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
Main dependencies¶
This is a graph of the default, main dependencies of the Python package:
flowchart LR
extra_platforms[["`extra-platforms`"]]
aiohttp(["`aiohttp`"])
pygments(["`pygments`"])
jinja2(["`jinja2`"])
packaging(["`packaging`"])
typing_extensions(["`typing-extensions`"])
yarl(["`yarl`"])
aiosignal(["`aiosignal`"])
arrow(["`arrow`"])
beautifulsoup4(["`beautifulsoup4`"])
click_0(["`click`"])
colorama(["`colorama`"])
docutils(["`docutils`"])
markdown_it_py(["`markdown-it-py`"])
pyyaml(["`pyyaml`"])
vt_py(["`vt-py`"])
accessible_pygments(["`accessible-pygments`"])
boltons(["`boltons`"])
cloup(["`cloup`"])
exceptiongroup(["`exceptiongroup`"])
frozenlist(["`frozenlist`"])
idna(["`idna`"])
mdit_py_plugins(["`mdit-py-plugins`"])
multidict(["`multidict`"])
pluggy(["`pluggy`"])
propcache(["`propcache`"])
py_walk(["`py-walk`"])
pyproject_metadata(["`pyproject-metadata`"])
python_dateutil(["`python-dateutil`"])
sphinx_basic_ng(["`sphinx-basic-ng`"])
tabulate(["`tabulate`"])
wcwidth(["`wcwidth`"])
aiofiles(["`aiofiles`"])
aiohappyeyeballs(["`aiohappyeyeballs`"])
alabaster(["`alabaster`"])
attrs(["`attrs`"])
babel(["`babel`"])
bracex(["`bracex`"])
certifi(["`certifi`"])
charset_normalizer(["`charset-normalizer`"])
deepmerge(["`deepmerge`"])
execnet(["`execnet`"])
imagesize(["`imagesize`"])
iniconfig(["`iniconfig`"])
markupsafe(["`markupsafe`"])
mdurl(["`mdurl`"])
psutil(["`psutil`"])
roman_numerals(["`roman-numerals`"])
six(["`six`"])
sly(["`sly`"])
snowballstemmer(["`snowballstemmer`"])
soupsieve(["`soupsieve`"])
sphinxcontrib_applehelp(["`sphinxcontrib-applehelp`"])
sphinxcontrib_devhelp(["`sphinxcontrib-devhelp`"])
sphinxcontrib_htmlhelp(["`sphinxcontrib-htmlhelp`"])
sphinxcontrib_jsmath(["`sphinxcontrib-jsmath`"])
sphinxcontrib_qthelp(["`sphinxcontrib-qthelp`"])
sphinxcontrib_serializinghtml(["`sphinxcontrib-serializinghtml`"])
tomlrt(["`tomlrt`"])
tzdata(["`tzdata`"])
urllib3(["`urllib3`"])
subgraph ext_pytest [--extra pytest]
ext_pytest_pytest{{"`pytest >=8.2.1`"}}
end
subgraph grp_docs [--group docs]
sphinx{{"`sphinx >=9.1`"}}
click_extra{{"`click-extra >=8.3`"}}
repomatic{{"`repomatic >=6.14`"}}
myst_parser{{"`myst-parser >=5.1`"}}
furo{{"`furo >=2025.9.25`"}}
sphinxcontrib_mermaid{{"`sphinxcontrib-mermaid >=1.2.2`"}}
wcmatch{{"`wcmatch >=10`"}}
sphinx_autodoc_typehints{{"`sphinx-autodoc-typehints >=2.4`"}}
sphinx_copybutton{{"`sphinx-copybutton >=0.5.2`"}}
sphinx_design{{"`sphinx-design >=0.6`"}}
sphinxext_opengraph{{"`sphinxext-opengraph >=0.13`"}}
grp_docs_pytest{{"`pytest >=8.2.1`"}}
end
subgraph grp_test [--group test]
pytest{{"`pytest`"}}
requests{{"`requests >=2.34`"}}
pytest_cov{{"`pytest-cov >=7`"}}
pytest_xdist{{"`pytest-xdist >=3.7`"}}
coverage{{"`coverage >=7.11`"}}
tomli{{"`tomli >=2.3`"}}
pytest_github_actions_annotate_failures{{"`pytest-github-actions-annotate-failures >=0.3`"}}
pytest_randomly{{"`pytest-randomly >=4`"}}
end
sphinx --> requests
sphinx --> pygments
sphinx --> jinja2
sphinx --> packaging
sphinx --> colorama
sphinx --> docutils
sphinx --> alabaster
sphinx --> babel
sphinx --> imagesize
sphinx --> roman_numerals
sphinx --> snowballstemmer
sphinx --> sphinxcontrib_applehelp
sphinx --> sphinxcontrib_devhelp
sphinx --> sphinxcontrib_htmlhelp
sphinx --> sphinxcontrib_jsmath
sphinx --> sphinxcontrib_qthelp
sphinx --> sphinxcontrib_serializinghtml
click_extra --> sphinx
click_extra --> extra_platforms
click_extra --> pygments
click_extra --> wcmatch
click_extra --> click_0
click_extra --> docutils
click_extra --> boltons
click_extra --> cloup
click_extra --> tabulate
click_extra --> wcwidth
click_extra --> deepmerge
pytest --> pygments
pytest --> packaging
pytest --> colorama
pytest --> tomli
pytest --> exceptiongroup
pytest --> pluggy
pytest --> iniconfig
repomatic --> extra_platforms
repomatic --> click_extra
repomatic --> packaging
repomatic --> wcmatch
repomatic --> arrow
repomatic --> pyyaml
repomatic --> vt_py
repomatic --> boltons
repomatic --> py_walk
repomatic --> pyproject_metadata
repomatic --> tomlrt
myst_parser --> sphinx
myst_parser --> jinja2
myst_parser --> docutils
myst_parser --> markdown_it_py
myst_parser --> pyyaml
myst_parser --> mdit_py_plugins
furo --> sphinx
furo --> pygments
furo --> beautifulsoup4
furo --> accessible_pygments
furo --> sphinx_basic_ng
requests --> idna
requests --> certifi
requests --> charset_normalizer
requests --> urllib3
pytest_cov --> pytest
pytest_cov --> coverage
pytest_cov --> pluggy
pytest_xdist --> pytest
pytest_xdist --> execnet
pytest_xdist --> psutil
sphinxcontrib_mermaid --> sphinx
sphinxcontrib_mermaid --> jinja2
sphinxcontrib_mermaid --> pyyaml
wcmatch --> bracex
coverage --> tomli
pytest_github_actions_annotate_failures --> pytest
pytest_randomly --> pytest
sphinx_autodoc_typehints --> sphinx
sphinx_copybutton --> sphinx
sphinx_design --> sphinx
sphinxext_opengraph --> sphinx
jinja2 --> markupsafe
arrow --> python_dateutil
arrow --> tzdata
beautifulsoup4 --> typing_extensions
beautifulsoup4 --> soupsieve
click_0 --> colorama
markdown_it_py --> mdurl
vt_py --> aiohttp
vt_py --> aiofiles
accessible_pygments --> pygments
cloup --> click_0
exceptiongroup --> typing_extensions
mdit_py_plugins --> markdown_it_py
py_walk --> sly
pyproject_metadata --> packaging
sphinx_basic_ng --> sphinx
tabulate --> wcwidth
aiohttp --> typing_extensions
aiohttp --> yarl
aiohttp --> aiosignal
aiohttp --> frozenlist
aiohttp --> multidict
aiohttp --> propcache
aiohttp --> aiohappyeyeballs
aiohttp --> attrs
python_dateutil --> six
yarl --> idna
yarl --> multidict
yarl --> propcache
aiosignal --> typing_extensions
aiosignal --> frozenlist
extra_platforms -.-> ext_pytest
extra_platforms -.-> grp_docs
extra_platforms -.-> grp_test
ext_pytest_pytest -.- pytest
grp_docs_pytest -.- pytest
click accessible_pygments "https://pypi.org/project/accessible-pygments/" _blank
click aiofiles "https://pypi.org/project/aiofiles/" _blank
click aiohappyeyeballs "https://pypi.org/project/aiohappyeyeballs/" _blank
click aiohttp "https://pypi.org/project/aiohttp/" _blank
click aiosignal "https://pypi.org/project/aiosignal/" _blank
click alabaster "https://pypi.org/project/alabaster/" _blank
click arrow "https://pypi.org/project/arrow/" _blank
click attrs "https://pypi.org/project/attrs/" _blank
click babel "https://pypi.org/project/babel/" _blank
click beautifulsoup4 "https://pypi.org/project/beautifulsoup4/" _blank
click boltons "https://pypi.org/project/boltons/" _blank
click bracex "https://pypi.org/project/bracex/" _blank
click certifi "https://pypi.org/project/certifi/" _blank
click charset_normalizer "https://pypi.org/project/charset-normalizer/" _blank
click click_0 "https://pypi.org/project/click/" _blank
click click_extra "https://pypi.org/project/click-extra/" _blank
click cloup "https://pypi.org/project/cloup/" _blank
click colorama "https://pypi.org/project/colorama/" _blank
click coverage "https://pypi.org/project/coverage/" _blank
click deepmerge "https://pypi.org/project/deepmerge/" _blank
click docutils "https://pypi.org/project/docutils/" _blank
click exceptiongroup "https://pypi.org/project/exceptiongroup/" _blank
click execnet "https://pypi.org/project/execnet/" _blank
click extra_platforms "https://pypi.org/project/extra-platforms/" _blank
click frozenlist "https://pypi.org/project/frozenlist/" _blank
click furo "https://pypi.org/project/furo/" _blank
click idna "https://pypi.org/project/idna/" _blank
click imagesize "https://pypi.org/project/imagesize/" _blank
click iniconfig "https://pypi.org/project/iniconfig/" _blank
click jinja2 "https://pypi.org/project/jinja2/" _blank
click markdown_it_py "https://pypi.org/project/markdown-it-py/" _blank
click markupsafe "https://pypi.org/project/markupsafe/" _blank
click mdit_py_plugins "https://pypi.org/project/mdit-py-plugins/" _blank
click mdurl "https://pypi.org/project/mdurl/" _blank
click multidict "https://pypi.org/project/multidict/" _blank
click myst_parser "https://pypi.org/project/myst-parser/" _blank
click packaging "https://pypi.org/project/packaging/" _blank
click pluggy "https://pypi.org/project/pluggy/" _blank
click propcache "https://pypi.org/project/propcache/" _blank
click psutil "https://pypi.org/project/psutil/" _blank
click py_walk "https://pypi.org/project/py-walk/" _blank
click pygments "https://pypi.org/project/pygments/" _blank
click pyproject_metadata "https://pypi.org/project/pyproject-metadata/" _blank
click pytest "https://pypi.org/project/pytest/" _blank
click pytest_cov "https://pypi.org/project/pytest-cov/" _blank
click pytest_github_actions_annotate_failures "https://pypi.org/project/pytest-github-actions-annotate-failures/" _blank
click pytest_randomly "https://pypi.org/project/pytest-randomly/" _blank
click pytest_xdist "https://pypi.org/project/pytest-xdist/" _blank
click python_dateutil "https://pypi.org/project/python-dateutil/" _blank
click pyyaml "https://pypi.org/project/pyyaml/" _blank
click repomatic "https://pypi.org/project/repomatic/" _blank
click requests "https://pypi.org/project/requests/" _blank
click roman_numerals "https://pypi.org/project/roman-numerals/" _blank
click six "https://pypi.org/project/six/" _blank
click sly "https://pypi.org/project/sly/" _blank
click snowballstemmer "https://pypi.org/project/snowballstemmer/" _blank
click soupsieve "https://pypi.org/project/soupsieve/" _blank
click sphinx "https://pypi.org/project/sphinx/" _blank
click sphinx_autodoc_typehints "https://pypi.org/project/sphinx-autodoc-typehints/" _blank
click sphinx_basic_ng "https://pypi.org/project/sphinx-basic-ng/" _blank
click sphinx_copybutton "https://pypi.org/project/sphinx-copybutton/" _blank
click sphinx_design "https://pypi.org/project/sphinx-design/" _blank
click sphinxcontrib_applehelp "https://pypi.org/project/sphinxcontrib-applehelp/" _blank
click sphinxcontrib_devhelp "https://pypi.org/project/sphinxcontrib-devhelp/" _blank
click sphinxcontrib_htmlhelp "https://pypi.org/project/sphinxcontrib-htmlhelp/" _blank
click sphinxcontrib_jsmath "https://pypi.org/project/sphinxcontrib-jsmath/" _blank
click sphinxcontrib_mermaid "https://pypi.org/project/sphinxcontrib-mermaid/" _blank
click sphinxcontrib_qthelp "https://pypi.org/project/sphinxcontrib-qthelp/" _blank
click sphinxcontrib_serializinghtml "https://pypi.org/project/sphinxcontrib-serializinghtml/" _blank
click sphinxext_opengraph "https://pypi.org/project/sphinxext-opengraph/" _blank
click tabulate "https://pypi.org/project/tabulate/" _blank
click tomli "https://pypi.org/project/tomli/" _blank
click tomlrt "https://pypi.org/project/tomlrt/" _blank
click typing_extensions "https://pypi.org/project/typing-extensions/" _blank
click tzdata "https://pypi.org/project/tzdata/" _blank
click urllib3 "https://pypi.org/project/urllib3/" _blank
click vt_py "https://pypi.org/project/vt-py/" _blank
click wcmatch "https://pypi.org/project/wcmatch/" _blank
click wcwidth "https://pypi.org/project/wcwidth/" _blank
click yarl "https://pypi.org/project/yarl/" _blank
click ext_pytest_pytest "https://pypi.org/project/pytest/" _blank
click grp_docs_pytest "https://pypi.org/project/pytest/" _blank
style extra_platforms stroke-width:3px
style click_extra stroke-width:3px
style coverage stroke-width:3px
style furo stroke-width:3px
style myst_parser stroke-width:3px
style pytest stroke-width:3px
style pytest_cov stroke-width:3px
style pytest_github_actions_annotate_failures stroke-width:3px
style pytest_randomly stroke-width:3px
style pytest_xdist stroke-width:3px
style repomatic stroke-width:3px
style requests stroke-width:3px
style sphinx stroke-width:3px
style sphinx_autodoc_typehints stroke-width:3px
style sphinx_copybutton stroke-width:3px
style sphinx_design stroke-width:3px
style sphinxcontrib_mermaid stroke-width:3px
style sphinxext_opengraph stroke-width:3px
style tomli stroke-width:3px
style wcmatch stroke-width:3px
style ext_pytest_pytest stroke-width:3px,stroke-dasharray:5 5
style grp_docs_pytest stroke-width:3px,stroke-dasharray:5 5
style ext_pytest fill:#7B1FA220,stroke:#BA68C8
style grp_docs fill:#546E7A20,stroke:#90A4AE
style grp_test fill:#546E7A20,stroke:#90A4AE
Extra dependencies¶
For additional features, you may need to install extra dependencies.
For Pytest¶
Activate new fixtures and utilities for testing Click CLIs:
$ pip install extra-platforms[pytest]
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.