commit c6b62f2381571cc83c6c32ef4984fabcbb4ca892 · pyrox.dev/nixpkgs

+6 -4

doc/builders/special/mkshell.section.md

···

       1
        
       # pkgs.mkShell {#sec-pkgs-mkShell}

     

       2
        
       

     

       3
       -
       `pkgs.mkShell` is a special kind of derivation that is only useful when using it combined with `nix-shell`. It will in fact fail to instantiate when invoked with `nix-build`.

     

       0
        
       
     

       0
        
       
     

       4
        
       

     

       5
        
       ## Usage {#sec-pkgs-mkShell-usage}

     

       6
        
       

     

       7
        
       ```nix

     

       8
        
       { pkgs ? import <nixpkgs> {} }:

     

       9
        
       pkgs.mkShell {

     

       10
       -
         # this will make all the build inputs from hello and gnutar

     

       11
       -
         # available to the shell environment

     

       0
        
       
     

       12
        
         inputsFrom = with pkgs; [ hello gnutar ];

     

       13
       -
         buildInputs = [ pkgs.gnumake ];

     

       14
        
       }

     

       15
        
       ```

···

       1
        
       # pkgs.mkShell {#sec-pkgs-mkShell}

     

       2
        
       

     

       3
       +
       `pkgs.mkShell` is a special kind of derivation that is only useful when using

     

       4
       +
       it combined with `nix-shell`. It will in fact fail to instantiate when invoked

     

       5
       +
       with `nix-build`.

     

       6
        
       

     

       7
        
       ## Usage {#sec-pkgs-mkShell-usage}

     

       8
        
       

     

       9
        
       ```nix

     

       10
        
       { pkgs ? import <nixpkgs> {} }:

     

       11
        
       pkgs.mkShell {

     

       12
       +
         # specify which packages to add to the shell environment

     

       13
       +
         packages = [ pkgs.gnumake ];

     

       14
       +
         # add all the dependencies, of the given packages, to the shell environment

     

       15
        
         inputsFrom = with pkgs; [ hello gnutar ];

     

       0
        
       
     

       16
        
       }

     

       17
        
       ```

+2 -2

doc/languages-frameworks/dotnet.section.md

···

       10
        
       

     

       11
        
       mkShell {

     

       12
        
         name = "dotnet-env";

     

       13
       -
         buildInputs = [

     

       14
        
           dotnet-sdk_3

     

       15
        
         ];

     

       16
        
       }

     
