Mason::Tidy(3)

💖 Mason::Tidy — the manual, but make it a group chat 💖

okay so bestie, this is Mason::Tidy(3), and yeah it's from the User Contributed Perl Documentation corner of the universe, but don't let that scare you. it's literally the engine that powers masontidy, and it's lowkey iconic. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

Mason::Tidy — it's the engine for masontidy. that's it, that's the whole vibe. 🎀

---

🌸 VERSION 🌸

version 2.57, periodt. 💅

---

🦋 SYNOPSIS 🦋

here's how you'd actually use it in your own little program, no cap:

use Mason::Tidy;

my $mc = Mason::Tidy->new(mason_version => 2);
my $dest = $mc->tidy($source);

look at that. two lines and you're the main character. 👑

---

🌈 DESCRIPTION 🌈

so, real talk: this right here is the engine that masontidy runs on. bestie, go read that one first if you want the big-picture tea — this is just the engine room. 🔧

the fun part? you don't have to run the masontidy command at all. you can call this API straight from your own program instead of executing "masontidy". it's giving "I'll do it myself" energy and honestly? respect. 💖

---

🎀 CONSTRUCTOR PARAMETERS 🎀

these are the knobs you can twist when you build your Mason::Tidy object. they're all the same as the equivalent "masontidy" command-line options — you just swap the dashes for underscores (so like, the --indent-per-block option becomes indent_perl_block here). cute, right? 🧚

• indent_block — same deal as the masontidy option of the same name, dashes-to-underscores and all.
• indent_perl_block — same deal as the masontidy option of the same name, dashes-to-underscores and all.
• mason_version — required, bestie! you literally cannot skip this one. 🙈
• perltidy_argv — same deal as the masontidy option of the same name, dashes-to-underscores and all.
• perltidy_block_argv — same deal as the masontidy option of the same name, dashes-to-underscores and all.
• perltidy_line_argv — same deal as the masontidy option of the same name, dashes-to-underscores and all.
• perltidy_tag_argv — same deal as the masontidy option of the same name, dashes-to-underscores and all.

---

💅 METHODS 💅

tidy ($source)

this is the one. you hand it component source $source, it tidies it up, and it hands you back the tidied result. glow-up complete. ✨

⚠️ but listen — if the source can't be tidied (say, invalid syntax, oop), it will throw a fatal error. no gentle vibes, just a hard stop. don't say I didn't warn you. 💀

---

🫶 AUTHOR 🫶

Jonathan Swartz <swartz@pobox.com> — the legend who made this happen. thank you for your service, king. 👑

---

💜 COPYRIGHT AND LICENSE 💜

this software is copyright (c) 2011 by Jonathan Swartz.

it's free software, bestie — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. free as in freedom, free as in slay. 🌈

---

aaaand that's the whole page! 🎉 this was Mason::Tidy, perl v5.42.0, dated 2025-07-25. mwah, go tidy something gorgeous. 💖✨🎀