Expand description
Local package-manager foundation for the Soroban DevKit (sdkt), .
This module lays the groundwork for a future package registry without any network or remote-registry functionality. It supports:
- a package manifest (
[package]withname/version/description), - local path-only dependencies (
[dependencies]withpath = "..."), - offline validation of package metadata and the local dependency graph.
No git, HTTP, or registry resolution is performed. The dependency-graph
cycle/duplicate/self checks reuse the same topological-sort algorithm that
project::resolve_deploy_order uses, extracted into topo_sort so the
two resolvers share one implementation.
Structs§
- Bundle
Entry - One resolved dependency recorded in a
PackageBundledescriptor. - Package
Bundle - A self-contained, offline package bundle descriptor ().
- Publish
Readiness - Result of a
publish --dry-runreadiness check ().
Enums§
- Package
Error - Errors raised while validating a local package manifest/dependency graph.
Functions§
- best_
version_ match - Resolve the best available dependency version that satisfies a semver
constraint, given a list of
(tag, commit)pairs (already fetched from the remote viagit ls-remote --tags). Pure: no I/O, no allocation beyond the returnedOption. - pack
- Bundle a project into a portable offline artifact ().
- parse_
manifest - Parse a manifest TOML string into
DevKitConfig. - publish_
plan - Evaluate publish readiness for a project (
publish --dry-run). - topo_
sort - Generic topological sort (Kahn’s algorithm) over a string-keyed graph.
- unpack
- Reconstruct a project from a bundle artifact ( round-trip).
- validate_
dependencies - Validate the local
[dependencies]graph. - validate_
git_ url - Validate a Git remote URL’s scheme and basic shape (no network access).
- validate_
manifest - Validate an entire local package manifest: metadata + dependency graph.
- validate_
package - Validate the
[package]manifest metadata in isolation. - validate_
version_ format - Validate a single
[package]version string. - verify_
bundle_ equivalence - Verify a reconstructed (unpacked) bundle reproduces the original
sdkt.locksha256 and per-git-dependency integrity exactly ( round-trip).