https://github.com/gleb-sevruk/pycrunch-trace

Time Travel Debugging for Python
https://github.com/gleb-sevruk/pycrunch-trace

debugging profiler python time-travel tracing

Last synced: 3 months ago
JSON representation

Time Travel Debugging for Python

• Host: GitHub
• URL: https://github.com/gleb-sevruk/pycrunch-trace
• Owner: gleb-sevruk
• License: mit
• Created: 2020-03-04T00:45:06.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-02-10T21:30:25.000Z (over 2 years ago)
• Last Synced: 2024-03-08T07:29:47.191Z (4 months ago)
• Topics: debugging, profiler, python, time-travel, tracing
• Language: Python
• Homepage: https://pytrace.com
• Size: 225 KB
• Stars: 136
• Watchers: 4
• Forks: 10
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - pycrunch-trace - sevruk | 137 | (Python)

README

        
# UI Overview

![PyTrace UI](https://hsto.org/webt/vp/im/xd/vpimxdvufmcmirahmktwpii79vw.png)

# Quick start

[Interactive Demo](https://app.pytrace.com/?open=v0.1-interactive-demo)

[Documentation](https://pytrace.com)

`pip install pycrunch-trace`

Then, Add attribute `@trace` to the method you want to record

```python

from pycrunch_trace.client.api import trace

@trace

def run():

    some_code()

```

Or, alternatively, without decorator:

```python

from pycrunch_trace.client.api import Trace

tracer = Trace()

tracer.start('recording_name')

some_code()

tracer.stop()

```

Optional session_name can be also passed to decorator:

```python

@trace('my_custom_recording_name')

``` 

### Specifying custom folders/files to exclude 

this will greatly speed-up profiler, however calls to the ignored directories will be ignored. 

Exclusion will be considered if absolute file path either `starts_with` or `ends_with` with given stop-list. 

```python

from pycrunch_trace.client.api import Trace

 

t = Trace()

t.start(additional_excludes=[

             '/Users/gleb/.venvs/pycrunch_trace'

             '/Users/gleb/.pyenv/versions/3.6.15/',

             'unwanted_file.py',

        ])

some_code()

t.stop()

```

This is also possible via decorator:

```python

from pycrunch_trace.client.api import trace

@trace(additional_excludes=['/Users/gleb/.venvs/pycrunch_trace'])

def run():

    some_code()

```

Use web app for replaying recording:

http://app.pytrace.com/

In case if you want to run UI locally, instead of using hosted version:

[Link for web app source code](https://github.com/gleb-sevruk/pycrunch-tracing-webui)

(Replays are not sent anywhere and processed entirely in-memory)