mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-19 15:18:40 +01:00
On NixOS, running komorebi should take one flake input and one module line. The flake exports `services.komorebi` as nixosModules.default (and .komorebi). It adds the flake's overlay, which gains komorebi-full, installs komorebi and komorebic, and runs the daemon in every Plasma session as a systemd user unit, wanted by plasma-workspace.target and ordered after plasma-core.target, which Plasma orders after KWin. systemd starts a daemon that fails again; the exit status of a SIGTERM (130) counts as success, so a stopped unit is not failed. The unit's PATH is the one a terminal in the session has, instead of the few store paths NixOS gives a unit. The options are enable, package, logLevel and a read-only execStart, the command line the unit runs. There is no configFile: the daemon reads no configuration file yet, and an option that linked one would do nothing. nixos-module-eval evaluates seven scenarios as real NixOS systems and checks their assertions, the unit and execStart, with builtins.tryEval for the two that must not evaluate. Nothing in it builds a Linux package, so it runs on a Mac as well. The VM nodes import the module, so every suite runs komorebi as the module installs it. The headless node's komorebi@NAME runs execStart, which has --log-level, so the nodes set logLevel to debug and the suites stop passing it; latency, which times the daemon, keeps the default level. The session node starts the module's unit at login; render-smoke turns it off, since a tiled terminal would cover the desktop it looks at. A new fast suite, vm-module, logs in to Plasma and checks that the unit runs the daemon with the module's log level and PATH, that a window opened in the session is tiled, that a killed daemon is started again, and that a stop is not a failure. docs/installation.md covers NixOS first, and building from source on other distributions. There is no binary cache: the Komorebi license does not allow third parties to redistribute binaries.
112 lines
4.2 KiB
Nix
112 lines
4.2 KiB
Nix
# A machine with Plasma installed and no login: `kwin_wayland --virtual` runs as the test user's
|
|
# own user units, once for every session a test starts, each with its own private session bus and
|
|
# Wayland socket (`session-bus@NAME`, `kwin-virtual@NAME`). A virtual KWin has no real output, so it
|
|
# cannot draw: pixel and pointer tests use the session node instead.
|
|
#
|
|
# komorebi comes from the NixOS module, `komorebiModule`, which the test framework passes in: the
|
|
# node imports it and enables `services.komorebi` as a user's machine does, which installs
|
|
# `komorebi` and `komorebic`. The module's unit starts with a Plasma session, and this node has
|
|
# none; `komorebi@NAME` runs the module's `execStart` in a test session instead.
|
|
{
|
|
config,
|
|
lib,
|
|
pkgs,
|
|
komorebiModule,
|
|
...
|
|
}:
|
|
{
|
|
imports = [
|
|
./options.nix
|
|
komorebiModule
|
|
];
|
|
|
|
# KWin, its plugins and the environment a session expects
|
|
services.desktopManager.plasma6.enable = true;
|
|
hardware.graphics.enable = true;
|
|
|
|
# A suite can change either in its `node`. The tests read the daemon's debug log.
|
|
services.komorebi = {
|
|
enable = lib.mkDefault true;
|
|
logLevel = lib.mkDefault "debug";
|
|
};
|
|
|
|
users.users.komorebi = {
|
|
isNormalUser = true;
|
|
uid = 1000;
|
|
# keeps the user manager, and so /run/user/1000, alive without a login
|
|
linger = true;
|
|
};
|
|
|
|
virtualisation = {
|
|
memorySize = lib.mkDefault 3072;
|
|
cores = lib.mkDefault 2;
|
|
# KWin wants a DRM render node, which needs a GPU. The test driver adds one on aarch64 only.
|
|
qemu.options = lib.optionals (config.komorebi.vm.renderNode && pkgs.stdenv.hostPlatform.isx86_64) [
|
|
"-device virtio-gpu-pci"
|
|
];
|
|
};
|
|
|
|
environment.systemPackages = with pkgs; [
|
|
foot
|
|
jq
|
|
kdotool
|
|
kdePackages.libkscreen
|
|
kdePackages.qttools
|
|
];
|
|
|
|
systemd.user.services = {
|
|
"session-bus@" = {
|
|
description = "The private session bus of the test session %i";
|
|
serviceConfig.ExecStart = "${pkgs.dbus}/bin/dbus-daemon --session --address=unix:path=%t/session-%i.bus --nofork --nopidfile";
|
|
};
|
|
|
|
"kwin-virtual@" = {
|
|
description = "A headless KWin for the test session %i";
|
|
requires = [ "session-bus@%i.service" ];
|
|
after = [ "session-bus@%i.service" ];
|
|
# KWin looks for Xwayland on its PATH, when it is started with --xwayland
|
|
path = [ pkgs.xwayland ];
|
|
environment = {
|
|
DBUS_SESSION_BUS_ADDRESS = "unix:path=%t/session-%i.bus";
|
|
XDG_SESSION_TYPE = "wayland";
|
|
# software rendering makes KWin skip every animating effect unless told otherwise
|
|
KWIN_EFFECTS_FORCE_ANIMATIONS = "1";
|
|
# script print() goes through qCDebug, which is off by default
|
|
QT_LOGGING_RULES = "kwin_scripting.debug=true;js.debug=true;qml.debug=true";
|
|
};
|
|
serviceConfig = {
|
|
# the library writes KWIN_ARGS (size, number of outputs) before it starts the unit
|
|
EnvironmentFile = "-%t/kwin-virtual-%i.env";
|
|
ExecStart = "${pkgs.kdePackages.kwin}/bin/kwin_wayland --virtual --socket wayland-%i --no-lockscreen --no-global-shortcuts $KWIN_ARGS";
|
|
};
|
|
};
|
|
|
|
# The module's unit, moved to the test session's bus and Wayland socket. Not bound to KWin's
|
|
# unit: a test restarts KWin under a running daemon.
|
|
"komorebi@" = {
|
|
description = "komorebi in the test session %i";
|
|
requires = [ "session-bus@%i.service" ];
|
|
after = [
|
|
"session-bus@%i.service"
|
|
"kwin-virtual@%i.service"
|
|
];
|
|
environment = {
|
|
DBUS_SESSION_BUS_ADDRESS = "unix:path=%t/session-%i.bus";
|
|
WAYLAND_DISPLAY = "wayland-%i";
|
|
XDG_SESSION_TYPE = "wayland";
|
|
# the log is read by the test, not a terminal
|
|
NO_COLOR = "1";
|
|
};
|
|
serviceConfig = {
|
|
# the library writes KOMOREBI_ARGS (what follows the module's command line) before it
|
|
# starts the unit
|
|
EnvironmentFile = "-%t/komorebi-%i.env";
|
|
# a log file per run, emptied on every start, which the library reads
|
|
ExecStart = "${pkgs.runtimeShell} -c 'exec ${config.services.komorebi.execStart} $${KOMOREBI_ARGS} > %t/komorebi-%i.log 2>&1'";
|
|
# what komorebi exits with when it is told to stop
|
|
SuccessExitStatus = 130;
|
|
};
|
|
};
|
|
};
|
|
}
|