Method resolve

libs/@local/hashql/core/src/module/mod.rs:177–205

Resolves a path to an item in the registry. # Errors Returns a `ResolutionError` if: - The path cannot be resolved to any item - The path resolves to multiple items (ambiguous resolution) - Any part of the path fails to resolve correctly

(
        &self,
        path: impl IntoIterator<Item = Symbol<'heap>>,
        universe: Universe,
    )

    /// - The path resolves to multiple items (ambiguous resolution)
    /// - Any part of the path fails to resolve correctly
    pub fn resolve(
        &self,
        path: impl IntoIterator<Item = Symbol<'heap>>,
        universe: Universe,
    ) -> Result<Item<'heap>, ResolutionError<'heap>> {
        let resolver = Resolver {
            registry: self,
            options: ResolverOptions {
                mode: ResolverMode::Single(universe),
                suggestions: true,
            },
        };

        let mut iter = resolver.resolve_absolute(path)?;
        let item = iter.next().unwrap_or_else(|| {
            unreachable!("ResolveIter guarantees at least one item is returned")
        });

        if iter.next().is_some() {
            Err(ResolutionError::Ambiguous(item))
        } else {
            match item {
                Reference::Binding(_) => {
                    unreachable!("Absolute path cannot point to a local binding")
                }
                Reference::Item(item) => Ok(item),
            }
        }
    }

    /// Attempts to resolve a path to an item in the registry.
    ///