nix index

index nix

Une base de données de fichiers pour nixpkgs

nix-index est un outil permettant de localiser rapidement le package fournissant un certain fichier dans nixpkgs . Il indexe les dérivations construites trouvées dans les caches binaires.

Démo

 $ 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

Installation

Flocons

1. créer la base de données :

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

2. requête pour un fichier :

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

Dernière version de Git

Pour installer la dernière version de développement de nix-index, clonez simplement le dépôt et exécutez nix-env -if. :

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

Écurie

Pour la version stable, vous pouvez soit récupérer la dernière balise (voir la liste ici), soit utiliser les référentiels de Nixpkgs et l'installer avec :

 $ nix-env -iA nixos.nix-index

Usage

Tout d’abord, vous devez générer un index en exécutant nix-index (cela prend environ 5 minutes). Ensuite, vous pouvez utiliser nix-locate pattern . Pour plus d'informations, consultez nix-locate --help et nix-index --help .

Utiliser une base de données pré-générée

nix-index-database fournit des bases de données pré-générées si vous ne souhaitez pas générer de base de données localement. Il est également livré avec des modules nixos/home-manager pour utiliser ces bases de données.

Utilisation en remplacement d'une commande introuvable

Nix-index fournit un script "commande non trouvée" qui peut imprimer pour vous le chemin d'attribut des commandes non trouvées dans votre shell. Vous pouvez soit sourcer ${pkgs.nix-index}/etc/command-not-found.sh dans vos propres fichiers d'initialisation du shell (fonctionne pour ZSH et Bash pour autant que nous le sachions), soit utiliser ce qui suit dans home- gestionnaire / /etc/nixos/configuration.nix :

    programs . command-not-found . enable = false ;
    # for home-manager, use programs.bash.initExtra instead
    programs . bash . interactiveShellInit = ''
      source ${ pkgs . nix-index } /etc/profile.d/command-not-found.sh
    '' ;

Remplacez bash par zsh si vous utilisez zsh .

Exemple de sortie :

 $ 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 ...

Un module home-manager est maintenant disponible pour intégrer nix-index avec bash , zsh et fish à l'aide de ce script.

Contribuer

Si vous trouvez des fonctionnalités manquantes que vous aimeriez implémenter, je suis très heureux de tous les PR ! Vous pouvez également créer d'abord un problème si la fonctionnalité est plus complexe afin que nous puissions discuter des implémentations possibles.

Voici une description rapide de tous les fichiers pertinents :

• bin/{nix-index, nix-locate}.rs : Implémentation des outils de ligne de commande nix-index / nix-locate
• src/database.rs : Fonctions de haut niveau pour travailler avec le format de base de données
• src/files.rs : Les types de données pour travailler avec des listes de fichiers
• src/frcode.rs : Implémentation bas niveau d'un encodeur pour stocker efficacement de nombreux chemins de fichiers (voir commentaires dans le fichier pour plus de détails). Utilisé par database.rs .
• src/hydra.rs : Traite de tout ce qui a à voir avec le téléchargement à partir du cache binaire (récupération des listes et références de fichiers)
• src/nixpkgs.rs : Implémente la collecte des packages (chemins de stockage et attributs) à l'aide de nix-env
• src/package.rs : types de données de haut niveau pour représenter les chemins de magasin (parfois également appelé package)
• src/workset.rs : Une file d'attente utilisée par nix-index pour implémenter la récupération récursive (récupération des références de tout)