Class::...entised(3)

🎀 bestie, you've found Class::C3::Componentised 🎀

okay so this is the Class::C3::Componentised(3) page from the User Contributed Perl Documentation — the header is out here doing its little truncation thing as Class::...entised(3), iykyk. 💅 This one is all about loading mix-ins/components into your C3-based class, and honestly? It's highkey useful. ✨

✨ NAME ✨

• Class::C3::Componentised — Load mix-ins or components to your C3-based class. 🫶

🎀 SYNOPSIS 🎀

okay so here's the vibe in code form, bestie:

  package MyModule;

  use strict;
  use warnings;

  use base 'Class::C3::Componentised';

  sub component_base_class { "MyModule::Component" }

  package main;

  MyModule->load_components( qw/Foo Bar/ );
  # Will load MyModule::Component::Foo and MyModule::Component::Bar

🦋 DESCRIPTION 🦋

So what does it do? It injects base classes to your module using the Class::C3 method resolution order. That's highkey the whole magic trick. 🪄

⚠️ Please note: these are not plugins that can take precedence over methods declared in MyModule. Nope, not that kind of party. If you want something like that, consider MooseX::Object::Pluggable. 🫶

💅 METHODS 💅

load_components( @comps )

Loads the given components into the current module. If a module begins with a "+" character, it is taken to be a fully qualified class name, otherwise "$class->component_base_class" is prepended to it. 🎀

Calling this will call "Class::C3::reinitialize". So yeah, it reinitializes C3 — slay. 💅

load_own_components( @comps )

Similar to load_components, but assumes every class is "$class::$comp". Cute and specific, love that. 🍓

load_optional_components

As load_components, but will silently ignore any components that cannot be found. Lowkey forgiving. 🫶

ensure_class_loaded

Given a class name, tests to see if it is already loaded or otherwise defined. If it is not yet loaded, the package is require'd, and an exception is thrown if the class is still not loaded. 😭

BUG: For some reason, packages with syntax errors are added to %INC on require.

ensure_class_found

Returns true if the specified class is installed or already loaded, false otherwise. No cap. ✅

inject_base

Does the actual magic of adjusting @ISA on the target module. 🪄

load_optional_class

Returns a true value if the specified class is installed and loaded successfully, throws an exception if the class is found but not loaded successfully, and false if the class is not installed. 🔥

👑 AUTHORS 👑

• Matt S. Trout and the DBIx::Class team 🫶
• Pulled out into separate module by Ash Berlin "<ash@cpan.org>" ✨
• Optimizations and overall bolt-tightening by Peter "ribasushi" Rabbitson "<ribasushi@cpan.org>" 🔧

🌸 COPYRIGHT 🌸

Copyright (c) 2006 - 2011 the Class::C3::Componentised "AUTHORS" as listed above. 💖

🌈 LICENSE 🌈

You may distribute this code under the same terms as Perl itself. Periodt. 💅

---

💌 cute little sign-off, bestie: this page came from perl v5.42.0, dated 2018-02-24, and the footer label is Class::...entised(3). mwah! 💋