Files
cinereal fb6a0c6d39 modules: add modular services support
Adds `home.services`, an attribute set of nixpkgs
[modular services](https://nixos.org/manual/nixos/unstable/#modular-services)
sourced from `<nixpkgs/lib/services/lib.nix>`. Each service exposes
`process.argv` and the upstream NixOS-style systemd schema
(`systemd.lib`, `systemd.mainExecStart`, `systemd.service`,
`systemd.services`, `systemd.sockets`) by re-exporting
`nixos/modules/system/service/systemd/service.nix`. Service modules
shipped with `_class = "service"` (e.g.
`pkgs.<name>.passthru.services.default`) drop in unchanged --
service portability across module systems is the point of modular
services.

Lifted units are evaluated and translated from NixOS-style attrs
(`wantedBy`, `serviceConfig`, `unitConfig`, `environment`, ...) into
the section-based INI shape (`{ Unit; Service; Install; }`) that
home-manager's `systemd.user.{services,sockets}` consumes; only the
common keys are mapped, uncommon options remain reachable via
`unitConfig` / `serviceConfig` / `socketConfig`. Sub-services and
their units are dashed under the parent service name;
`process.argv` becomes the default `ExecStart` for the service's
primary unit, which defaults to `WantedBy=default.target`.

Mirrors the surface of nixpkgs' portable systemd module (services +
sockets only); other unit kinds home-manager supports natively
(timers etc.) are intentionally not modeled until upstream grows
them.

Each service's `configData.<name>` entries are materialized at
`$XDG_CONFIG_HOME/system-services/<service-prefix>/<name>` (mirroring
how `nixos/modules/system/service/systemd/{config-data-path,system}.nix`
lifts `configData` to `environment.etc`), with the absolute path
injected back into `configData.<name>.path` so the service can refer
to its files at a stable location.

Includes nmt tests covering: a basic `process.argv`-only service, a
service with a `configData` entry, and importing
`pkgs.ghostunnel.passthru.services.default` to assert the lifted user
unit contains the expected ExecStart flags and `LoadCredential`
entries.
2026-05-04 17:22:16 +02:00

23 lines
905 B
Nix

# Per-service extension module loaded into every `home.services` entry.
#
# Re-exports the nixpkgs portable systemd service module so HM modular
# services accept the same NixOS-style schema (`systemd.lib`,
# `systemd.mainExecStart`, `systemd.service`, `systemd.services`,
# `systemd.sockets`) as their NixOS counterparts. This is what lets
# upstream service modules (e.g. `pkgs.<name>.passthru.services.default`)
# drop in unchanged. Then overrides the primary unit's `wantedBy` default
# to `default.target`, since user units typically attach to that instead
# of `multi-user.target`.
{ lib, nixpkgsPath, ... }:
{
imports = [
(nixpkgsPath + "/nixos/modules/system/service/systemd/service.nix")
];
# The empty key `""` is the modular service's *primary* unit (see
# `dashed` in `default.nix`).
config.systemd.services."" = {
wantedBy = lib.mkOverride 950 [ "default.target" ];
};
}