Groups¶

OS families¶

Each platform is assigned to a group of non-overlpaping families:

        ---
title: <code>extra_platforms.NON_OVERLAPPING_GROUPS</code> - Non-overlapping groups.
---
flowchart

    subgraph "<code>extra_platforms.ANY_WINDOWS</code><br/>🪟 <em>Any Windows</em>"
        any_windows_windows(<code>windows</code><br/>🪟 <em>Windows</em>)
    end
    subgraph "<code>extra_platforms.BSD</code><br/>🅱️+ <em>Any BSD</em>"
        bsd_freebsd(<code>freebsd</code><br/>😈 <em>FreeBSD</em>)
        bsd_macos(<code>macos</code><br/>🍎 <em>macOS</em>)
        bsd_midnightbsd(<code>midnightbsd</code><br/>🌘 <em>MidnightBSD</em>)
        bsd_netbsd(<code>netbsd</code><br/>🚩 <em>NetBSD</em>)
        bsd_openbsd(<code>openbsd</code><br/>🐡 <em>OpenBSD</em>)
        bsd_sunos(<code>sunos</code><br/>☀️ <em>SunOS</em>)
    end
    subgraph "<code>extra_platforms.LINUX</code><br/>🐧 <em>Any Linux distribution</em>"
        linux_altlinux(<code>altlinux</code><br/>🐧 <em>ALT Linux</em>)
        linux_amzn(<code>amzn</code><br/>🙂 <em>Amazon Linux</em>)
        linux_android(<code>android</code><br/>🤖 <em>Android</em>)
        linux_arch(<code>arch</code><br/>🎗️ <em>Arch Linux</em>)
        linux_buildroot(<code>buildroot</code><br/>⛑️ <em>Buildroot</em>)
        linux_centos(<code>centos</code><br/>💠 <em>CentOS</em>)
        linux_cloudlinux(<code>cloudlinux</code><br/>꩜ <em>CloudLinux OS</em>)
        linux_debian(<code>debian</code><br/>🌀 <em>Debian</em>)
        linux_exherbo(<code>exherbo</code><br/>🐽 <em>Exherbo Linux</em>)
        linux_fedora(<code>fedora</code><br/>🎩 <em>Fedora</em>)
        linux_gentoo(<code>gentoo</code><br/>🗜️ <em>Gentoo Linux</em>)
        linux_guix(<code>guix</code><br/>🐃 <em>Guix System</em>)
        linux_ibm_powerkvm(<code>ibm_powerkvm</code><br/>🤹 <em>IBM PowerKVM</em>)
        linux_kvmibm(<code>kvmibm</code><br/>🤹 <em>KVM for IBM z Systems</em>)
        linux_linuxmint(<code>linuxmint</code><br/>🌿 <em>Linux Mint</em>)
        linux_mageia(<code>mageia</code><br/>⍥ <em>Mageia</em>)
        linux_mandriva(<code>mandriva</code><br/>💫 <em>Mandriva Linux</em>)
        linux_nobara(<code>nobara</code><br/> <em>Nobara</em>)
        linux_opensuse(<code>opensuse</code><br/>🦎 <em>openSUSE</em>)
        linux_oracle(<code>oracle</code><br/>🦴 <em>Oracle Linux</em>)
        linux_parallels(<code>parallels</code><br/>∥ <em>Parallels</em>)
        linux_pidora(<code>pidora</code><br/>🍓 <em>Pidora</em>)
        linux_raspbian(<code>raspbian</code><br/>🍓 <em>Raspbian</em>)
        linux_rhel(<code>rhel</code><br/>🎩 <em>RedHat Enterprise Linux</em>)
        linux_rocky(<code>rocky</code><br/>⛰️ <em>Rocky Linux</em>)
        linux_scientific(<code>scientific</code><br/>⚛️ <em>Scientific Linux</em>)
        linux_slackware(<code>slackware</code><br/>🚬 <em>Slackware</em>)
        linux_sles(<code>sles</code><br/>🦎 <em>SUSE Linux Enterprise Server</em>)
        linux_tumbleweed(<code>tumbleweed</code><br/>↻ <em>openSUSE Tumbleweed</em>)
        linux_tuxedo(<code>tuxedo</code><br/>🤵 <em>Tuxedo OS</em>)
        linux_ubuntu(<code>ubuntu</code><br/>🎯 <em>Ubuntu</em>)
        linux_unknown_linux(<code>unknown_linux</code><br/>🐧 <em>Unknown Linux</em>)
        linux_xenserver(<code>xenserver</code><br/>Ⓧ <em>XenServer</em>)
    end
    subgraph "<code>extra_platforms.LINUX_LAYERS</code><br/>≚ <em>Any Linux compatibility layers</em>"
        linux_layers_wsl1(<code>wsl1</code><br/>⊞ <em>Windows Subsystem for Linux v1</em>)
        linux_layers_wsl2(<code>wsl2</code><br/>⊞ <em>Windows Subsystem for Linux v2</em>)
    end
    subgraph "<code>extra_platforms.OTHER_UNIX</code><br/>⊎ <em>Any other Unix</em>"
        other_unix_hurd(<code>hurd</code><br/>🐃 <em>GNU/Hurd</em>)
    end
    subgraph "<code>extra_platforms.SYSTEM_V</code><br/>Ⅴ <em>Any Unix derived from AT&amp;T System Five</em>"
        system_v_aix(<code>aix</code><br/>➿ <em>IBM AIX</em>)
        system_v_solaris(<code>solaris</code><br/>🌞 <em>Solaris</em>)
    end
    subgraph "<code>extra_platforms.UNIX_LAYERS</code><br/>≛ <em>Any Unix compatibility layers</em>"
        unix_layers_cygwin(<code>cygwin</code><br/>Ͼ <em>Cygwin</em>)
    end

