···

       
2
       
 
       


     

       
3
       
 
       
Some packages provide the shell integration to be more useful. But unlike other systems, nix doesn't have a standard `share` directory location. This is why a bunch `PACKAGE-share` scripts are shipped that print the location of the corresponding shared folder. Current list of such packages is as following:

     

       
4
       
 
       


     

       
5
       
-
       
- `sk` : `sk-share`

     

       
6
       
 
       


     

       
7
       
-
       
E.g. `sk` can then be used in the `.bashrc` like this:

     

       
8
       
 
       


     

       
9
       
 
       
```bash

     

       
10
       
-
       
source "$(sk-share)/completion.bash"

     

       
11
       
-
       
source "$(sk-share)/key-bindings.bash"

     

       
12
       
 
       
```

     

···

       
2
       
 
       


     

       
3
       
 
       
Some packages provide the shell integration to be more useful. But unlike other systems, nix doesn't have a standard `share` directory location. This is why a bunch `PACKAGE-share` scripts are shipped that print the location of the corresponding shared folder. Current list of such packages is as following:

     

       
4
       
 
       


     

       
5
       
+
       
- `fzf` : `fzf-share`

     

       
6
       
 
       


     

       
7
       
+
       
E.g. `fzf` can then be used in the `.bashrc` like this:

     

       
8
       
 
       


     

       
9
       
 
       
```bash

     

       
10
       
+
       
source "$(fzf-share)/completion.bash"

     

       
11
       
+
       
source "$(fzf-share)/key-bindings.bash"

     

       
12
       
 
       
```

     

···

       
79
       
 
       


     

       
80
       
 
       
