Course of Raku / Advanced / Modules / Modules basics

Using modules

To use a module, load it with the use statement. After that, the names the module exports are available as if you had written them yourself.

Given the Greeting.rakumod file from the previous topic, a program uses it like this:

use Greeting;

say hello('Anna');

Because hello was marked is export, the use statement makes it available, and the program calls it directly:

Hello, Anna!

For Raku to find the module, it has to be on the module search path. When the module file sits in the same directory as your program, you tell Raku to look there with the -I. option (the dot means “the current directory”):

$ raku -I. program.raku
Hello, Anna!

Installed modules (covered later in Installing modules from the web) are found automatically, so the -I option is only needed for modules that live next to your own program.

Course navigation

← Quiz — is export   |   Quiz — use →

💪 Or jump directly to the exercises in this section.