Other groups¶

Other groups are available for convenience, but these overlaps:

        ---
title: <code>extra_platforms.EXTRA_GROUPS</code> - Overlapping groups, defined for convenience.
---
flowchart

    subgraph "<code>extra_platforms.ALL_PLATFORMS</code><br/>🖥️ <em>All platforms</em>"
        all_platforms_aix(<code>aix</code><br/>➿ <em>IBM AIX</em>)
        all_platforms_altlinux(<code>altlinux</code><br/>🐧 <em>ALT Linux</em>)
        all_platforms_amzn(<code>amzn</code><br/>🙂 <em>Amazon Linux</em>)
        all_platforms_android(<code>android</code><br/>🤖 <em>Android</em>)
        all_platforms_arch(<code>arch</code><br/>🎗️ <em>Arch Linux</em>)
        all_platforms_buildroot(<code>buildroot</code><br/>⛑️ <em>Buildroot</em>)
        all_platforms_centos(<code>centos</code><br/>💠 <em>CentOS</em>)
        all_platforms_cloudlinux(<code>cloudlinux</code><br/>꩜ <em>CloudLinux OS</em>)
        all_platforms_cygwin(<code>cygwin</code><br/>Ͼ <em>Cygwin</em>)
        all_platforms_debian(<code>debian</code><br/>🌀 <em>Debian</em>)
        all_platforms_exherbo(<code>exherbo</code><br/>🐽 <em>Exherbo Linux</em>)
        all_platforms_fedora(<code>fedora</code><br/>🎩 <em>Fedora</em>)
        all_platforms_freebsd(<code>freebsd</code><br/>😈 <em>FreeBSD</em>)
        all_platforms_gentoo(<code>gentoo</code><br/>🗜️ <em>Gentoo Linux</em>)
        all_platforms_guix(<code>guix</code><br/>🐃 <em>Guix System</em>)
        all_platforms_hurd(<code>hurd</code><br/>🐃 <em>GNU/Hurd</em>)
        all_platforms_ibm_powerkvm(<code>ibm_powerkvm</code><br/>🤹 <em>IBM PowerKVM</em>)
        all_platforms_kvmibm(<code>kvmibm</code><br/>🤹 <em>KVM for IBM z Systems</em>)
        all_platforms_linuxmint(<code>linuxmint</code><br/>🌿 <em>Linux Mint</em>)
        all_platforms_macos(<code>macos</code><br/>🍎 <em>macOS</em>)
        all_platforms_mageia(<code>mageia</code><br/>⍥ <em>Mageia</em>)
        all_platforms_mandriva(<code>mandriva</code><br/>💫 <em>Mandriva Linux</em>)
        all_platforms_midnightbsd(<code>midnightbsd</code><br/>🌘 <em>MidnightBSD</em>)
        all_platforms_netbsd(<code>netbsd</code><br/>🚩 <em>NetBSD</em>)
        all_platforms_nobara(<code>nobara</code><br/> <em>Nobara</em>)
        all_platforms_openbsd(<code>openbsd</code><br/>🐡 <em>OpenBSD</em>)
        all_platforms_opensuse(<code>opensuse</code><br/>🦎 <em>openSUSE</em>)
        all_platforms_oracle(<code>oracle</code><br/>🦴 <em>Oracle Linux</em>)
        all_platforms_parallels(<code>parallels</code><br/>∥ <em>Parallels</em>)
        all_platforms_pidora(<code>pidora</code><br/>🍓 <em>Pidora</em>)
        all_platforms_raspbian(<code>raspbian</code><br/>🍓 <em>Raspbian</em>)
        all_platforms_rhel(<code>rhel</code><br/>🎩 <em>RedHat Enterprise Linux</em>)
        all_platforms_rocky(<code>rocky</code><br/>⛰️ <em>Rocky Linux</em>)
        all_platforms_scientific(<code>scientific</code><br/>⚛️ <em>Scientific Linux</em>)
        all_platforms_slackware(<code>slackware</code><br/>🚬 <em>Slackware</em>)
        all_platforms_sles(<code>sles</code><br/>🦎 <em>SUSE Linux Enterprise Server</em>)
        all_platforms_solaris(<code>solaris</code><br/>🌞 <em>Solaris</em>)
        all_platforms_sunos(<code>sunos</code><br/>☀️ <em>SunOS</em>)
        all_platforms_tumbleweed(<code>tumbleweed</code><br/>↻ <em>openSUSE Tumbleweed</em>)
        all_platforms_tuxedo(<code>tuxedo</code><br/>🤵 <em>Tuxedo OS</em>)
        all_platforms_ubuntu(<code>ubuntu</code><br/>🎯 <em>Ubuntu</em>)
        all_platforms_unknown_linux(<code>unknown_linux</code><br/>🐧 <em>Unknown Linux</em>)
        all_platforms_windows(<code>windows</code><br/>🪟 <em>Windows</em>)
        all_platforms_wsl1(<code>wsl1</code><br/>⊞ <em>Windows Subsystem for Linux v1</em>)
        all_platforms_wsl2(<code>wsl2</code><br/>⊞ <em>Windows Subsystem for Linux v2</em>)
        all_platforms_xenserver(<code>xenserver</code><br/>Ⓧ <em>XenServer</em>)
    end
    subgraph "<code>extra_platforms.BSD_WITHOUT_MACOS</code><br/>🅱️ <em>Any BSD excluding macOS</em>"
        bsd_without_macos_freebsd(<code>freebsd</code><br/>😈 <em>FreeBSD</em>)
        bsd_without_macos_midnightbsd(<code>midnightbsd</code><br/>🌘 <em>MidnightBSD</em>)
        bsd_without_macos_netbsd(<code>netbsd</code><br/>🚩 <em>NetBSD</em>)
        bsd_without_macos_openbsd(<code>openbsd</code><br/>🐡 <em>OpenBSD</em>)
        bsd_without_macos_sunos(<code>sunos</code><br/>☀️ <em>SunOS</em>)
    end
    subgraph "<code>extra_platforms.LINUX_LIKE</code><br/>🐧+ <em>Any Linux and compatibility layers</em>"
        linux_like_altlinux(<code>altlinux</code><br/>🐧 <em>ALT Linux</em>)
        linux_like_amzn(<code>amzn</code><br/>🙂 <em>Amazon Linux</em>)
        linux_like_android(<code>android</code><br/>🤖 <em>Android</em>)
        linux_like_arch(<code>arch</code><br/>🎗️ <em>Arch Linux</em>)
        linux_like_buildroot(<code>buildroot</code><br/>⛑️ <em>Buildroot</em>)
        linux_like_centos(<code>centos</code><br/>💠 <em>CentOS</em>)
        linux_like_cloudlinux(<code>cloudlinux</code><br/>꩜ <em>CloudLinux OS</em>)
        linux_like_debian(<code>debian</code><br/>🌀 <em>Debian</em>)
        linux_like_exherbo(<code>exherbo</code><br/>🐽 <em>Exherbo Linux</em>)
        linux_like_fedora(<code>fedora</code><br/>🎩 <em>Fedora</em>)
        linux_like_gentoo(<code>gentoo</code><br/>🗜️ <em>Gentoo Linux</em>)
        linux_like_guix(<code>guix</code><br/>🐃 <em>Guix System</em>)
        linux_like_ibm_powerkvm(<code>ibm_powerkvm</code><br/>🤹 <em>IBM PowerKVM</em>)
        linux_like_kvmibm(<code>kvmibm</code><br/>🤹 <em>KVM for IBM z Systems</em>)
        linux_like_linuxmint(<code>linuxmint</code><br/>🌿 <em>Linux Mint</em>)
        linux_like_mageia(<code>mageia</code><br/>⍥ <em>Mageia</em>)
        linux_like_mandriva(<code>mandriva</code><br/>💫 <em>Mandriva Linux</em>)
        linux_like_nobara(<code>nobara</code><br/> <em>Nobara</em>)
        linux_like_opensuse(<code>opensuse</code><br/>🦎 <em>openSUSE</em>)
        linux_like_oracle(<code>oracle</code><br/>🦴 <em>Oracle Linux</em>)
        linux_like_parallels(<code>parallels</code><br/>∥ <em>Parallels</em>)
        linux_like_pidora(<code>pidora</code><br/>🍓 <em>Pidora</em>)
        linux_like_raspbian(<code>raspbian</code><br/>🍓 <em>Raspbian</em>)
        linux_like_rhel(<code>rhel</code><br/>🎩 <em>RedHat Enterprise Linux</em>)
        linux_like_rocky(<code>rocky</code><br/>⛰️ <em>Rocky Linux</em>)
        linux_like_scientific(<code>scientific</code><br/>⚛️ <em>Scientific Linux</em>)
        linux_like_slackware(<code>slackware</code><br/>🚬 <em>Slackware</em>)
        linux_like_sles(<code>sles</code><br/>🦎 <em>SUSE Linux Enterprise Server</em>)
        linux_like_tumbleweed(<code>tumbleweed</code><br/>↻ <em>openSUSE Tumbleweed</em>)
        linux_like_tuxedo(<code>tuxedo</code><br/>🤵 <em>Tuxedo OS</em>)
        linux_like_ubuntu(<code>ubuntu</code><br/>🎯 <em>Ubuntu</em>)
        linux_like_unknown_linux(<code>unknown_linux</code><br/>🐧 <em>Unknown Linux</em>)
        linux_like_wsl1(<code>wsl1</code><br/>⊞ <em>Windows Subsystem for Linux v1</em>)
        linux_like_wsl2(<code>wsl2</code><br/>⊞ <em>Windows Subsystem for Linux v2</em>)
        linux_like_xenserver(<code>xenserver</code><br/>Ⓧ <em>XenServer</em>)
    end
    subgraph "<code>extra_platforms.UNIX</code><br/>⨷ <em>Any Unix</em>"
        unix_aix(<code>aix</code><br/>➿ <em>IBM AIX</em>)
        unix_altlinux(<code>altlinux</code><br/>🐧 <em>ALT Linux</em>)
        unix_amzn(<code>amzn</code><br/>🙂 <em>Amazon Linux</em>)
        unix_android(<code>android</code><br/>🤖 <em>Android</em>)
        unix_arch(<code>arch</code><br/>🎗️ <em>Arch Linux</em>)
        unix_buildroot(<code>buildroot</code><br/>⛑️ <em>Buildroot</em>)
        unix_centos(<code>centos</code><br/>💠 <em>CentOS</em>)
        unix_cloudlinux(<code>cloudlinux</code><br/>꩜ <em>CloudLinux OS</em>)
        unix_cygwin(<code>cygwin</code><br/>Ͼ <em>Cygwin</em>)
        unix_debian(<code>debian</code><br/>🌀 <em>Debian</em>)
        unix_exherbo(<code>exherbo</code><br/>🐽 <em>Exherbo Linux</em>)
        unix_fedora(<code>fedora</code><br/>🎩 <em>Fedora</em>)
        unix_freebsd(<code>freebsd</code><br/>😈 <em>FreeBSD</em>)
        unix_gentoo(<code>gentoo</code><br/>🗜️ <em>Gentoo Linux</em>)
        unix_guix(<code>guix</code><br/>🐃 <em>Guix System</em>)
        unix_hurd(<code>hurd</code><br/>🐃 <em>GNU/Hurd</em>)
        unix_ibm_powerkvm(<code>ibm_powerkvm</code><br/>🤹 <em>IBM PowerKVM</em>)
        unix_kvmibm(<code>kvmibm</code><br/>🤹 <em>KVM for IBM z Systems</em>)
        unix_linuxmint(<code>linuxmint</code><br/>🌿 <em>Linux Mint</em>)
        unix_macos(<code>macos</code><br/>🍎 <em>macOS</em>)
        unix_mageia(<code>mageia</code><br/>⍥ <em>Mageia</em>)
        unix_mandriva(<code>mandriva</code><br/>💫 <em>Mandriva Linux</em>)
        unix_midnightbsd(<code>midnightbsd</code><br/>🌘 <em>MidnightBSD</em>)
        unix_netbsd(<code>netbsd</code><br/>🚩 <em>NetBSD</em>)
        unix_nobara(<code>nobara</code><br/> <em>Nobara</em>)
        unix_openbsd(<code>openbsd</code><br/>🐡 <em>OpenBSD</em>)
        unix_opensuse(<code>opensuse</code><br/>🦎 <em>openSUSE</em>)
        unix_oracle(<code>oracle</code><br/>🦴 <em>Oracle Linux</em>)
        unix_parallels(<code>parallels</code><br/>∥ <em>Parallels</em>)
        unix_pidora(<code>pidora</code><br/>🍓 <em>Pidora</em>)
        unix_raspbian(<code>raspbian</code><br/>🍓 <em>Raspbian</em>)
        unix_rhel(<code>rhel</code><br/>🎩 <em>RedHat Enterprise Linux</em>)
        unix_rocky(<code>rocky</code><br/>⛰️ <em>Rocky Linux</em>)
        unix_scientific(<code>scientific</code><br/>⚛️ <em>Scientific Linux</em>)
        unix_slackware(<code>slackware</code><br/>🚬 <em>Slackware</em>)
        unix_sles(<code>sles</code><br/>🦎 <em>SUSE Linux Enterprise Server</em>)
        unix_solaris(<code>solaris</code><br/>🌞 <em>Solaris</em>)
        unix_sunos(<code>sunos</code><br/>☀️ <em>SunOS</em>)
        unix_tumbleweed(<code>tumbleweed</code><br/>↻ <em>openSUSE Tumbleweed</em>)
        unix_tuxedo(<code>tuxedo</code><br/>🤵 <em>Tuxedo OS</em>)
        unix_ubuntu(<code>ubuntu</code><br/>🎯 <em>Ubuntu</em>)
        unix_unknown_linux(<code>unknown_linux</code><br/>🐧 <em>Unknown Linux</em>)
        unix_wsl1(<code>wsl1</code><br/>⊞ <em>Windows Subsystem for Linux v1</em>)
        unix_wsl2(<code>wsl2</code><br/>⊞ <em>Windows Subsystem for Linux v2</em>)
        unix_xenserver(<code>xenserver</code><br/>Ⓧ <em>XenServer</em>)
    end
    subgraph "<code>extra_platforms.UNIX_WITHOUT_MACOS</code><br/>⨂ <em>Any Unix excluding macOS</em>"
        unix_without_macos_aix(<code>aix</code><br/>➿ <em>IBM AIX</em>)
        unix_without_macos_altlinux(<code>altlinux</code><br/>🐧 <em>ALT Linux</em>)
        unix_without_macos_amzn(<code>amzn</code><br/>🙂 <em>Amazon Linux</em>)
        unix_without_macos_android(<code>android</code><br/>🤖 <em>Android</em>)
        unix_without_macos_arch(<code>arch</code><br/>🎗️ <em>Arch Linux</em>)
        unix_without_macos_buildroot(<code>buildroot</code><br/>⛑️ <em>Buildroot</em>)
        unix_without_macos_centos(<code>centos</code><br/>💠 <em>CentOS</em>)
        unix_without_macos_cloudlinux(<code>cloudlinux</code><br/>꩜ <em>CloudLinux OS</em>)
        unix_without_macos_cygwin(<code>cygwin</code><br/>Ͼ <em>Cygwin</em>)
        unix_without_macos_debian(<code>debian</code><br/>🌀 <em>Debian</em>)
        unix_without_macos_exherbo(<code>exherbo</code><br/>🐽 <em>Exherbo Linux</em>)
        unix_without_macos_fedora(<code>fedora</code><br/>🎩 <em>Fedora</em>)
        unix_without_macos_freebsd(<code>freebsd</code><br/>😈 <em>FreeBSD</em>)
        unix_without_macos_gentoo(<code>gentoo</code><br/>🗜️ <em>Gentoo Linux</em>)
        unix_without_macos_guix(<code>guix</code><br/>🐃 <em>Guix System</em>)
        unix_without_macos_hurd(<code>hurd</code><br/>🐃 <em>GNU/Hurd</em>)
        unix_without_macos_ibm_powerkvm(<code>ibm_powerkvm</code><br/>🤹 <em>IBM PowerKVM</em>)
        unix_without_macos_kvmibm(<code>kvmibm</code><br/>🤹 <em>KVM for IBM z Systems</em>)
        unix_without_macos_linuxmint(<code>linuxmint</code><br/>🌿 <em>Linux Mint</em>)
        unix_without_macos_mageia(<code>mageia</code><br/>⍥ <em>Mageia</em>)
        unix_without_macos_mandriva(<code>mandriva</code><br/>💫 <em>Mandriva Linux</em>)
        unix_without_macos_midnightbsd(<code>midnightbsd</code><br/>🌘 <em>MidnightBSD</em>)
        unix_without_macos_netbsd(<code>netbsd</code><br/>🚩 <em>NetBSD</em>)
        unix_without_macos_nobara(<code>nobara</code><br/> <em>Nobara</em>)
        unix_without_macos_openbsd(<code>openbsd</code><br/>🐡 <em>OpenBSD</em>)
        unix_without_macos_opensuse(<code>opensuse</code><br/>🦎 <em>openSUSE</em>)
        unix_without_macos_oracle(<code>oracle</code><br/>🦴 <em>Oracle Linux</em>)
        unix_without_macos_parallels(<code>parallels</code><br/>∥ <em>Parallels</em>)
        unix_without_macos_pidora(<code>pidora</code><br/>🍓 <em>Pidora</em>)
        unix_without_macos_raspbian(<code>raspbian</code><br/>🍓 <em>Raspbian</em>)
        unix_without_macos_rhel(<code>rhel</code><br/>🎩 <em>RedHat Enterprise Linux</em>)
        unix_without_macos_rocky(<code>rocky</code><br/>⛰️ <em>Rocky Linux</em>)
        unix_without_macos_scientific(<code>scientific</code><br/>⚛️ <em>Scientific Linux</em>)
        unix_without_macos_slackware(<code>slackware</code><br/>🚬 <em>Slackware</em>)
        unix_without_macos_sles(<code>sles</code><br/>🦎 <em>SUSE Linux Enterprise Server</em>)
        unix_without_macos_solaris(<code>solaris</code><br/>🌞 <em>Solaris</em>)
        unix_without_macos_sunos(<code>sunos</code><br/>☀️ <em>SunOS</em>)
        unix_without_macos_tumbleweed(<code>tumbleweed</code><br/>↻ <em>openSUSE Tumbleweed</em>)
        unix_without_macos_tuxedo(<code>tuxedo</code><br/>🤵 <em>Tuxedo OS</em>)
        unix_without_macos_ubuntu(<code>ubuntu</code><br/>🎯 <em>Ubuntu</em>)
        unix_without_macos_unknown_linux(<code>unknown_linux</code><br/>🐧 <em>Unknown Linux</em>)
        unix_without_macos_wsl1(<code>wsl1</code><br/>⊞ <em>Windows Subsystem for Linux v1</em>)
        unix_without_macos_wsl2(<code>wsl2</code><br/>⊞ <em>Windows Subsystem for Linux v2</em>)
        unix_without_macos_xenserver(<code>xenserver</code><br/>Ⓧ <em>XenServer</em>)
    end

