doc/languages-frameworks/hy.section.md

   1 # Hy {#sec-language-hy}
   2
   3 ## Installation {#ssec-hy-installation}
   4
   5 ### Installation without packages {#installation-without-packages}
   6
   7 You can install `hy` via nix-env or by adding it to `configuration.nix` by referring to it as a `hy` attribute. This kind of installation adds `hy` to your environment and it successfully works with `python3`.
   8
   9 ::: {.caution}
  10 Packages that are installed with your python derivation, are not accessible by `hy` this way.
  11 :::
  12
  13 ### Installation with packages {#installation-with-packages}
  14
  15 Creating `hy` derivation with custom `python` packages is really simple and similar to the way that python does it. Attribute `hy` provides function `withPackages` that creates custom `hy` derivation with specified packages.
  16
  17 For example if you want to create shell with `matplotlib` and `numpy`, you can do it like so:
  18
  19 ```ShellSession
  20 $ nix-shell -p "hy.withPackages (ps: with ps; [ numpy matplotlib ])"
  21 ```
  22
  23 Or if you want to extend your `configuration.nix`:
  24 ```nix
  25 { # ...
  26
  27   environment.systemPackages = with pkgs; [
  28     (hy.withPackages (py-packages: with py-packages; [ numpy matplotlib ]))
  29   ];
  30 }
  31 ```