Poet(3pm)

📦
version 0.16 · 2 versions
  • 0.16 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.16 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Poet(3pm) — the vibe 💖

okay bestie, pull up a chair, because this is Poet(3pm) from the User Contributed Perl Documentation collection and honestly? she's a whole icon. ✨

🌸 NAME 🌸

Poet — a modern Perl web framework for Mason developers 💅

🎀 SYNOPSIS 🎀

like, here's literally what it looks like to use her:

  % poet new MyApp
  my_app/.poet_root
  my_app/bin/app.psgi
  ...

  % my_app/bin/run.pl
  Running plackup --Reload ... --env development --port 5000
  Watching ... for file updates.
  HTTP::Server::PSGI: Accepting connections at http://0:5000/

no cap, that's the whole onboarding. she just works. 🦋

✨ DESCRIPTION ✨

So Poet is a modern Perl web framework, and she was designed especially for Mason developers — like, she sees you, she gets you. 🫶

She uses PSGI/Plack for server integration, Mason for request routing and templating, and then a hand-picked selection of best-of-breed CPAN modules for caching, logging and configuration. it's giving curated. it's giving taste. 💜

👑 FEATURES 👑

  • 🗂️ A common-sense directory hierarchy for web development — the layout just makes sense, no notes
  • ⚙️ A configuration system that scales elegantly with multiple coders and multiple layers (development/production) — she grows with you, bestie
  • 📝 Integration with Log4perl for logging, wrapped with dead-simple configuration
  • 💾 Integration with CHI for powerful and flexible caching
  • 🧚 The power of Mason, an object-oriented templating system, for request routing and content generation
  • 🔑 Easy access to common objects and utilities from anywhere in your application
  • ⭐ Conventions and defaults based on the author's best practices from over fifteen years of Perl web development; and
  • 🌈 The freedom to override just about any of Poet's behaviors

that last one?? main character energy fr fr. she has opinions but she's not controlling about it. 💅

📚 DOCUMENTATION 📚

All documentation is indexed at Poet::Manual. go read, iykyk. 🍓

🫂 SUPPORT 🫂

For now Poet will share a mailing list and IRC with Mason. The Mason mailing list is mason-users@lists.sourceforge.net; you must be subscribed at <https://lists.sourceforge.net/lists/listinfo/mason-users> to send a message. The Mason IRC channel is #mason at <irc://irc.perl.org/#mason>.

Bugs and feature requests will be tracked at RT:

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Poet
  bug-poet@rt.cpan.org

The latest source code can be browsed and fetched at:

  http://github.com/jonswar/perl-poet
  git clone git://github.com/jonswar/perl-poet.git
heads up bestie — you gotta be subscribed to that mailing list before you can post. that's not a suggestion, that's the rules. 💀

🙈 ACKNOWLEDGEMENTS 🙈

Poet was originally designed and developed for the Digital Media group of the Hearst Corporation, a diversified media company based in New York City. Many thanks to Hearst for agreeing to this open source release. 🎀

However — and this part matters — Hearst has no direct involvement with this open source release and bears no responsibility for its support or maintenance. so don't @ them, okay? 😭

🔥 SEE ALSO 🔥

Mason, Plack, PSGI — the holy trinity, the girlies she rolls with. ⭐

💜 AUTHOR 💜

Jonathan Swartz <swartz@pobox.com>

This software is copyright (c) 2012 by Jonathan Swartz.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

and that's the tea, bestie 🍵 — this page came to you courtesy of perl v5.34.0, dated 2022-06-18, from the User Contributed Perl Documentation crew. slay, go build something cute 💖✨

📦 where this page comes from