distro provides information about the
OS distribution it runs on, such as a reliable machine-readable ID, or
version information.
It is the recommended replacement for Python's original
platform.linux_distribution
function (which will be removed in Python 3.8).
It also provides much more functionality which isn't necessarily Python bound,
like a command-line interface.
Distro currently supports Linux and BSD based systems but Windows and OS X support is also planned.
For Python 2.6 support, see https://github.com/nir0s/distro/tree/python2.6-support
Installation of the latest released version from PyPI:
pip install distroInstallation of the latest development version:
pip install https://github.com/nir0s/distro/archive/master.tar.gz$ distro
Name: Antergos Linux
Version: 2015.10 (ISO-Rolling)
Codename: ISO-Rolling
$ distro -j
{
"codename": "ISO-Rolling",
"id": "antergos",
"like": "arch",
"version": "16.9",
"version_parts": {
"build_number": "",
"major": "16",
"minor": "9"
}
}
$ python
>>> import distro
>>> distro.linux_distribution(full_distribution_name=False)
('centos', '7.1.1503', 'Core')On top of the aforementioned API, several more functions are available. For a complete description of the API, see the latest API documentation.
An alternative implementation became necessary because Python 3.5 deprecated
this function, and Python 3.8 will remove it altogether.
Its predecessor function platform.dist was already deprecated since
Python 2.6 and will also be removed in Python 3.8.
Still, there are many cases in which access to that information is needed.
See Python issue 1322 for more
information.
The distro package implements a robust and inclusive way of retrieving the
information about a distribution based on new standards and old methods,
namely from these data sources (from high to low precedence):
- The os-release file
/etc/os-release, if present. - The output of the
lsb_releasecommand, if available. - The distro release file (
/etc/*(-|_)(release|version)), if present. - The
unamecommand for BSD based distrubtions.
distro is supported and tested on Python 2.7, 3.4+ and PyPy and on
any distribution that provides one or more of the data sources
covered.
This package is tested with test data that mimics the exact behavior of the data sources of a number of Linux distributions.
git clone git@github.com:nir0s/distro.git
cd distro
pip install tox
toxPull requests are always welcome to deal with specific distributions or just for general merriment.
See CONTRIBUTIONS for contribution info.
Reference implementations for supporting additional distributions and file formats can be found here:
- https://github.com/saltstack/salt/blob/develop/salt/grains/core.py#L1172
- https://github.com/chef/ohai/blob/master/lib/ohai/plugins/linux/platform.rb
- https://github.com/ansible/ansible/blob/devel/lib/ansible/module_utils/facts/system/distribution.py
- https://github.com/puppetlabs/facter/blob/master/lib/src/facts/linux/os_linux.cc
- https://src.fedoraproject.org/rpms/python-distro
- https://www.archlinux.org/packages/community/any/python-distro/
- https://launchpad.net/ubuntu/+source/python-distro
- https://packages.debian.org/sid/python-distro
- https://packages.gentoo.org/packages/dev-python/distro
- https://pkgs.org/download/python2-distro
- https://slackbuilds.org/repository/14.2/python/python-distro/