Build 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_])

Usage¶

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¶

^{System: Macbook M2 Pro}

Linux¶

x86_64-unknown-linux-gnu¶

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