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 universe repos under base_path.

Uses ResolveConfig::default() — meaning default_branch is None and any resolve that omits both branch and commit will fail with NapError::NoDefaultBranch.

Example layout

base_path/
├── starwars/    ← universe repo
├── toystory/    ← universe repo
└── marvel/      ← universe 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.

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://starwars/character/lukeskywalker", &Default::default())

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

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

// With fragment query (via URI)
resolver.resolve("nap://starwars/character/lukeskywalker#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_universes(&self) -> Result<Vec<String>, NapError>

List all universe repositories available.