···

       
464
       
 
       
    with wrapped binaries in <filename>bin/</filename>.

     

       
465
       
 
       
  </para>

     

       
466
       
 
       


     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
467
       
 
       
  <variablelist>

     

       
468
       
 
       
    <title>

     

       
469
       
 
       
      <function>python.buildEnv</function> arguments

     

···

       
464
       
 
       
    with wrapped binaries in <filename>bin/</filename>.

     

       
465
       
 
       
  </para>

     

       
466
       
 
       


     

       
467
       
+
       
  <para>

     

       
468
       
+
       
  You can also use <varname>env</varname> attribute to create local

     

       
469
       
+
       
  environments with needed packages installed (somewhat comparable to

     

       
470
       
+
       
  <literal>virtualenv</literal>). For example, with the following

     

       
471
       
+
       
  <filename>shell.nix</filename>:

     

       
472
       
+
       


     

       
473
       
+
       
<programlisting language="nix">

     

       
474
       
+
       
<![CDATA[with import <nixpkgs> {};

     

       
475
       
+
       


     

       
476
       
+
       
(python3.buildEnv.override {

     

       
477
       
+
       
  extraLibs = with python3Packages;

     

       
478
       
+
       
    [ numpy

     

       
479
       
+
       
      requests

     

       
480
       
+
       
    ];

     

       
481
       
+
       
}).env]]>

     

       
482
       
+
       
</programlisting>

     

       
483
       
+
       


     

       
484
       
+
       
  Running <command>nix-shell</command> will drop you into a shell where

     

       
485
       
+
       
  <command>python</command> will have specified packages in its path.

     

       
486
       
+
       
  </para>

     

       
487
       
+
       


     

       
488
       
 
       
  <variablelist>

     

       
489
       
 
       
    <title>

     

       
490
       
 
       
      <function>python.buildEnv</function> arguments

     

···

       
6
       
 
       
# Create a python executable that knows about additional packages.

     

       
7
       
 
       
let

     

       
8
       
 
       
  recursivePthLoader = import ../../python-modules/recursive-pth-loader/default.nix { stdenv = stdenv; python = python; };

     

       
9
       
-
       
in

     

       
10
       
-
       
(buildEnv {

     

       
11
       
-
       
  name = "${python.name}-env";

     

       
12
       
-
       
  paths = stdenv.lib.filter (x : x ? pythonPath) (stdenv.lib.closePropagation extraLibs) ++ [ python recursivePthLoader ];

     

       
13
       
 
       


     

       
14
       
-
       
  inherit ignoreCollisions;

     

       
15
       
 
       


     

       
16
       
-
       
  postBuild = ''

     

       
17
       
-
       
    . "${makeWrapper}/nix-support/setup-hook"

     

       
18
       
 
       


     

       
19
       
-
       
    if [ -L "$out/bin" ]; then

     

       
20
       
-
       
        unlink "$out/bin"

     

       
21
       
-
       
    fi

     

       
22
       
-
       
    mkdir -p "$out/bin"

     

       
23
       
 
       


     

       
24
       
-
       
    cd "${python}/bin"

     

       
25
       
-
       
    for prg in *; do

     

       
26
       
-
       
      rm -f "$out/bin/$prg"

     

       
27
       
-
       
      makeWrapper "${python}/bin/$prg" "$out/bin/$prg" --set PYTHONHOME "$out"

     

       
28
       
-
       
    done

     

       
29
       
-
       
  '' + postBuild;

     

       
30
       
-
       
}) // {

     

       
31
       
-
       
  inherit python;

     

       
32
       
-
       
  inherit (python) meta;

     

       
33
       
-
       
}

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

···

       
6
       
 
       
# Create a python executable that knows about additional packages.

     

       
7
       
 
       
let

     

       
8
       
 
       
  recursivePthLoader = import ../../python-modules/recursive-pth-loader/default.nix { stdenv = stdenv; python = python; };

     

       
9
       
+
       
  env = (buildEnv {

     

       
10
       
+
       
    name = "${python.name}-env";

     

       
11
       
+
       
    paths = stdenv.lib.filter (x : x ? pythonPath) (stdenv.lib.closePropagation extraLibs) ++ [ python recursivePthLoader ];

     

       
0
       
 
       

     

       
12
       
 
       


     

       
13
       
+
       
    inherit ignoreCollisions;

     

       
14
       
 
       


     

       
15
       
+
       
    postBuild = ''

     

       
16
       
+
       
      . "${makeWrapper}/nix-support/setup-hook"

     

       
17
       
 
       


     

       
18
       
+
       
      if [ -L "$out/bin" ]; then

     

       
19
       
+
       
          unlink "$out/bin"

     

       
20
       
+
       
      fi

     

       
21
       
+
       
      mkdir -p "$out/bin"

     

       
22
       
 
       


     

       
23
       
+
       
      cd "${python}/bin"

     

       
24
       
+
       
      for prg in *; do

     

       
25
       
+
       
        rm -f "$out/bin/$prg"

     

       
26
       
+
       
        makeWrapper "${python}/bin/$prg" "$out/bin/$prg" --set PYTHONHOME "$out"

     

       
27
       
+
       
      done

     

       
28
       
+
       
    '' + postBuild;

     

       
29
       
+
       


     

       
30
       
+
       
    passthru.env = stdenv.mkDerivation {

     

       
31
       
+
       
      name = "interactive-${python.name}-environment";

     

       
32
       
+
       
      nativeBuildInputs = [ env ];

     

       
33
       
+
       


     

       
34
       
+
       
      buildCommand = ''

     

       
35
       
+
       
        echo >&2 ""

     

       
36
       
+
       
        echo >&2 "*** Python 'env' attributes are intended for interactive nix-shell sessions, not for building! ***"

     

       
37
       
+
       
        echo >&2 ""

     

       
38
       
+
       
        exit 1

     

       
39
       
+
       
      '';

     

       
40
       
+
       
    };

     

       
41
       
+
       
  }) // {

     

       
42
       
+
       
    inherit python;

     

       
43
       
+
       
    inherit (python) meta;

     

       
44
       
+
       
  };

     

       
45
       
+
       
in env