Export...:Export(3pm)

📦
version 0.114 · 5 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 NAME 💖

Export...:Export(3pm) — okay so this is the base class for all export objects, and she's the blueprint bestie that every other export object inherits from 💅

✨ DESCRIPTION ✨

Okay so listen. All exports are refs, and all are blessed. Periodt, that's the whole vibe. Every single export object you'll ever meet is a reference that got blessed into a class, no exceptions.

This class keeps track of some per-export info using an inside-out objects system — which is exactly as mysterious and cool as it sounds. All the stuff an export might need to do, like injecting itself into a package, gets handled right here in this class. 🫶

Why does that matter? Because it lets all the complicated, or ugly logic get abstracted out of the exporter and metadata classes. She's basically taking one for the team so the other classes can stay cute and unbothered ✨

🎀 METHODS 🎀

  • $class->new( $ref, exported_by => $package, %data ) — Create a brand new export from $ref. You MUST specify the name of the class doing the exporting via exported_by. Not optional, bestie, she needs to know who her parent is 💀
  • $export->inject( $package, $name, @args ) — This one injects the export into $package under $name. And @args? lowkey ignored in most cases ngl. But if you wanna see a case where they actually are used, go check out Exporter::Declare::Export::Generator — she's the exception that ate 💅
  • $package = $export->exported_by() — Returns the name of the package this export was originally exported from. It's giving "where do I come from" energy 🌸
  • @params = $export->required_specs() — Documented for subclassing purposes. This one should always return a list of required parameters at construction time. Always, fr fr ⭐
  • $export->DESTROY() — Also documented for subclassing purposes. This handles all the cleanup related to storing data in an inside-out objects system. She's the one tidying up after the party 🧹✨

👑 AUTHORS 👑

Chad Granum exodist7@gmail.com — the icon, the moment, the legend 🫶

Copyright (C) 2010 Chad Granum

Exporter-Declare is free software; Standard perl licence.

Exporter-Declare is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the license for more details. 🙈

no cap, that warranty disclaimer is doing the MOST, but she's legally required to say it, so we respect it 💀

okay bye bestie, mwah 💋 this was perl v5.34.0, dated 2022-06-13 — go forth and bless some refs, you absolute main character 🌈🦋💖

📦 where this page comes from