---
name: "MooX::Traits"
section: "3pm"
platform: "linux"
package: "libmoox-traits-perl"
version: "0.005-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/MooX::Traits"
---

# MooX::Traits(3pm)

automatically apply roles at object creation time

## NAME

MooX::Traits - automatically apply roles at object creation time

## SYNOPSIS

Given some roles:

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

And a class:

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

Apply the roles to the class:

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

Then use your customized class:

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

## DESCRIPTION

Was any of the SYNOPSIS unexpected? Basically, this module is the same thing as MooseX::Traits and MouseX::Traits, only for Moo. *Quelle surprise*, right?

### Methods

- "$class-\>with\_traits( @traits )"

  Return a new class name with the traits applied.

- "$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' });
  ```

  This method exists for compatibility with the MooseX and MouseX equivalents of this module, but generally speaking you should prefer to use `"with_traits"`.

- "$class-\>\_trait\_namespace"

  This returns undef, but you can override it in your class to automatically prepend a namespace to supplied traits.

  This differs slightly from the MooseX and MouseX versions of this module which have `"_trait_namespace"` as an attribute instead of a method.

### Compatibility

Although called MooX::Traits, this module actually uses Role::Tiny, so doesn't really require Moo. 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.

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

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

## BUGS

Please report any bugs to \<http://rt.cpan.org/Dist/Display.html?Queue=MooX-Traits\>.

## 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.