Module workspace 

lex.toml manifest parsing and package resolution.

A lex.toml file marks a project root and declares its package dependencies. Import paths of the form "pkg-name/module" are resolved against this file.

File format

[package]
name = "lex-web"
version = "0.1.0"

[dependencies]
lex-schema = { path = "../lex-schema" }
# pin to a tag:
lex-schema = { git = "https://github.com/alpibrusl/lex-schema", tag = "v1.2.0" }
# pin to a commit:
lex-schema = { git = "https://github.com/alpibrusl/lex-schema", rev = "abc1234" }
# track a branch:
lex-schema = { git = "https://github.com/alpibrusl/lex-schema", branch = "stable" }
# or from a registry:
lex-schema = { registry = "https://lexhub.alpibru.com", version = "0.9.2" }

At most one of tag, rev, branch may be set; omitting all three clones the default branch at HEAD (not reproducible — pin for releases).

Module resolution

import "lex-schema/validate" as v splits into pkg = "lex-schema", module = "validate". The loader:

1. Walks up from the importing file to find the nearest lex.toml.
2. Looks up lex-schema in [dependencies].
3. For path =: resolves {dep_path}/src/validate.lex; falls back to {dep_path}/validate.lex if src/ doesn’t exist.
4. For git =: clones the repo into ~/.lex/packages/lex-schema-<ref>/ (once; subsequent loads hit the cache), then resolves the same way.

Structs

Manifest

PackageMeta

StoreSection

[store] table of lex.toml.

Enums

Dependency

PackageError

Functions

dep_source_prefers_git

Whether dependency resolution should prefer a dual dep’s git fallback over its vcs/registry primary. Set by the CLI’s --source git flag via the LEX_DEP_SOURCE env var so the pure source resolver stays flag-free. Default (unset, or any value other than git) is vcs-primary.

find_manifest

Walk up from start (a file or directory) looking for lex.toml. Returns (toml_path, toml_dir) for the nearest ancestor that has one.

packages_cache_root

The flat package cache root used by the resolver — $LEX_PACKAGES_DIR if set, otherwise ~/.lex/packages/. Returns None only when neither is available. Exposed so tooling can recognise dependencies whose path resolves into this cache (and are therefore aliases of an already-installed package rather than independent sources).

parse_version

Parse a MAJOR.MINOR.PATCH version into comparable parts.

resolve_package_import

Resolve pkg_name/module_path to a .lex file on disk.

satisfies_floor

Does running satisfy a declared floor?

Type Aliases

GitCoord

A git dependency coordinate: (url, branch, tag, rev). branch/tag/rev are mutually exclusive (at most one set); all None means the default branch.