fastly 0.6.0-beta1

Fastly Compute@Edge API
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

//! Error-handling utilities.

pub use crate::request::SendError;
pub use anyhow::{anyhow, bail, ensure, Error};

#[derive(Debug, thiserror::Error)]
pub enum NewError {
    #[error("invalid HTTP header name")]
    InvalidHeaderName,
    #[error("invalid HTTP header value")]
    InvalidHeaderValue,
    #[error("invalid HTTP method")]
    InvalidMethod,
    #[error("error parsing URL: {0}")]
    UrlParseError(#[from] url::ParseError),
}

impl From<std::convert::Infallible> for NewError {
    fn from(_: std::convert::Infallible) -> Self {
        unreachable!()
    }
}

impl From<http::header::InvalidHeaderName> for NewError {
    fn from(_: http::header::InvalidHeaderName) -> Self {
        Self::InvalidHeaderName
    }
}

impl From<http::header::InvalidHeaderValue> for NewError {
    fn from(_: http::header::InvalidHeaderValue) -> Self {
        Self::InvalidHeaderValue
    }
}

impl From<http::method::InvalidMethod> for NewError {
    fn from(_: http::method::InvalidMethod) -> Self {
        Self::InvalidMethod
    }
}

/// Insufficient buffer size error.
///
/// This is thrown by methods like [`RequestHandle::get_header_names`][get_header_names] or
/// [`RequestHandle::get_header_values`][get_header_values] if a value was larger than the provided
/// maximum size.
///
/// This error is used to inform a user that they can try a multi-value hostcall again, using a
/// larger buffer.
///
/// [get_header_names]: ../request/struct.RequestHandle.html#method.get_header_names
/// [get_header_values]: ../request/struct.RequestHandle.html#method.get_header_values
#[derive(Copy, Clone, Debug, PartialEq, Eq, thiserror::Error)]
#[error("insufficient buffer size {buf_size}; value requires {needed_buf_size} bytes")]
pub struct BufferSizeError {
    /// The buffer size.
    ///
    /// This is to help make nicer error messages.
    pub buf_size: usize,
    pub needed_buf_size: usize,
}

impl BufferSizeError {
    /// Create a new [`BufferSizeError`](struct.BufferSizeError.html).
    pub(crate) fn new(buf_size: usize, needed_buf_size: usize) -> Self {
        Self {
            buf_size,
            needed_buf_size,
        }
    }
}