NAME

Mojo::IOLoop::Subprocess::Sereal - Subprocesses with Sereal

SYNOPSIS

  use Mojo::IOLoop::Subprocess::Sereal;

  # Operation that would block the event loop for 5 seconds
  my $subprocess = Mojo::IOLoop->$_subprocess(
    sub {
      my $subprocess = shift;
      sleep 5;
      return '♥', 'Mojolicious';
    },
    sub {
      my ($subprocess, $err, @results) = @_;
      say "I $results[0] $results[1]!";
    }
  );

  # Start event loop if necessary
  Mojo::IOLoop->start unless Mojo::IOLoop->is_running;

DESCRIPTION

Mojo::IOLoop::Subprocess::Sereal provides a "$_subprocess" method which works as a drop-in replacement for "subprocess" in Mojo::IOLoop while using Sereal for data serialization. Sereal is faster than Storable and supports serialization of more reference types such as Regexp. The "FREEZE/THAW CALLBACK MECHANISM" in Sereal::Encoder is supported to control serialization of blessed objects.

See Mojo::IOLoop::Subprocess::Role::Sereal for a role to apply Sereal data serialization to any Mojo::IOLoop::Subprocess.

EXPORTS

Mojo::IOLoop::Subprocess::Sereal exports the following variable by default.

$_subprocess

  my $subprocess = Mojo::IOLoop->$_subprocess(sub {...}, sub {...});
  my $subprocess = Mojo::IOLoop->$_subprocess;
  my $subprocess = $loop->$_subprocess(sub {...}, sub {...});

Build Mojo::IOLoop::Subprocess object to perform computationally expensive operations in subprocesses, without blocking the event loop. Composes and calls "with_sereal" in Mojo::IOLoop::Subprocess::Role::Sereal to use Sereal for data serialization. If arguments are provided, they will be used to call "run" in Mojo::IOLoop::Subprocess.

BUGS

Report any issues on the public bugtracker.

AUTHOR

Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2016 by Dan Book.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

SEE ALSO

Mojo::IOLoop, Mojo::IOLoop::Subprocess::Role::Sereal, Sereal