loongson/pypi/: distro-1.7.0 metadata and description

Homepage Simple index

Distro - an OS platform information API

author Nir Cohen
author_email nir36g@gmail.com
classifiers
  • Development Status :: 5 - Production/Stable
  • Intended Audience :: Developers
  • Intended Audience :: System Administrators
  • License :: OSI Approved :: Apache Software License
  • Operating System :: POSIX :: Linux
  • Operating System :: POSIX :: BSD
  • Operating System :: POSIX :: BSD :: FreeBSD
  • Operating System :: POSIX :: BSD :: NetBSD
  • Operating System :: POSIX :: BSD :: OpenBSD
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3 :: Only
  • Programming Language :: Python :: 3.6
  • Programming Language :: Python :: 3.7
  • Programming Language :: Python :: 3.8
  • Programming Language :: Python :: 3.9
  • Programming Language :: Python :: 3.10
  • Topic :: Software Development :: Libraries :: Python Modules
  • Topic :: System :: Operating System
description_content_type text/markdown
license Apache License, Version 2.0
platform
  • All
requires_python >=3.6

Because this project isn't in the mirror_whitelist, no releases from root/pypi are included.

File Tox results History
distro-1.7.0-py3-none-any.whl
Size
20 KB
Type
Python Wheel
Python
3
  • Replaced 1 time(s)
  • Uploaded to loongson/pypi by loongson 2022-09-09 03:07:37
distro-1.7.0.tar.gz
Size
57 KB
Type
Source

Distro - an OS platform information API

CI Status PyPI version Supported Python Versions Code Coverage Is Wheel Latest Github Release Join the chat at https://gitter.im/python-distro/distro

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 (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/python-distro/distro/tree/python2.6-support

Installation

Installation of the latest released version from PyPI:

pip install distro

Installation of the latest development version:

pip install https://github.com/python-distro/distro/archive/master.tar.gz

To use as a standalone script, download distro.py directly:

curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
python distro.py

distro is safe to vendor within projects that do not wish to add dependencies.

cd myproject
curl -O https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py

Usage

$ 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')

Documentation

On top of the aforementioned API, several more functions are available. For a complete description of the API, see the latest API documentation.

Background

An alternative implementation became necessary because Python 3.5 deprecated this function, and Python 3.8 removed it altogether. Its predecessor function platform.dist was already deprecated since Python 2.6 and 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):

Python and Distribution Support

distro is supported and tested on Python 3.6+ 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.

Testing

git clone git@github.com:python-distro/distro.git
cd distro
pip install tox
tox

Contributions

Pull 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:

Package manager distributions