argan-core 0.1.1

Core types and traits for the Argan Web Framework.
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

//! Response types and conversion traits into them.

// ----------

use http::{HeaderName, HeaderValue};

use crate::body::Body;

// ----------

pub use http::response::Builder;

// --------------------------------------------------

mod error;
pub use error::{ErrorResponse, ResponseError};

mod impls;

// --------------------------------------------------------------------------------
// --------------------------------------------------------------------------------

pub type Response<B = Body> = http::response::Response<B>;
pub type ResponseHeadParts = http::response::Parts;

pub type BoxedErrorResponse = Box<dyn ErrorResponse + Send + Sync>;
pub type ResponseResult = Result<Response, BoxedErrorResponse>;

// --------------------------------------------------------------------------------

// --------------------------------------------------
// IntoResponseHeadParts trait

/// Implemented by types that form or can be converted into a type that forms the
/// [`ResponseHeadParts`].
pub trait IntoResponseHeadParts {
	fn into_response_head(
		self,
		head: ResponseHeadParts,
	) -> Result<ResponseHeadParts, BoxedErrorResponse>;
}

// --------------------------------------------------
// IntoResponse trait

/// Implemented by types that can be converted into the [`Response`] type.
pub trait IntoResponse {
	fn into_response(self) -> Response;
}

impl IntoResponse for Response {
	fn into_response(self) -> Response {
		self
	}
}

// --------------------------------------------------
// IntoResponseResult trait

/// Implemented by types that can be converted into the [`ResponseResult`] type.
pub trait IntoResponseResult {
	fn into_response_result(self) -> Result<Response, BoxedErrorResponse>;
}

impl<R, E> IntoResponseResult for Result<R, E>
where
	R: IntoResponseResult,
	E: Into<BoxedErrorResponse>,
{
	fn into_response_result(self) -> Result<Response, BoxedErrorResponse> {
		self
			.map_err(Into::into)
			.and_then(IntoResponseResult::into_response_result)
	}
}

impl<R> IntoResponseResult for R
where
	R: IntoResponse,
{
	fn into_response_result(self) -> Result<Response, BoxedErrorResponse> {
		Ok(self.into_response())
	}
}

// --------------------------------------------------------------------------------