ti-debug v0.2.1

Server-side debugging engines using the WebKit remote debugger.

Prerequisites

At a minimum this requires node and npm to get started. I am currently using:

$ node -v
v0.10.1
$ npm -v
1.2.15

For best results, use a recent WebKit-based browser like Google Chrome or Apple Safari to connect to the ti-debug server.

Installation

git clone https://github.com/dpb587/ti-debug
cd ti-debug/
npm install

Usage

By default bin/ti-debug will start a web server on localhost:9222 for you to connect and get started debugging. When a new debug session is available the page will redirect to the debugging tools for the session. To see a full list of configuration options run bin/ti-debug --help.

DBGp

The DBGp service is enabled by default. Simple run bin/ti-debug, point your browser to localhost:9222, and configure your DBGp engine to connect to the DBGp client at localhost:9000. If you need to support multiple developers, enable the DBGp proxy server by adding the --dbgp-proxy option to the command - both browser-based and IDEs are supported.

PHP

You'll probably want to ensure the xdebug extension is installed and configured.

See Also:

• xdebug_break

Python

You'll probably want to ensure the komodo-remote-debugging module is installed. Be sure to invoke scripts with the included pydbgp.

See Also:

• dbgp.client.brk

Functionality

✓ – full support
‡ – partial support
✕ – no support

Architecture

The main purpose of ti-debug is to allow debugging protocols to be accessible through a browser interface. Currently the WebKit Inspector powers the interface and communications occur:

frontend debugger <-- frontend protocol --> ti-debug <-- debugger protocol --> debugger engine

In the case of DBGp, a client is started to wait for connections from the DBGp server. When a connection is received, it checks to see if there's a browser waiting to debug and creates a debug session for the browser to connect to. From there, Inspector-friendly agents handle translating DBGp commands into WebKit commands. For example:

References

• DBGp Protocol
• Zend/PDT Protocol
• V8 Protocol
• WebKit Announcement

Credits

• Created by Danny Berger
• WebKit - front-end (r149292, 2013-04-29 09:24:18)
• npm packages: commander, express, mocha, node-expat, node-uuid, socket.io, xml2json

License

MIT License