[!IMPORTANT] All the graphs above would be better off if merged. Unfortunately Graphviz is not capable of producing Euler diagrams. Only non-overlapping clusters can be rendered.

There’s still a chance to have them supported by Mermaid so we can switch to that if the feature materialize.

`extra_platforms.group` API¶

Group models collection of platforms. Also referred as families or categories.

class extra_platforms.group.Group(id, name, icon='❓', platforms=<factory>)[source]¶

Bases: object

A Group identify a collection of Platform.

Used to group platforms of the same family.

set-like methods are available and performed on the platform objects the group contains (in the self.platforms data field).

Todo

Replace the platforms/platform_ids combo fields with a single platforms field that is a simple dict of platform ID to platform object. But maybe that going to be too much of a hassle because a dict cannot be frozen.

id: str¶: Unique ID of the group.

name: str¶: User-friendly description of a group.

icon: str = '❓'¶: Icon of the group.

platforms: tuple[Platform, ...]¶: Sorted list of platforms that belong to this group.

platform_ids: frozenset[str]¶: Set of platform IDs that belong to this group.

property short_desc: str¶

Returns the group name with its first letter in lowercase to be used as a short description.

Mainly used to produce docstrings for function dynamically generated for each group.

items()[source]¶

Iterate over the platforms of the group as key-value pairs.

