NAME

Linux::Utils::YUM - Wrapper class for the 'yum' and 'repolist' commands.

VERSION

version 0.002

SYNOPSIS

  $yum = Linux::Utils::YUM->new;
  
  $aref = $yum->repoQuery (all       => 1,
                           installed => 1);
 
  $aref = $yum->repoList(enabled  => 1,
                         disabled => 0);
                         repoId   => $repoId);

ATTRIBUTES

none

METHODS

repoList

Generates a list of configured YUM repositories.

Returns: ArrayRef[HashRef]

Example HashRef:

  {
    repoBaseurl   "http://centos3.zswap.net/7.8.2003/updates/x86_64/ (9 more)",
    repoExpire    "21,600 second(s) (last: Tue Oct 13 12:14:28 2020)",
    repoId        "updates/7/x86_64",
    repoMirrors   "http://mirrorlist.centos.org/?release=7&arch=x86_64&repo=updates&infra=vag",
    repoName      "CentOS-7 - Updates",
    repoPkgs      "1,104",
    repoSize      "5.4 G",
    repoStatus    "enabled",
    repoUpdated   "Mon Sep 14 08:18:15 2020"
  }

usage:

 $aref = $yum->repoList([enabled => 1],
                        [disabled => 0]);
 

args:

enabled [Bool] (optional)

Flag indicating the returned list should include enabled repos.

Default: 1

disabled [Bool] (optional)

Flag indicating the returned list should include disabled repos.

Default: 0

repoQuery

Captures the output from the 'repoquery' command.

Returns: ArrayRef[Str]

usage:

  $aref = $yum->repoQuery ([all       => 0|1],
                           [installed => 0|1],
                           [repoId    => $repoId]);

args:

all [Bool] (optional)

Equivalent to the --all flag on the cli.

Default: 0

installed [Bool] (optional)

Equivalent to the --installed flag on the cli.

Default: 0

repoId [Str] (optional)

Equivalent to the --repoid option on the cli.

list

Captures the output from the 'yum list' command.

Returns: ArrayRef[Str] or ArrayRef[HashRef]

usage:

  $aref = $yum->list ([installed => 0|1],
                      [repoId    => $repoId]);

args:

installed [Bool] (optional)

List only installed packages.

Default: 0

repoId [Str] (optional)

Limit the listing to this repo. This leverages 'repository-packages' under the hood.

useSudo [Bool] (optional)

If a repoId is provided and your running under a user other than root, you must use sudo privileges in order to run "yum repo-pkgs". Must be due to some "feature" I am not privy to.

parseOutput [Bool] (optional)

Indicates the caller wants the output parsed and put into a hashref.