Data Structures
class	cached_property

class	InfoDict

class	LinuxDistribution

class	VersionDict

Functions
Tuple[str, str, str]	linux_distribution (bool full_distribution_name=True)

str	id ()

str	name (bool pretty=False)

str	version (bool pretty=False, bool best=False)

Tuple[str, str, str]	version_parts (bool best=False)

str	major_version (bool best=False)

str	minor_version (bool best=False)

str	build_number (bool best=False)

str	like ()

str	codename ()

InfoDict	info (bool pretty=False, bool best=False)

Dict[str, str]	os_release_info ()

Dict[str, str]	lsb_release_info ()

Dict[str, str]	distro_release_info ()

Dict[str, str]	uname_info ()

str	os_release_attr (str attribute)

str	lsb_release_attr (str attribute)

str	distro_release_attr (str attribute)

str	uname_attr (str attribute)

None	main ()

Variables
	TypedDict = dict

	_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc")

	_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib")

str	_OS_RELEASE_BASENAME = "os-release"

dict	NORMALIZED_OS_ID

dict	NORMALIZED_LSB_ID

dict	NORMALIZED_DISTRO_ID

	_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN

	_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release\|version)$")

list	_DISTRO_RELEASE_BASENAMES

tuple	_DISTRO_RELEASE_IGNORE_BASENAMES

	_distro = LinuxDistribution()

Detailed Description

The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.

It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 removed it altogether. Its
predecessor function :py:func:`platform.dist` was already deprecated since
Python 2.6 and removed in Python 3.8. Still, there are many cases in which
access to OS distribution information is needed. See `Python issue 1322
<https://bugs.python.org/issue1322>`_ for more information.

Function Documentation

◆ build_number()

str build_number ( bool best = False )

Return the build number of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The build number is the third part
of the dot-separated version string.

For a description of the *best* parameter, see the :func:`distro.version`
method.

Definition at line 413 of file distro.py.