Return type:: Iterator[tuple[str, Platform]]

isdisjoint(other)[source]¶

Return True if the group has no platforms in common with other.

Groups are disjoint if and only if their intersection is an empty set.

other can be an arbitrarily nested Iterable of Group and Platform.

Return type:: bool

fullyintersects(other)[source]¶

Return True if the group has all platforms in common with other.

Return type:: bool

issubset(other)[source]¶

Test whether every platforms in the group is in other.

Return type:: bool

issuperset(other)[source]¶

Test whether every platform in other is in the group.

Return type:: bool

union(*others)[source]¶

Return a new Group with platforms from the group and all others.

Return type:: Group

..caution::: The new Group will inherits the metadata of the first one. All other groups’ metadata will be ignored.

intersection(*others)[source]¶

Return a new Group with platforms common to the group and all others.

Return type:: Group

..caution::: The new Group will inherits the metadata of the first one. All other groups’ metadata will be ignored.

difference(*others)[source]¶

Return a new Group with platforms in the group that are not in the others.

Return type:: Group

..caution::: The new Group will inherits the metadata of the first one. All other groups’ metadata will be ignored.

symmetric_difference(other)[source]¶

Return a new Group with platforms in either the group or other but not both.

Return type:: Group

..caution::: The new Group will inherits the metadata of the first one. All other groups’ metadata will be ignored.

