nix-index

nixpkgs的文件数据库

nix-index是一个快速定位nixpkgs中提供特定文件的包的工具。它会索引二进制缓存中的已构建派生项。

演示

$ nix-locate 'bin/hello'
hello.out                                        29,488 x /nix/store/bdjyhh70npndlq3rzmggh4f2dzdsj4xy-hello-2.10/bin/hello
linuxPackages_4_4.dpdk.examples               2,022,224 x /nix/store/jlnk3d38zsk0bp02rp9skpqk4vjfijnn-dpdk-16.07.2-4.4.52-examples/bin/helloworld
linuxPackages.dpdk.examples                   2,022,224 x /nix/store/rzx4k0pb58gd1dr9kzwam3vk9r8bfyv1-dpdk-16.07.2-4.9.13-examples/bin/helloworld
linuxPackages_4_10.dpdk.examples              2,022,224 x /nix/store/wya1b0910qidfc9v3i6r9rnbnc9ykkwq-dpdk-16.07.2-4.10.1-examples/bin/helloworld
linuxPackages_grsec_nixos.dpdk.examples       2,022,224 x /nix/store/2wqv94290pa38aclld7sc548a7hnz35k-dpdk-16.07.2-4.9.13-examples/bin/helloworld
camlistore.out                                7,938,952 x /nix/store/xn5ivjdyslxldhm5cb4x0lfz48zf21rl-camlistore-0.9/bin/hello

安装

Flakes

1. 创建数据库：

   $ nix run github:nix-community/nix-index#nix-index
   

2. 查询文件：

   $ nix run github:nix-community/nix-index#nix-locate -- bin/hello
   

最新Git版本

要安装nix-index的最新开发版本，只需克隆仓库并运行nix-env -if.：

$ git clone https://github.com/nix-community/nix-index
$ cd nix-index
$ nix-env -if.

稳定版

对于稳定版，你可以checkout最新的tag（查看这里的列表），或使用Nixpkgs的仓库并通过以下命令安装：

$ nix-env -iA nixos.nix-index

使用方法

首先，你需要通过运行nix-index来生成索引（大约需要5分钟）。然后，你可以使用nix-locate pattern。更多信息，请查看nix-locate --help和nix-index --help。

使用预生成的数据库

如果你不想在本地生成数据库，nix-index-database提供了预生成的数据库。 它还提供了nixos/home-manager模块来使用这些数据库。

作为command-not-found替代品使用

Nix-index提供了一个"command-not-found"脚本，可以在你的shell中打印未找到命令的属性路径。你可以在自己的shell初始化文件中source ${pkgs.nix-index}/etc/command-not-found.sh（据我们所知，适用于ZSH和Bash），或者在home-manager / /etc/nixos/configuration.nix中使用以下配置：

    programs.command-not-found.enable = false;
    # 对于home-manager，使用programs.bash.initExtra代替
    programs.bash.interactiveShellInit = ''
      source ${pkgs.nix-index}/etc/profile.d/command-not-found.sh
    '';

如果你使用zsh，将bash替换为zsh。

输出示例：

$ blender
The program 'blender' is currently not installed. You can install it
by typing:
  nix-env -iA nixpkgs.blender.out

Or run it once with:
  nix-shell -p blender.out --run ...

现在有一个home-manager模块可用于使用此脚本将nix-index与bash、zsh和fish集成。

贡献

如果你发现任何你想实现的缺失功能，我非常欢迎任何PR！如果功能比较复杂，你也可以先创建一个issue，这样我们可以讨论可能的实现方式。

以下是所有相关文件的简要描述：

• bin/{nix-index, nix-locate}.rs：nix-index / nix-locate命令行工具的实现
• src/database.rs：用于处理数据库格式的高级函数
• src/files.rs：用于处理文件列表的数据类型
• src/frcode.rs：用于高效存储多个文件路径的编码器的底层实现（详见文件中的注释）。由database.rs使用。
• src/hydra.rs：处理与从二进制缓存下载相关的所有内容（获取文件列表和引用）
• src/nixpkgs.rs：使用nix-env实现包（存储路径和属性）的收集
• src/package.rs：用于表示存储路径（有时也称为包）的高级数据类型
• src/workset.rs：由nix-index用于实现递归获取（获取所有内容的引用）的队列