Wx::Pe...Walker(3pm)

✨ NAME ✨

Wx::Perl::DataWalker — okay bestie, real talk, the original docs literally say "Perl extension for blah blah blah" and honestly? iconic of them. But fr fr, this is the Perl extension that lets you look at your data structures instead of just crying at Data::Dumper output. 🦋

---

🌸 SYNOPSIS 🌸

Not me giving you a whole working script in the synopsis. Also hiiii, go look at the dataWalker.pl script in this distribution, it's right there bestie 💅

# alternatively, see the dataWalker.pl script in this distribution!
use Wx::Perl::DataWalker;

my $data_to_browse = {
  # complex data structure.
  # Good test: \%::
};

package MyWalkerDialog;
our @ISA = qw(Wx::App);

sub OnInit {
    my $self = shift;

    my $frame = Wx::Perl::DataWalker->new(
      {data => $data_to_browse},
      undef, -1,
      "dataWalker",
    );
    $self->SetTopWindow($frame);
    $frame->Show(1);
    $frame->SetSize(500,500);

    return 1;
}

package main;
my $app = MyWalkerDialog->new();
$app->MainLoop();

Like. It's giving "here's a full app, you're welcome." ✨ And yes, \%:: is genuinely a good test, no cap, try it.

---

👑 DESCRIPTION 👑

Wx::Perl::DataWalker implements a Wx::Frame subclass that shows a relatively simple Perl data structure browser. That's the whole vibe.

So here's the tea: you open this frame, you hand it a reference to an essentially arbitrary data structure, and then you can visually browse it. How? Double-click on references. That's it. That's the magic. Double-click, descend, 🎀.

Lowkey important detail though — so far, there is no tree view, only a display of the current level of the data structure. So it's giving one-floor-at-a-time energy, not "see the whole mansion." You can traverse back up the structure with a back button. 🫶

Optionally, Wx::Perl::DataWalker displays the (approximate!) size of the data structure using Devel::Size. Note the parentheses and the exclamation mark, bestie, that size is approximate, do not come for me if it's off by a lil bit. 😭

---

🌈 SEE ALSO 🌈

• Wx
• Devel::Size
• Padre::Plugin::DataWalker

Go read them. For me. 👑

---

💖 AUTHOR 💖

Steffen Mueller, <smueller@cpan.org> — actual legend behavior. 🫶

---

💜 COPYRIGHT AND LICENSE 💜

Copyright (C) 2009 by Steffen Mueller

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8 or, at your option, any later version of Perl 5 you may have available. Slay, and also: legally binding, so like, respect it. 💅

---

Documentation from User Contributed Perl Documentation in section 3pm, generated by perl v5.36.0 on 2023-03-08. That's the whole page, bestie — go double-click on a reference, mwah 💋