commit 3947220b3dd2c4f44f664c0d08e1c29dce5b0db5 · pyrox.dev/nixpkgs

nixos/doc/manual/release-notes/rl-2405.section.md

···

       153
       153
        
       

     

       154
       154
        
       - binfmt option for AppImage-run to support running [AppImage](https://appimage.org/)'s seamlessly on NixOS.. Available as [programs.appimage.binfmt](#opt-programs.appimage.binfmt).

     

       155
       155
        
       

     

       156
       156
       +
       - [nh](https://github.com/viperML/nh), yet another Nix CLI helper. Available as [programs.nh](#opt-programs.nh.enable).

     

       157
       157
       +
       

     

       156
       158
        
       - [ALVR](https://github.com/alvr-org/alvr), a VR desktop streamer. Available as [programs.alvr](#opt-programs.alvr.enable)

     

       157
       159
        
       

     

       158
       160
        
       - [RustDesk](https://rustdesk.com), a full-featured open source remote control alternative for self-hosting and security with minimal configuration. Alternative to TeamViewer.

nixos/modules/module-list.nix

···

       233
       233
        
         ./programs/neovim.nix

     

       234
       234
        
         ./programs/nethoscope.nix

     

       235
       235
        
         ./programs/nexttrace.nix

     

       236
       236
       +
         ./programs/nh.nix

     

       236
       237
        
         ./programs/nix-index.nix

     

       237
       238
        
         ./programs/nix-ld.nix

     

       238
       239
        
         ./programs/nm-applet.nix

+96

nixos/modules/programs/nh.nix

···

       1
       1
       +
       { config

     

       2
       2
       +
       , lib

     

       3
       3
       +
       , pkgs

     

       4
       4
       +
       , ...

     

       5
       5
       +
       }:

     

       6
       6
       +
       let

     

       7
       7
       +
         cfg = config.programs.nh;

     

       8
       8
       +
       in

     

       9
       9
       +
       {

     

       10
       10
       +
         meta.maintainers = [ lib.maintainers.viperML ];

     

       11
       11
       +
       

     

       12
       12
       +
         options.programs.nh = {

     

       13
       13
       +
           enable = lib.mkEnableOption "nh, yet another Nix CLI helper";

     

       14
       14
       +
       

     

       15
       15
       +
           package = lib.mkPackageOption pkgs "nh" { };

     

       16
       16
       +
       

     

       17
       17
       +
           flake = lib.mkOption {

     

       18
       18
       +
             type = lib.types.nullOr lib.types.path;

     

       19
       19
       +
             default = null;

     

       20
       20
       +
             description = ''

     

       21
       21
       +
               The path that will be used for the `FLAKE` environment variable.

     

       22
       22
       +
       

     

       23
       23
       +
               `FLAKE` is used by nh as the default flake for performing actions, like `nh os switch`.

     

       24
       24
       +
             '';

     

       25
       25
       +
           };

     

       26
       26
       +
       

     

       27
       27
       +
           clean = {

     

       28
       28
       +
             enable = lib.mkEnableOption "periodic garbage collection with nh clean all";

     

       29
       29
       +
       

     

       30
       30
       +
             dates = lib.mkOption {

     

       31
       31
       +
               type = lib.types.singleLineStr;

     

       32
       32
       +
               default = "weekly";

     

       33
       33
       +
               description = ''

     

       34
       34
       +
                 How often cleanup is performed. Passed to systemd.time

     

       35
       35
       +
       

     

       36
       36
       +
                 The format is described in

     

       37
       37
       +
                 {manpage}`systemd.time(7)`.

     

       38
       38
       +
               '';

     

       39
       39
       +
             };

     

       40
       40
       +
       

     

       41
       41
       +
             extraArgs = lib.mkOption {

     

       42
       42
       +
               type = lib.types.singleLineStr;

     

       43
       43
       +
               default = "";

     

       44
       44
       +
               example = "--keep 5 --keep-since 3d";

     

       45
       45
       +
               description = ''

     

       46
       46
       +
                 Options given to nh clean when the service is run automatically.

     

       47
       47
       +
       

     

       48
       48
       +
                 See `nh clean all --help` for more information.

     

       49
       49
       +
               '';

     

       50
       50
       +
             };

     

       51
       51
       +
           };

     

       52
       52
       +
         };

     

       53
       53
       +
       

     

       54
       54
       +
         config = {

     

       55
       55
       +
           warnings =

     

       56
       56
       +
             if (!(cfg.clean.enable -> !config.nix.gc.automatic)) then [

     

       57
       57
       +
               "programs.nh.clean.enable and nix.gc.automatic are both enabled. Please use one or the other to avoid conflict."

     

       58
       58
       +
             ] else [ ];

     

       59
       59
       +
       

     

       60
       60
       +
           assertions = [

     

       61
       61
       +
             # Not strictly required but probably a good assertion to have

     

       62
       62
       +
             {

     

       63
       63
       +
               assertion = cfg.clean.enable -> cfg.enable;

     

       64
       64
       +
               message = "programs.nh.clean.enable requires programs.nh.enable";

     

       65
       65
       +
             }

     

       66
       66
       +
       

     

       67
       67
       +
             {

     

       68
       68
       +
               assertion = (cfg.flake != null) -> !(lib.hasSuffix ".nix" cfg.flake);

     

       69
       69
       +
               message = "nh.flake must be a directory, not a nix file";

     

       70
       70
       +
             }

     

       71
       71
       +
           ];

     

       72
       72
       +
       

     

       73
       73
       +
           environment = lib.mkIf cfg.enable {

     

       74
       74
       +
             systemPackages = [ cfg.package ];

     

       75
       75
       +
             variables = lib.mkIf (cfg.flake != null) {

     

       76
       76
       +
               FLAKE = cfg.flake;

     

       77
       77
       +
             };

     

       78
       78
       +
           };

     

       79
       79
       +
       

     

       80
       80
       +
           systemd = lib.mkIf cfg.clean.enable {

     

       81
       81
       +
             services.nh-clean = {

     

       82
       82
       +
               description = "Nh clean";

     

       83
       83
       +
               script = "exec ${lib.getExe cfg.package} clean all ${cfg.clean.extraArgs}";

     

       84
       84
       +
               startAt = cfg.clean.dates;

     

       85
       85
       +
               path = [ config.nix.package ];

     

       86
       86
       +
               serviceConfig.Type = "oneshot";

     

       87
       87
       +
             };

     

       88
       88
       +
       

     

       89
       89
       +
             timers.nh-clean = {

     

       90
       90
       +
               timerConfig = {

     

       91
       91
       +
                 Persistent = true;

     

       92
       92
       +
               };

     

       93
       93
       +
             };

     

       94
       94
       +
           };

     

       95
       95
       +
         };

     

       96
       96
       +
       }