Autodi...::Perl(3pm)

πŸ“¦
version 2.14 Β· 3 versions
, in debian bookworm, debian trixie, ubuntu noble

πŸ’– Autodi...::Perl πŸ’–

okay bestie, so this is the man page for Autodia::Handler::Perl.pm β€” it's part of the User Contributed Perl Documentation, and it lives at Autodi...::Perl(3pm). Think of it as the little backstage gremlin that reads your Perl and turns it into diagrams. adorable, honestly. πŸŽ€


✨ NAME ✨

Autodia::Handler::Perl.pm β€” the AutoDia handler for perl, periodt πŸ’…


🌸 DESCRIPTION 🌸

so HandlerPerl takes files and parses them into a Diagram Object, which is the thing literally every handler uses. the handler's whole job is to read through the file and pull out the good stuff β€” Class names, attributes, methods and properties. it's giving detective energy, but make it UML. πŸ•΅οΈβ€β™€οΈ

HandlerPerl does its parsing using simple perl rules. and if that's not your vibe, the original author notes a possible alternative: you could write HandlerCPerl to handle C style perl, or HandleHairyPerl to handle hairy perl. (yes, those are the actual suggested names. iconic.) πŸ¦‹

HandlerPerl is registered in the Autodia.pm module, which contains a hash of language names and the name of their respective language β€” in this case:

%language_handlers = { .. , perl => "perlHandler", .. };

πŸ”₯ METHODS πŸ”₯

πŸ’œ CONSTRUCTION METHOD πŸ’œ

use Autodia::Handler::Perl;

my $handler = Autodia::Handler::Perl->New(\%Config);

this creates a new handler, using the Configuration hash to provide the rules you selected at the command line. build-a-bear, but for handlers. no cap. 🧚

⭐ ACCESSOR METHODS ⭐

$handler->Parse(filename); # where filename includes full or relative
path.

this parses the named file and returns 1 if it worked, or 0 if the file could not be opened. simple as. 😭

$handler->output(); # any arguments are ignored.

this outputs the Dia XML file, following the rules in the %Config hash that got passed in at initialisation of the object. any arguments? ignored. we don't know them, we don't see them. πŸ’€


🫢 SEE ALSO 🫢

  • Autodia::Handler
  • Autodia::Diagram

go read those next bestie, they're the supporting cast. πŸ’–


πŸ‘‘ AUTHOR πŸ‘‘

Aaron Trevena, <aaron.trevena@gmail.com>


Copyright (C) 2001-2007 by Aaron Trevena

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.1 or, at your option, any later version of Perl 5 you may have available.

fr fr this one's free β€” remix it, share it, just keep it under the same Perl-ish terms. ✨

and that's the whole thing, bestie β€” this page came to you courtesy of perl v5.36.0, dated 2022-11-02, from the User Contributed Perl Documentation. slay, go diagram something. πŸ’…πŸŒΈπŸ’œ

πŸ“¦ where this page comes from