Detection¶
extra_platforms.detection API¶
Heuristics to detect platforms.
This collection of heuristics is designed as a set of separate function with minimal logic and dependencies.
All these heuristics can be hard-cached as the underlying system is not changing between code execution. They are still allowed to depends on each others, as long as you’re careful of not implementing circular dependencies.
Warning
Even if highly unlikely, it is possible to have multiple platforms detected for the same environment.
Typical example is Ubuntu WSL, which
will make both the is_wsl2() and is_ubuntu() functions return True at
the same time.
That’s because of the environment metadata, where:
$ uname -a
Linux 5.15.167.4-microsoft-standard-WSL2
$ cat /etc/os-release
PRETTY_NAME="Ubuntu 22.04.5 LTS"
That way we have the possibility elsewhere in extra-platforms to either decide
if we only allow one, and only one, heuristic to match the current system, or allow
for considering multiple systems at the same time.
Detection of Linux distribution rely on distro to gather as much details as possible.
And also because it is the recommended replacement for Python’s original
platform.linux_distribution function (which was removed in Python 3.8).
For all other platforms, we either rely on: - `sys.platform
environment variables
- extra_platforms.detection.is_altlinux()[source]¶
Return True if current platform is ALT Linux.
- Return type:
- extra_platforms.detection.is_amzn()[source]¶
Return True if current platform is Amazon Linux.
- Return type:
- extra_platforms.detection.is_android()[source]¶
Return True if current platform is Android.
Source: https://github.com/kivy/kivy/blob/master/kivy/utils.py#L429
- Return type:
- extra_platforms.detection.is_arch()[source]¶
Return True if current platform is Arch Linux.
- Return type:
- extra_platforms.detection.is_buildroot()[source]¶
Return True if current platform is Buildroot.
- Return type:
- extra_platforms.detection.is_centos()[source]¶
Return True if current platform is CentOS.
- Return type:
- extra_platforms.detection.is_cloudlinux()[source]¶
Return True if current platform is CloudLinux OS.
- Return type:
- extra_platforms.detection.is_cygwin()[source]¶
Return True if current platform is Cygwin.
- Return type:
- extra_platforms.detection.is_debian()[source]¶
Return True if current platform is Debian.
- Return type:
- extra_platforms.detection.is_exherbo()[source]¶
Return True if current platform is Exherbo Linux.
- Return type:
- extra_platforms.detection.is_fedora()[source]¶
Return True if current platform is Fedora.
- Return type:
- extra_platforms.detection.is_freebsd()[source]¶
Return True if current platform is FreeBSD.
- Return type:
- extra_platforms.detection.is_gentoo()[source]¶
Return True if current platform is GenToo Linux.
- Return type:
- extra_platforms.detection.is_guix()[source]¶
Return True if current platform is Guix System.
- Return type:
- extra_platforms.detection.is_hurd()[source]¶
Return True if current platform is GNU/Hurd.
- Return type:
- extra_platforms.detection.is_ibm_powerkvm()[source]¶
Return True if current platform is IBM PowerKVM.
- Return type:
- extra_platforms.detection.is_kvmibm()[source]¶
Return True if current platform is KVM for IBM z Systems.
- Return type:
- extra_platforms.detection.is_linuxmint()[source]¶
Return True if current platform is Linux Mint.
- Return type:
- extra_platforms.detection.is_macos()[source]¶
Return True if current platform is macOS.
- Return type:
- extra_platforms.detection.is_mageia()[source]¶
Return True if current platform is Mageia.
- Return type:
- extra_platforms.detection.is_mandriva()[source]¶
Return True if current platform is Mandriva Linux.
- Return type:
- extra_platforms.detection.is_midnightbsd()[source]¶
Return True if current platform is MidnightBSD.
- Return type:
- extra_platforms.detection.is_netbsd()[source]¶
Return True if current platform is NetBSD.
- Return type:
- extra_platforms.detection.is_nobara()[source]¶
Return True if current platform is Nobara Linux.
- Return type:
- extra_platforms.detection.is_openbsd()[source]¶
Return True if current platform is OpenBSD.
- Return type:
- extra_platforms.detection.is_opensuse()[source]¶
Return True if current platform is openSUSE.
- Return type:
- extra_platforms.detection.is_oracle()[source]¶
Return True if current platform is Oracle Linux (and Oracle Enterprise Linux).
- Return type:
- extra_platforms.detection.is_parallels()[source]¶
Return True if current platform is Parallels.
- Return type:
- extra_platforms.detection.is_pidora()[source]¶
Return True if current platform is Pidora.
- Return type:
- extra_platforms.detection.is_raspbian()[source]¶
Return True if current platform is Raspbian.
- Return type:
- extra_platforms.detection.is_rhel()[source]¶
Return True if current platform is RedHat Enterprise Linux.
- Return type:
- extra_platforms.detection.is_rocky()[source]¶
Return True if current platform is Rocky Linux.
- Return type:
- extra_platforms.detection.is_scientific()[source]¶
Return True if current platform is Scientific Linux.
- Return type:
- extra_platforms.detection.is_slackware()[source]¶
Return True if current platform is Slackware.
- Return type:
- extra_platforms.detection.is_sles()[source]¶
Return True if current platform is SUSE Linux Enterprise Server.
- Return type:
- extra_platforms.detection.is_solaris()[source]¶
Return True if current platform is Solaris.
- Return type:
- extra_platforms.detection.is_sunos()[source]¶
Return True if current platform is SunOS.
- Return type:
- extra_platforms.detection.is_tumbleweed()[source]¶
Return True if current platform is openSUSE Tumbleweed.
- Return type:
- extra_platforms.detection.is_tuxedo()[source]¶
Return True if current platform is Tuxedo OS.
- Return type:
- extra_platforms.detection.is_ubuntu()[source]¶
Return True if current platform is Ubuntu.
- Return type:
- extra_platforms.detection.is_unknown_linux()[source]¶
Return True if current platform is an unknown Linux.
- Return type:
- extra_platforms.detection.is_windows()[source]¶
Return True if current platform is Windows.
- Return type:
- extra_platforms.detection.is_wsl1()[source]¶
Return True if current platform is running over Windows Subsystem for Linux v1. :rtype:
boolCaution
The only difference between WSL1 and WSL2 is the case of the kernel release version:
WSL 1:
$ uname -r 4.4.0-22572-Microsoft
WSL 2:
$ uname -r 5.10.102.1-microsoft-standard-WSL2