fluidattacks-core-git 0.54.0

Fluid Attacks Core Git
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use std::io;
use std::process::ExitStatus;
use std::time::Duration;

#[derive(Debug, thiserror::Error)]
pub enum GitCallError {
    #[error("git {command} could not start: {source}")]
    NotStarted {
        command: &'static str,
        source: io::Error,
    },
    #[error("git {command} did not finish within {after:?}")]
    TimedOut {
        command: &'static str,
        after: Duration,
    },
    /// git ran and refused, as it does for a missing repository or revision.
    #[error("git {command} exited with {status}: {stderr}")]
    Refused {
        command: &'static str,
        status: ExitStatus,
        stderr: String,
    },
    /// No process can receive a NUL, so std turns the call down before it starts.
    #[error("git {command} got an argument with an embedded null byte")]
    NullByte { command: &'static str },
    #[error("git {command} printed something unreadable: {reason}")]
    Malformed {
        command: &'static str,
        reason: String,
    },
}

/// Why `download_and_extract_repo` failed, by the step that failed.
#[derive(Debug, thiserror::Error)]
pub enum DownloadError {
    /// The parent of the destination, or the archive inside the work
    /// directory, could not be created or written.
    #[error("writing the archive: {0}")]
    Write(#[source] io::Error),
    #[error(transparent)]
    Fetch(#[from] FetchError),
    #[error(transparent)]
    Extract(#[from] ExtractError),
    /// `git reset --hard` did not restore the working tree.
    #[error(transparent)]
    Reset(#[from] GitCallError),
    /// Removing symlinks or out-of-scope files failed; `errno` is the one of
    /// the file call that failed, when there was one.
    #[error("pruning the working tree: {message}")]
    Prune { message: String, errno: Option<i32> },
    /// The work directory beside the destination could not be created, or the
    /// repository could not take the place of the destination.
    #[error("placing the repository: {0}")]
    Place(#[source] io::Error),
}

/// How the request for the archive failed.
#[derive(Debug, thiserror::Error)]
pub enum FetchError {
    #[error("invalid url {url}: {reason}")]
    InvalidUrl { url: String, reason: String },
    #[error("not an http url: {0}")]
    NonHttpUrl(String),
    /// DNS, a refused connection or a TLS handshake that failed.
    #[error("could not connect: {0}")]
    Connect(#[source] reqwest::Error),
    #[error("connecting timed out: {0}")]
    ConnectTimeout(#[source] reqwest::Error),
    /// The total timeout ran out before the response headers arrived.
    #[error("no response in time: {0}")]
    Timeout(#[source] reqwest::Error),
    /// The server closed the connection before it answered.
    #[error("the server disconnected: {0}")]
    Disconnected(#[source] reqwest::Error),
    /// The socket failed while the request was sent; `errno` is the one of
    /// the socket call.
    #[error("the socket failed: {source}")]
    Socket {
        reset: bool,
        errno: Option<i32>,
        source: reqwest::Error,
    },
    #[error("malformed response: {0}")]
    Malformed(#[source] reqwest::Error),
    #[error("the server answered {0}")]
    Status(reqwest::StatusCode),
    /// The body ended before its length, or the connection broke mid-read.
    #[error("the body was cut: {0}")]
    BodyCut(#[source] reqwest::Error),
    /// The total timeout ran out while the body was read.
    #[error("the body did not arrive in time: {0}")]
    BodyTimeout(#[source] reqwest::Error),
    #[error("the request failed: {0}")]
    Other(#[source] reqwest::Error),
}

/// How turning the archive into a repository failed.
#[derive(Debug, thiserror::Error)]
pub enum ExtractError {
    /// The archive is not gzip, its tar or deflate data is broken, or its
    /// checksum does not match.
    #[error("corrupt archive: {0}")]
    Corrupt(#[source] io::Error),
    /// The gzip stream ends before its trailer.
    #[error("truncated archive: {0}")]
    Truncated(#[source] io::Error),
    /// The archive holds no top directory with a real `.git` directory.
    #[error("the archive holds no repository: {0}")]
    NoRepository(String),
    #[error("extracting the archive: {0}")]
    Io(#[source] io::Error),
}