aleym_core 0.1.0-alpha.1

Extensible news aggregation and knowledge-base engine (Core Library Component of Aleym)
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

#[derive(Debug)]
#[repr(i8)]
pub(crate) enum InformantErrorKind {
	#[cfg(feature = "informant_feedrs")]
	Internal = 0,
	#[cfg(feature = "informant_feedrs")]
	Network = 1,
	#[cfg(feature = "informant_feedrs")]
	Parsing = 2,
	Parameters = 3,
}

impl From<InformantErrorKind> for i8 {
	fn from(value: InformantErrorKind) -> Self {
		value as i8
	}
}

#[derive(thiserror::Error, Debug)]
#[non_exhaustive]
pub enum InformantError {
	#[error("Informat with identifier `{0}` is not available")]
	UnsupportedInformatIdentifier(i8),
	#[error("Informant parameters doesn't match the required structure: {0}")]
	InvalidInformantParameters(#[from] serde_json::Error),

	#[cfg(feature = "informant_feedrs")]
	#[error("URI parsing error occurred: {0}")]
	InvalidUri(#[from] crate::net::protocols::http::InvalidUri),
	#[cfg(feature = "informant_feedrs")]
	#[error("URI contains no host")]
	NoTargetUriAuthority,
	#[cfg(feature = "informant_feedrs")]
	#[error("Network error occurred: {0}")]
	NetworkError(#[from] crate::net::NetworkError),
	#[cfg(feature = "informant_feedrs")]
	#[error("Tokio one-shot channel receive error occurred: {0}")]
	TokioOneShotError(#[from] tokio::sync::oneshot::error::RecvError),
	#[cfg(feature = "informant_feedrs")]
	#[error("`feed_rs` parsing error occurred: {0}")]
	FeedRsParsingError(#[from] feed_rs::parser::ParseFeedError),
}

impl InformantError {
	/// Get the error kind for database storage.
	///
	/// Used to categorize errors for the machine-learned ranking engine.
	#[cfg_attr(not(feature = "_informant"), expect(unused))]
	pub(crate) const fn kind(&self) -> InformantErrorKind {
		// NOTE: Breaking changes to the following mappings should be accompanied with a database migration.
		match self {
			#[cfg(feature = "informant_feedrs")]
			InformantError::TokioOneShotError(_) => InformantErrorKind::Internal,

			#[cfg(feature = "informant_feedrs")]
			InformantError::NetworkError(_) => InformantErrorKind::Network,

			#[cfg(feature = "informant_feedrs")]
			InformantError::FeedRsParsingError(_) => InformantErrorKind::Parsing,

			InformantError::UnsupportedInformatIdentifier(_) | InformantError::InvalidInformantParameters(_) => {
				InformantErrorKind::Parameters
			}
			#[cfg(feature = "informant_feedrs")]
			InformantError::InvalidUri(_) | InformantError::NoTargetUriAuthority => InformantErrorKind::Parameters,
		}
	}
}