Installation¶

Installing UNIT¶

UNIT can be installed via Git and CMake:

bash¶

git clone https://github.com/ZeroIntensity/unit && cd unit
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
sudo cmake --install build

This installs the library and headers to your system’s default prefix (on Linux, this is /usr/local). To install elsewhere, pass the CMAKE_INSTALL_PREFIX setting:

bash¶

cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$HOME/.local
cmake --build build
cmake --install build

Python bindings¶

Alternatively, if you plan on using the Python bindings without the C API or C++ API, you can solely install that using your preferred package manager:

bash¶

pip install unit-compiler

bash¶

uv add unit-compiler

bash¶

poetry add unit-compiler

bash¶

pdm add unit-compiler

bash¶

pipenv install unit-compiler

bash¶

conda install -c conda-forge unit-compiler

bash¶

pixi add unit-compiler

bash¶

hatch dep add unit-compiler

Using UNIT in your project¶

CMakeLists.txt¶

find_package(unit REQUIRED)
target_link_libraries(my_program PRIVATE unit::unit)

meson.build¶

unit_dep = dependency('unit')
executable('my_program', 'main.c', dependencies: unit_dep)

bash¶

gcc -o my_program main.c $(pkg-config --cflags --libs unit)

Makefile¶

CFLAGS := $(shell pkg-config --cflags unit)
LDFLAGS := $(shell pkg-config --libs unit)

bash¶

gcc -o my_program main.c -lunit

Powershell¶

cl /I path\to\unit\include main.c /link path\to\unit\lib\unit.lib