IM::Alias(3pm)

💖 IM::Alias 💖

okay bestie, you found it — this is IM::Alias, aka the mail and host alias looking up package, living in the 3pm manual, part of the Internet Message Perl modules squad. she's here to handle your mail aliases AND your host aliases, and honestly? she ate. 🎀

---

✨ SYNOPSIS ✨

use IM::Alias;

alias_read(mail_alias_files, addrbook_files);
$result = alias_lookup(user_name);
alias_print(alias);

hosts_read(hosts_alias_files);
$result = hosts_completion(mail_address);
hosts_print(alias);

like, that's the whole vibe. read your files, look stuff up, print it. no cap. 🦋

---

🌸 DESCRIPTION 🌸

so the tea is: the IM::Alias module handles mail and host aliases. that's it, that's the job, and she does it beautifully. 💅

and just so you know where she came from — this module is provided by IM (Internet Message). iykyk. 👑

---

🧚 EXAMPLES 🧚

here's how you'd actually use her, fr fr:

alias_read("$HOME/.im/Aliases", "$HOME/.im/Addrbook");
hosts_read("$HOME/.hostaliases");

$result = alias_lookup('u');
print "$result\n" if ($result);

$result = hosts_completion('u@h');
print "$result\n" if ($result);

and for the print girlies:

• alias_print("a") displays mail addresses whose alias is "a". 🍓
• hosts_print("") displays all host aliases. passing an empty string = show me everything, main character energy. ✨

---

👑 COPYRIGHT 👑

IM (Internet Message) is copyrighted by the IM developing team. you can redistribute it and/or modify it under the modified BSD license — so go off, just do it responsibly. see the copyright file for more details. 📜

---

lowkey important reminder: that's the whole copyright situation, no extra clauses hiding anywhere, bestie. 💖

---

and that's a wrap on the IM::Alias page, mwah 🫶 — this gem was served up as version IM153, dated 2016-10-10, and she's still iconic. 💜