# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-distro
VERSION=		1.9.0
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		Distro - an OS platform information API (3.12)
SDESC[v13]=		Distro - an OS platform information API (3.13)
HOMEPAGE=		https://github.com/python-distro/distro
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/12/b3/231ffd4ab1fc9d679809f356cebee130ac7daa00d6d6f3206dd4fd137e9e
DISTFILE[1]=		distro-1.9.0-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		distro-1.9.0.dist-info

GENERATED=		yes

[PY312].USES_ON=			python:v12,wheel

[PY313].USES_ON=			python:v13,wheel

[FILE:2185:descriptions/desc.single]
Distro - an OS platform information API
=======================================

[CI Status]
[PyPI version]
[Supported Python Versions]
[Code Coverage]
[Is Wheel]
[Latest Github Release]

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

`shell
pip install distro
`

Installation of the latest development version:

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

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

```shell
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.

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

## Usage

```bash
$ 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.name(pretty=True)
'CentOS Linux 8'
>>> distro.id()
'centos'
>>> distro.version(best=True)
'8.4.2105'
```

## 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`]


[FILE:119:distinfo]
7bffd925d65168f85027d8da9af6bddab658135b840670a223589bc0c8ef02b2        20277 python-src/distro-1.9.0-py3-none-any.whl