copy(id=None, name=None, icon=None, platforms=None)[source]¶

Return a shallow copy of the group.

Fields can be overridden by passing new values as arguments.

Return type:: Group

`extra_platforms.group_data` API¶

Definitions of ready-to-use groups.

extra_platforms.group_data.ALL_PLATFORMS: Group = Group(id='all_platforms', name='All platforms', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'windows', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'}))¶: All recognized platforms.

extra_platforms.group_data.ANY_WINDOWS = Group(id='any_windows', name='Any Windows', platform_ids=frozenset({'windows'}))¶: All Windows operating systems.

extra_platforms.group_data.UNIX = Group(id='unix', name='Any Unix', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'}))¶: All Unix-like operating systems and compatibility layers.

extra_platforms.group_data.UNIX_WITHOUT_MACOS = Group(id='unix_without_macos', name='Any Unix excluding macOS', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'}))¶

All Unix platforms, without macOS.

This is useful to avoid macOS-specific workarounds on Unix platforms.

extra_platforms.group_data.BSD = Group(id='bsd', name='Any BSD', platform_ids=frozenset({'freebsd', 'midnightbsd', 'macos', 'sunos', 'openbsd', 'netbsd'}))¶

All BSD platforms.

Note

Are considered of this family (according Wikipedia):

386BSD (FreeBSD, NetBSD, OpenBSD, DragonFly BSD)
NeXTSTEP
Darwin (macOS, iOS, audioOS, iPadOS, tvOS, watchOS, bridgeOS)
SunOS
Ultrix

extra_platforms.group_data.BSD_WITHOUT_MACOS = Group(id='bsd_without_macos', name='Any BSD excluding macOS', platform_ids=frozenset({'freebsd', 'midnightbsd', 'sunos', 'openbsd', 'netbsd'}))¶

All BSD platforms, without macOS.

This is useful to avoid macOS-specific workarounds on BSD platforms.

extra_platforms.group_data.LINUX = Group(id='linux', name='Any Linux distribution', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'altlinux', 'tuxedo'}))¶

All distributions based on a Linux kernel.

Note

Are considered of this family (according Wikipedia):

Android
ChromeOS
any other distribution

extra_platforms.group_data.LINUX_LAYERS = Group(id='linux_layers', name='Any Linux compatibility layers', platform_ids=frozenset({'wsl2', 'wsl1'}))¶

Interfaces that allows Linux binaries to run on a different host system.

Note

Are considered of this family (according Wikipedia):

Windows Subsystem for Linux

extra_platforms.group_data.LINUX_LIKE = Group(id='linux_like', name='Any Linux and compatibility layers', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'tuxedo'}))¶: Sum of all Linux distributions and Linux compatibility layers.

