Build and Install Guide

wirelog is designed to be lightweight and portable. Building requires only standard C tooling — no external runtimes or language toolchains.

Prerequisites

Before building wirelog, you need the following tools installed on your system:

• C11 Compiler: gcc or clang
• Build System: meson (>= 0.60.0) and ninja

Depending on your operating system, follow the specific commands below.

Ubuntu / Debian

# Update package list
sudo apt-get update

# Install build tools
sudo apt-get install -y build-essential python3-pip ninja-build

# Install Meson via pip (to get a recent version)
pip3 install --user meson

macOS

Using Homebrew:

# Install Meson, Ninja
brew install meson ninja

Note: macOS typically comes with clang pre-installed via Xcode Command Line Tools. If not, run xcode-select --install.

Windows

The easiest way to build on Windows is using MSYS2 or the Windows Subsystem for Linux (WSL).

WSL (Ubuntu)

Follow the Ubuntu / Debian instructions inside your WSL terminal.

MSYS2 (MinGW64)

Open the MSYS2 MinGW 64-bit terminal:

# Install GCC, Ninja, and Python
pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-ninja python3-pip

# Install Meson
pip3 install meson

---

Building

Once your prerequisites are satisfied, building wirelog is straightforward. Clone the repository and initialize the Meson build directory:

# Clone the repository
git clone https://github.com/justinjoy/wirelog.git
cd wirelog

# Setup the build directory
meson setup builddir

# Compile the project
meson compile -C builddir

Running wirelog

After a successful build, the wirelog-cli binary will be located in the builddir folder. You can run a Datalog program by passing the file to the CLI:

./builddir/wirelog-cli your_program.dl

For more details on CLI options, see the CLI Usage.