Renderingen-US

Experimental through version 1. Version 0 was alpha. This is the first language release: the interface is relatively stable, not frozen. Nothing is promised stable until version 2.

manifest

Translation status: English reader-locale proof. Term names and code fences follow the en pack; supporting prose may still be English.

faber.toml package metadata for build, run, and test.

Aliases: faber.toml, package manifest

Syntax: faber.toml

Category#

package

Examples#

radix/corpus/reference/concept/manifest/manifest.fab (canonical · concept)#

faber.toml package metadata for build, run, and test.

# =============================================================================
# manifest — faber.toml package metadata for build, run, and test.
# =============================================================================
#
# What this teaches:
#   • the package manifest file `faber.toml` — configures build, run, and test for a Faber package
#   • key manifest sections: `[package]`, `[paths]`, `[build]`
#   • optional `[format] width = N` — opt-in line wrapping for `faber format`
#
# Common mistakes:
#   • Omitting the required [package], [paths], or [build] sections — a valid faber.toml must include all three.
#
# See also: targets, cli, main, test
# =============================================================================

# meta/manifest — package manifest (META)
#
# Website/tooling documents faber.toml; this exemplum is not a manifest file.
#
# Example package layout:
#
#   faber.toml
#   src/main.fab
#
# Example faber.toml:
#
#   [package]
#   name = "salve"
#   version = "0.1.0"
#   edition = "2026"
#
#   [paths]
#   source = "src"
#   entry = "main.fab"
#
#   [build]
#   target = "rust"
#   kind = "bin"
#
#   [format]
#   width = 100
#
# The [format] table is optional. [format] width = N wraps `faber format` output at N display columns,
# indentation included, breaking only between tokens where a newline changes
# nothing (an unbreakable span wider than N overflows). It is a positive
# integer; zero, a negative number or a non-integer is refused. There is no
# built-in width: with neither the key nor the flag, output is not wrapped.
# `faber format --width N` wins over the manifest key; `--stdin` has no package,
# so only the flag applies.
#
# GRAMMAR:
#   packageManifest :← toml document (faber tool, not Faber source)
#
# EXPECTED OUTPUT:
#   manifest exemplum
#
# BACKEND:
#   META-only — runnable body is compile smoke only.

main {
    print "manifest exemplum — configure packages via faber.toml"
}

Expected output:

manifest exemplum — configure packages via faber.toml