heartrate - GitLite

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #golang #machine-learning #deep-learning #docker #macos #java #awesome #cli #awesome-list #pytorch

heartrate

(★ 1,840)

Simple real time visualisation of the execution of a Python program.

File Explorer

Download Latest Version (.zip)

- - favicon.ico
- - base.html
  - file.html
  - file_table.html
  - index.html
- __init__.py
- core.py
- files.py
.gitignore
LICENSE
README.md
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/alexmojaki/heartrate

Downloads the entire project code from GitHub to your computer.

cd heartrate

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install .

Installs the package published on PyPI directly — no need to clone the source.

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# heartrate

This library offers a simple real time visualisation of the execution of a Python program:

![demo](https://media.giphy.com/media/H7wUw65MLvHLoX4sMW/giphy.gif)

The numbers on the left are how many times each line has been hit. The bars show the lines that have been hit recently - longer bars mean more hits, lighter colours mean more recent.

Calls that are currently being executed are highlighted thanks to the [`executing`](https://github.com/alexmojaki/executing) library.

It also shows a live stacktrace:

![stacktrace](https://media.giphy.com/media/VIQqY8yyjYkhNfwF29/giphy.gif)

## Installation

`pip install --user heartrate`

Supports Python 3.5+.

## Usage

```python
import heartrate; heartrate.trace(browser=True)
```

This will:

- Start tracing your program
 - Start a server in a thread
 - Open a browser window displaying the visualisation of the file where `trace()` was called.

In the file view, the stacktrace is at the bottom. In the stacktrace, you can click on stack entries for files that are being traced to open the visualisation for that file at that line.

`trace` only traces the thread where it is called. To trace multiple threads, you must call it in each thread, with a different port each time.

### Options

- **`files`** determines which files get traced *in addition to the one where `trace` was called*. It must be a callable which accepts one argument: the path to a file, and returns True if the file should be traced. For convenience, a few functions are supplied for use, e.g.:

```python
    from heartrate import trace, files
    trace(files=files.path_contains('my_app', 'my_library'))
    ```
    
    The supplied functions are:
    
    - `files.all`: trace all files.
    - `files.path_contains(*substrings)` trace all files where the path contains any of the given substrings.
    - `files.contains_regex(pattern)` trace all files which contain the given regex in the file itself, so you can mark files to be traced in the source code, e.g. with a comment.
    
    The default is to trace files containing the comment "`# heartrate`" (spaces optional).
    
    If you're tracing multiple files, there are two ways to get to the pages with their visualisations:
        
    1. In the stacktrace, click on stack entries for files that are being traced. This will open the page and jump to the line in that stack entry.
    2. Go to the index page at http://localhost:9999/ (you can click on the logo in the top left corner) to see a list of traced files.

- **`host`**: HTTP host for the server. To run a remote server accessible from anywhere, use `'0.0.0.0'`. Default `'127.0.0.1'`.

- **`port`**: HTTP port for the server. Default `9999`.

- **`browser`**: if True, automatically opens a browser tab displaying the visualisation for the file where `trace` is called. False by default.

- **`daemon`**: sets whether the thread containing the server is a daemon thread. Set this to true to shut down the server once the rest of the program completes.

## Related libraries

- [pyheat](https://github.com/csurfer/pyheat): a heatmap showing which lines of a file consume the most time.
- [snoop](https://github.com/alexmojaki/snoop): a feature-rich and convenient debugging library which records every line executed, the local variables at each point, and other information.
- [birdseye](https://github.com/alexmojaki/birdseye): a debugger which lets you easily view the value of every expression