···

       25
        
       

     

       26
        
       mkShell {

     

       27
        
         name = "dotnet-env";

     

       28
       -
         buildInputs = [

     

       29
        
           (with dotnetCorePackages; combinePackages [

     

       30
        
             sdk_3_1

     

       31
        
             sdk_3_0

···

       10
        
       

     

       11
        
       mkShell {

     

       12
        
         name = "dotnet-env";

     

       13
       +
         packages = [

     

       14
        
           dotnet-sdk_3

     

       15
        
         ];

     

       16
        
       }

     
···

       25
        
       

     

       26
        
       mkShell {

     

       27
        
         name = "dotnet-env";

     

       28
       +
         packages = [

     

       29
        
           (with dotnetCorePackages; combinePackages [

     

       30
        
             sdk_3_1

     

       31
        
             sdk_3_0

+1 -1

doc/languages-frameworks/python.section.md

···

       245
        
           ps.toolz

     

       246
        
         ]);

     

       247
        
       in mkShell {

     

       248
       -
         buildInputs = [

     

       249
        
           pythonEnv

     

       250
        
       

     

       251
        
           black

···

       245
        
           ps.toolz

     

       246
        
         ]);

     

       247
        
       in mkShell {

     

       248
       +
         packages = [

     

       249
        
           pythonEnv

     

       250
        
       

     

       251
        
           black

+1 -1

doc/languages-frameworks/ruby.section.md

···

       106
        
           name = "gems-for-some-project";

     

       107
        
           gemdir = ./.;

     

       108
        
         };

     

       109
       -
       in mkShell { buildInputs = [ gems gems.wrappedRuby ]; }

     

       110
        
       ```

     

       111
        
       

     

       112
        
       With this file in your directory, you can run `nix-shell` to build and use the gems. The important parts here are `bundlerEnv` and `wrappedRuby`.

···

       106
        
           name = "gems-for-some-project";

     

       107
        
           gemdir = ./.;

     

       108
        
         };

     

       109
       +
       in mkShell { packages = [ gems gems.wrappedRuby ]; }

     

       110
        
       ```

     

       111
        
       

     

       112
        
       With this file in your directory, you can run `nix-shell` to build and use the gems. The important parts here are `bundlerEnv` and `wrappedRuby`.

+5 -2

maintainers/scripts/update-luarocks-shell.nix

···

       2
        
       }:

     

       3
        
       with nixpkgs;

     

       4
        
       mkShell {

     

       5
       -
         buildInputs = [

     

       6
       -
           bash luarocks-nix nix-prefetch-scripts parallel

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       7
        
         ];

     

       8
        
         LUAROCKS_NIXPKGS_PATH = toString nixpkgs.path;

     

       9
        
       }

···

       2
        
       }:

     

       3
        
       with nixpkgs;

     

       4
        
       mkShell {

     

       5
       +
         packages = [

     

       6
       +
           bash

     

       7
       +
           luarocks-nix

     

       8
       +
           nix-prefetch-scripts

     

       9
       +
           parallel

     

       10
        
         ];

     

       11
        
         LUAROCKS_NIXPKGS_PATH = toString nixpkgs.path;

     

       12
        
       }

+1 -1

nixos/doc/manual/shell.nix

···

       4
        
       pkgs.mkShell {

     

       5
        
         name = "nixos-manual";

     

       6
        
       

     

       7
       -
         buildInputs = with pkgs; [ xmlformat jing xmloscopy ruby ];

     

       8
        
       }

···

       4
        
       pkgs.mkShell {

     

       5
        
         name = "nixos-manual";

     

       6
        
       

     

       7
       +
         packages = with pkgs; [ xmlformat jing xmloscopy ruby ];

     

       8
        
       }

+3 -3

pkgs/applications/editors/emacs-modes/emacs2nix.nix

···

       7
        
           rev = "860da04ca91cbb69c9b881a54248d16bdaaf9923";

     

       8
        
           sha256 = "1r3xmyk9rfgx7ln69dk8mgbnh3awcalm3r1c5ia2shlsrymvv1df";

     

       9
        
         };

     

       10
       -
       

     

       11
       -
       in pkgs.mkShell {

     

       12
        
       

     

       13
       -
         buildInputs = [

     

       14
        
           pkgs.bash

     

       15
        
         ];

     

       16

···

       7
        
           rev = "860da04ca91cbb69c9b881a54248d16bdaaf9923";

     

       8
        
           sha256 = "1r3xmyk9rfgx7ln69dk8mgbnh3awcalm3r1c5ia2shlsrymvv1df";

     

       9
        
         };

     

       10
       +
       in

     

       11
       +
       pkgs.mkShell {

     

       12
        
       

     

       13
       +
         packages = [

     

       14
        
           pkgs.bash

     

       15
        
         ];

     

       16

+1 -1

pkgs/applications/editors/emacs-modes/updater-emacs.nix

···

       29
        
         in [ promise semaphore ]);

     

       30
        
       

     

       31
        
       in pkgs.mkShell {

     

       32
       -
         buildInputs = [

     

       33
        
           pkgs.git

     

       34
        
           pkgs.nix

     

       35
        
           pkgs.bash

···

       29
        
         in [ promise semaphore ]);

     

       30
        
       

     

       31
        
       in pkgs.mkShell {

     

       32
       +
         packages = [

     

       33
        
           pkgs.git

     

       34
        
           pkgs.nix

     

       35
        
           pkgs.bash

+2 -2

pkgs/applications/networking/cluster/nixops/shell.nix

···

       1
       -
       { pkgs ? import <nixpkgs> {} }:

     

       2
        
       

     

       3
        
       pkgs.mkShell {

     

       4
       -
         buildInputs = [

     

       5
        
           pkgs.poetry2nix.cli

     

       6
        
           pkgs.pkg-config

     

       7
        
           pkgs.libvirt

···

       1
       +
       { pkgs ? import <nixpkgs> { } }:

     

       2
        
       

     

       3
        
       pkgs.mkShell {

     

       4
       +
         packages = [

     

       5
        
           pkgs.poetry2nix.cli

     

       6
        
           pkgs.pkg-config

     

       7
        
           pkgs.libvirt

+1 -1

pkgs/build-support/agda/default.nix

···

       1
        
       # Builder for Agda packages.

     

       2
        
       

     

       3
       -
       { stdenv, lib, self, Agda, runCommandNoCC, makeWrapper, writeText, mkShell, ghcWithPackages, nixosTests }:

     

       4
        
       

     

       5
        
       with lib.strings;

     

       6

···

       1
        
       # Builder for Agda packages.

     

       2
        
       

     

       3
       +
       { stdenv, lib, self, Agda, runCommandNoCC, makeWrapper, writeText, ghcWithPackages, nixosTests }:

     

       4
        
       

     

       5
        
       with lib.strings;

     

       6

+14 -10

pkgs/build-support/mkshell/default.nix

···

       3
        
       # A special kind of derivation that is only meant to be consumed by the

     

       4
        
       # nix-shell.

     

       5
        
       {

     

       6
       -
         inputsFrom ? [], # a list of derivations whose inputs will be made available to the environment

     

       7
       -
         buildInputs ? [],

     

       8
       -
         nativeBuildInputs ? [],

     

       9
       -
         propagatedBuildInputs ? [],

     

       10
       -
         propagatedNativeBuildInputs ? [],

     

       11
       -
         ...

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       12
        
       }@attrs:

     

       13
        
       let

     

       14
        
         mergeInputs = name: lib.concatLists (lib.catAttrs name

     

       15
       -
           ([attrs] ++ inputsFrom));

     

       16
        
       

     

       17
        
         rest = builtins.removeAttrs attrs [

     

       0
        
       
     

       18
        
           "inputsFrom"

     

       19
        
           "buildInputs"

     

       20
        
           "nativeBuildInputs"

     
···

       26
        
       

     

       27
        
       stdenv.mkDerivation ({

     

       28
        
         name = "nix-shell";

     

       29
       -
         phases = ["nobuildPhase"];

     

       30
        
       

     

       31
        
         buildInputs = mergeInputs "buildInputs";

     

       32
       -
         nativeBuildInputs = mergeInputs "nativeBuildInputs";

     

       33
        
         propagatedBuildInputs = mergeInputs "propagatedBuildInputs";

     

       34
        
         propagatedNativeBuildInputs = mergeInputs "propagatedNativeBuildInputs";

     

       35
        
       

     

       36
        
         shellHook = lib.concatStringsSep "\n" (lib.catAttrs "shellHook"

     

       37
       -
           (lib.reverseList inputsFrom ++ [attrs]));

     

       38
        
       

     

       39
        
         nobuildPhase = ''

     

       40
        
           echo

···

       3
        
       # A special kind of derivation that is only meant to be consumed by the

     

       4
        
       # nix-shell.

     

       5
        
       {

     

       6
       +
         # a list of packages to add to the shell environment

     

       7
       +
         packages ? [ ]

     

       8
       +
       , # propagate all the inputs from the given derivations

     

       9
       +
         inputsFrom ? [ ]

     

       10
       +
       , buildInputs ? [ ]

     

       11
       +
       , nativeBuildInputs ? [ ]

     

       12
       +
       , propagatedBuildInputs ? [ ]

     

       13
       +
       , propagatedNativeBuildInputs ? [ ]

     

       14
       +
       , ...

     

       15
        
       }@attrs:

     

       16
        
       let

     

       17
        
         mergeInputs = name: lib.concatLists (lib.catAttrs name

     

       18
       +
           ([ attrs ] ++ inputsFrom));

     

       19
        
       

     

       20
        
         rest = builtins.removeAttrs attrs [

     

       21
       +
           "packages"

     

       22
        
           "inputsFrom"

     

       23
        
           "buildInputs"

     

       24
        
           "nativeBuildInputs"

     
···

       30
        
       

     

       31
        
       stdenv.mkDerivation ({

     

       32
        
         name = "nix-shell";

     

       33
       +
         phases = [ "nobuildPhase" ];

     

       34
        
       

     

       35
        
         buildInputs = mergeInputs "buildInputs";

     

       36
       +
         nativeBuildInputs = packages ++ (mergeInputs "nativeBuildInputs");

     

       37
        
         propagatedBuildInputs = mergeInputs "propagatedBuildInputs";

     

       38
        
         propagatedNativeBuildInputs = mergeInputs "propagatedNativeBuildInputs";

     

       39
        
       

     

       40
        
         shellHook = lib.concatStringsSep "\n" (lib.catAttrs "shellHook"

     

       41
       +
           (lib.reverseList inputsFrom ++ [ attrs ]));

     

       42
        
       

     

       43
        
         nobuildPhase = ''

     

       44
        
           echo

+1 -1

pkgs/development/mobile/androidenv/examples/shell.nix

···

       115
        
       in

     

       116
        
       pkgs.mkShell rec {

     

       117
        
         name = "androidenv-demo";

     

       118
       -
         buildInputs = [ androidSdk platformTools jdk pkgs.android-studio ];

     

       119
        
       

     

       120
        
         LANG = "C.UTF-8";

     

       121
        
         LC_ALL = "C.UTF-8";

···

       115
        
       in

     

       116
        
       pkgs.mkShell rec {

     

       117
        
         name = "androidenv-demo";

     

       118
       +
         packages = [ androidSdk platformTools jdk pkgs.android-studio ];

     

       119
        
       

     

       120
        
         LANG = "C.UTF-8";

     

       121
        
         LC_ALL = "C.UTF-8";

+2 -2

pkgs/tools/X11/opentabletdriver/shell.nix

···

       1
       -
       { pkgs ? import ../../../../. {} }:

     

       2
        
       

     

       3
        
       with pkgs;

     

       4
        
       

     

       5
        
       mkShell {

     

       6
       -
         buildInputs = [

     

       7
        
           common-updater-scripts

     

       8
        
           curl

     

       9
        
           dotnetCorePackages.sdk_5_0

···

       1
       +
       { pkgs ? import ../../../../. { } }:

     

       2
        
       

     

       3
        
       with pkgs;

     

       4
        
       

     

       5
        
       mkShell {

     

       6
       +
         packages = [

     

       7
        
           common-updater-scripts

     

       8
        
           curl

     

       9
        
           dotnetCorePackages.sdk_5_0