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
-
创建数据库:
$ nix run github:nix-community/nix-index#nix-index
-
查询文件:
$ 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
用于实现递归获取(获取所有内容的引用)的队列