- [frigate](https://frigate.video), an open source NVR built around real-time AI object detection. Available as [services.frigate](#opt-services.frigate.enable).

     

       
81
       
 
       


     

       
82
       
-
       
- [fzf](https://github.com/junegunn/fzf), a command line fuzzyfinder. Available as [programs.fzf](#opt-programs.fzf.enable).

     

       
83
       
 
       


     

       
84
       
 
       
- [gemstash](https://github.com/rubygems/gemstash), a RubyGems.org cache and private gem server. Available as [services.gemstash](#opt-services.gemstash.enable).

     

       
85
       
 
       


     

···

       
79
       
 
       


     

       
80
       
 
       
- [frigate](https://frigate.video), an open source NVR built around real-time AI object detection. Available as [services.frigate](#opt-services.frigate.enable).

     

       
81
       
 
       


     

       
82
       
+
       
- [fzf](https://github.com/junegunn/fzf), a command line fuzzyfinder. Available as [programs.fzf](#opt-programs.fzf.fuzzyCompletion).

     

       
83
       
 
       


     

       
84
       
 
       
- [gemstash](https://github.com/rubygems/gemstash), a RubyGems.org cache and private gem server. Available as [services.gemstash](#opt-services.gemstash.enable).

     

       
85
       
 
       


     

···

       
328
       
 
       


     

       
329
       
 
       
- `xxd` has been moved from `vim` default output to its own output to reduce closure size. The canonical way to reference it across all platforms is `unixtools.xxd`.

     

       
330
       
 
       


     

       
331
       
-
       
- `programs.fzf.keybindings` and `programs.fzf.fuzzyCompletion` got replaced by `programs.fzf.enable` as shell-completion is included in the fzf-binary now there is no easy option to load completion and keybindings separately. Please consult fzf-documentation on how to configure/disable certain keybindings.

     

       
332
       
-
       


     

       
333
       
 
       
- The `stalwart-mail` package has been updated to v0.5.3, which includes [breaking changes](https://github.com/stalwartlabs/mail-server/blob/v0.5.3/UPGRADING.md).

     

       
334
       
 
       


     

       
335
       
 
       
- `services.zope2` has been removed as `zope2` is unmaintained and was relying on Python2.

     

···

       
328
       
 
       


     

       
329
       
 
       
- `xxd` has been moved from `vim` default output to its own output to reduce closure size. The canonical way to reference it across all platforms is `unixtools.xxd`.

     

       
330
       
 
       


     

       
0
       
 
       

     

       
0
       
 
       

     

       
331
       
 
       
- The `stalwart-mail` package has been updated to v0.5.3, which includes [breaking changes](https://github.com/stalwartlabs/mail-server/blob/v0.5.3/UPGRADING.md).

     

       
332
       
 
       


     

       
333
       
 
       
- `services.zope2` has been removed as `zope2` is unmaintained and was relying on Python2.

     

···

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

     

       
2
       
 
       


     

       
3
       
-
       
with lib;

     

       
4
       
-
       


     

       
5
       
 
       
let

     

       
6
       
 
       
  cfg = config.programs.fzf;

     

       
7
       
-
       


     

       
8
       
 
       
in

     

       
9
       
 
       
{

     

       
10
       
-
       
  imports = [

     

       
11
       
-
       
    (lib.mkRemovedOptionModule [ "programs" "fzf" "keybindings" ] ''

     

       
12
       
-
       
      Use "programs.fzf.enable" instead, due to fzf upstream-change it's not possible to load shell-completion and keybindings separately.

     

       
13
       
-
       
      If you want to change/disable certain keybindings please check the fzf-documentation.

     

       
14
       
-
       
    '')

     

       
15
       
-
       
    (lib.mkRemovedOptionModule [ "programs" "fzf" "fuzzyCompletion" ] ''

     

       
16
       
-
       
      Use "programs.fzf.enable" instead, due to fzf upstream-change it's not possible to load shell-completion and keybindings separately.

     

       
17
       
-
       
      If you want to change/disable certain keybindings please check the fzf-documentation.

     

       
18
       
-
       
    '')

     

       
19
       
-
       
  ];

     

       
20
       
-
       


     

       
21
       
 
       
  options = {

     

       
22
       
-
       
    programs.fzf.enable = mkEnableOption (mdDoc "fuzzy completion with fzf and keybindings");

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
23
       
 
       
  };

     

       
24
       
 
       


     

       
25
       
-
       
  config = mkIf cfg.enable {

     

       
26
       
-
       
    environment.systemPackages = [ pkgs.fzf ];

     

       
27
       
-
       


     

       
28
       
-
       
    programs.bash.interactiveShellInit = ''

     

       
29
       
-
       
      eval "$(${getExe pkgs.fzf} --bash)"

     

       
30
       
-
       
    '';

     

       
31
       
-
       


     

       
32
       
-
       
    programs.fish.interactiveShellInit = ''

     

       
33
       
-
       
      ${getExe pkgs.fzf} --fish | source

     

       
34
       
-
       
    '';

     

       
35
       
 
       


     

       
36
       
-
       
    programs.zsh = {

     

       
37
       
-
       
      interactiveShellInit = optionalString (!config.programs.zsh.ohMyZsh.enable) ''

     

       
38
       
-
       
        eval "$(${getExe pkgs.fzf} --zsh)"

     

       
0
       
 
       

     

       
0
       
 
       

     

       
39
       
 
       
      '';

     

       
40
       
 
       


     

       
41
       
-
       
      ohMyZsh.plugins = mkIf (config.programs.zsh.ohMyZsh.enable) [ "fzf" ];

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
42
       
 
       
    };

     

       
43
       
 
       
  };

     

       
44
       
 
       


     

       
45
       
-
       
  meta.maintainers = with maintainers; [ laalsaas ];

     

       
46
       
 
       
}

     

···

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

     

       
2
       
 
       


     

       
0
       
 
       

     

       
0
       
 
       

     

       
3
       
 
       
let

     

       
4
       
 
       
  cfg = config.programs.fzf;

     

       
0
       
 
       

     

       
5
       
 
       
in

     

       
6
       
 
       
{

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
7
       
 
       
  options = {

     

       
8
       
+
       
    programs.fzf = {

     

       
9
       
+
       
      fuzzyCompletion = lib.mkEnableOption (lib.mdDoc "fuzzy completion with fzf");

     

       
10
       
+
       
      keybindings = lib.mkEnableOption (lib.mdDoc "fzf keybindings");

     

       
11
       
+
       
    };

     

       
12
       
 
       
  };

     

       
13
       
 
       


     

       
14
       
+
       
  config = lib.mkIf (cfg.keybindings || cfg.fuzzyCompletion) {

     

       
15
       
+
       
    environment.systemPackages = lib.mkIf (cfg.keybindings || cfg.fuzzyCompletion) [ pkgs.fzf ];

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
16
       
 
       


     

       
17
       
+
       
    programs = {

     

       
18
       
+
       
      bash.interactiveShellInit = lib.optionalString cfg.fuzzyCompletion ''

     

       
19
       
+
       
        source ${pkgs.fzf}/share/fzf/completion.bash

     

       
20
       
+
       
      '' + lib.optionalString cfg.keybindings ''

     

       
21
       
+
       
        source ${pkgs.fzf}/share/fzf/key-bindings.bash

     

       
22
       
 
       
      '';

     

       
23
       
 
       


     

       
24
       
+
       
      zsh = {

     

       
25
       
+
       
        interactiveShellInit = lib.optionalString (!config.programs.zsh.ohMyZsh.enable)

     

       
26
       
+
       
        (lib.optionalString cfg.fuzzyCompletion ''

     

       
27
       
+
       
          source ${pkgs.fzf}/share/fzf/completion.zsh

     

       
28
       
+
       
        '' + lib.optionalString cfg.keybindings ''

     

       
29
       
+
       
          source ${pkgs.fzf}/share/fzf/key-bindings.zsh

     

       
30
       
+
       
        '');

     

       
31
       
+
       


     

       
32
       
+
       
        ohMyZsh.plugins = lib.mkIf config.programs.zsh.ohMyZsh.enable [ "fzf" ];

     

       
33
       
+
       
      };

     

       
34
       
 
       
    };

     

       
35
       
 
       
  };

     

       
36
       
 
       


     

       
37
       
+
       
  meta.maintainers = with lib.maintainers; [ laalsaas ];

     

       
38
       
 
       
}

     

···

       
1
       
 
       
{ lib

     

       
2
       
 
       
, buildGoModule

     

       
3
       
 
       
, fetchFromGitHub

     

       
0
       
 
       

     

       
4
       
 
       
, installShellFiles

     

       
5
       
 
       
, bc

     

       
6
       
 
       
, ncurses

     
···

       
55
       
 
       
    install -D plugin/* -t $out/share/vim-plugins/${pname}/plugin

     

       
56
       
 
       
    mkdir -p $out/share/nvim

     

       
57
       
 
       
    ln -s $out/share/vim-plugins/${pname} $out/share/nvim/site

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
58
       
 
       
  '';

     

       
59
       
 
       


     

       
60
       
 
       
  passthru.tests.version = testers.testVersion {

     

···

       
1
       
 
       
{ lib

     

       
2
       
 
       
, buildGoModule

     

       
3
       
 
       
, fetchFromGitHub

     

       
4
       
+
       
, runtimeShell

     

       
5
       
 
       
, installShellFiles

     

       
6
       
 
       
, bc

     

       
7
       
 
       
, ncurses

     
···

       
56
       
 
       
    install -D plugin/* -t $out/share/vim-plugins/${pname}/plugin

     

       
57
       
 
       
    mkdir -p $out/share/nvim

     

       
58
       
 
       
    ln -s $out/share/vim-plugins/${pname} $out/share/nvim/site

     

       
59
       
+
       


     

       
60
       
+
       
    # Install shell integrations

     

       
61
       
+
       
    install -D shell/* -t $out/share/fzf/

     

       
62
       
+
       
    install -D shell/key-bindings.fish $out/share/fish/vendor_functions.d/fzf_key_bindings.fish

     

       
63
       
+
       
    mkdir -p $out/share/fish/vendor_conf.d

     

       
64
       
+
       
    cat << EOF > $out/share/fish/vendor_conf.d/load-fzf-key-bindings.fish

     

       
65
       
+
       
      status is-interactive; or exit 0

     

       
66
       
+
       
      fzf_key_bindings

     

       
67
       
+
       
    EOF

     

       
68
       
+
       


     

       
69
       
+
       
    cat <<SCRIPT > $out/bin/fzf-share

     

       
70
       
+
       
    #!${runtimeShell}

     

       
71
       
+
       
    # Run this script to find the fzf shared folder where all the shell

     

       
72
       
+
       
    # integration scripts are living.

     

       
73
       
+
       
    echo $out/share/fzf

     

       
74
       
+
       
    SCRIPT

     

       
75
       
+
       
    chmod +x $out/bin/fzf-share

     

       
76
       
 
       
  '';

     

       
77
       
 
       


     

       
78
       
 
       
  passthru.tests.version = testers.testVersion {