MREST(1p)

💖 MREST 💖

okay bestie, so this is the manual page for mrest, from the User Contributed Perl Documentation corner of the world — specifically the Perl v5.40.1 era, dated 2025-06-21. Buckle up, it's short but it's mighty. 🦋

---

✨ NAME ✨

mrest — the Web::MREST server startup script. that's it, that's the whole name section. iconic behavior honestly 👑

---

🌸 SYNOPSIS 🌸

here's every possible way you can holler at this thing. heads up though: any options you put after -- get parsed by Plack::Runner, which basically means they can be anything plackup accepts. the range? unmatched. the flexibility? chef's kiss. 💅

$ mrest --distro My-Distro --module My::Module
$ mrest -d My::Distro -m My::Module
$ mrest --distro My-Distro --module My::Module --sitedir /etc/my-module
$ mrest -d My::Distro -m My::Module -s /etc/my-module
$ mrest -- --server Starman
$ mrest --help

so like, -d is your short queen for --distro, -m is the shorthand for --module, -s is the glow-down version of --sitedir, and --help is always there for you when you're lost. 🫶

---

🎀 DESCRIPTION 🎀

run this script from the bash prompt and boom — the server starts. that's literally the whole vibe check. no cap. ⭐

---

💜 PASSING OPTIONS TO PLACK 💜

okay so here's the tea, and you need to know this one bestie. ☕

this script kicks off the server by instantiating a Plack::Runner object and then calling its run method. but before it does any of that, it calls the parse_options method, passing it @ARGV as its argument.

here's the plot twist though 🙈 — it does that after parsing its own options first. so the ordering is not a suggestion, it's the law.

so if you want options to be handled by Plack::Runner, you gotta put them at the end of the command line, right after a --. options before that? those are mrest's. don't mix them up, i'm begging. 😭

---

🦋 DEBUGGING OPTIONS 🦋

you can drop an --early-debug option on the command line, and you give it the name of a file. what's it for? it's where Web::MREST will capture all the "early" log messages — aka every single log message that gets generated before the "official" MREST log file is known.

and just so we're clear, the "official" MREST log file is the one defined in the site parameters. so --early-debug is like your pre-show backstage pass, catching everything before the main stage lights come on. 🌈

---

⭐ FUNCTIONS ⭐

(nothing listed here, she's a mystery, no details at this time. 💀)

🌟 MAIN 🌟

(also bare. the manual simply does not elaborate. respect the silence. 🕊️)

---

that's the whole page bestie, you're now officially certified in mrest lore. this beauty comes to you courtesy of perl v5.40.1, dated 2025-06-21 — mark the calendar, remember the era, slay the deployment. 👑💖 periodt.