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
Related#
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