def build_number(best: bool = False) -> str:
    """
    Return the build number of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The build number is the third part
    of the dot-separated version string.
 
    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.build_number(best)
 
 

References i.

◆ codename()

str codename ( )

Return the codename for the release of the current OS distribution,
as a string.

If the distribution does not have a codename, an empty string is returned.

Note that the returned codename is not always really a codename. For
example, openSUSE returns "x86_64". This function does not handle such
cases in any special way and just returns the string it finds, if any.

**Lookup hierarchy:**

* the codename within the "VERSION" attribute of the os-release file, if
  provided,

* the value of the "Codename" attribute returned by the lsb_release
  command,

* the value of the "<codename>" field of the distro release file.

Definition at line 443 of file distro.py.

def codename() -> str:
    """
    Return the codename for the release of the current OS distribution,
    as a string.
 
    If the distribution does not have a codename, an empty string is returned.
 
    Note that the returned codename is not always really a codename. For
    example, openSUSE returns "x86_64". This function does not handle such
    cases in any special way and just returns the string it finds, if any.
 
    **Lookup hierarchy:**
 
    * the codename within the "VERSION" attribute of the os-release file, if
      provided,
 
    * the value of the "Codename" attribute returned by the lsb_release
      command,
 
    * the value of the "<codename>" field of the distro release file.
    """
    return _distro.codename()
 
 

References i.

◆ distro_release_attr()

str distro_release_attr ( str attribute )

Return a single named information item from the distro release file
data source of the current OS distribution.

Parameters:

* ``attribute`` (string): Key of the information item.

Returns:

* (string): Value of the information item, if the item exists.
  The empty string, if the item does not exist.

See `distro release file`_ for details about these information items.

Definition at line 589 of file distro.py.

def distro_release_attr(attribute: str) -> str:
    """
    Return a single named information item from the distro release file
    data source of the current OS distribution.
 
    Parameters:
 
    * ``attribute`` (string): Key of the information item.
 
    Returns:
 
    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.
 
    See `distro release file`_ for details about these information items.
    """
    return _distro.distro_release_attr(attribute)
 
 

References i.

◆ distro_release_info()

Dict[str, str] distro_release_info ( )

Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.

See `distro release file`_ for details about these information items.

Definition at line 532 of file distro.py.

def distro_release_info() -> Dict[str, str]:
    """
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.
 
    See `distro release file`_ for details about these information items.
    """
    return _distro.distro_release_info()
 
 

References i.

◆ id()

str id ( )

Return the distro ID of the current distribution, as a
machine-readable string.

For a number of OS distributions, the returned distro ID value is
*reliable*, in the sense that it is documented and that it does not change
across releases of the distribution.

This package maintains the following reliable distro ID values:

==============  =========================================
Distro ID       Distribution
==============  =========================================
"ubuntu"        Ubuntu
"debian"        Debian
"rhel"          RedHat Enterprise Linux
"centos"        CentOS
"fedora"        Fedora
"sles"          SUSE Linux Enterprise Server
"opensuse"      openSUSE
"amzn"          Amazon Linux
"arch"          Arch Linux
"buildroot"     Buildroot
"cloudlinux"    CloudLinux OS
"exherbo"       Exherbo Linux
"gentoo"        GenToo Linux
"ibm_powerkvm"  IBM PowerKVM
"kvmibm"        KVM for IBM z Systems
"linuxmint"     Linux Mint
"mageia"        Mageia
"mandriva"      Mandriva Linux
"parallels"     Parallels
"pidora"        Pidora
"raspbian"      Raspbian
"oracle"        Oracle Linux (and Oracle Enterprise Linux)
"scientific"    Scientific Linux
"slackware"     Slackware
"xenserver"     XenServer
"openbsd"       OpenBSD
"netbsd"        NetBSD
"freebsd"       FreeBSD
"midnightbsd"   MidnightBSD
"rocky"         Rocky Linux
"aix"           AIX
"guix"          Guix System
==============  =========================================

If you have a need to get distros for reliable IDs added into this set,
or if you find that the :func:`distro.id` function returns a different
distro ID for one of the listed distros, please create an issue in the
`distro issue tracker`_.

**Lookup hierarchy and transformations:**

First, the ID is obtained from the following sources, in the specified
order. The first available and non-empty value is used:

* the value of the "ID" attribute of the os-release file,

* the value of the "Distributor ID" attribute returned by the lsb_release
  command,

* the first part of the file name of the distro release file,

The so determined ID value then passes the following transformations,
before it is returned by this method:

* it is translated to lower case,

* blanks (which should not be there anyway) are translated to underscores,

* a normalization of the ID is performed, based upon
  `normalization tables`_. The purpose of this normalization is to ensure
  that the ID is as reliable as possible, even across incompatible changes
  in the OS distributions. A common reason for an incompatible change is
  the addition of an os-release file, or the addition of the lsb_release
  command, with ID values that differ from what was previously determined
  from the distro release file name.

Definition at line 200 of file distro.py.

def id() -> str:
    """
    Return the distro ID of the current distribution, as a
    machine-readable string.
 
    For a number of OS distributions, the returned distro ID value is
    *reliable*, in the sense that it is documented and that it does not change
    across releases of the distribution.
 
    This package maintains the following reliable distro ID values:
 
    ==============  =========================================
    Distro ID       Distribution
    ==============  =========================================
    "ubuntu"        Ubuntu
    "debian"        Debian
    "rhel"          RedHat Enterprise Linux
    "centos"        CentOS
    "fedora"        Fedora
    "sles"          SUSE Linux Enterprise Server
    "opensuse"      openSUSE
    "amzn"          Amazon Linux
    "arch"          Arch Linux
    "buildroot"     Buildroot
    "cloudlinux"    CloudLinux OS
    "exherbo"       Exherbo Linux
    "gentoo"        GenToo Linux
    "ibm_powerkvm"  IBM PowerKVM
    "kvmibm"        KVM for IBM z Systems
    "linuxmint"     Linux Mint
    "mageia"        Mageia
    "mandriva"      Mandriva Linux
    "parallels"     Parallels
    "pidora"        Pidora
    "raspbian"      Raspbian
    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
    "scientific"    Scientific Linux
    "slackware"     Slackware
    "xenserver"     XenServer
    "openbsd"       OpenBSD
    "netbsd"        NetBSD
    "freebsd"       FreeBSD
    "midnightbsd"   MidnightBSD
    "rocky"         Rocky Linux
    "aix"           AIX
    "guix"          Guix System
    ==============  =========================================
 
    If you have a need to get distros for reliable IDs added into this set,
    or if you find that the :func:`distro.id` function returns a different
    distro ID for one of the listed distros, please create an issue in the
    `distro issue tracker`_.
 
    **Lookup hierarchy and transformations:**
 
    First, the ID is obtained from the following sources, in the specified
    order. The first available and non-empty value is used:
 
    * the value of the "ID" attribute of the os-release file,
 
    * the value of the "Distributor ID" attribute returned by the lsb_release
      command,
 
    * the first part of the file name of the distro release file,
 
    The so determined ID value then passes the following transformations,
    before it is returned by this method:
 
    * it is translated to lower case,
 
    * blanks (which should not be there anyway) are translated to underscores,
 
    * a normalization of the ID is performed, based upon
      `normalization tables`_. The purpose of this normalization is to ensure
      that the ID is as reliable as possible, even across incompatible changes
      in the OS distributions. A common reason for an incompatible change is
      the addition of an os-release file, or the addition of the lsb_release
      command, with ID values that differ from what was previously determined
      from the distro release file name.
    """
    return _distro.id()
 
 

References i.

◆ info()

InfoDict info	(	bool	pretty = `False`,
		bool	best = `False`
	)

Return certain machine-readable information items about the current OS
distribution in a dictionary, as shown in the following example:

.. sourcecode:: python

    {
        'id': 'rhel',
        'version': '7.0',
        'version_parts': {
            'major': '7',
            'minor': '0',
            'build_number': ''
        },
        'like': 'fedora',
        'codename': 'Maipo'
    }

The dictionary structure and keys are always the same, regardless of which
information items are available in the underlying data sources. The values
for the various keys are as follows:

* ``id``:  The result of :func:`distro.id`.

* ``version``:  The result of :func:`distro.version`.

* ``version_parts -> major``:  The result of :func:`distro.major_version`.

* ``version_parts -> minor``:  The result of :func:`distro.minor_version`.

* ``version_parts -> build_number``:  The result of
  :func:`distro.build_number`.

* ``like``:  The result of :func:`distro.like`.

* ``codename``:  The result of :func:`distro.codename`.

For a description of the *pretty* and *best* parameters, see the
:func:`distro.version` method.

Definition at line 467 of file distro.py.

def info(pretty: bool = False, best: bool = False) -> InfoDict:
    """
    Return certain machine-readable information items about the current OS
    distribution in a dictionary, as shown in the following example:
 
    .. sourcecode:: python
 
        {
            'id': 'rhel',
            'version': '7.0',
            'version_parts': {
                'major': '7',
                'minor': '0',
                'build_number': ''
            },
            'like': 'fedora',
            'codename': 'Maipo'
        }
 
    The dictionary structure and keys are always the same, regardless of which
    information items are available in the underlying data sources. The values
    for the various keys are as follows:
 
    * ``id``:  The result of :func:`distro.id`.
 
    * ``version``:  The result of :func:`distro.version`.
 
    * ``version_parts -> major``:  The result of :func:`distro.major_version`.
 
    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.
 
    * ``version_parts -> build_number``:  The result of
      :func:`distro.build_number`.
 
    * ``like``:  The result of :func:`distro.like`.
 
    * ``codename``:  The result of :func:`distro.codename`.
 
    For a description of the *pretty* and *best* parameters, see the
    :func:`distro.version` method.
    """
    return _distro.info(pretty, best)
 
 

References i.

◆ like()

str like ( )

Return a space-separated list of distro IDs of distributions that are
closely related to the current OS distribution in regards to packaging
and programming interfaces, for example distributions the current
distribution is a derivative from.

**Lookup hierarchy:**

This information item is only provided by the os-release file.
For details, see the description of the "ID_LIKE" attribute in the
`os-release man page
<http://www.freedesktop.org/software/systemd/man/os-release.html>`_.

Definition at line 426 of file distro.py.

def like() -> str:
    """
    Return a space-separated list of distro IDs of distributions that are
    closely related to the current OS distribution in regards to packaging
    and programming interfaces, for example distributions the current
    distribution is a derivative from.
 
    **Lookup hierarchy:**
 
    This information item is only provided by the os-release file.
    For details, see the description of the "ID_LIKE" attribute in the
    `os-release man page
    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
    """
    return _distro.like()
 
 

References i.

◆ linux_distribution()

Tuple[str, str, str] linux_distribution ( bool full_distribution_name = True )

.. deprecated:: 1.6.0

    :func:`distro.linux_distribution()` is deprecated. It should only be
    used as a compatibility shim with Python's
    :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
    :func:`distro.version` and :func:`distro.name` instead.

Return information about the current OS distribution as a tuple
``(id_name, version, codename)`` with items as follows:

* ``id_name``:  If *full_distribution_name* is false, the result of
  :func:`distro.id`. Otherwise, the result of :func:`distro.name`.

* ``version``:  The result of :func:`distro.version`.

* ``codename``:  The extra item (usually in parentheses) after the
  os-release version number, or the result of :func:`distro.codename`.

The interface of this function is compatible with the original
:py:func:`platform.linux_distribution` function, supporting a subset of
its parameters.

The data it returns may not exactly be the same, because it uses more data
sources than the original function, and that may lead to different data if
the OS distribution is not consistent across multiple data sources it
provides (there are indeed such distributions ...).

Another reason for differences is the fact that the :func:`distro.id`
method normalizes the distro ID string to a reliable machine-readable value
for a number of popular OS distributions.

Definition at line 157 of file distro.py.

def linux_distribution(full_distribution_name: bool = True) -> Tuple[str, str, str]:
    """
    .. deprecated:: 1.6.0
 
        :func:`distro.linux_distribution()` is deprecated. It should only be
        used as a compatibility shim with Python's
        :py:func:`platform.linux_distribution()`. Please use :func:`distro.id`,
        :func:`distro.version` and :func:`distro.name` instead.
 
    Return information about the current OS distribution as a tuple
    ``(id_name, version, codename)`` with items as follows:
 
    * ``id_name``:  If *full_distribution_name* is false, the result of
      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.
 
    * ``version``:  The result of :func:`distro.version`.
 
    * ``codename``:  The extra item (usually in parentheses) after the
      os-release version number, or the result of :func:`distro.codename`.
 
    The interface of this function is compatible with the original
    :py:func:`platform.linux_distribution` function, supporting a subset of
    its parameters.
 
    The data it returns may not exactly be the same, because it uses more data
    sources than the original function, and that may lead to different data if
    the OS distribution is not consistent across multiple data sources it
    provides (there are indeed such distributions ...).
 
    Another reason for differences is the fact that the :func:`distro.id`
    method normalizes the distro ID string to a reliable machine-readable value
    for a number of popular OS distributions.
    """
    warnings.warn(
        "distro.linux_distribution() is deprecated. It should only be used as a "
        "compatibility shim with Python's platform.linux_distribution(). Please use "
        "distro.id(), distro.version() and distro.name() instead.",
        DeprecationWarning,
        stacklevel=2,
    )
    return _distro.linux_distribution(full_distribution_name)
 
 

References i.

◆ lsb_release_attr()

str lsb_release_attr ( str attribute )

Return a single named information item from the lsb_release command output
data source of the current OS distribution.

Parameters:

* ``attribute`` (string): Key of the information item.

Returns:

* (string): Value of the information item, if the item exists.
  The empty string, if the item does not exist.

See `lsb_release command output`_ for details about these information
items.

Definition at line 569 of file distro.py.

def lsb_release_attr(attribute: str) -> str:
    """
    Return a single named information item from the lsb_release command output
    data source of the current OS distribution.
 
    Parameters:
 
    * ``attribute`` (string): Key of the information item.
 
    Returns:
 
    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.
 
    See `lsb_release command output`_ for details about these information
    items.
    """
    return _distro.lsb_release_attr(attribute)
 
 

References i.

◆ lsb_release_info()

Dict[str, str] lsb_release_info ( )

Return a dictionary containing key-value pairs for the information items
from the lsb_release command data source of the current OS distribution.

See `lsb_release command output`_ for details about these information
items.

Definition at line 521 of file distro.py.

def lsb_release_info() -> Dict[str, str]:
    """
    Return a dictionary containing key-value pairs for the information items
    from the lsb_release command data source of the current OS distribution.
 
    See `lsb_release command output`_ for details about these information
    items.
    """
    return _distro.lsb_release_info()
 
 

References i.

◆ main()

None main ( )

Definition at line 1358 of file distro.py.

def main() -> None:
    logger = logging.getLogger(__name__)
    logger.setLevel(logging.DEBUG)
    logger.addHandler(logging.StreamHandler(sys.stdout))
 
    parser = argparse.ArgumentParser(description="OS distro info tool")
    parser.add_argument(
        "--json", "-j", help="Output in machine readable format", action="store_true"
    )
 
    parser.add_argument(
        "--root-dir",
        "-r",
        type=str,
        dest="root_dir",
        help="Path to the root filesystem directory (defaults to /)",
    )
 
    args = parser.parse_args()
 
    if args.root_dir:
        dist = LinuxDistribution(
            include_lsb=False,
            include_uname=False,
            include_oslevel=False,
            root_dir=args.root_dir,
        )
    else:
        dist = _distro
 
    if args.json:
        logger.info(json.dumps(dist.info(), indent=4, sort_keys=True))
    else:
        logger.info("Name: %s", dist.name(pretty=True))
        distribution_version = dist.version(pretty=True)
        logger.info("Version: %s", distribution_version)
        distribution_codename = dist.codename()
        logger.info("Codename: %s", distribution_codename)
 
 

References i, and pip._vendor.distro.distro.main().

Referenced by pip._vendor.distro.distro.main().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ major_version()

str major_version ( bool best = False )

Return the major version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The major version is the first
part of the dot-separated version string.

For a description of the *best* parameter, see the :func:`distro.version`
method.

Definition at line 387 of file distro.py.

def major_version(best: bool = False) -> str:
    """
    Return the major version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The major version is the first
    part of the dot-separated version string.
 
    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.major_version(best)
 
 

References i.

◆ minor_version()

str minor_version ( bool best = False )

Return the minor version of the current OS distribution, as a string,
if provided.
Otherwise, the empty string is returned. The minor version is the second
part of the dot-separated version string.

For a description of the *best* parameter, see the :func:`distro.version`
method.

Definition at line 400 of file distro.py.

def minor_version(best: bool = False) -> str:
    """
    Return the minor version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The minor version is the second
    part of the dot-separated version string.
 
    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.minor_version(best)
 
 

References i.

◆ name()

str name ( bool pretty = False )

Return the name of the current OS distribution, as a human-readable
string.

If *pretty* is false, the name is returned without version or codename.
(e.g. "CentOS Linux")

If *pretty* is true, the version and codename are appended.
(e.g. "CentOS Linux 7.1.1503 (Core)")

**Lookup hierarchy:**

The name is obtained from the following sources, in the specified order.
The first available and non-empty value is used:

* If *pretty* is false:

  - the value of the "NAME" attribute of the os-release file,

  - the value of the "Distributor ID" attribute returned by the lsb_release
    command,

  - the value of the "<name>" field of the distro release file.

* If *pretty* is true:

  - the value of the "PRETTY_NAME" attribute of the os-release file,

  - the value of the "Description" attribute returned by the lsb_release
    command,

  - the value of the "<name>" field of the distro release file, appended
    with the value of the pretty version ("<version_id>" and "<codename>"
    fields) of the distro release file, if available.

Definition at line 283 of file distro.py.

def name(pretty: bool = False) -> str:
    """
    Return the name of the current OS distribution, as a human-readable
    string.
 
    If *pretty* is false, the name is returned without version or codename.
    (e.g. "CentOS Linux")
 
    If *pretty* is true, the version and codename are appended.
    (e.g. "CentOS Linux 7.1.1503 (Core)")
 
    **Lookup hierarchy:**
 
    The name is obtained from the following sources, in the specified order.
    The first available and non-empty value is used:
 
    * If *pretty* is false:
 
      - the value of the "NAME" attribute of the os-release file,
 
      - the value of the "Distributor ID" attribute returned by the lsb_release
        command,
 
      - the value of the "<name>" field of the distro release file.
 
    * If *pretty* is true:
 
      - the value of the "PRETTY_NAME" attribute of the os-release file,
 
      - the value of the "Description" attribute returned by the lsb_release
        command,
 
      - the value of the "<name>" field of the distro release file, appended
        with the value of the pretty version ("<version_id>" and "<codename>"
        fields) of the distro release file, if available.
    """
    return _distro.name(pretty)
 
 

References i.

◆ os_release_attr()

str os_release_attr ( str attribute )

Return a single named information item from the os-release file data source
of the current OS distribution.

Parameters:

* ``attribute`` (string): Key of the information item.

Returns:

* (string): Value of the information item, if the item exists.
  The empty string, if the item does not exist.

See `os-release file`_ for details about these information items.

Definition at line 550 of file distro.py.

def os_release_attr(attribute: str) -> str:
    """
    Return a single named information item from the os-release file data source
    of the current OS distribution.
 
    Parameters:
 
    * ``attribute`` (string): Key of the information item.
 
    Returns:
 
    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.
 
    See `os-release file`_ for details about these information items.
    """
    return _distro.os_release_attr(attribute)
 
 

References i.

◆ os_release_info()

Dict[str, str] os_release_info ( )

Return a dictionary containing key-value pairs for the information items
from the os-release file data source of the current OS distribution.

See `os-release file`_ for details about these information items.

Definition at line 511 of file distro.py.

def os_release_info() -> Dict[str, str]:
    """
    Return a dictionary containing key-value pairs for the information items
    from the os-release file data source of the current OS distribution.
 
    See `os-release file`_ for details about these information items.
    """
    return _distro.os_release_info()
 
 

References i.

◆ uname_attr()

str uname_attr ( str attribute )

Return a single named information item from the distro release file
data source of the current OS distribution.

Parameters:

* ``attribute`` (string): Key of the information item.

Returns:

* (string): Value of the information item, if the item exists.
            The empty string, if the item does not exist.

Definition at line 608 of file distro.py.

def uname_attr(attribute: str) -> str:
    """
    Return a single named information item from the distro release file
    data source of the current OS distribution.
 
    Parameters:
 
    * ``attribute`` (string): Key of the information item.
 
    Returns:
 
    * (string): Value of the information item, if the item exists.
                The empty string, if the item does not exist.
    """
    return _distro.uname_attr(attribute)
 
 

References i.

◆ uname_info()

Dict[str, str] uname_info ( )

Return a dictionary containing key-value pairs for the information items
from the distro release file data source of the current OS distribution.

Definition at line 542 of file distro.py.

def uname_info() -> Dict[str, str]:
    """
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.
    """
    return _distro.uname_info()
 
 

References i.

◆ version()

str version	(	bool	pretty = `False`,
		bool	best = `False`
	)

Return the version of the current OS distribution, as a human-readable
string.

If *pretty* is false, the version is returned without codename (e.g.
"7.0").

If *pretty* is true, the codename in parenthesis is appended, if the
codename is non-empty (e.g. "7.0 (Maipo)").

Some distributions provide version numbers with different precisions in
the different sources of distribution information. Examining the different
sources in a fixed priority order does not always yield the most precise
version (e.g. for Debian 8.2, or CentOS 7.1).

Some other distributions may not provide this kind of information. In these
cases, an empty string would be returned. This behavior can be observed
with rolling releases distributions (e.g. Arch Linux).

The *best* parameter can be used to control the approach for the returned
version:

If *best* is false, the first non-empty version number in priority order of
the examined sources is returned.

If *best* is true, the most precise version number out of all examined
sources is returned.

**Lookup hierarchy:**

In all cases, the version number is obtained from the following sources.
If *best* is false, this order represents the priority order:

* the value of the "VERSION_ID" attribute of the os-release file,
* the value of the "Release" attribute returned by the lsb_release
  command,
* the version number parsed from the "<version_id>" field of the first line
  of the distro release file,
* the version number parsed from the "PRETTY_NAME" attribute of the
  os-release file, if it follows the format of the distro release files.
* the version number parsed from the "Description" attribute returned by
  the lsb_release command, if it follows the format of the distro release
  files.

Definition at line 322 of file distro.py.

def version(pretty: bool = False, best: bool = False) -> str:
    """
    Return the version of the current OS distribution, as a human-readable
    string.
 
    If *pretty* is false, the version is returned without codename (e.g.
    "7.0").
 
    If *pretty* is true, the codename in parenthesis is appended, if the
    codename is non-empty (e.g. "7.0 (Maipo)").
 
    Some distributions provide version numbers with different precisions in
    the different sources of distribution information. Examining the different
    sources in a fixed priority order does not always yield the most precise
    version (e.g. for Debian 8.2, or CentOS 7.1).
 
    Some other distributions may not provide this kind of information. In these
    cases, an empty string would be returned. This behavior can be observed
    with rolling releases distributions (e.g. Arch Linux).
 
    The *best* parameter can be used to control the approach for the returned
    version:
 
    If *best* is false, the first non-empty version number in priority order of
    the examined sources is returned.
 
    If *best* is true, the most precise version number out of all examined
    sources is returned.
 
    **Lookup hierarchy:**
 
    In all cases, the version number is obtained from the following sources.
    If *best* is false, this order represents the priority order:
 
    * the value of the "VERSION_ID" attribute of the os-release file,
    * the value of the "Release" attribute returned by the lsb_release
      command,
    * the version number parsed from the "<version_id>" field of the first line
      of the distro release file,
    * the version number parsed from the "PRETTY_NAME" attribute of the
      os-release file, if it follows the format of the distro release files.
    * the version number parsed from the "Description" attribute returned by
      the lsb_release command, if it follows the format of the distro release
      files.
    """
    return _distro.version(pretty, best)
 
 

References i.

◆ version_parts()

Tuple[str, str, str] version_parts ( bool best = False )

Return the version of the current OS distribution as a tuple
``(major, minor, build_number)`` with items as follows:

* ``major``:  The result of :func:`distro.major_version`.

* ``minor``:  The result of :func:`distro.minor_version`.

* ``build_number``:  The result of :func:`distro.build_number`.

For a description of the *best* parameter, see the :func:`distro.version`
method.

Definition at line 370 of file distro.py.

def version_parts(best: bool = False) -> Tuple[str, str, str]:
    """
    Return the version of the current OS distribution as a tuple
    ``(major, minor, build_number)`` with items as follows:
 
    * ``major``:  The result of :func:`distro.major_version`.
 
    * ``minor``:  The result of :func:`distro.minor_version`.
 
    * ``build_number``:  The result of :func:`distro.build_number`.
 
    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.version_parts(best)
 
 

References i.

Variable Documentation

◆ _distro

_distro = LinuxDistribution()

protected

Definition at line 1355 of file distro.py.

◆ _DISTRO_RELEASE_BASENAME_PATTERN

_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(r"(\w+)[-_](release|version)$")

protected

Definition at line 123 of file distro.py.

◆ _DISTRO_RELEASE_BASENAMES

list _DISTRO_RELEASE_BASENAMES

protected

Initial value:

=  [
    "SuSE-release",
    "arch-release",
    "base-release",
    "centos-release",
    "fedora-release",
    "gentoo-release",
    "mageia-release",
    "mandrake-release",
    "mandriva-release",
    "mandrivalinux-release",
    "manjaro-release",
    "oracle-release",
    "redhat-release",
    "rocky-release",
    "sl-release",
    "slackware-version",
]

Definition at line 126 of file distro.py.

◆ _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN

_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN

protected

Initial value:

=  re.compile(
    r"(?:[^)]*\‍)(.*)\‍()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)"
)

Definition at line 118 of file distro.py.

◆ _DISTRO_RELEASE_IGNORE_BASENAMES

tuple _DISTRO_RELEASE_IGNORE_BASENAMES

protected

Initial value:

=  (
    "debian_version",
    "lsb-release",
    "oem-release",
    _OS_RELEASE_BASENAME,
    "system-release",
    "plesk-release",
    "iredmail-release",
)

Definition at line 146 of file distro.py.

◆ _OS_RELEASE_BASENAME

str _OS_RELEASE_BASENAME = "os-release"

protected

Definition at line 77 of file distro.py.

◆ _UNIXCONFDIR

_UNIXCONFDIR = os.environ.get("UNIXCONFDIR", "/etc")

protected

Definition at line 75 of file distro.py.

◆ _UNIXUSRLIBDIR

_UNIXUSRLIBDIR = os.environ.get("UNIXUSRLIBDIR", "/usr/lib")

protected

Definition at line 76 of file distro.py.

◆ NORMALIZED_DISTRO_ID

dict NORMALIZED_DISTRO_ID

Initial value:

=  {
    "redhat": "rhel",  # RHEL 6.x, 7.x
}

Definition at line 113 of file distro.py.

◆ NORMALIZED_LSB_ID

dict NORMALIZED_LSB_ID

Initial value:

=  {
    "enterpriseenterpriseas": "oracle",  # Oracle Enterprise Linux 4
    "enterpriseenterpriseserver": "oracle",  # Oracle Linux 5
    "redhatenterpriseworkstation": "rhel",  # RHEL 6, 7 Workstation
    "redhatenterpriseserver": "rhel",  # RHEL 6, 7 Server
    "redhatenterprisecomputenode": "rhel",  # RHEL 6 ComputeNode
}

Definition at line 98 of file distro.py.

◆ NORMALIZED_OS_ID

dict NORMALIZED_OS_ID

Initial value:

=  {
    "ol": "oracle",  # Oracle Linux
    "opensuse-leap": "opensuse",  # Newer versions of OpenSuSE report as opensuse-leap
}

Definition at line 86 of file distro.py.

◆ TypedDict

TypedDict = dict

Definition at line 56 of file distro.py.

Data Structures

Functions

Variables

Detailed Description

Function Documentation

◆ build_number()

◆ codename()

◆ distro_release_attr()

◆ distro_release_info()

◆ id()

◆ info()

◆ like()

◆ linux_distribution()

◆ lsb_release_attr()

◆ lsb_release_info()

◆ main()

◆ major_version()

◆ minor_version()

◆ name()

◆ os_release_attr()

◆ os_release_info()

◆ uname_attr()

◆ uname_info()

◆ version()

◆ version_parts()

Variable Documentation

◆ _distro

◆ _DISTRO_RELEASE_BASENAME_PATTERN

◆ _DISTRO_RELEASE_BASENAMES

◆ _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN

◆ _DISTRO_RELEASE_IGNORE_BASENAMES

◆ _OS_RELEASE_BASENAME

◆ _UNIXCONFDIR

◆ _UNIXUSRLIBDIR

◆ NORMALIZED_DISTRO_ID

◆ NORMALIZED_LSB_ID

◆ NORMALIZED_OS_ID

◆ TypedDict