Module B0_def

B0 definitions.

B0 definitions are uniquely named OCaml values of different types used for describing software construction. The value names are used for end-user interaction.

B0 definitions occur in various B0 files and libraries during the module initialisation phase of the program consuming the definitions. After the module initialisation phase no new definition is allowed.

This module handle the management of these named values in B0 files and libraries. It provides the infrastructure to track the location of their definition, properly scope the names, check their unicity in the scope, index them and make sure they cannot be defined after the module initialisation phase of the program.

Definitions

module Scope : sig ... end

Scopes are used to track and scope B0 definitions created by libraries and B0 files.

type t

The type for definition names and their scoping information.

type def = t

See t.

val scope : t -> Scope.t

scope d is the scope in which d is defined.

val file : t -> B00_std.Fpath.t option

file d is the absolute file path in which d is defined, if defined in a file.

val scope_dir : t -> B00_std.Fpath.t option

scope_dir is the parent of file d.

val name : t -> string

name d is the qualified name of d.

val doc : t -> string

doc d is a one-line documentation string for d.

val meta : t -> B0_meta.t

meta is the metadata associated to the definition.

exception Err of string

Exception thrown if a definition error occurs. This can be due to

  • Duplicate name.
  • Malformed name.

The argument is an error message to print as is. The backtrace should point to the redefinition (it is unfortunately difficult to keep track of the previous definition).

Defining values

module type VALUE = sig ... end

The type for values to be named.

module type S = sig ... end

The type of named values.

module Make (V : VALUE) : S with type t = V.t

Make (V) names the values of V.