Skip to content

Ruby

makeRubyGemsInstall

Fetch and install the specified Ruby gems from the RubyGems.

Types:

  • makeRubyGemsInstall (function { ... } -> package):
    • name (str): Custom name to assign to the build step, be creative, it helps in debugging.
    • ruby (enum [ "3.1" "3.2" "3.3" ]): Version of the Ruby interpreter.
    • searchPaths (asIn makeSearchPaths): Optional. Arguments here will be passed as-is to makeSearchPaths. Defaults to makeSearchPaths's defaults.
    • sourcesYaml (package): sources.yaml file computed as explained in the pre-requisites section.

Example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# /path/to/my/project/makes/example/main.nix
{
  makeRubyGemsInstall,
  ...
}:
makeRubyGemsInstall {
  name = "example";
  ruby = "3.1";
  sourcesYaml = projectPath "/makes/example/sources.yaml";
}
Tip

Refer to makeRubyLock to learn how to generate a sourcesYaml.

makeRubyGemsEnvironment

Create an environment where the specified Ruby gems from RubyGems are available.

Types:

  • makeRubyGemsEnvironment (function { ... } -> package):
    • name (str): Custom name to assign to the build step, be creative, it helps in debugging.
    • ruby (enum [ "3.1" "3.2" "3.3" ]): Version of the Ruby interpreter.
    • searchPathsBuild (asIn makeSearchPaths): Optional. Arguments here will be passed as-is to makeSearchPaths and used while installing gems. Defaults to makeSearchPaths's defaults.
    • searchPathsRuntime (asIn makeSearchPaths): Optional. Arguments here will be passed as-is to makeSearchPaths and propagated to the runtime environment. Defaults to makeSearchPaths's defaults.
    • sourcesYaml (package): sources.yaml file computed as explained in the pre-requisites section.

Example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# /path/to/my/project/makes/example/main.nix
{
  inputs,
  makeRubyGemsEnvironment,
  makeScript,
  ...
}:
let
  env = makeRubyGemsEnvironment {
    name = "example";
    ruby = "3.1";
    searchPathsBuild.bin = [ inputs.nixpkgs.gcc ];
    searchPathsRuntime.rpath = [ inputs.nixpkgs.gcc.cc.lib ];
    sourcesYaml = projectPath "/makes/example/sources.yaml";
  };
in
makeScript {
  entrypoint = ''
    slimrb --version
  '';
  name = "example";
  searchPaths.source = [ env ];
}

1
2
3
$ m . /example

    Slim 4.1.0
Tip

Refer to makeRubyLock to learn how to generate a sourcesYaml.