Ravenports generated: 23 Feb 2022 02:10
[ravenports.git] / bucket_B8 / python-distro
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-distro
4 VERSION=                1.7.0
5 KEYWORDS=               python
6 VARIANTS=               py39 py310
7 SDESC[py310]=           Distro - an OS platform information API (3.10)
8 SDESC[py39]=            Distro - an OS platform information API (3.9)
9 HOMEPAGE=               https://github.com/python-distro/distro
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/e1/54/d08d1ad53788515392bec14d2d6e8c410bffdc127780a9a4aa8e6854d502
14 DISTFILE[1]=            distro-1.7.0-py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[py39]=            single
18
19 OPTIONS_AVAILABLE=      PY39 PY310
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY39=OFF PY310=ON
22 VOPTS[py39]=            PY39=ON PY310=OFF
23
24 DISTNAME=               distro-1.7.0.dist-info
25
26 GENERATED=              yes
27
28 [PY39].USES_ON=                         python:py39,wheel
29
30 [PY310].USES_ON=                        python:py310,wheel
31
32 [FILE:2419:descriptions/desc.single]
33 Distro - an OS platform information API
34 =======================================
35
36 [CI Status]
37 [PyPI version]
38 [Supported Python Versions]
39 [Code Coverage]
40 [Is Wheel]
41 [Latest Github Release]
42 [![Join the chat at
43 https://gitter.im/python-distro/distro]](https://gitter.im/python-distro/distro?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
44
45 `distro` provides information about the
46 OS distribution it runs on, such as a reliable machine-readable ID, or
47 version information.
48
49 It is the recommended replacement for Python's original
50 [`platform.linux_distribution`]
51 function (removed in Python 3.8). It also provides much more functionality
52 which isn't necessarily Python bound, like a command-line interface.
53
54 Distro currently supports Linux and BSD based systems but [Windows and OS X
55 support] is also planned.
56
57 For Python 2.6 support, see
58 https://github.com/python-distro/distro/tree/python2.6-support
59
60 ## Installation
61
62 Installation of the latest released version from PyPI:
63
64 `shell
65 pip install distro
66 `
67
68 Installation of the latest development version:
69
70 ```shell
71 pip install https://github.com/python-distro/distro/archive/master.tar.gz
72 ```
73
74 To use as a standalone script, download `distro.py` directly:
75
76 ```shell
77 curl -O
78 https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
79 python distro.py
80 `
81
82 distro`` is safe to vendor within projects that do not wish to add
83 dependencies.
84
85 ```shell
86 cd myproject
87 curl -O
88 https://raw.githubusercontent.com/python-distro/distro/master/src/distro/distro.py
89 ```
90
91 ## Usage
92
93 ```bash
94 $ distro
95 Name: Antergos Linux
96 Version: 2015.10 (ISO-Rolling)
97 Codename: ISO-Rolling
98
99 $ distro -j
100 {
101     "codename": "ISO-Rolling",
102     "id": "antergos",
103     "like": "arch",
104     "version": "16.9",
105     "version_parts": {
106         "build_number": "",
107         "major": "16",
108         "minor": "9"
109     }
110 }
111
112 $ python
113 >>> import distro
114 >>> distro.linux_distribution(full_distribution_name=False)
115 ('centos', '7.1.1503', 'Core')
116 ```
117
118 ## Documentation
119
120 On top of the aforementioned API, several more functions are available. For
121 a complete description of the
122 API, see the [latest API documentation].
123
124 ## Background
125
126 An alternative implementation became necessary because Python 3.5
127 deprecated
128 this function, and Python 3.8 removed it altogether. Its predecessor
129 function
130 [`platform.dist`]
131 was already deprecated since Python 2.6 and removed in Python 3.8. Still,
132 there
133
134
135 [FILE:108:distinfo]
136 d596311d707e692c2160c37807f83e3820c5d539d5a83e87cfb6babd8ba3a06b        20096 distro-1.7.0-py3-none-any.whl
137