NAME

Tie::Moose - tie a hash to a Moose object (yeah, like Tie::MooseObject)

SYNOPSIS

        use v5.14;
        
        package Person {
                use Moose;
                has name => (
                        is     => "rw",
                        isa    => "Str",
                );
                has age => (
                        is     => "rw",
                        isa    => "Num",
                        reader => "get_age",
                        writer => "set_age",
                );
        }
        
        my $bob = Person->new(name => "Robert");
        
        tie my %bob, "Tie::Moose", $bob;
        
        $bob{age} = 32;       # calls the "set_age" method
        $bob{age} = "x";      # would croak
        $bob{xyz} = "x";      # would croak

DESCRIPTION

This module is much like Tie::MooseObject. It ties a hash to an instance of a Moose-based class, allowing you to access attributes as hash keys. It uses the accessors provided by Moose, and thus honours read-only attributes, type constraints and coercions, triggers, etc.

There are a few key differences with Tie::MooseObject:

• It handles differently named getters/setters more to my liking. Given the example in the SYNOPSIS, with Tie::MooseObject you need to write:

          $bob{set_age} = 32;
          say $bob{get_age};

  Whereas with Tie::Moose, you just use the age hash key for both fetching from and storing to the hash.

• Implements DELETE from the Tie::Hash interface. Tie::MooseObject does not allow keys to be deleted from its hashes.

  (DELETE only works on Moose attributes that have a "clearer" method.)

• Supplied with various traits to influence the behaviour of the tied hash.

          tie my %bob, "Tie::Moose"->with_traits("ReadOnly"), $bob;

  (Note that by design, many of the traits supplied with Tie::Moose are mutually exclusive.)

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Tie-Moose.

SEE ALSO

Tie::MooseObject.

Traits for Tie::Moose hashes: Tie::Moose::ReadOnly, Tie::Moose::Forgiving, Tie::Moose::FallbackHash, Tie::Moose::FallbackSlot.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

This software is copyright (c) 2013 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.