NAME

Rex::Augeas - An augeas module for (R)?ex

DESCRIPTION

This is a simple module to manipulate configuration files with the help of augeas.

SYNOPSIS

my $k = augeas exists => "/etc/hosts",
                  "*/ipaddr" => "127.0.0.1";
augeas insert => "/etc/hosts",
          label => "01",
          after => "/7",
          ipaddr => "192.168.2.23",
          canonical => "test";

augeas dump => "/etc/hosts";

EXPORTED FUNCTIONS

augeas($action, $file, @options)

It returns 1 on success and 0 on failure.

Actions:

modify

This modifies the keys given in @options in $file.

augeas modify => "/etc/hosts",
          "/7/ipaddr"    => "127.0.0.2",
          "/7/canonical" => "test01";

remove

Remove an entry.

augeas remove => "/etc/hosts", "/2";

insert

Insert an item into the file. Here, the order of the options is important. If the order is wrong it won't save your changes.

augeas insert => "/etc/hosts",
          label  => "01",
          after  => "/7",
          ipaddr => "192.168.2.23",
          alias  => "test02";

dump

Dump the contents of a file to STDOUT.

augeas dump => "/etc/hosts";

exists

Check if an item exists.

my $exists = augeas exists => "/etc/hosts",
                       "*/ipaddr" => "127.0.0.1";
if($exists) {
    say "127.0.0.1 exists!";
}