NAME

       Test::UNIXSock - testing UNIX domain socket program

SYNOPSIS

           use Test::UNIXSock;

           my $server = Test::UNIXSock->new(
               code => sub {
                   my $path = shift;
                   ...
               },
           );
           my $client = MyClient->new( sock => $server->path );
           undef $server; # kill child process on DESTROY

       Using memcached:

           use Test::UNIXSock;

           my $memcached = Test::UNIXSock->new(
               code => sub {
                   my $path = shift;

                   exec $bin, '-s' => $path;
                   die "cannot execute $bin: $!";
               },
           );
           my $memd = Cache::Memcached->new({servers => [$memcached->path]});
           ...

       And functional interface is available:

           use Test::UNIXSock;
           test_unix_sock(
               client => sub {
                   my ($path, $server_pid) = @_;
                   # send request to the server
               },
               server => sub {
                   my $path = shift;
                   # run server
               },
           );

DESCRIPTION

       Test::UNIXSock is a test utility to test UNIX domain socket server programs.

       This is based on Test::TCP.

METHODS

       test_unixsock
           Functional interface.

               test_unixsock(
                   client => sub {
                       my $path = shift;
                       # send request to the server
                   },
                   server => sub {
                       my $path = shift;
                       # run server
                   },
                   # optional
                   path => "/tmp/mytest.sock", # if not specified, create a sock in tmpdir
                   max_wait => 3, # seconds
               );

       wait_unix_sock
               wait_unix_sock({ path => $path });

           Waits for a particular path is available for connect.

Object Oriented interface interface

       my $server = Test::UNIXSock->new(%args);
           Create new instance of Test::UNIXSock.

           Arguments are following:

           $args{auto_start}: Boolean
               Call "$server->start()" after create instance.

               Default: true

           $args{code}: CodeRef
               The callback function. Argument for callback function is: "$code->($pid)".

               This parameter is required.

           $args{max_wait} : Number
               Will wait for at most $max_wait seconds before checking port.

               See also Net::EmptyPort.

               Default: 10

       $server->start()
           Start the server process. Normally, you don't need to call this method.

       $server->stop()
           Stop the server process.

       my $pid = $server->pid();
           Get the pid of child process.

       my $port = $server->port();
           Get the port number of child process.

FAQ

       See also Test::TCP FAQ section.

AUTHOR

       Fujiwara Shunichiro <fujiwara.shunichiro@gmail.com>

SEE ALSO

       Test::TCP

LICENSE

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

       This module is based on Test::TCP. copyright (c) 2013 by Tokuhiro Matsuno
       <tokuhirom@gmail.com>.