1
0
mirror of https://github.com/nix-community/home-manager synced 2024-06-30 18:38:31 +02:00
home-manager/modules/services/trayer.nix
Emily 36a53d9f26 treewide: convert all option docs to Markdown
This process was automated by [my fork of `nix-doc-munge`]. All
conversions were automatically checked to produce the same DocBook
result when converted back, modulo minor typographical/formatting
differences on the acceptable-to-desirable spectrum.

To reproduce this commit, run:

  $ NIX_PATH=nixpkgs=flake:nixpkgs/e7e69199f0372364a6106a1e735f68604f4c5a25 \
    nix shell nixpkgs#coreutils \
    -c find . -name '*.nix' \
    -exec nix run -- github:emilazy/nix-doc-munge/98dadf1f77351c2ba5dcb709a2a171d655f15099 \
    {} +
  $ ./format

[my fork of `nix-doc-munge`]: https://github.com/emilazy/nix-doc-munge/tree/home-manager
2023-07-17 18:40:56 +01:00

157 lines
3.4 KiB
Nix

{ config, lib, pkgs, ... }:
with lib;
let
boolTrue = {
type = types.bool;
default = true;
};
number0 = {
type = types.int;
default = 0;
};
knownSettings = {
edge = {
type = types.enum [ "left" "right" "top" "bottom" "none" ];
default = "bottom";
};
align = {
type = types.enum [ "left" "right" "center" ];
default = "center";
};
margin = number0;
widthtype = {
type = types.enum [ "request" "pixel" "percent" ];
default = "percent";
};
width = {
type = types.int;
default = 100;
};
heighttype = {
type = types.enum [ "request" "pixel" ];
default = "pixel";
};
height = {
type = types.int;
default = 26;
};
SetDockType = boolTrue;
SetPartialStrut = boolTrue;
transparent = {
type = types.bool;
default = false;
};
alpha = {
type = types.int;
default = 127;
};
tint = {
type = types.str;
default = "0xFFFFFFFF";
};
distance = number0;
distancefrom = {
type = types.enum [ "left" "right" "top" "bottom" ];
default = "top";
};
expand = boolTrue;
padding = number0;
monitor = {
type = types.either types.ints.unsigned (types.enum [ "primary" ]);
default = 0;
};
iconspacing = number0;
};
cfg = config.services.trayer;
in {
meta.maintainers = [ hm.maintainers.mager ];
options = {
services.trayer = {
enable = mkEnableOption
(lib.mdDoc "trayer, the lightweight GTK2+ systray for UNIX desktops");
package = mkOption {
default = pkgs.trayer;
defaultText = literalExpression "pkgs.trayer";
type = types.package;
example = literalExpression "pkgs.trayer";
description = lib.mdDoc "The package to use for the trayer binary.";
};
settings = mkOption {
type = with types; attrsOf (nullOr (either str (either bool int)));
description = lib.mdDoc ''
Trayer configuration as a set of attributes. Further details can be
found in [trayer's README](https://github.com/sargon/trayer-srg/blob/master/README).
${concatStringsSep "\n" (mapAttrsToList (n: v: ''
{var}`${n}`
: ${v.type.description} (default: `${builtins.toJSON v.default}`)
'') knownSettings)}
'';
default = { };
example = literalExpression ''
{
edge = "top";
padding = 6;
SetDockType = true;
tint = "0x282c34";
}
'';
};
};
};
config = mkIf cfg.enable ({
assertions = [
(lib.hm.assertions.assertPlatform "services.trayer" pkgs
lib.platforms.linux)
];
home.packages = [ cfg.package ];
systemd.user.services.trayer = let
valueToString = v:
if isBool v then (if v then "true" else "false") else "${toString v}";
parameter = k: v: "--${k} ${valueToString v}";
parameters = concatStringsSep " " (mapAttrsToList parameter cfg.settings);
in {
Unit = {
Description = "trayer -- lightweight GTK2+ systray for UNIX desktops";
PartOf = [ "tray.target" ];
};
Install.WantedBy = [ "tray.target" ];
Service = {
ExecStart = "${cfg.package}/bin/trayer ${parameters}";
Restart = "on-failure";
};
};
});
}