herolib-code 0.3.13

Code analysis and parsing utilities for Rust source files
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

//! Error types for the parser module.
//!
//! This module defines custom error types for handling parsing and file system errors.

use std::path::PathBuf;
use thiserror::Error;

/// Errors that can occur during code parsing.
#[derive(Debug, Error)]
pub enum ParseError {
    /// Failed to read a file.
    #[error("Failed to read file '{path}': {source}")]
    FileRead {
        /// The path of the file that couldn't be read.
        path: PathBuf,
        /// The underlying IO error.
        #[source]
        source: std::io::Error,
    },

    /// Failed to parse Rust source code.
    #[error("Failed to parse Rust source in '{path}': {message}")]
    SyntaxError {
        /// The path of the file with the syntax error.
        path: PathBuf,
        /// Error message from the parser.
        message: String,
    },

    /// The specified directory does not exist.
    #[error("Directory does not exist: {0}")]
    DirectoryNotFound(PathBuf),

    /// Failed to walk directory.
    #[error("Failed to walk directory '{path}': {source}")]
    WalkError {
        /// The path of the directory being walked.
        path: PathBuf,
        /// The underlying walkdir error.
        #[source]
        source: walkdir::Error,
    },

    /// Invalid path encoding.
    #[error("Invalid path encoding: {0}")]
    InvalidPath(PathBuf),
}

/// Result type alias for parser operations.
pub type ParseResult<T> = Result<T, ParseError>;