meta-ast 0.7.0

Polyglot static-analysis engine: extract symbols and cross-language dependency graphs from 9 supported source languages, with optional MetaCall deployment manifest generation.
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Error definitions for shard serialization and deserialization.

use std::path::PathBuf;

/// Failures that can occur during shard reading, writing, or restoration.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum ShardError {
    #[error("shard IO failed: {0}")]
    Io(#[from] std::io::Error),

    #[error("failed to encode shard record: {0}")]
    Encode(serde_json::Error),

    #[error("invalid shard JSON on line {line}: {source}")]
    Decode {
        line: usize,
        #[source]
        source: serde_json::Error,
    },

    #[error("unsupported shard schema version {found} on line {line}; expected {expected}")]
    SchemaVersion {
        line: usize,
        found: u32,
        expected: u32,
    },

    #[error("graph node {node_index} has no stable file owner")]
    MissingNodeOwner { node_index: usize },

    #[error("shard edge endpoint '{name}' does not exist in the rebuilt graph")]
    MissingEndpoint { name: String },

    #[error("path is not valid UTF-8: {path:?}")]
    NonUtf8Path { path: PathBuf },

    #[error("invalid edge {edge_index} on shard line {line}: {message}")]
    InvalidEdge {
        line: usize,
        edge_index: usize,
        message: String,
    },

    #[error("index written by meta-ast {found}; this build is {expected}")]
    ToolVersionMismatch { found: String, expected: String },

    #[error("unsafe shard name: {name}")]
    UnsafeShardName { name: String },

    #[error("shard name '{name}' cannot be written on every platform: {reason}")]
    UnwritableShardName { name: String, reason: &'static str },

    #[error("index path escapes the project root: {path:?}")]
    PathOutsideRoot { path: PathBuf },
}