extra_platforms.group_data.SYSTEM_V = Group(id='system_v', name='Any Unix derived from AT&T System Five', platform_ids=frozenset({'aix', 'solaris'}))¶

All Unix platforms derived from AT&T System Five.

Note

Are considered of this family (according Wikipedia):

A/UX
AIX
HP-UX
IRIX
OpenServer
Solaris
OpenSolaris
Illumos
Tru64
UNIX
UnixWare

extra_platforms.group_data.UNIX_LAYERS = Group(id='unix_layers', name='Any Unix compatibility layers', platform_ids=frozenset({'cygwin'}))¶

Interfaces that allows Unix binaries to run on a different host system.

Note

Are considered of this family (according Wikipedia):

Cygwin
Darling
Eunice
GNV
Interix
MachTen
Microsoft POSIX subsystem
MKS Toolkit
PASE
P.I.P.S.
PWS/VSE-AF
UNIX System Services
UserLAnd Technologies
Windows Services for UNIX

extra_platforms.group_data.OTHER_UNIX = Group(id='other_unix', name='Any other Unix', platform_ids=frozenset({'hurd'}))¶

All other Unix platforms.

Note

Are considered of this family (according Wikipedia):

Coherent
GNU/Hurd
HarmonyOS
LiteOS
LynxOS
Minix
MOS
OSF/1
QNX
BlackBerry 10
Research Unix
SerenityOS

