polars-lprof 0.1.0

Read line profiler reports into Polars DataFrames

polars-lprof

Read line_profiler reports into Polars DataFrames

Installation

The polars-lprof package can be installed with either polars or polars-lts-cpu using the extras by those names:

pip install polars-lprof[polars]
pip install polars-lprof[polars-lts-cpu]

If Polars is already installed, you can simply pip install polars-lprof.

Usage

Note: use this tool after running Python code with @line_profiler.profile decorators on functions which will output .txt plain text reports on the program's performance. The line_profiler tool relies on the environment variable set with export LINE_PROFILE=1.

First run your line_profiler (in whichever variations you want) and then use this tool to analyse the performance reports (named like profile_output_2025-02-04T002856.txt). The most recent one will always be called profile_output.txt but often we want to collect multiple for review.

plprof profile_output.txt

Use it from Python as a library:

from plprof import parse_lprof

metadata, lines = parse_lprof("profile_output.txt")