NAME

       AnyEvent::Serialize - async serialize/deserialize function

SYNOPSIS

         use AnyEvent::Serialize ':all';
         use AnyEvent::Serialize 'serialize';
         use AnyEvent::Serialize 'deserialize';
         use AnyEvent::Serialize ... block_size => 666;

         serialize $object, sub { ($str, $recursion_detected) = @_ };
         deserialize $string, sub { my ($object, $error, $tail) = @_ }

DESCRIPTION

       Sometimes You need to serialize/deserialize a lot of data. If You do it using Data::Dumper or eval it can
       take You too much time.  This module splits (de)serialization process into fixed-size parts and does this
       work in non-blocking mode.

       This module uses Data::StreamSerializer and Data::StreamDeserializer to serialize or deserialize Your
       data.

EXPORT

   serialize($object, $result_callback)
       Serializes Your object. When serialization is done it will call $result_callback. This callback receives
       two arguments:

       result string
       flag if recursion is detected

   deserialize($str, $result_callback)
       Deserializes Your string. When deserialization is done or an error is detected it will call
       $result_callback. This callback receives three arguments:

       deserialized object
       error string (if an error was occured)
       undeserialized string tail

BREAKING

       You can break serialization/deserialization process if You save value that is returned by functions
       serialize/deserialize. They return guards if they are called in non-void context.

SEE ALSO

       Data::StreamSerializer, Data::StreamDeserializer.

AUTHOR

       Dmitry E. Oboukhov, <unera@debian.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2011 by Dmitry E. Oboukhov

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have
       available.