versionlockstring.pp

# This type matches strings appropriate for use with yum-versionlock.
# Its basic format, using the `rpm(8)` query string format, is
# `%{EPOCH}:%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}`.  As a Regex, it
# breaks down into five distinct parts, plus the seperators.
#
#   EPOCH: An unsigned integer
#   type Yum::PackageEpoch   = Regexp[/[0-9]\*]+/]
#
#   NAME: Any valid package name (see https://github.com/rpm-software-management/rpm/blob/master/doc/manual/spec)
#   type Yum::PackageName    = Regexp[/[0-9a-zA-Z\._\+%\{\}\*-]+/]
#
#   VERSION: Any valid version string. The only limitation here, according to the RPM manual, is that it may not contain a dash (`-`).
#   type Yum::PackageVersion = Regexp[/[^-]+/]
#
#   RELEASE: Any valid release string. Only limitation is that it is not a dash (`-`)
#   type Yum::PackageRelease = Regexp[/[^-]+/]
#
# lint:ignore:140chars
#   ARCH: Matches a string such as `el7.x86_64`.  This is actuall two sub-expressions.  See below.
#   type Yum::PackageArch    = Regexp[/([0-9a-zZ-Z_\*]+)(?:\.(noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa|\*))?/]
# lint:endignore
#
# The `%{ARCH}` sub-expression is composed of two sub-expressions
# separated by a dot (`.`), where the second part is optional.  The RPM
# specification calls the first field the `DistTag`, and the second the
# `BuildArch`.
#
#    DistTag: Any string consiting of only letters, numbers, or an underscore, e.g., `el6`, `sl7`, or `fc24`.
#    type Yum::PackageDistTag   = Regexp[/[0-9a-zZ-Z_\*]+/]
#
# lint:ignore:140chars
#    BuildArch: Any string from the list at https://github.com/rpm-software-management/rpm/blob/master/rpmrc.in.  Strings are roughly listed from most common to least common to improve performance.
#    type Yum::PackageBuildArch = Regexp[/noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa/]
# lint:endignore
#
# @note Each field may contain wildcard characters (`*`), but the
# wildcard characters may not span the fields, may not cover the
# seperators.  This is an undocumented but tested limitation of
# yum-versionlock.
#
# @example A complete, well-formed string: `0:bash-4.1.2-9.el6_2.x86_64'
# @example A well-formed string that has dropped the optional BuildArch sub-field: `0:bash-4.1.2-9.el6_2`
# @example A well-formed string using wildcards: `*0:bash*-4.*-*.*`
# @example An invalid string (wildcard spans the VERSION and RELEASE fields): `0:bash-4.*-el6.x86_64
# @example An invlaid string (wildcard spans the VERSION, RELEASE, and ARCH fields): `0:bash-*`
#
# lint:ignore:140chars
type Yum::VersionlockString = Pattern[/^([0-9\*]+):([0-9a-zA-Z\._\+%\{\}\*-]+)-([^-]+)-([^-]+)\.(([0-9a-zZ-Z_\*]+)(?:\.(noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa|\*))?)$/]
# lint:endignore