Home / Docs / Specification / 30. Packages and dependencies

30.1 Lexical rules

Release v0.4.0
  1. The lexer of spec/01. ita.una, ita.lock and itaty.una are read by the lexer of spec/01: UTF-8 without a byte order mark, two-space indentation, -- comments, no tabs, the control characters of spec/01 §1 rule 6 rejected, identifiers, and integer and text literals as spec/01 §4 and §6 state. Two differences hold in these files only.
    • A version token. version_lit = num "." num [ "." num ] [ "-" pre { "." pre } ], where num is 0 or digits without a leading zero, and pre is [0-9A-Za-z]+, a numeric pre without a leading zero. It is matched before integers, so 1.4 and 0.1.0 are versions here. A malformed version, such as 01.2, 1.2.3.4 or 1.2.3+build, is an error.
    • Text without interpolation. A text literal MUST NOT contain { or } other than as \{ and \}: nothing is interpolated.
  2. No keywords. No word of these files is a keyword or a reserved word: from, in, trusted and profile are words of the grammar where it names them. No word of these files becomes a keyword of a module.
  3. Nothing runs. There are no expressions, no interpolation, no conditions, no includes and no environment variables, and nothing else runs when a package is read, checked or built: there are no install scripts, build scripts or hooks of any kind.
  4. Bounds. ita.una and itaty.una hold at most 1 MiB, and ita.lock at most 16 MiB; past that, the file is refused whole, at its start.