Home / Docs / Configure a package

[package] name

Release v0.4.0Edition 0.1 and laterU7002

What it does

A package is one program or library: a directory that holds the source files under src/ and a file una.toml, its manifest, which says what the package is called, which version it is and which edition of Una it uses. name is the package's name. It is required, in the [package] table, and is a non-blank string.

Learn more: The manifest and the lock.

una.tomltoml
[package]
name = "shop"
version = "0.1.0"
edition = "0.2"
src/shop.unauna
module shop

pub price(cents: Int) -> Int = cents

Forms

toml
[package]
name = "<a non-blank string>"

A package's una.toml is a TOML document (TOML is a plain text format of key = value lines grouped under [table] headers) with the tables and keys the specification defines, and no others. A syntax error, a missing required key, and a value of the wrong type or outside its range are U7002.

Examples

An empty name is rejected, and so is one of spaces only:

una.tomltoml
[package]
name = ""
version = "0.1.0"
edition = "0.2"
src/shop.unauna
-- fails with U7002
module shop

pub price(cents: Int) -> Int = cents

Edge cases

The key is required. A [package] table without name is U7002, like a missing version or edition.

Further rules:

Diagnostics

Edition

name is the same in editions 0.1 and 0.2. From edition 0.4 it is the head line of ita.una, ita <name> or ita <owner>/<name> (see ita.una).

Normative source