MooX::Traits(3pm)

💖 MooX::Traits 💖

okay bestie, so this is MooX::Traits — it's a Perl module from the User Contributed Perl Documentation crew, and it's literally just here to automatically apply roles at object creation time. that's the whole vibe. let's get into it 🦋

---

✨ NAME ✨

MooX::Traits — automatically apply roles at object creation time. no cap, that's it. 🎀

---

✨ SYNOPSIS ✨

okay so picture this: you got some roles.

package Role;
use Moo::Role;
has foo => ( is => 'ro', required => 1 );

and then a class:

package Class;
use Moo;
with 'MooX::Traits';

now you apply the roles to the class:

my $class = Class->with_traits('Role');

and then you get to use your customized class:

my $object = $class->new( foo => 42 );
$object->isa('Class'); # true
$object->does('Role'); # true
$object->foo; # 42

like… look at her go 💅

---

✨ DESCRIPTION ✨

was any of that SYNOPSIS giving unexpected?? 🙈 because basically, this module is the exact same thing as MooseX::Traits and MouseX::Traits, only for Moo. Quelle surprise, right? (yes bestie that's the original's little French moment, we keep it, it's iconic)

🌸 Methods 🌸

• $class->with_traits( @traits ) — returns a new class name with the traits applied. this is the main character fr fr.
• $class->new_with_traits(%args, traits => \@traits) — new_with_traits can also take a hashref, e.g.:

my $instance = $class->new_with_traits({ traits => \@traits, foo => 'bar' });

ngl, this method exists purely for compatibility with the MooseX and MouseX equivalents of this module. but generally speaking? you should prefer to use with_traits. do it for me. 🫶

• $class->_trait_namespace — this returns undef, but you can override it in your class to automatically prepend a namespace to supplied traits.

heads up bestie: this differs slightly from the MooseX and MouseX versions of this module, which have _trait_namespace as an attribute instead of a method. different energy, same name, don't get it twisted. 💀

🌈 Compatibility 🌈

even though it's called MooX::Traits, this module actually uses Role::Tiny, so it doesn't really require Moo. plot twist. if you use it in a non-Moo class, you should be able to safely consume any Role::Tiny-based traits. ✨

if you use it in a Moo class, you should also be able to consume Moo::Role-based traits and Moose::Role-based traits. slay.

Package::Variant and MooseX::Role::Parameterized roles should be usable too — just provide a hashref of arguments:

$class->with_traits( $param_role => \%args )->new( ... )

---

✨ BUGS ✨

found a bug? 😭 please report any bugs to <http://rt.cpan.org/Dist/Display.html?Queue=MooX-Traits>. do it, you'll feel better.

---

✨ SEE ALSO ✨

• MooX::Traits::Util.
• Moo::Role, Role::Tiny.
• MooseX::Traits, MouseX::Traits.

---

✨ AUTHOR ✨

Toby Inkster <tobyink@cpan.org>. 👑

---

✨ COPYRIGHT AND LICENCE ✨

This software is copyright (c) 2014 by Toby Inkster.

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

---

✨ DISCLAIMER OF WARRANTIES ✨

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

like, they said it in all caps so you know they mean it. no warranty bestie, we're all just out here vibing. 💀

---

okay that's the whole page!! this was perl v5.32.0 energy, dated 2021-01-24, and it's the MooX::Traits(3pm) page from User Contributed Perl Documentation. mwah 💖 bye bestie, go apply some roles 🦋✨