Skip to content

Distributions and modules

tt is a core and a set of modules. The core parses the command line, finds projects and scopes, and offers the services modules are built on; the commands come from modules. There are two kinds of them.

Compiled-in modules

A tt module is a Go module compiled into tt. Its package exports a constructor, func New(sdk.Services) []sdk.Mount, that returns the commands it adds, or func New(sdk.Services) sdk.Module, that returns the build backends and the checks of the files of a package it adds as well. tt itself is the core with its standard modules: builtin, its own commands, and the modules of its repository the core's package standard lists, aeon, build, emmylua and wasm. build has the build backends of tt: the core has none of its own. wasm has tt wasm and the check of the .wasm files of a package.

A distribution of tt is the core and a set of modules built into one binary, described by tt.manifest.toml. It takes the standard modules of its core by default, at the commit of the core, and adds modules of its own; it can leave some standard modules out, or put a module of its own in the place of one. It can present itself under another name and edition, choose an integrity provider, which signs and checks packages, and leave out tt's own commands or external modules. tt version --modules lists the modules of a binary.

tt binary build tt builds a distribution. See Build a distribution of tt; the API of modules is described in the SDK.

External modules

An external module is an executable in a modules directory, which tt runs as a command of its own. It can add a command or replace one of tt's. See External modules.