Struct Resolver 

pub struct Resolver { /* private fields */ }

The NAP resolver — resolves URIs to manifests or subtrees.

Implementations

impl Resolver

pub fn new(base_path: &Path) -> Self

Create a resolver that looks for repository repos under base_path.

Uses LoreBackend::from_env() by default when a version-control backend is configured for base_path (i.e. a valid provider.toml exists). Otherwise repositories are opened in unversioned mode. For testing, use Resolver::with_vcs_factory() with a mock backend.

Uses ResolveConfig::default() — meaning default_branch is None. In versioned mode any resolve that omits both branch and commit will fail with NapError::NoDefaultBranch; in unversioned mode such a resolve reads the current filesystem state.

Example layout

base_path/
├── toystory/    ← repository repo
├── toystory/    ← repository repo
└── marvel/      ← repository repo

pub fn with_vcs_factory( base_path: &Path, factory: fn() -> Box<dyn VcsBackend>, config: ResolveConfig, ) -> Self

Create a resolver with a custom VCS backend factory and config.

Repositories are always opened in versioned mode.

pub fn resolve( &self, uri_str: &str, options: &ResolveOptions, ) -> Result<ResolveResult, NapError>

Resolve a NAP URI string with options.

Examples

// Full manifest
resolver.resolve("nap://toystory/character/woody", &Default::default())

// Without scheme (auto-normalized)
resolver.resolve("toystory/character/woody", &Default::default())

// With branch
resolver.resolve("nap://toystory/character/woody", &ResolveOptions {
    branch: Some("canon".to_string()),
    ..Default::default()
})

// With fragment query (via URI)
resolver.resolve("nap://toystory/character/woody#references.appears_in", &Default::default())

pub fn resolve_uri( &self, uri: &NapUri, options: &ResolveOptions, ) -> Result<ResolveResult, NapError>

Resolve a parsed NAP URI with options.

pub fn query(&self, uri_str: &str, path: &str) -> Result<Value, NapError>

Convenience: query a specific path on a URI.

pub fn list_repositories(&self) -> Result<Vec<String>, NapError>

List all repositories available.