A python tracer
Project description
Panopticon
Panopticon is a debugger-powered tracer for Python code to quickly visualize and explore code execution. Traces generated are Catapult compatible — available at `chrome://tracing` if you're using Chrome.
Alpha: I'm still working on adding tests, polishing the api, and cleaning up the code in general. Expect the API to change drastically as it meanders towards v1. It should still be immediately useful as a debugging tool. Please report issues if you come across bugs!
Usage
You can read a more detailed guide with several examples of simple Python programs, different interfaces to visualize them and the corresponding traces at explog.in/panopticon.
Run a command directly
python3 -m panopticon -c "print('hello')" -o print_hello.trace
Run a file
python3 -m panopticon -o file.trace file.py
In code
from panopticon import record_trace
with record_trace("print_hello.trace"):
print("Hello")
Probe a specific function
It can be tricky to control how a program is executed: using the probe decorator allows instrumenting a specific function instead.
from panopticon.probe import probe
from panopticon.trace import StreamingTrace
@probe(trace=StreamingTrace(open("probe.trace", "w")))
def myfunction():
...
Asynchronous Functions
Python supports suspending and continuing execution of a frame through generators, coroutines and asynchronous generators. Panopticon creates "flow" events to connect a single frame executing through time, making it easier to visualize what's actually happening.
You can enable/disable connections for different types of functions by choosing to enable/disable flow events in Catapult (top-right).
Changelog
0.0.4
- Reimplement probes to be more robust and avoid capturing all contents
- Support for probing functions, coroutines, generators and async generators
- Probes can now write to multiple traces
0.0.3
- Added basic support for capturing arguments in traces
- New utility to "flatten" complex or sparse traces for readability
- Improved naming behavior when
self
is modified - Extremely basic support for async probes
0.0.2
- Added a simplified record_trace API
- Added support for @probe to instrument functions and classes
0.0.1
- Initial version of Panopticon
- CLI supports running commands and files for tracing
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
Built Distribution
Hashes for panopticon-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 22e7e63709c6492d23a394e8787a7b19a616f31da357b8326f0be3b6584cee5d |
|
MD5 | 91a22bc429994488585e32f7a42477a6 |
|
BLAKE2b-256 | 4b8227833eb8d3c0bbd34dc74245f477bded43d8ab13121a263eb5649b206aea |