quinzee.cloud

Development edition · 16 November 2026. Commands using repository paths, Make targets or sample projects require access to the Quinzee source checkout. No public installer is available. Examples use disposable local environments.

Contributor’s guide

6. Build System and Dependency Cache

CMake

  • CMakeLists.txt: C++20, GCC 13+ check, TRIGLAV_PROFILE, output directories.
  • cmake/triglav_compiler_options.cmake: warnings and per-profile flags; triglav_apply_project_options() and triglav_apply_executable_options() (static libstdc++/libgcc for debug and release).
  • cmake/triglav_dependencies.cmake: runs prepare.sh, parses name=prefix, finds OpenSSL and Simple in CONFIG mode with NO_DEFAULT_PATH, and defines triglav::boost_headers.

Additional helpers: triglav_apply_imported_options() gives imported code (the Simple package wrapper, Boost.JSON) the profile flags and -Wall -Wextra -Wpedantic without the first-party baseline and -Werror. QHQ's post-build step copies the installed SIMPLE_ASSET_DIR and src/qhq/assets/logos/ to bin/<profile>/assets/.

Parallel builds

The root Makefile adds --jobs=$(JOBS) to MAKEFLAGS, invokes CMake builds with a + recipe prefix so the generated makefiles join Make's jobserver, and runs CTest with --parallel. Never add a serial step; Docker builds use -j"$(nproc)".

prepare.sh

for each manifest line (name version recipe source_identity url):
    identity = hash(recipe, package, archive sha, patches[, variant, toolchain, glibc, arch])
    lock .packages/locks/<name>.lock
    if installed/<platform>/<name>-<ver>-<id12>/.triglav-complete: reuse
    else: fetch (HTTPS archive + SHA-256, or Git + exact commit)
          → extract/checkout + patch (sources/, atomic)
          → build into staging (DESTDIR) → file hash list → identity
          → complete marker → rename into place
    print name=prefix

Adding a dependency means adding a manifest line and, if it needs compiling, a recipe function and an entry in required_file_for. Bump recipe_version when recipe behaviour changes, so existing entries are rebuilt.

TRIGLAV_PACKAGES_DIR, TRIGLAV_DEPS_MANIFEST, and TRIGLAV_DEPS_PATCHES redirect the script (the lifecycle test uses them). TRIGLAV_DEPS_ALLOW_FILE_URLS=1 is for tests only. --without-simple skips the UI package for service-only builds. CMake uses this when TRIGLAV_BUILD_QHQ=OFF, as in the runtime Docker build.

Messaging and Functions dependencies

Service Bus adds source-built Apache Qpid Proton for AMQP framing/state and shares the verified SQLite dependency with Table Storage. The broker store remains in-process; it does not require an external broker container.

Functions uses an optional Microsoft Functions host image and locked .NET worker and binding packages. make functions-example publishes the worker and builds its local image; registration resolves the image to an immutable ID. Runtime image approval and helper operation remain separate from the native cloud build. See messaging and Functions for the source map.

Manual publication

make pdf builds the developer, administrator and internals books independently of the native targets. make manuals-check verifies their assembly, code, assets and destinations. make manual-screenshots refreshes the illustrations through an isolated live application test. The publishing guide (source checkout required) explains their caches, output paths and verification.

make admin-manual-screenshots captures the administrative atlas against a separate native HTTPS lab. The ordinary PDF build reads reviewed PNGs and starts no cloud service. Its pinned Node/Chromium tools live in .packages; all three PDF/HTML publications go into bin/manuals.