Hash::Inflator - Access hash entries through methods


Hash-Inflator documentation Contained in the Hash-Inflator distribution.

Index


Code Index:

NAME

Top

Hash::Inflator - Access hash entries through methods

VERSION

Top

version 1.100820

SYNOPSIS

Top

    my %h = (
        persons => [
            {
                last_name  => 'Shindou',
                first_name => 'Hikaru',
            },
            {
                last_name  => 'Touya',
                first_name => 'Akira',
            },
        ],
        # ...
    );

    my $obj = Hash::Inflator->new(%h);
    print $obj->persons->[0]->first_name;

DESCRIPTION

Top

This class can inflate a hash so that you can access it using methods instead of plain hash keys. So instead of $x->{foo} you can do $x->foo().

Why would we want to do this?

First, because this way you can quickly prototype a class. Your class can inherit from Hash::Inflator and the code using your class can just assume the attributes are there. You can bother with writing the methods later. Although tools like Class::Accessor and friends make this very easy anyway.

Second, because we can.

You can call any method on the object. If the name corresponds to a hash key, its value will be returned. If there is no such key, undef will be returned. If the hash contains other hashes (however deep down), those will become inflated as well.

The code has been taken, with very little adaption, from Net::Jaiku by Rick Measham, with his permission.

METHODS

Top

new

Takes a hash or a hash ref and returns the inflated hash as a reference.

INSTALLATION

Top

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

Top

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Hash-Inflator.

AVAILABILITY

Top

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Hash-Inflator/.

The development version lives at http://github.com/hanekomu/Hash-Inflator/. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHORS

Top

  Marcel Gruenauer <marcel@cpan.org>
  Rick Measham <rickm@cpan.org>

COPYRIGHT AND LICENSE

Top


Hash-Inflator documentation Contained in the Hash-Inflator distribution.

use 5.008;
use strict;
use warnings;

package Hash::Inflator;
our $VERSION = '1.100820';
# ABSTRACT: Access hash entries through methods

sub new {
    my $class = shift;

    # handle simple scalars - could happen if we're called with the elements
    # of a list
    return $_[0] if @_ == 1 && !ref $_[0];
    my %hash = @_ > 1 ? @_ : %{ $_[0] };
    for my $key (keys %hash) {
        if (ref $hash{$key} eq 'HASH') {
            $hash{$key} = Hash::Inflator->new($hash{$key});
        } elsif (ref $hash{$key} eq 'ARRAY') {
            $_ = Hash::Inflator->new($_) for @{ $hash{$key} };
        }
    }
    bless \%hash, $class;
}

sub AUTOLOAD {
    my $self = shift;
    our $AUTOLOAD;
    $AUTOLOAD =~ s/.+:://;
    return if $AUTOLOAD =~ /^[A-Z]+$/;
    $self->{$AUTOLOAD};
}
1;


__END__