NAME
   Hash::Objectify - Create objects from hashes on the fly

VERSION
   version 0.004

SYNOPSIS
     use Hash::Objectify;

     # turn a hash reference into an object with accessors

     $object = objectify { foo => 'bar', wibble => 'wobble' };
     print $object->foo;

     # objectify with a specific class name

     $object = objectify { foo => 'bar' }, "Foo::Response";
     print ref $object; # "Foo::Response"

DESCRIPTION
   Hash::Objectify turns a hash reference into a simple object with
   accessors for each of the keys.

   One application of this module could be to create lightweight response
   objects without the extra work of setting up an entire response class
   with the framework of your choice.

   Using Hash::Objectify is slower than accessing the keys of the hash
   directly, but does provide "typo protection" since a misspelled method
   is an error.

USAGE
 objectify
     $object = objectify $hashref
     $object = objectify $hashref, $classname;

     $object->$key;          # accessor
     $object->$key($value);  # mutator

   The "objectify" function copies the hash reference (shallow copy), and
   blesses it into the given classname. If no classname is given, a
   meaningless, generated package name is used instead. In either case, the
   object will inherit from the Hash::Objectified class, which generates
   accessors on demand for any key in the hash.

   As an optimization, a generated classname will be the same for any given
   "objectify" call if the keys of the input are the same. (This avoids
   excessive accessor generation.)

   The first time a method is called on the object, an accessor will be
   dynamically generated if the key exists. If the key does not exist, an
   exception is thrown. Note: deleting a key *after* calling it as an
   accessor will not cause subsequent calls to throw an exception; the
   accessor will merely return undef.

   Objectifying with a "real" classname that does anything other than
   inherit from Hash::Objectified may lead to surprising behaviors from
   method name conflict. You probably don't want to do that.

   Objectifying anything other than an unblessed hash reference is an
   error. This is true even for objects based on blessed hash references,
   since the correct semantics are not universally obvious. If you really
   want Hash::Objectify for access to the keys of a blessed hash, you
   should make an explicit, shallow copy:

     my $copy = objectify {%$object};

SUPPORT
 Bugs / Feature Requests
   Please report any bugs or feature requests through the issue tracker at
   <https://github.com/dagolden/hash-objectify/issues>. You will be
   notified automatically of any progress on your issue.

 Source Code
   This is open source software. The code repository is available for
   public review and contribution under the terms of the license.

   <https://github.com/dagolden/hash-objectify>

     git clone https://github.com/dagolden/hash-objectify.git

AUTHOR
   David Golden <[email protected]>

COPYRIGHT AND LICENSE
   This software is Copyright (c) 2012 by David Golden.

   This is free software, licensed under:

     The Apache License, Version 2.0, January 2004

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.