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/${pkgs.luaPackages.lua.luaversion}";
  makeSearchPath = lib.concatMapStrings (path:
    " --search ${getLuaPath path "share"}"
    " --search ${getLuaPath path "lib"}"
  );

in

{
  options = {
    xsession.windowManager.awesome = {
      enable = mkEnableOption "Awesome window manager.";

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

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

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

  config = mkIf cfg.enable {
    home.packages = [ awesome ];
    xsession.windowManager.command = 
      "${awesome}/bin/awesome "
      + optionalString cfg.noArgb "--no-argb "
      + makeSearchPath cfg.luaModules;
  };
}