The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Squatting::With::Coro::Debug - inspect running Squatting apps with Coro::Debug

SYNOPSIS

From the command line:

squatting --module With::Coro::Debug App

From a script:

use App qw(On::Continuity With::Coro::Debug);
App->init;
App->continue();

Connect to Coro::Debug in another terminal

socat readline unix:/tmp/squatting.with.coro.debug

A Coro::Debug session looks like this:

> ps
               PID SC  RSS USES Description              Where
         142161516 RC 245k   23 [main::]                 [Event.pm:164]
         142188912 -- 1404    4 [coro manager]           [Coro.pm:358]
         142189128 N-   84    0 [unblock_sub scheduler]  -
         142455240 N-   84    0 [Event idle process]     -
         146549540 -- 7340   14                          [HttpDaemon.pm:426]
         146549792 -- 2088    5                          [Continuity.pm:436]
         146552468 UC 3344    6 [Coro::Debug session]    [Coro.pm:257]

DESCRIPTION

Using this module in conjunction with a Squatting app that's running on top of Continuity will provide you with a Coro::Debug server that you can connect to using tools like socat. This will let you inspect the state of your Squatting app while its running.

CONFIG

with.coro.debug.unix_domain_socket

This should be a string that represents the path of the Unix domain socket that Coro::Debug will use. If this option is not set, the default value is /tmp/squatting.with.coro.debug.

Example

$CONFIG{'with.coro.debug.unix_domain_socket'} = '/tmp/coro-debug-socket';

SEE ALSO

Perl Modules

Coro, Coro::Debug, Continuity, Squatting::On::Continuity

socat

http://www.dest-unreach.org/socat/