code2graph 0.0.0-beta.2

Purpose-neutral code-graph extraction: source files → symbols, references, and cross-file edges. Tree-sitter based, no storage opinion.
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
27
28
29
30
31
32
33

// SPDX-License-Identifier: Apache-2.0

//! `CodegraphError` — errors surfaced by extraction and resolution.
//!
//! Deliberately small and storage-free. Consumers map these into their own
//! error domains at their boundary.

/// Errors that can arise while turning source into structural facts.
#[derive(Debug, thiserror::Error)]
pub enum CodegraphError {
    /// The language for an extension/path is not supported by code2graph.
    #[error("unsupported language for `{0}`")]
    UnsupportedLanguage(String),

    /// tree-sitter failed to construct a parser or parse the source.
    #[error("parse error in `{path}`")]
    Parse {
        /// Source path (relative) that failed to parse.
        path: String,
    },

    /// A tree-sitter query failed to compile (internal/library bug).
    #[error("invalid tree-sitter query for `{lang}`: {msg}")]
    Query {
        /// Language whose query failed.
        lang: String,
        /// Underlying message.
        msg: String,
    },
}

/// Convenience alias for code2graph fallible operations.
pub type Result<T> = std::result::Result<T, CodegraphError>;