onoma 0.0.14

A fast, language-agnostic semantic symbol indexer and typo-resistant fuzzy finder, enabling real-time search across virtually unlimited code symbols without the need for language servers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

use crate::parser;

use std::{future::Future, path::Path};

/// A parser for reading source code and constructing symbol indexes ([`crate::models::parsed::Index`]).
pub trait Parser: Default + Send + Sync + Clone {
    #[allow(missing_docs)]
    type ParseContext;

    #[allow(missing_docs)]
    type ParseOutput;

    /// Create an index from a source file.
    ///
    /// The way in which parsing occurs, and the context required to perform parsing efficiently
    /// will depend on the underlying parser which is used.
    fn parse(
        &self,
        file: &Path,
        ctx: &Self::ParseContext,
    ) -> impl Future<Output = Result<Self::ParseOutput>> + Send;
}

#[allow(missing_docs)]
#[doc(hidden)]
pub type Result<T> = std::result::Result<T, parser::Error>;