installation.md

Installation

• Distribution packages
  • Ubuntu
  • Fedora
  • Arch Linux
  • Conda
  • Nix
  • Windows
  • macOS
• Building from source
  • Linux
  • macOS
  • Windows
    • Visual Studio native build
• Shell autocompletion scripts
  • Bash
  • Zsh

Distribution packages

Ubuntu

# Currently supported Ubuntu versions are Focal, Jammy and Mantic
sudo add-apt-repository ppa:bkryza/clang-uml
sudo apt update
sudo apt install clang-uml

Fedora

# Fedora 38
wget https://github.com/bkryza/clang-uml/releases/download/0.5.5/clang-uml-0.5.4-1.fc38.x86_64.rpm
sudo dnf install ./clang-uml-0.5.5-1.fc38.x86_64.rpm

# Fedora 39
wget https://github.com/bkryza/clang-uml/releases/download/0.5.5/clang-uml-0.5.5-1.fc39.x86_64.rpm
sudo dnf install ./clang-uml-0.5.5-1.fc39.x86_64.rpm

# Fedora 40
wget https://github.com/bkryza/clang-uml/releases/download/0.5.5/clang-uml-0.5.5-1.fc40.x86_64.rpm
sudo dnf install ./clang-uml-0.5.5-1.fc40.x86_64.rpm

Arch Linux

clang-uml is available from AUR, and can be installed using several methods:

git clone https://aur.archlinux.org/clang-uml.git
cd clang-uml
makepkg -s -i -c

or using yay:

yay -S clang-uml

Conda

conda config --add channels conda-forge
conda config --set channel_priority strict
conda install -c bkryza/label/clang-uml clang-uml

Nix

You can use the version packaged in nixpkgs like this: Currently clang-uml version 0.5.2 is available in nixos-unstable and nixos-24.05

nix-shell -p clang-uml

Or you can build it by yourself

# To build it by yourself
git clone https://github.com/bkryza/clang-uml

# To build using nix flakes
nix --extra-experimental-features 'nix-command flakes' build

# or without nix flakes
nix-build -E 'with import <nixpkgs> { }; callPackage ./packaging/nix { }'

Or if you have flake enabled, you can also directly run

nix run github:bkryza/clang-uml

Windows

Download and run the latest Windows installer from Releases page.

macOS

Use Homebrew:

brew install clang-uml

Building from source

Linux

First make sure that you have the following dependencies installed:

# Ubuntu (Clang version will vary depending on Ubuntu version - below example is for Ubuntu 24.04)
apt install make gcc g++ ccache cmake libyaml-cpp-dev llvm-18 clang-18 libclang-18-dev libclang-cpp18-dev

Then proceed with building the sources:

git clone https://github.com/bkryza/clang-uml
cd clang-uml
# Please note that top level Makefile is just a convenience wrapper for CMake
make release
release/src/clang-uml --help

# To build using a specific installed version of LLVM use:
LLVM_VERSION=18 make release
# or specify a path to a specific llvm-config binary, e.g.:
LLVM_CONFIG_PATH=/usr/bin/llvm-config-18 make release
# or directly specify the path where LLVMConfig.cmake can be found on your system, e.g.:
CMAKE_PREFIX=/usr/lib/llvm-18/lib/cmake/llvm make release

# By default clang-uml is linked against shared LLVM libraries, this can be changed using:
LLVM_SHARED=OFF LLVM_VERSION=18 make release

# Optionally, to install in default prefix
make install
# or to install in custom prefix
make install DESTDIR=/opt/clang-uml
# or simply
export PATH=$PATH:$PWD/release

macOS

On Intel-based macOS:

brew install ccache cmake llvm yaml-cpp

export CC=/usr/local/opt/llvm/bin/clang
export CXX=/usr/local/opt/llvm/bin/clang++
LLVM_VERSION=18 make release
# or, if this fails, try:
CMAKE_PREFIX=/usr/local/opt/llvm/lib/cmake/llvm make release

On Arm-based macOS (since Ventura):

brew install ccache cmake llvm yaml-cpp

