package MooseX::Role::WithOverloading; # git description: v0.16-18-g8c1d6d0
# ABSTRACT: (DEPRECATED) Roles which support overloading
# KEYWORDS: moose extension role operator overload overloading deprecated

our $VERSION = '0.17';

use Moose::Role ();
use Moose::Exporter;
use aliased 'MooseX::Role::WithOverloading::Meta::Role', 'MetaRole';
use aliased 'MooseX::Role::WithOverloading::Meta::Role::Application::ToClass';
use aliased 'MooseX::Role::WithOverloading::Meta::Role::Application::ToRole';
use aliased 'MooseX::Role::WithOverloading::Meta::Role::Application::ToInstance';

use namespace::clean 0.19;

# this functionality is built-in, starting with Moose 2.1300
my $has_core_support = eval { Moose->VERSION('2.1300'); 1 };

if ($has_core_support)
    Moose::Exporter->setup_import_methods(also => 'Moose::Role');
    require XSLoader;

        also           => 'Moose::Role',
        role_metaroles => {
            role                    => [MetaRole],
            application_to_class    => [ToClass],
            application_to_role     => [ToRole],
            application_to_instance => [ToInstance],




=encoding UTF-8

=head1 NAME

MooseX::Role::WithOverloading - (DEPRECATED) Roles which support overloading

=head1 VERSION

version 0.17


    package MyRole;
    use MooseX::Role::WithOverloading;

    use overload
        q{""}    => 'as_string',
        fallback => 1;

    has message => (
        is       => 'rw',
        isa      => 'Str',

    sub as_string { shift->message }

    package MyClass;
    use Moose;
    use namespace::autoclean;

    with 'MyRole';

    package main;

    my $i = MyClass->new( message => 'foobar' );
    print $i; # Prints 'foobar'


MooseX::Role::WithOverloading allows you to write a L<Moose::Role> which
defines overloaded operators and allows those overload methods to be
composed into the classes/roles/instances it's compiled to, where plain
L<Moose::Role>s would lose the overloading.

Starting with L<Moose> version 2.1300, this module is no longer necessary, as
the functionality is available already. In that case,
C<use MooseX::Role::WithOverloading> behaves identically to C<use Moose::Role>.

=for stopwords metaclasses


This module is marked as deprecated, as starting with L<Moose> version 2.1300,
the functionality provided here is now built-in to Moose. You only need to use
this module if you are using an older L<Moose> (but please upgrade!).

=head1 SUPPORT

Bugs may be submitted through L<the RT bug tracker|>
(or L<|>).

There is also a mailing list available for users of this distribution, at

There is also an irc channel available for users of this distribution, at

=head1 AUTHORS

=over 4

=item *

Florian Ragwitz <>

=item *

Tomas Doran <>



=for stopwords Karen Etheridge Dave Rolsky Jesse Luehrs Tomas Doran (t0m)

=over 4

=item *

Karen Etheridge <>

=item *

Dave Rolsky <>

=item *

Jesse Luehrs <>

=item *

Tomas Doran (t0m) <>



This software is copyright (c) 2009 by Florian Ragwitz.

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