prollytree 0.3.2

A prolly (probabilistic) tree for efficient storage, retrieval, and modification of ordered data.
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

/*
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

use crate::storage::StorageError;
use crate::validation::ValidationError;
use thiserror::Error;

/// Unified error type that bridges all error domains in the crate.
///
/// Use this at API boundaries where errors from different subsystems
/// (tree operations, storage backends, git versioning) may need to be
/// returned through a single `Result` type.
#[derive(Error, Debug)]
pub enum ProllyError {
    /// An error from core tree operations (encoding, schema, etc.).
    #[error(transparent)]
    Tree(#[from] ProllyTreeError),

    /// An error from a storage backend (I/O, serialization, etc.).
    #[error(transparent)]
    Storage(#[from] StorageError),

    /// An input validation error (empty key, oversized key/value).
    #[error(transparent)]
    Validation(#[from] ValidationError),

    /// An error from the git versioning layer.
    #[cfg(feature = "git")]
    #[error(transparent)]
    Git(#[from] crate::git::types::GitKvError),
}

/// Error type for core tree operations (encoding, schema, etc.).
#[derive(Error, Debug)]
pub enum ProllyTreeError {
    #[error("Arrow error: {0}")]
    Arrow(#[from] arrow::error::ArrowError),

    #[error("Parquet error: {0}")]
    Parquet(#[from] parquet::errors::ParquetError),

    #[error("Serde JSON error: {0}")]
    SerdeJson(#[from] serde_json::Error),

    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Unsupported Value Type")]
    UnsupportedValueType,

    #[error("Unsupported Key Type")]
    UnsupportedKeyType,

    #[error("Unsupported Chunking Strategy")]
    UnsupportedChunkingStrategy,

    #[error("Unknown Codec")]
    UnknownCodec,

    #[error("Serde Error")]
    Serde,

    #[error("Schema not found")]
    SchemaNotFound,

    #[error("Invalid JSON value")]
    InvalidJsonValue,

    #[error("Invalid digest length")]
    InvalidDigestLength,
}