Software Distribution Primitives#

Software Distribution primitives (distros) are used to collect information about a software distribution. For example, which repos hold packages and what packaging scheme is used.

When issuing requests, the UID field in the URL can be either the actual UID of the primitive or the name of the primitive as given in the "name" field.

Data Fields#

Distro primitives have several fields:

name
     Required: The name of the distro. Names cannot start with a number.

description
     Optional: A text string with descriptive information

repos
     Optional: A list of one or more Software Repository primitives

packaging
     Optional: A string representing the packaging scheme:  rpm, deb, apk; if it cannot
               be inferred from other data, “rpm” will be assumed

release
     Optional: A string representing the name of the release

Additional Endpoints#

There are no additional endpoints for distros; the basic operations all function as expected. For example, GET /distro/<UID> will return information about the distro.