moosex::storage::basic(3pm) [mojave man page]

MooseX::Storage::Basic(3pm)				User Contributed Perl Documentation			       MooseX::Storage::Basic(3pm)

NAME

       MooseX::Storage::Basic - The simplest level of serialization

VERSION

       version 0.45

SYNOPSIS

	 package Point;
	 use Moose;
	 use MooseX::Storage;

	 with Storage;

	 has 'x' => (is => 'rw', isa => 'Int');
	 has 'y' => (is => 'rw', isa => 'Int');

	 1;

	 my $p = Point->new(x => 10, y => 10);

	 ## methods to pack/unpack an
	 ## object in perl data structures

	 # pack the class into a hash
	 $p->pack(); # { __CLASS__ => 'Point-0.01', x => 10, y => 10 }

	 # unpack the hash into a class
	 my $p2 = Point->unpack({ __CLASS__ => 'Point-0.01', x => 10, y => 10 });

	 # unpack the hash, with insertion of paramaters
	 my $p3 = Point->unpack( $p->pack, inject => { x => 11 } );

DESCRIPTION

       This is the most basic form of serialization. This is used by default but the exported "Storage" function.

METHODS

       pack ([ disable_cycle_check = 1])>
	   Providing the "disable_cycle_check" argument disables checks for any cyclical references. The current implementation for this check is
	   rather naive, so if you know what you are doing, you can bypass this check.

	   This trait is applied on a perl-case basis. To set this flag for all objects that inherit from this role, see
	   MooseX::Storage::Traits::DisableCycleDetection.

       unpack ($data [, insert = { key => val, ... } ] )>
	   Providing the "insert" argument let's you supply additional arguments to the class' "new" function, or override ones from the
	   serialized data.

   Introspection
       meta

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to
       cpan-RT.

AUTHORS

       o   Chris Prather <chris.prather@iinteractive.com>

       o   Stevan Little <stevan.little@iinteractive.com>

       o   XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2007 by Infinity Interactive, Inc..

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

perl v5.18.2							    2013-12-21					       MooseX::Storage::Basic(3pm)

MooseX::Storage::Deferred(3pm)				User Contributed Perl Documentation			    MooseX::Storage::Deferred(3pm)

NAME

       MooseX::Storage::Deferred - A role for indecisive programmers

VERSION

       version 0.45

SYNOPSIS

	 package Point;
	 use Moose;
	 use MooseX::Storage;

	 with 'MooseX::Storage::Deferred';

	 has 'x' => (is => 'rw', isa => 'Int');
	 has 'y' => (is => 'rw', isa => 'Int');

	 1;

	 my $p = Point->new(x => 10, y => 10);

	 ## methods to freeze/thaw into
	 ## a specified serialization format
	 ## (in this case JSON)

	 # pack the class into a JSON string
	 $p->freeze({ format => 'JSON' }); # { "__CLASS__" : "Point", "x" : 10, "y" : 10 }

	 # pack the class into a JSON string using parameterized JSONpm role
	 $p->freeze({ format => [ JSONpm => { json_opts => { pretty => 1 } } ] });

	 # unpack the JSON string into a class
	 my $p2 = Point->thaw(
	     '{ "__CLASS__" : "Point", "x" : 10, "y" : 10 }',
	     { format => 'JSON' }
	 );

DESCRIPTION

       This role is designed for those times when you need to serialize into many different formats or I/O options.

       It basically allows you to choose the format and IO options only when you actually use them (see the SYNOPSIS for more info)

SUPPORTED FORMATS

       JSON
       JSONpm
       YAML
       Storable

SUPPORTED I
/O
       File
       AtomicFile

       NOTE: The StorableFile I/O option is not supported, this is because it does not mix well with options who also have a "thaw" and "freeze"
       methods like this. It is possible to probably work around this issue, but I don't currently have the need for it. If you need this
       supported, talk to me and I will see what I can do.

METHODS

       freeze ($type_desc)
       thaw ($data, $type_desc)
       load ($filename, $type_desc)
       store ($filename, $type_desc)

   Introspection
       meta

BUGS

       All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to
       cpan-RT.

AUTHORS

       o   Chris Prather <chris.prather@iinteractive.com>

       o   Stevan Little <stevan.little@iinteractive.com>

       o   XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2007 by Infinity Interactive, Inc..

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

perl v5.18.2							    2013-12-21					    MooseX::Storage::Deferred(3pm)