home-manager/modules/services/window-managers/awesome.nix

{ config, lib, pkgs, ... }:

with lib;

let

  cfg = config.xsession.windowManager.awesome;
  awesome = cfg.package;
  getLuaPath = lib: dir: "${lib}/${dir}/lua/${awesome.lua.luaversion}";
  makeSearchPath = lib.concatMapStrings (path:
    " --search ${getLuaPath path "share"}"
    + " --search ${getLuaPath path "lib"}");

in {
  options = {
    xsession.windowManager.awesome = {
      enable = mkEnableOption (lib.mdDoc "Awesome window manager");

      package = mkOption {
        type = types.package;
        default = pkgs.awesome;
        defaultText = literalExpression "pkgs.awesome";
        description = lib.mdDoc "Package to use for running the Awesome WM.";
      };

      luaModules = mkOption {
        default = [ ];
        type = types.listOf types.package;
        description = lib.mdDoc ''
          List of lua packages available for being
          used in the Awesome configuration.
        '';
        example = literalExpression "[ pkgs.luaPackages.vicious ]";
      };

      noArgb = mkOption {
        default = false;
        type = types.bool;
        description = lib.mdDoc ''
          Disable client transparency support, which can be greatly
          detrimental to performance in some setups
        '';
      };
    };
  };

  config = mkIf cfg.enable {
    assertions = [
      (hm.assertions.assertPlatform "xsession.windowManager.awesome" pkgs
        platforms.linux)
    ];

    home.packages = [ awesome ];

    xsession.windowManager.command = "${awesome}/bin/awesome "
      + optionalString cfg.noArgb "--no-argb " + makeSearchPath cfg.luaModules;
  };
}