openjd-snapshots 0.1.2

[Experimental] Job attachments snapshot library for content-addressed file tree operations. The v2023 on-disk manifest format is stable and used by AWS Deadline Cloud; the v2025 format is an experimental draft.
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

// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// Copyright by contributors to this project.
// SPDX-License-Identifier: (Apache-2.0 OR MIT)

use thiserror::Error;

/// Errors that can occur during snapshot operations.
#[derive(Debug, Error)]
#[non_exhaustive]
pub enum SnapshotError {
    /// An I/O error occurred during file or directory operations.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    /// Manifest content failed validation (bad paths, missing hashes, etc.).
    #[error("Manifest validation error: {0}")]
    Validation(String),

    /// A required file or directory was not found.
    #[error("File not found: {0}")]
    FileNotFound(String),

    /// The operation was cancelled via the cancellation flag.
    #[error("Operation cancelled")]
    Cancelled,

    /// A cache (hash cache or S3 check cache) operation failed.
    #[error("Cache error: {0}")]
    Cache(String),

    /// An S3 or STS API call failed.
    #[error("S3 error: {0}")]
    S3(String),

    /// A background task (tokio spawn/runtime) failed.
    #[error("Task error: {0}")]
    Task(String),
}

pub type Result<T> = std::result::Result<T, SnapshotError>;