NAME

DBGp::Client::Connection - DBGp connection class

SYNOPSIS

    $connection = $listener->accept;

    $res = $connection->send_command('step_over');
    die $res->message if $res->is_error;

    $res = $connection->send_command('eval', '--', encode_base64('$var'));
    die $res->message if $res->is_error;

    # assumes result is a scalar value, it should check ->children
    print $res->result->value, "\n";

DESCRIPTION

Simple blocking interface for a DBGp connection.

METHODS

new

    $connection = DBGp::Client::Connection->new(
        socket  => $connected_socket,
    );

Usually called by DBGp::Client::Listener, not used directly.

Creates a new connection object wrapping the passed-in socket; after construction, call "parse_init" to process the initialization message sent by the debugger.

parse_init

    $init = $connection->parse_init;

Usually called by DBGp::Client::Listener, not used directly.

Parses the init message sent by the debugger, and returns a "init" in DBGp::Client::Response object.

send_command

    $res = $connection->send_command('step_over');
    $res = $connection->send_command('eval', '--', 'base64-encoded-data');

Sends a command to the debugger, parses the answer and returns it as a response object (see DBGp::Client::Response).

It automatically adds the DBGp transaction id (-i parameter) to the command.

Note that this method could block indefinitely.

on_stream

    $connection->on_stream(sub { ... });

Set a callback for receiving redirected program output.

The callback receives a "stream" in DBGp::Client::Response object.

on_notification

    $connection->on_notification(sub { ... });

Set a callback for receiving notifications.

The callback receives a "notify" in DBGp::Client::Response object.

AUTHOR

Mattia Barbon <mbarbon@cpan.org>

LICENSE

Copyright (c) 2015 Mattia Barbon. All rights reserved.

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

cpanm DBGp::Client

perl -MCPAN -e shell
install DBGp::Client