Devel:...ne::PPI(3pm)

✨ NAME ✨

Devel::REPL::Plugin::MultiLine::PPI — bestie, it reads lines until all your blocks are closed 💖

Like, it's a plugin from Devel::REPL (that's a User Contributed Perl Documentation page, iykyk), and its whole personality is: keep collecting input until nothing's left hanging open. Periodt.

---

🌸 VERSION 🌸

This is version 1.003029, no cap.

---

🎀 SYNOPSIS 🎀

Here's the whole vibe in code, bestie:

use Devel::REPL;

my $repl = Devel::REPL->new;
$repl->load_plugin('LexEnv');
$repl->load_plugin('History');
$repl->load_plugin('MultiLine::PPI');
$repl->run;

That's it. That's the setup. 💅

---

🦋 DESCRIPTION 🦋

Okay so this plugin is the friend who waits for you to finish your sentence before replying. It collects lines until you have no unfinished structures — like, zero loose ends, main character energy only.

Which means you get to write subroutines, if statements, loops, etc. way more naturally, instead of cramming everything onto one cursed line.

Let's do a little before-and-after, because the glow-up is real:

Before — no MultiLine plugin, and the terminal is being so dramatic:

$ my $x = 3;
3
$ if ($x == 3) {

Not me getting a compile error 😭 — and it's literally just because that if statement is incomplete. It's giving "half-finished thought".

After — with a MultiLine plugin, we're thriving:

$ my $x = 3;
3
$ if ($x == 3) {

> print "OH NOES!"

> }
OH NOES
1

See how the prompt switches to > while it's waiting for you to close the block? Obsessed. So now you may write the code across multiple lines, just like in irb and python. Iconic behaviour, honestly. 🌈

This module uses PPI. And why is it named MultiLine::PPI instead of just MultiLine? Because someone else may conceivably implement similar behavior some other, less dependency-heavy way. Considerate of them, fr fr. 🫶

---

💜 SEE ALSO 💜

• "Devel::REPL" — the whole reason we're here, the parent show.

---

🌟 SUPPORT 🌟

Got bugs? Bestie, they may be submitted through the RT bug tracker: <https://rt.cpan.org/Public/Dist/Display.html?Name=Devel-REPL>

Or you can email them straight to bug-Devel-REPL@rt.cpan.org (that's mailto:bug-Devel-REPL@rt.cpan.org if you need the link form). 💌

There's also an irc channel available for users of this distribution, hanging out at "#devel" on "irc.perl.org" — that's irc://irc.perl.org/#devel-repl for the cool kids who like protocols. Come say hi! 💬

---

👑 AUTHOR 👑

Shawn M Moore, "<sartak at gmail dot com>". Living legend, we stan. ✨

---

💖 COPYRIGHT AND LICENSE 💖

Copyright (C) 2007 by Shawn M Moore

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Slay. 🎀

---

That's the whole page, bestie — go forth and write multi-line Perl like the main character you are. 🦋

Signing off from perl v5.34.0, dated 2022-06-03 — that's the footer, babes, and we're done here. 💜