Profiles

Many Build Profiles are defined to optimize for different use cases.

Flowchart

As a general rule of thumb for what option to use, you can follow:

graph LR
    Start((**Start**)) --> Release("`
        Final Release?
        <small>(Slow compilation)</small>
    `")
    Release --> |No| UseDevelop([_develop_])
    Release --> |Yes| Flavor(Optimizing for)
    Flavor --> |Speed| Speed("`
        Best size and speeds?
        <small>(slowest compilation)</small>
    `")
    Flavor --> |Size| Size("`
        Smallest binary
        <small>(slower compilation)</small>
    `")
    Speed --> |No| UseFast([_fast_])
    Speed --> |Yes| UseFastest([_fastest_])
    Size --> |No| UseSmall([_small_])
    Size --> |Yes| UseSmallest([_smallest_])

Suggestion: Always use smallest for releases, plenty fast and portable 😉

Usage

Python Command Rust

project.build.profile = "fast"

pyaket build --profile fast

cargo build --profile fast

Benchmarks

Tests are made with this script, measuring:

Size: Base compiled binary size, only including the uv runtime.
Startup: Overhead until the python interpreter is called¹.
Cold: Time to build without any prior cargo build cache.
Warm: Time to rebuild after a prior cargo build cache exists.

Apple

aarch64-apple-darwin

Profile	Size	Startup	Cold	Warm
develop	45.11 MB	15.4 ms	99.2 s	11.2 s
fast	33.78 MB	10.9 ms	183.5 s	118.7 s
fastest	29.88 MB	10.3 ms	290.1 s	225.4 s
small	29.69 MB	11.1 ms	113.3 s	67.5 s
smallest	23.23 MB	10.7 ms	190.1 s	145.2 s

^{System: Macbook M2 Pro}

Linux

x86_64-unknown-linux-gnu

Profile	Size	Startup	Cold	Warm
develop	59.03 MB	32.2 ms	65.7 s	8.7 s
fast	45.10 MB	25.1 ms	158.3 s	100.7 s
fastest	40.54 MB	24.1 ms	255.2 s	198.7 s
small	36.87 MB	28.2 ms	98.8 s	57.1 s
smallest	29.74 MB	26.0 ms	170.0 s	132.3 s

^{System: Ryzen 9 5900X, 2x3200 MT/s DDR4 CL16 2Rx8}

Difference between system's python -c '' and pyaket -c '' ↩