iyi

Playground · Basics · 2 of 33

modules

Modules: every file is one, and import brings another in.

samples/tour/modules.iyi · modules.wasm · 121 KB
# Modules: every file is one, and `import` brings another in.

# `geometry/point` is the file geometry/point.iyi. The path is the name.
import geometry/point

# After `import`, the module's exports are reachable under its qualified
# name: the path with each segment capitalised, joined by `::`.
a = Geometry::Point::Point.new(1, 2)
b = Geometry::Point::Point.new(4, 6)
puts Geometry::Point.distance(a, b)
output
Press Run.

recorded with iyi 0.18.0 (built on Crystal 1.22.0-dev [2a9653052] (2026-10-18)) · Linux 7.0.0-38-generic x86_64, QEMU Virtual CPU version 2.5+ · 2026-10-19

You can type in the pane: nothing here compiles, so what you type cannot run, and the page says which bytes it is running the moment the text stops being the recorded file. There is no standard input, no filesystem and no threads on this target, and one sample fails on purpose for exactly that reason.

Run executes modules.wasm, the module the compiler built from this file, in your browser. How this works

Try it on your machine

Copy the program into modules.iyi, change something, and run it. Only a compiler on your own machine can run what you wrote.

sh, after installing
$ iyi run modules.iyi