i_edit_json 0.1.0

A lightweight, high-performance tool for editing JSON based on field paths
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
57
58
59
60
61

use thiserror::Error;

/// Error types for JSON extraction and manipulation operations.
#[derive(Error, Debug)]
pub enum JsonExtractError {
    /// The specified file was not found.
    #[error("File not found: {0}")]
    FileNotFound(String),

    /// The JSON file contains invalid syntax.
    #[error("Invalid JSON syntax in {file}: {error}")]
    InvalidJson {
        /// Path to the invalid JSON file.
        file: String,
        /// Description of the syntax error.
        error: String,
    },

    /// The specified field path does not exist in the JSON file.
    #[error("Field not found: {0}")]
    FieldNotFound(String),

    /// An array index is out of bounds.
    #[error("Array index out of bounds: {path}[{index}], array length: {length}")]
    ArrayIndexOutOfBounds {
        /// Path to the array in the JSON file.
        path: String,
        /// The index that was accessed.
        index: usize,
        /// The actual length of the array.
        length: usize,
    },

    /// The specified value is not an array.
    #[error("Not an array: {0}")]
    NotAnArray(String),

    /// The array index is invalid (e.g., non-numeric).
    #[error("Invalid array index: {0}")]
    InvalidArrayIndex(String),

    /// An I/O error occurred while reading/writing the file.
    #[error("IO error: {0}")]
    IoError(#[from] std::io::Error),

    /// An error occurred during JSON serialization/deserialization.
    #[error("JSON serialization error: {0}")]
    JsonError(#[from] serde_json::Error),

    /// The specified value is not a JSON object.
    #[error("Not an object: {0}")]
    NotAnObject(String),

    /// The field path is invalid (e.g., empty segments, invalid syntax).
    #[error("Invalid field path: {0}")]
    InvalidFieldPath(String),

    /// The value type is invalid for the requested operation.
    #[error("Invalid value type: {0}")]
    InvalidValueType(String),
}