MooseX...uggable(3pm)

💖 MooseX::Traits::Pluggable 💖

okay bestie, welcome to MooseX...uggable(3pm) — the User Contributed Perl Documentation page that's about to change your whole trait-loading life. no cap 🦋

This is MooseX::Traits::Pluggable — it does trait loading and resolution for Moose. That's the whole vibe. Periodt. 💅

---

✨ DESCRIPTION ✨

So like, for actual usage info, go read MooseX::Traits. That's the main character here, this module is the iconique plot twist.

You use new_with_traits to construct an object with a list of traits, and apply_traits to apply traits to an instance. That's it, that's the move. 🎀

On top of that, this module adds support for class precedence search for traits and some extra attributes, which are described below. Keep scrolling bestie, the tea is further down. 🍓

---

🔍 TRAIT SEARCH 🔍

Here's the moment. If the value of _trait_namespace in MooseX::Traits starts with a "+", then the namespace is considered relative to the class_precedence_list (ie. @ISA) of the original class. Yes, that @ISA. The ancestor list. The family tree. 🌳

Example:

package Class1
use Moose;

package Class1::Trait::Foo;
use Moose::Role;
has 'bar' => (
    is       => 'ro',
    isa      => 'Str',
    required => 1,
);

package Class2;
use parent 'Class1';
with 'MooseX::Traits';
has '+_trait_namespace' => (default => '+Trait');
has '+_traits_behave_like_roles' => (default => 1);

package Class2::Trait::Bar;
use Moose::Role;
has 'baz' => (
    is       => 'ro',
    isa      => 'Str',
    required => 1,
);

package main;
my $instance = Class2->new_with_traits(
    traits => ['Foo', 'Bar'],
    bar => 'baz',
    baz => 'quux',
);

$instance->does('Class1::Trait::Foo'); # true
$instance->does('Class2::Trait::Bar'); # true

like, the trait Foo got found all the way up in Class1's namespace and Bar came from Class2's. it's giving inheritance but make it fashion. 👑

---

🌈 NAMESPACE ARRAYS 🌈

You can search multiple namespaces for traits, bestie. Multiple. Not just one. For example:

has '+_trait_namespace' => (
    default => sub { [qw/+Trait +Role ExtraNS::Trait/] }
);

Will search in the class_precedence_list for ::Trait::TheTrait and ::Role::TheTrait and then for ExtraNS::Trait::TheTrait. In that order, okay? The order matters. It's a whole queue. 🫶

---

💅 CORRECT ROLE BEHAVIOR 💅

okay this part is important, listen up.

By default, a method from a role will override a class method. However — and this is the gag — this is not the behavior one expects when applying a Moose role using the normal methods. So like, surprise! not in a cute way. 😭

If you want the behavior to be consistent with Moose roles, then use this configuration attribute in your class:

has '+_traits_behave_like_roles' => (default => 1);

This may or may not become the default in the future. For now you have to ask for it, for backward compatibility reasons. So don't be out here assuming, bestie — you gotta opt in. 🧚

---

🎁 EXTRA ATTRIBUTES 🎁

_original_class_name

When traits are applied to your class or instance, you get an anonymous class back whose name will be not the same as your original class. Rude, I know. So ref $self will not be Class, but $self->_original_class_name will be. It's the glow-up disguise situation — the identity is still in there. ✨

_traits

List of the (unresolved) traits applied to the instance. Just the raw list, no resolution, no nothing. Keepin' it real. 💜

_resolved_traits

List of traits applied to the instance resolved to full package names. This is the one that actually knows where everybody lives. 🏠

---

👀 SEE ALSO 👀

• MooseX::Traits
• MooseX::Object::Pluggable
• CatalystX::Component::Traits

---

🐛 BUGS 🐛

Please report any bugs or feature requests to bug-moosex-traits-pluggable at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MooseX-Traits-Pluggable.

I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. So like, you're not screaming into the void, bestie. You'll get updates. That's the deal. 🙈

---

👑 AUTHOR 👑

Rafael Kitover <rkitover@cpan.org>

---

🌸 CONTRIBUTORS 🌸

Tomas Doran, <bobtfish@bobtfish.net> Fitz Elliott, <fitz.elliott@gmail.com> Andreas Marienborg, <andreas.marienborg@gmail.com> Alexander Hartmaier, <abraxxa@cpan.org>

---

📜 COPYRIGHT & LICENSE 📜

Copyright (c) 2014 by the aforementioned AUTHOR and CONTRIBUTORS.

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

---

okay that's the whole page, you ate it, you read the whole thing, I'm so proud of you 🫶

this was perl v5.34.0, dated 2022-06-15, and you just finished the MooseX...uggable(3pm) page — the User Contributed Perl Documentation, iconic behavior, no notes. 💖 ✨ 🎀 🦋 🌸 💅 ⭐