extra_platforms.group_data.NON_OVERLAPPING_GROUPS: frozenset[Group] = frozenset({Group(id='any_windows', name='Any Windows', platform_ids=frozenset({'windows'})), Group(id='other_unix', name='Any other Unix', platform_ids=frozenset({'hurd'})), Group(id='system_v', name='Any Unix derived from AT&T System Five', platform_ids=frozenset({'aix', 'solaris'})), Group(id='unix_layers', name='Any Unix compatibility layers', platform_ids=frozenset({'cygwin'})), Group(id='linux', name='Any Linux distribution', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'altlinux', 'tuxedo'})), Group(id='bsd', name='Any BSD', platform_ids=frozenset({'freebsd', 'midnightbsd', 'macos', 'sunos', 'openbsd', 'netbsd'})), Group(id='linux_layers', name='Any Linux compatibility layers', platform_ids=frozenset({'wsl2', 'wsl1'}))})¶: Non-overlapping groups.

extra_platforms.group_data.EXTRA_GROUPS: frozenset[Group] = frozenset({Group(id='bsd_without_macos', name='Any BSD excluding macOS', platform_ids=frozenset({'freebsd', 'midnightbsd', 'sunos', 'openbsd', 'netbsd'})), Group(id='linux_like', name='Any Linux and compatibility layers', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'tuxedo'})), Group(id='unix_without_macos', name='Any Unix excluding macOS', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'})), Group(id='unix', name='Any Unix', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'})), Group(id='all_platforms', name='All platforms', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'windows', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'}))})¶: Overlapping groups, defined for convenience.

extra_platforms.group_data.ALL_GROUPS: frozenset[Group] = frozenset({Group(id='unix_without_macos', name='Any Unix excluding macOS', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'})), Group(id='unix', name='Any Unix', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'})), Group(id='any_windows', name='Any Windows', platform_ids=frozenset({'windows'})), Group(id='other_unix', name='Any other Unix', platform_ids=frozenset({'hurd'})), Group(id='system_v', name='Any Unix derived from AT&T System Five', platform_ids=frozenset({'aix', 'solaris'})), Group(id='unix_layers', name='Any Unix compatibility layers', platform_ids=frozenset({'cygwin'})), Group(id='linux', name='Any Linux distribution', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'altlinux', 'tuxedo'})), Group(id='bsd_without_macos', name='Any BSD excluding macOS', platform_ids=frozenset({'freebsd', 'midnightbsd', 'sunos', 'openbsd', 'netbsd'})), Group(id='bsd', name='Any BSD', platform_ids=frozenset({'freebsd', 'midnightbsd', 'macos', 'sunos', 'openbsd', 'netbsd'})), Group(id='linux_layers', name='Any Linux compatibility layers', platform_ids=frozenset({'wsl2', 'wsl1'})), Group(id='linux_like', name='Any Linux and compatibility layers', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'sles', 'debian', 'ubuntu', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'kvmibm', 'rocky', 'arch', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'tuxedo'})), Group(id='all_platforms', name='All platforms', platform_ids=frozenset({'buildroot', 'oracle', 'opensuse', 'rhel', 'macos', 'wsl2', 'centos', 'slackware', 'ibm_powerkvm', 'nobara', 'openbsd', 'hurd', 'solaris', 'android', 'exherbo', 'amzn', 'linuxmint', 'parallels', 'mageia', 'pidora', 'scientific', 'tumbleweed', 'gentoo', 'raspbian', 'midnightbsd', 'sles', 'debian', 'ubuntu', 'windows', 'fedora', 'xenserver', 'cloudlinux', 'guix', 'freebsd', 'kvmibm', 'rocky', 'arch', 'cygwin', 'mandriva', 'unknown_linux', 'wsl1', 'altlinux', 'sunos', 'tuxedo', 'netbsd', 'aix'}))})¶: All groups.

Groups¶

OS families¶

Other groups¶

extra_platforms.group API¶

extra_platforms.group_data API¶

`extra_platforms.group` API¶

`extra_platforms.group_data` API¶