Push items: errata

class pushsource.ErratumPushItem[source]

A PushItem representing a single erratum (also known as “advisory”).

Note that many fields on erratum objects which appear to be numeric are instead represented as strings (‘release’ and ‘pushcount’ being two examples).

Attributes:

type

‘bugfix’, ‘security’ or ‘enhancement’.

Type:

str

release

Release number. Typically an integer-string, initially ‘0’.

Type:

str

status

Status, typically ‘final’.

Type:

str

pushcount

Number of times advisory has been revised and published (starting at ‘1’).

Type:

str

reboot_suggested

True if rebooting host machine is recommended after installing this advisory.

Warning

The intended usage of this field is unclear.

In practice, tools such as yum are instead consuming the reboot_suggested field from ErratumPackage.

Type:

bool

references

A list of references associated with the advisory.

Type:

list[ErratumReference]

pkglist

A list of package collections associated with the advisory.

Type:

list[ErratumPackageCollection]

container_list

A list of container images associated with the advisory.

Example of the list:

"container_list": [
    {
        "openshift4/ose-local-storage-rhel7-operator-metadata": {
            "digest": "sha256:2321a7d13d9fa53f05437663cf2dc217d15f3cda4b67076c941b10f0491cf9d7",
            "images": {
                "s390x": {
                    "digest": "sha256:05649a19718fde131372c761d359302ccbe81f9744d2893ac4c826b05d670206"
                },
                "ppc64le": {
                    "digest": "sha256:06d1c5e4fa6a5d1ff868388f3feadf193d04128b62d1181e37fe4ab8ecda27e1"
                },
                "x86_64": {
                    "digest": "sha256:c2e3030306f71b94cbffe2d16fcebe6e14f2842ae26789926bcf1afeeecb5859"
                }
            }
        }
    }
Type:

list[Dict[str, Dict[str, Union[str, Dict[str, Optional[str]]]]]]

from_

Contact email address for the owner of the advisory.

Note that the canonical name for this attribute is from. As this clashes with a Python keyword, in most contexts the attribute is also available as an alias, from_. Where possible, the canonical name from should be preferred.

Type:

str

rights

Copyright message.

Type:

str

title

Title of the advisory (e.g. ‘bash bugfix and enhancement’).

Type:

str

description

Full human-readable description of the advisory, usually multiple lines.

Type:

str

version

Advisory version. Starts counting at “1”, and some systems require updating the version whenever an advisory is modified.

Type:

str

updated

Timestamp of the last update to this advisory.

Typically of the form ‘2019-12-31 06:54:41 UTC’, but this is not enforced.

Type:

str

issued

Timestamp of the initial release of this advisory.

Uses the same format as updated().

Type:

str

severity

Severity of the advisory, e.g. “low”, “moderate”, “important” or “critical”.

Type:

str

summary

Typically a single sentence briefly describing the advisory.

Type:

str

solution

Text explaining how to apply the advisory.

Type:

str

content_types

A list of content types associated with the advisory.

For example, “docker” may be found in this list if the advisory deals with container images.

Type:

list[str]

class pushsource.ErratumReference[source]

A reference within a references() list.

Attributes:

href

A URL.

Type:

str

id

A short ID for the reference, unique within this erratum.

Type:

str

title

A title for the reference; analogous to the ‘title’ attribute in HTML.

Type:

str

type

Type of reference. This defines the expected target of the URL and includes at least:

  • “self”: reference to a page for this advisory

  • “bugzilla”: reference to a bug

  • “other”: any other kind of reference

Type:

str

class pushsource.ErratumPackageCollection[source]

A collection of packages found within an pkglist().

A non-modular advisory typically contains only a single collection, while modular advisories typically contain one collection per module.

Attributes:

name

A name for this collection. The collection name has no specific meaning, but must be unique within an advisory.

Type:

str

packages

List of packages within this collection.

Type:

list[ErratumPackage]

short

An alternative name for this collection. In practice, this field is typically blank.

Type:

str

module

An ErratumModule defining the module this entry is associated with, if any.

Type:

ErratumModule

class pushsource.ErratumModule[source]

A module entry within a pkglist().

Attributes:

name

Module name.

Type:

str

stream

Module stream.

Type:

str

version

Module version.

Type:

str

context

Module context.

Type:

str

arch

Module architecture.

Type:

str

class pushsource.ErratumPackage[source]

A package (RPM) entry within a pkglist().

Attributes:

arch

RPM architecture.

Type:

str

filename

RPM filename (basename).

Type:

str

epoch

RPM epoch.

Type:

str

name

RPM name (e.g. “bash-4.0.1-1.el7.x86_64.rpm” name is “bash”)

Type:

str

version

RPM version (e.g. “bash-4.0.1-1.el7.x86_64.rpm” version is “4.0.1”)

Type:

str

release

RPM release (e.g. “bash-4.0.1-1.el7.x86_64.rpm” version is “1.el7”)

Type:

str

src

Filename of the source RPM from which this RPM was built; equal to filename() for the source RPM itself.

Type:

str

reboot_suggested

True if rebooting host machine is recommended after installing this package.

Type:

bool

md5sum

MD5 checksum of this RPM in hex string form, if available.

Type:

str

sha1sum

SHA1 checksum of this RPM in hex string form, if available.

Type:

str

sha256sum

SHA256 checksum of this RPM in hex string form, if available.

Type:

str