Skip to main content

WebSocket Debugger

Project description

Awesome Web Debugger

How to use

Run the command awdb-server to start a server for debugging. The webserver runs on port 8080 by default. It will listen for websocket connections on path /ws.

In order to use the debugger, you can use the

Breapoints using environment variables:

The set_trace method can be defined in PYTHONBREAKPOINT environment variable as such

PYTHONBREAKPOINT=awdb.set_trace

Then in the code you can invoke the debugger using the breakpoint native method.

print(1)
breakpoint()
call_method()

Invoke a breakpoint using set_trace

Like usual debugger in python, you can invoke it using the following code snippet.

import awdb; awdb.set_trace()

Information about debugger

The debugger creates a thread with an async loop to communicate with the websocket server. So the python application must be able to connect to the debugger server.

For each thread being debugged, a thread will be spawned with a websocket client. Each thread can send asynchronuously messages to the server on their individual message loop.

The communication with the main thread is achieved using Queues.

When connected to the server, the Websocket client more or less act as a slave and wait for messages.

The control of the process start in the thread where it can be configured then moves into the frame trace method. It will block the thread in a loop that send/receives messages from the async thread.

The design allow us to continue debugging while being able to eventually interrupt the debugging session. Without having to reuse a breakpoint or even place any breakpoint.

Debugging an application

Debugging can be achieved by using the awdb-client program. it will connect to the server and provide a simple terminal user interface. There are few commands such as

  • w: show where we are
  • up/down: move in the stack
  • (-)break event line file: add a breakpoint for certain event/file/line each of those parameters can be defined as "any" for anything.
  • inspect: display the current stack frame with locals/globals and current code being executed
  • (un)subscribe uuid: subscribe to a debugging session. It will display the messages received from any subscribed session
  • use uuid: set the uuid session as the current session
  • continue: continue without breaking until it reaches a breakpoint
  • step: step to the next thing
  • stop: stop debugging (remove set_trace as tracing method)
  • list: show all sessions with their tags.
  • execute code...: execute some code in the stack frame
  • set name value: set a value in the current stack frame

Since it's using websocket, it's technically possible to run the client directly in the browser in a single page application. The websocket protocol is the only requirement to be able to debug an application.

Environment variables

Those are environment variables useful to configure the servers/client/traced app

  • AWDB_TAGS_[X]: Define tags in coma separated list used to display with the started sessions.
  • AWDB_URL: Url of the AWDB server
  • AWDB_ADMIN_TOKEN: Initial token for authentication

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

awdb-0.0.11.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

awdb-0.0.11-py3-none-any.whl (14.2 kB view details)

Uploaded Python 3

File details

Details for the file awdb-0.0.11.tar.gz.

File metadata

  • Download URL: awdb-0.0.11.tar.gz
  • Upload date:
  • Size: 11.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.6

File hashes

Hashes for awdb-0.0.11.tar.gz
Algorithm Hash digest
SHA256 579c5c922b9519cd6a0e4cf0829c655909294120a40813960e9ebfdd0aa2330a
MD5 7bf1dd6ac24a53dc40aa48de71cdd8b0
BLAKE2b-256 206710db297f5ca3f8490121e121eefe25beb4cfcf6501c65c78f906d990befc

See more details on using hashes here.

File details

Details for the file awdb-0.0.11-py3-none-any.whl.

File metadata

  • Download URL: awdb-0.0.11-py3-none-any.whl
  • Upload date:
  • Size: 14.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.24.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.6

File hashes

Hashes for awdb-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 cf2b24e7b2742e37c02f2ede980bf23f486b29fca91c50c55f0322cd06f67ac4
MD5 da91f5c14ea2055890b87bfc352c34d5
BLAKE2b-256 19dcbd3696a17f71f85b1b4bc725b6c83d6d026f0ae0af605395ba47a74849b7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page