Module project

Expand description

Project root detection and shape.toml configuration

Discovers the project root by walking up from a starting directory looking for a shape.toml file, then parses its configuration.

Structs§

BuildExternalSection: [build.external] section
BuildSection: [build] section
DetailedDependency: Detailed dependency with path, git, or version fields.
ExtensionEntry: An extension entry in [[extensions]]
FsPermissions: [permissions.fs] — path-level filesystem constraints.
ModulesSection: [modules] section
NativeDependencyDetail: Detailed native dependency record.
NativeTarget: Normalized native target used for host-aware native dependency resolution.
NativeTargetValueDetail: Detailed target-qualified native dependency value.
NetPermissions: [permissions.net] — host-level network constraints.
PermissionsSection: [permissions] section — declares what capabilities the project needs.
ProjectRoot: A discovered project root with its parsed configuration
ProjectSection: [project] section
SandboxSection: [sandbox] section — isolation settings for deterministic/testing modes.
ShapeProject: Top-level shape.toml configuration

DependencySpec: A dependency specification: either a version string or a detailed table.
ExternalLockMode: External input lock mode for compile-time workflows.
NativeDependencyProvider: How a native dependency is provisioned.
NativeDependencySpec: Entry in [native-dependencies].
NativeTargetValue: Target-qualified native dependency value.
PermissionPreset: Permission shorthand: a string like “pure”, “readonly”, or “full”, or an inline table with fine-grained booleans.

find_project_root: Walk up from start_dir looking for a shape.toml file. Returns Some(ProjectRoot) if found, None otherwise.
normalize_package_identity: Normalize project metadata into a canonical package identity.
normalize_package_identity_with_fallback: Normalize project metadata into a canonical package identity with explicit fallbacks.
parse_native_dependencies_section: Parse the [native-dependencies] section table into typed specs.
parse_shape_project_toml: Parse a shape.toml document into a ShapeProject.