Rex::Co...ds::Host(3)

✨ NAME ✨

okay bestie, welcome to the Rex::Co...ds::Host(3) page from the User Contributed Perl Documentation 💖 the module is Rex::Commands::Host, and its whole personality is Edit /etc/hosts. that's it, that's the name. slay.

🌸 DESCRIPTION 🌸

with this module you can manage the host entries in /etc/hosts — literally the whole point. host entries? managed. /etc/hosts? handled. no cap. ✨

🦋 SYNOPSIS 🦋

here's the vibe in code form, bestie:

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

👑 EXPORTED FUNCTIONS 👑

these are the exported functions, and yes they are the main characters 💅

🎀 host_entry($name, %option) 🎀

this one manages the entries in /etc/hosts. it's giving host-entry manager, fr fr.

here's the ensure => "present" moment — look at that on_change callback, iconic:

        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"; };

and yes, the second one is the ensure => "absent" moment — removal vibes, bestie 🫶

🌈 create_host($) 🌈

update or create a /etc/hosts entry. lowkey the glow-up function for your host file, periodt.

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

🦋 delete_host($host) 🦋

delete a host from /etc/hosts. bye bestie 👋

        delete_host "www.rexify.org";

🔥 get_host($host) 🔥

returns the information of $host in /etc/hosts. it's giving data retrieval, and we love that for us.

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

---

okay that's the whole page, bestie 🫶 this was Rex::Co...ds::Host(3) from the User Contributed Perl Documentation, Perl v5.42.3, dated 2023-08-05 — slay and stay iconic 💜