server/nix/nixos-modules/useable.nix

{ config
, lib
, pkgs
, ...
}:
let
  cfg = config.x-banananetwork.useable;
in
{


  options = {

    x-banananetwork.useable = {

      enable = lib.mkEnableOption ''
        a set of opionated options to make systems useable & debugable for users.

        This means e.g. adding common, useful tools and add documentation.
      '';

    };

  };


  config = lib.mkIf cfg.enable {


    documentation = {

      enable = true;
      dev.enable = true;
      doc.enable = true;
      info.enable = true;

      man = {

        enable = true;
        generateCaches = true;

        man-db.enable = false; # see mandoc

        mandoc = {
          enable = true;
        };

      };

      nixos = {
        enable = true;
        includeAllModules = true;
      };

    };


    environment.systemPackages = with pkgs; let
      inherit (lib.lists) flatten optional optionals;
    in
    flatten [

      (optional (config.services.hardware.bolt.enable && config.services.desktopManager.plasma6.enable) kdePackages.plasma-thunderbolt) # TODO upstream

      (optionals config.hardware.graphics.amd.enable [
        nvtopPackages.amd
      ])
      (optionals config.hardware.graphics.intel.enable [
        intel-gpu-tools
        nvtopPackages.intel
      ])

      bat
      batmon # TODO only on systems wich batteries
      jq # JSON
      manix
      massren
      nethogs
      reptyr
      pciutils
      psitop
      pv
      unixtools.xxd
      up # ultimate plumber
      usbtop
      usbutils

    ];


    programs = {

      bandwhich.enable = true;

      git = {
        enable = true;
        config = {
          advice = {
            detachedHead = true;
          };
          alias = {
            lg1 = "log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(bold yellow)%d%C(reset)' --all";
            lg2 = "log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(bold yellow)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)' --all";
            lg = ''!"git lg1"'';
          };
          core = {
            autocrlf = "input";
          };
          init = {
            defaultBranch = "main";
          };
          pull = {
            ff = "only";
          };
          push = {
            autoSetupRemote = true;
          };
        };
      };

      iftop.enable = true;

      iotop.enable = true;

      less = {
        enable = true;
      };

      liboping.enable = true;

      mtr.enable = true;

      nano = {
        enable = true;
        nanorc = ''
          set nowrap
          set tabtospaces
          set tabsize 2
        '';
        syntaxHighlight = true;
      };

      tmux = {
        plugins = with pkgs.tmuxPlugins; [
          better-mouse-mode
          sensible
        ];
        secureSocket = true; # does not survive user logout
      };

      zsh = {
        autosuggestions = {
          enable = true;
          strategy = [
            "history"
            "completion"
          ];
        };
        enable = true;
        enableBashCompletion = true;
        enableCompletion = true;
        syntaxHighlighting = {
          enable = true;
          highlighters = [
            "main"
            "brackets"
            "root"
          ];
        };
        vteIntegration = true;
      };

    };


    x-banananetwork = {

      allCommon.enable = true;
      debugMinimal.enable = true;

    };


    # TODO withlist:
    # - update tmuxPlugins.sensible in nixpkgs (e.g. https://github.com/NixOS/nixpkgs/pull/272954)


  };


}