Difference between revisions of "Raku"

From NixOS Wiki
Jump to: navigation, search
m (language)
(more details and improvements on installation)
Line 9: Line 9:
 
</syntaxHighlight>
 
</syntaxHighlight>
  
or install them permanently by adding the lines <code>rakudo</code> and <code>zef</code> to your NixOS configuration file.
+
or install them permanently system-wide by adding <code>pkgs.rakudo</code> and <code>pkgs.zef</code> to your NixOS configuration file.
  
To get the ''Rakudo Star'' distribution (which bundles Rakudo with a collection of modules the language documentation), you need to download and compile it. This way, you'll also always get the latest Rakudo version.
+
To create a Nix user environment on NixOS, run
 +
 
 +
<syntaxHighlight lang=shell>
 +
nix-env -iA nixos.rakudo
 +
</syntaxHighlight>
 +
 
 +
(For environments or flakes on non-NixOS machines, different recommendations apply.<ref name="nixos-package-index">See https://search.nixos.org/packages?channel=25.05&show=rakudo&query=raku under the tab ''nix-env''</ref>)
 +
 
 +
No Nix packages currently exist for the ''Rakudo Star'' distribution, which bundles Rakudo with a collection of modules the language documentation. Thus, to use it, you need to download and compile it.<ref>https://rakudo.org/star</ref> This way, you'll also always get the latest Rakudo version.
  
 
=== Making the Readline library available ===
 
=== Making the Readline library available ===
Line 31: Line 39:
 
</syntaxHighlight>
 
</syntaxHighlight>
  
And indeed, keyboard commands like <code>Arrow-up</code> to go through history won't work.
+
And indeed, keyboard commands like <code>Arrow-up</code> to go through history will not work.
 +
 
 +
== References ==

Revision as of 10:16, 28 September 2025

Warning: This article is in a very early stage.

Installing Rakudo and Zef

Rakudo is the preferred implementation of Raku, and the zef the preferred module manager. Install them in a nix shell via

nix-shell -p rakudo zef

or install them permanently system-wide by adding pkgs.rakudo and pkgs.zef to your NixOS configuration file.

To create a Nix user environment on NixOS, run

nix-env -iA nixos.rakudo

(For environments or flakes on non-NixOS machines, different recommendations apply.[1])

No Nix packages currently exist for the Rakudo Star distribution, which bundles Rakudo with a collection of modules the language documentation. Thus, to use it, you need to download and compile it.[2] This way, you'll also always get the latest Rakudo version.

Making the Readline library available

When opening an interactive environment (by running rakudo, or its symlink raku, without arguments), you may get an error message like this:

I ran into a problem while trying to set up Readline: Could not instantiate role 'ReadlineBehavior'; exception details:

  Cannot locate native library 'libreadline.so.7': libreadline.so.7: cannot open shared object file: No such file or directory
  in method setup at [...]

Falling back to Linenoise (if present)
No line editor found.

You may want to exit first and `zef install Readline`, `zef install
Linenoise`, or `zef install Terminal::LineEditor` or install `rlwrap`
for a line editor before entering the REPL again.

And indeed, keyboard commands like Arrow-up to go through history will not work.

References