unobtanium 3.0.0

Opinioated Web search engine library with crawler and viewer companion.
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


//! Crawler SchedulingReason, Datastructure and Constants.

use serde::{Serialize,Deserialize};

use std::str::FromStr;

/// Enumerates reasons why something ended up in the scheduling log.
#[derive(PartialEq,Eq,Clone,Serialize,Deserialize)]
pub struct SchedulingReason(u8);

impl SchedulingReason {
	/// Scheduling happened manually
	pub const MANUAL: SchedulingReason = SchedulingReason(0);

	/// Scheduling happend through an automatic exploration algorithm
	pub const EXPLORE: SchedulingReason = SchedulingReason(1);

	/// Scheduled because the resource was due for a recrawl
	pub const RECRAWL: SchedulingReason = SchedulingReason(2);

	/// Scheduled because an update was announced through a feed
	pub const FEED: SchedulingReason = SchedulingReason(3);

	/// Scheduled because the previous attempt at fetching this
	/// failed because of reasons outside the control of both
	/// the crawlers admin and the crawled website.
	pub const FLUKE_RETRY: SchedulingReason = SchedulingReason(4);
}

impl ToString for SchedulingReason {
	fn to_string(&self) -> String {
		match *self {
			Self::MANUAL => "manual",
			Self::EXPLORE => "explore",
			Self::RECRAWL => "recrawl",
			Self::FEED => "feed",
			Self::FLUKE_RETRY => "fluke_retry",
			_ => { return self.0.to_string(); }
		}.to_string()
	}
}

impl FromStr for SchedulingReason {
	type Err = &'static str;
	
	fn from_str(s: &str) -> Result<Self, Self::Err> {
		match s {
			"manual" => Ok(Self::MANUAL),
			"explore" => Ok(Self::EXPLORE),
			"recrawl" => Ok(Self::RECRAWL),
			"feed" => Ok(Self::FEED),
			"fluke_retry" => Ok(Self::FLUKE_RETRY),
			_ => {
				if let Ok(code) = u8::from_str(s) {
					Ok(Self(code))
				} else {
					Err("Not a recognized scheduling reason. Make sure it is in lower_snake_case or number in the u8 range.")
				}
			},
		}
	}
}

impl From<SchedulingReason> for u8 {
	fn from(reason: SchedulingReason) -> u8 {
		reason.0
	}
}

impl From<u8> for SchedulingReason {
	fn from(n: u8) -> Self {
		Self(n)
	}
}

impl SchedulingReason {
	pub fn from_number(n: u8) -> Self {
		n.into()
	}

	pub fn to_number(self) -> u8 {
		self.into()
	}
}