Build from Source¶

Prerequisites¶

Ubuntu / Debian¶

sudo apt-get install build-essential ccache cmake pkg-config python3-dev \
  python3-numpy

Arch (incl. Manjaro, EndeavourOS, CachyOS)¶

sudo pacman -S --needed base-devel ccache cmake pkgconf python python-numpy

Fedora / RHEL (incl. Rocky, AlmaLinux)¶

sudo dnf install gcc make ccache cmake pkgconf-pkg-config python3-devel \
  python3-numpy

openSUSE (Leap / Tumbleweed)¶

sudo zypper install gcc make ccache cmake pkg-config python3-devel \
  python3-numpy

macOS¶

brew install cmake ccache pkg-config python numpy

Windows¶

The C library builds natively on Windows and its full C test suite passes, with either of clang's two drivers against the MSVC runtime:

Both also need CMake 3.16+, Ninja, and the Windows SDK (installed with Visual Studio's C++ workload). MSVC's own cl.exe cannot build doppler: it has no C99 _Complex, and native/inc/doppler/dp_complex.h stops the build with an #error saying so.

From a Developer PowerShell for VS (x64), which puts the SDK and linker on the path:

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER=clang-cl
cmake --build build
ctest --test-dir build --output-on-failure

This is the build .github/workflows/windows.yml runs, once per driver, on every push to main and on pull requests that touch the C. The clang-cl build is binding (ci.yml's Windows job) and is what every release publishes as doppler-<version>-windows-x86_64.zip — see Install the C library → Windows to use it without building. For Python on Windows, pip install doppler-dsp installs a pre-built wheel; see Install for Python. On Windows the static library is doppler_static.lib, because doppler.lib is already the DLL's import library. The CMake target names (doppler::doppler, doppler::doppler-static) are the same on every platform.

Not available on Windows yet. These are not ported, and CMake leaves them out of a Windows build rather than failing:

• the NATS stream layer (libdoppler_stream, dp_pub_* / dp_sub_*), and everything built on it: the wfm StreamSink, the wfmgen CLI and doppler_wfmgen, and the streaming examples;
• the Rust crate, which is built and tested on Linux and macOS only. (The Python extensions do build on Windows, without doppler.stream and StreamSink; CI builds and tests them with clang-cl on every PR.)
• a few tests of POSIX-only behaviour (signal chaining in dp_interrupt, a memory soak that reads getrusage).

Each carve-out is tracked on #1364.

Build¶

make
make pyext

Or directly with CMake:

cmake -B build -S . -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

CMake options¶

Example — build Python extensions against a specific interpreter:

cmake -B build -S . \
    -DCMAKE_BUILD_TYPE=Release \
    -DBUILD_PYTHON=ON \
    -DPython3_EXECUTABLE="$(which python3)"
cmake --build build --parallel

Make targets¶