export CC=/opt/homebrew/opt/llvm/bin/clang
export CXX=/opt/homebrew/opt/llvm/bin/clang++
CMAKE_PREFIX=/opt/homebrew/opt/llvm/lib/cmake/llvm CMAKE_EXE_LINKER_FLAGS="-L/opt/homebrew/opt/llvm/lib/c++ -Wl,-rpath,/opt/homebrew/opt/llvm/lib/c++" make release

These paths will use the latest LLVM version installed by brew. If you want to use a specific version, you will need to adjust the paths.

Windows

Visual Studio native build

These steps present how to build and use clang-uml natively using Microsoft Visual Studio only.

First, install the following dependencies manually:

• Python 3
• Git
• CMake
• Visual Studio

All the following steps should be invoked in Developer PowerShell for VS.

Create installation directory for clang-uml and its dependencies:

# This is where clang-uml binary and its dependencies will be installed after build
# If you change this path, adapt all consecutive steps
mkdir C:\clang-uml
# This directory will be removed after build
mkdir C:\clang-uml-tmp
cd C:\clang-uml-tmp

Build and install yaml-cpp:

git clone https://github.com/jbeder/yaml-cpp
cd yaml-cpp
git checkout yaml-cpp-0.8.0
cd ..
cmake -S .\yaml-cpp\ -B .\yaml-cpp-build\ -DYAML_BUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX="C:\clang-uml" -Thost=x64
cd yaml-cpp-build
msbuild .\INSTALL.vcxproj -maxcpucount /p:Configuration=Release

Build and install LLVM:

pip install psutil
# Update the LLVM branch if necessary
git clone --branch llvmorg-19.1.3 --depth 1 https://github.com/llvm/llvm-project.git llvm
cmake -S .\llvm\llvm -B llvm-build -DLLVM_ENABLE_PROJECTS=clang -DCMAKE_INSTALL_PREFIX="C:\clang-uml" -DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD=X86 -Thost=x64
cd llvm-build
msbuild .\INSTALL.vcxproj -maxcpucount /p:Configuration=Release

Build and install clang-uml:

git clone https://github.com/bkryza/clang-uml
cmake -S .\clang-uml\ -B .\clang-uml-build\ -DCMAKE_INSTALL_PREFIX="C:\clang-uml" -DCMAKE_PREFIX_PATH="C:\clang-uml" -DBUILD_TESTS=OFF -Thost=x64
cd clang-uml-build
msbuild .\INSTALL.vcxproj -maxcpucount /p:Configuration=Release

Check if clang-uml works:

cd C:\clang-uml
bin\clang-uml.exe --version

It should produce something like:

clang-uml 0.5.5
Copyright (C) 2021-2024 Bartek Kryza <bkryza@gmail.com>
Linux x86_64 6.5.0-21-generic
Built against LLVM/Clang libraries version: 18.1.8
Using LLVM/Clang libraries version: Ubuntu clang version 18.1.8

Finally, remove the temporary build directory:

rm -r C:\clang-uml-tmp

Shell autocompletion scripts

For Linux and macos, Bash and Zsh autocomplete scripts are available, and if clang-uml is installed from a distribution package they should work out of the box. When installing clang-uml from sources the files need to be installed manually. The completion scripts are available in directory:

• packaging/autocomplete

Bash

The clang-uml script can be either directly loaded to the current Bash session using:

source clang-uml

or the script can be copied to /usr/share/bash-completion/completions/ or /etc/bash_completion.d on Linux or to /usr/local/etc/bash_completion.d on macos with Homebrew.

sudo cp packaging/autocomplete/clang-uml /usr/share/bash-completion/completions/

Make sure autocompletion is enabled in your ~/.bashrc or ~/.bash_profile:

if [ -f /etc/bash_completion ]; then
  . /etc/bash_completion
fi

On OSX you might need to install bash-completion using Homebrew:

brew install bash-completion

Make sure to the following lines are uncommented in the ~/.bashrc:

if [ -f $(brew --prefix)/etc/bash_completion ]; then
  . $(brew --prefix)/etc/bash_completion
fi

Zsh

In Zsh, the _clang-uml Zsh completion file must be copied to one of the folders under $FPATH variable, and the Zsh terminal should be reopened.

For testing, _clang-uml completion function can be updated without restarting Zsh:

# Copy _clang-uml somewhere under $FPATH
$ unfunction _clang-uml
$ autoload -U _clang-uml