Merge branch 'master' of https://github.com/christofmuc/KnobKraft-orm

Author: christofmuc

.dockerignore

@@ -0,0 +1,19 @@
+.builds/
+.pytest_cache/
+.vscode/
+Builds/
+build/
+builds/
+node_modules/
+public/
+venv/
+venv*/
+
+*.aps
+*.dmg
+*.exe
+*.msi
+Screenshot*.png
+youtube-screenshot.PNG
+*.tar.gz
+*.zip

.github/workflows/builds-archlinux-docker.yml

@@ -0,0 +1,28 @@
+# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
+
+name: Arch Linux Docker Build
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build-archlinux-docker:
+    runs-on: ubuntu-24.04
+    timeout-minutes: 90
+    steps:
+    - name: Checkout repository with tags and submodules
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        submodules: recursive
+
+    - name: Build Arch Linux Docker image
+      run: docker build --pull -f docker/archlinux/Dockerfile -t knobkraft-orm-arch .
+
+    - name: Verify executable can be copied from the image
+      run: |
+        container_id=$(docker create knobkraft-orm-arch)
+        docker cp "$container_id:/KnobKraft-orm/builds/The-Orm/KnobKraftOrm" ./KnobKraftOrm-arch
+        docker rm "$container_id"
+        test -s ./KnobKraftOrm-arch

README.md

@@ -179,7 +179,7 @@ This will produce the executable in the path `builds\The-Orm\Release`, namely a
 
 ## Building on Linux
 
-See the azure-pipelines.yml file for some hints how the Ubuntu server is doing it. Mainly, you need to install a long list of prerequisites and development libraries:
+See the GitHub Actions workflow files for some hints how the Ubuntu server is doing it. Mainly, you need to install a long list of prerequisites and development libraries:
 
     sudo apt-get -y update && sudo apt-get install -y libcurl4-openssl-dev pkg-config libtbb-dev libasound2-dev libboost-dev libgtk-3-dev libwebkit2gtk-4.0-dev libglew-dev libjack-dev libicu-dev libpython3-all-dev
 
@@ -192,6 +192,25 @@ This will produce a single executable `builds/The-Orm/KnobKraftOrm` that you can
 
 The LDFLAGS is required for a certain combination of gcc version/pybind11, else you will run into internal compiler errors. See issue #6 for a discussion.
 
+## Building on Arch Linux with Docker
+
+If you are running Arch Linux (or an Arch derivative) and the release binary fails due to library mismatches, you can build an Arch-linked binary in Docker using `docker/archlinux/Dockerfile`. This is based on the setup contributed in issue #319.
+
+Clone the repository with submodules and build the Docker image from the repository root:
+
+    git clone --recurse-submodules https://github.com/christofmuc/KnobKraft-orm
+    cd KnobKraft-orm
+    docker build -f docker/archlinux/Dockerfile -t knobkraft-orm-arch .
+
+The Docker build compiles KnobKraft Orm and runs the PatchDatabase doctest binary. The resulting `KnobKraftOrm` executable is linked against Arch Linux libraries and is expected to run on Arch or Arch-derivative hosts only; for Debian, Ubuntu, Fedora, or other distributions, use the native Linux build instructions above or create a matching distro-specific Docker build instead. To copy the compiled application out of the image:
+
+    container_id=$(docker create knobkraft-orm-arch)
+    docker cp "$container_id:/KnobKraft-orm/builds/The-Orm" ./The-Orm-arch
+    docker rm "$container_id"
+    ./The-Orm-arch/KnobKraftOrm
+
+The same Dockerfile is built by the `Arch Linux Docker Build` GitHub Action so the documented Arch build path is checked regularly.
+
 ## Building on macOS
 
 If you are inclined to build on Mac, you know what you're doing. I'd recommend to install the build requisites via homebrew like this

docker/archlinux/Dockerfile

@@ -0,0 +1,42 @@
+FROM archlinux:base-devel AS dependencies
+
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+
+RUN pacman -Syu --noconfirm \
+    && pacman -S --needed --noconfirm \
+        alsa-lib \
+        cmake \
+        curl \
+        freetype2 \
+        git \
+        glew \
+        gtk3 \
+        icu \
+        jack2 \
+        libxext \
+        mesa \
+        pkgconf \
+        python \
+        tbb \
+        webkit2gtk-4.1 \
+    && pacman -Scc --noconfirm
+
+FROM dependencies AS build
+
+WORKDIR /KnobKraft-orm
+COPY . .
+
+RUN git config --global --add safe.directory /KnobKraft-orm \
+    && git submodule update --recursive --init --depth 1
+
+RUN cmake -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=off \
+    -DBUILD_PATCH_DATABASE_TESTS=ON \
+    -S . \
+    -B builds
+
+RUN cmake --build builds --parallel "$(nproc)"
+
+RUN cmake --build builds --target patch_database_migration_test --parallel "$(nproc)" \
+    && ./builds/patch_database_migration_test
+
+RUN test -x builds/The-Orm/KnobKraftOrm