Модули и стандартная библиотека

Prerequisite

Use Topaz 5.21.3 with SELF and language mode 5.21. Work in one directory containing the two files in this chapter.

1. Split the program

Save both files with the shown names. greeting.tpz exports greet; main.tpz selects it and imports std.io as io. Keep the output call in main.tpz.

2. Check the entry file

Ссылка

Check both source files

Ссылка

check · checking · Проверка · Пройдено

main.tpzCheck both source filesОткрыть песочницу →

import greeting { greet }
import std.io
io.writeLine(greet("Topaz"))

Зафиксированный выводКод завершения 0

main.tpz: types-ok (3 modules)
main.tpz: resolve-ok (3 modules)

$ topaz check main.tpz --compiler self · Зафиксировано с Топазом 5.21.3

greeting.tpzCheck both source filesОткрыть песочницу →

export function greet(name: string) -> string {
return "Hello, {name}!"
}

Ожидаемый результат

Проверка принимает программу. Код завершения 0.

Наблюдаемые утверждения · Пройдено · 5.21.3

2026-11-06T13:40:34.0274796Z · checking · sha256:b6c3f574b78c558b526196fa04f5d835c9fe1df59d07397dbf4e5d279a3e1665

Код завершения 0.

Наблюдаемый стандартный вывод

main.tpz: types-ok (3 modules)
main.tpz: resolve-ok (3 modules)

Нет вывода ошибок.

Пройдено · expected 0; observed 0

Run the command from the directory containing both files. Checking should succeed. If module resolution fails, check the file name and location, then follow the reported diagnostic.

3. Run the program

Ссылка

Run the entry file

Ссылка

run · runtime · Проверка · Пройдено

main.tpzRun the entry fileОткрыть песочницу →

import greeting { greet }
import std.io
io.writeLine(greet("Topaz"))

Зафиксированный выводКод завершения 0

Hello, Topaz!

$ topaz run main.tpz --compiler self · Зафиксировано с Топазом 5.21.3

greeting.tpzRun the entry fileОткрыть песочницу →

export function greet(name: string) -> string {
return "Hello, {name}!"
}

Ожидаемый результат

Выполнение завершается. Код завершения 0.

Нет вывода ошибок.

Ожидаемый стандартный вывод

Hello, Topaz!

Наблюдаемые утверждения · Пройдено · 5.21.3

2026-11-06T13:40:34.1048255Z · runtime · sha256:b6c3f574b78c558b526196fa04f5d835c9fe1df59d07397dbf4e5d279a3e1665

Код завершения 0.

Наблюдаемый стандартный вывод

Hello, Topaz!

Нет вывода ошибок.

Пройдено · expected 0; observed 0
Пройдено · stdout matches the authored expectation
Пройдено · stderr matches the authored expectation

The expected program output is Hello, Topaz! followed by a newline. The imported function supplies the greeting; std.io.writeLine writes it.

Imports and package setup

Ссылка

import greeting { greet } selects an exported name; it does not install a dependency. These commands pass a source-file entry. Without an entry operand, package mode loads topaz.toml. See the check reference.

Verification record

Ссылка

Public Topaz 5.21.3 checked and ran this two-file program successfully in Docs run 42224592687, attempt 2. The recorded exit codes and output were compared with this page's current product assertions. The fixture files, invocation and expected output were unchanged.

Modules and visibility defines imports and exported declarations. Packages, locks and targets describes package inputs.