Home / Docs / Configure a package
[package] version
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. version is the package's own version, which its authors raise as they release changes. It is required, in the [package] table, and is a non-blank string.
Learn more: The manifest and the lock.
[package]
name = "shop"
version = "0.1.0"
edition = "0.2"module shop
pub price(cents: Int) -> Int = centsForms
[package]
version = "<a non-blank string>"The specification requires a non-empty string and fixes no format beyond that; a string of spaces only is refused too. 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
A package without a version is rejected:
[package]
name = "shop"
edition = "0.2"-- fails with U7002
module shop
pub price(cents: Int) -> Int = centsEdge cases
Further rules:
- Not the edition.
versionis the package's own version; the language version its code is written in isedition. See[package] edition.
Diagnostics
- U7002: a missing or blank
version.
Edition
version is the same in editions 0.1 and 0.2. From edition 0.4 it is the head line version of ita.una, and it must have the form MAJOR.MINOR.PATCH: any other is U7008 (see ita.una).
Normative source
- spec/13 §7: project files.