NAME

       Rex::Commands::Host - Edit /etc/hosts

DESCRIPTION

       With this module you can manage the host entries in /etc/hosts.

SYNOPSIS

        task "create-host", "remoteserver", sub {
          create_host "rexify.org" => {
           ip    => "88.198.93.110",
           aliases => ["www.rexify.org"],
          };
        };

EXPORTED FUNCTIONS

   host_entry($name, %option)
       Manages the entries in /etc/hosts.

        host_entry "rexify.org",
          ensure    => "present",
          ip        => "88.198.93.110",
          aliases   => ["www.rexify.org"],
          on_change => sub { say "added host entry"; };

         host_entry "rexify.org",
           ensure    => "absent",
           on_change => sub { say "removed host entry"; };

   create_host($)
       Update or create a /etc/hosts entry.

        create_host "rexify.org", {
          ip    => "88.198.93.110",
          aliases => ["www.rexify.org", ...]
        };

   delete_host($host)
       Delete a host from /etc/hosts.

        delete_host "www.rexify.org";

   get_host($host)
       Returns the information of $host in /etc/hosts.

        my @host_info = get_host "localhost";
        say "Host-IP: " . $host_info[0]->{"ip"};