Provided by: rex_1.6.0-1_all bug

NAME

       Rex::Commands::PkgConf - Configure packages

DESCRIPTION

       With this module you can configure packages. Currently it only supports Debian (using
       debconf), but it is designed to be extendable.

SYNOPSIS

        my %options = get_pkgconf('postfix');
        say $options{'postfix/relayhost'}->{value};

        # Only obtain one value
        my %options = get_pkgconf('postfix', 'postfix/relayhost');
        say $options{'postfix/relayhost'}->{value};

        # Set options
        set_pkgconf("postfix", [
           {question => 'chattr', type => 'boolean', value => 'false'},
           {question => 'relayhost', type => 'string', value => 'relay.example.com'},
        ]);

        # Don't update if it's already set
        set_pkgconf("mysql-server-5.5", [
           {question => 'mysql-server/root_password', type => 'string', value => 'mysecret'},
           {question => 'mysql-server/root_password_again', type => 'string', value => 'mysecret'},
        ], no_update => 1);

EXPORTED FUNCTIONS

   get_pkgconf($package, [$question])
       Use this to query existing package configurations.

       Without a question specified, it will return all options for the specified package as a
       hash.

       With a question specified, it will return only that option

       Each question is returned with the question as the key, and the value as a hashref. The
       hashref contains the keys: question, value and already_set. already_set is true if the
       question has already been answered.

        # Only obtain one value
        my %options = get_pkgconf('postfix', 'postfix/relayhost');
        say $options{'postfix/relayhost'}->{question};
        say $options{'postfix/relayhost'}->{value};
        say $options{'postfix/relayhost'}->{already_set};

   set_pkgconf($package, $values, [%options])
       Use this to set package configurations.

       At least the package name and values must be specified. Values must be an array ref, with
       each item containing a hashref with the attributes specified that are required by the
       package configuration program.

       For example, for debconf, this must be the question, the type and answer. In this case,
       the types can be any accetable debconf type: string, boolean, select, multiselect, note,
       text, password.

       Optionally the option "no_update" may be true, in which case the question will not be
       updated if it has already been set.

       See the synopsis for examples.