Rex::Commands::Augeas(3)

NAME
Rex::Commands::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 => "/files/etc/hosts/*/ipaddr", "127.0.0.1";

 augeas insert => "/files/etc/hosts",
           label => "01",
           after => "/7",
           ipaddr => "192.168.2.23",
           canonical => "test";

 augeas dump => "/files/etc/hosts";

 augeas modify =>
    "/files/etc/ssh/sshd_config/PermitRootLogin" => "without-password",
    on_change => sub {
       service ssh => "restart";
    };

EXPORTED FUNCTIONS

  augeas($action, @options)
It returns 1 on success and 0 on failure.

Actions:

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

     augeas modify =>
               "/files/etc/hosts/7/ipaddr"    => "127.0.0.2",
               "/files/etc/hosts/7/canonical" => "test01",
               on_change                      => sub { say "I changed!" };

remove
    Remove an entry.

     augeas remove    => "/files/etc/hosts/2",
            on_change => sub { say "I changed!" };

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 => "/files/etc/hosts",
               label     => "01",
               after     => "/7",
               ipaddr    => "192.168.2.23",
               alias     => "test02",
               on_change => sub { say "I changed!" };

dump
    Dump the contents of a file to STDOUT.

     augeas dump => "/files/etc/hosts";

exists
    Check if an item exists.

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

get Returns the value of the given item.

     my $val = augeas get => "/files/etc/hosts/1/ipaddr";