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.