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
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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153

//! ID types for interacting with the databases.

use rusqlite::{types::{FromSql, FromSqlResult, ToSqlOutput, Value, ValueRef}, ToSql};

use std::{fmt::Display, hash::Hash};

/// Id of an agent in the crawler database.
///
/// Outside of database code this should be treated like an opaque datatype.
///
/// TODO: Remove Default when agents have UUIDs
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Default)]
pub struct AgentId(i64);

/// Id of a crawl log entry in the crawler database.
///
/// Outside of database code this should be treated like an opaque datatype.
///
/// TODO: Remove Default when agents have UUIDs
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq, Default)]
pub struct CrawlLogEntryId(i64);

/// Id of a crawl summary in the summary database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct CrawlSummaryId(i64);

/// Id of a entity-generation in the summary database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct EntityGenerationId(i64);

/// Id of a file-info in the crawler database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct FileInfoId(i64);

/// Id of a mime-type in the base database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct MimetypeId(i64);

/// Id of an origin in the base database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct OriginId(i64);

/// Id of a redirect in the crawler database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct RedirectId(i64);

/// Id of a request in the crawler database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct RequestId(i64);

/// Id of a token in the summary database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct TokenId(i64);


/// Id of an url in the base database.
///
/// Outside of database code this should be treated like an opaque datatype.
#[derive(Debug, Clone, Copy, Hash, PartialEq, Eq)]
pub struct UrlId(i64);



/// Makes the numbers inside the otherwise opaque ids accessible to the outside world.
pub trait NumericDatabseId: Eq + Clone + Copy + Hash {

	/// Create a new id from a number.
	///
	/// There should be no need to call this outside of database code.
    fn new(id: i64) -> Self;

    
	/// Get the numeric id.
	///
	/// There should be no need to use this outside of database code.
	fn number(&self) -> i64;
}

impl NumericDatabseId for i64 {
	fn new(id: i64) -> Self {
	    id
	}

	fn number(&self) -> i64 {
	    *self
	}
}

macro_rules! impl_id {
	($t:ty) => {
		impl NumericDatabseId for $t {

			#[inline]
			fn new(id: i64) -> Self {
				Self(id)
			}

			#[inline]
			fn number(&self) -> i64 {
				self.0
			}
		}


		impl FromSql for $t {
			fn column_result(value: ValueRef<'_>) -> FromSqlResult<Self> {
			    Ok(Self(value.as_i64()?))
			}
		}

		impl ToSql for $t {
			fn to_sql(&self) -> rusqlite::Result<ToSqlOutput<'_>> {
				Ok(ToSqlOutput::Owned(Value::Integer(self.0)))
			}
		}

		impl Display for $t {
			fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
				f.write_fmt(format_args!("{}", self.0))
			}
		}

	}
}


impl_id!(AgentId);
impl_id!(CrawlLogEntryId);
impl_id!(CrawlSummaryId);
impl_id!(EntityGenerationId);
impl_id!(FileInfoId);
impl_id!(MimetypeId);
impl_id!(OriginId);
impl_id!(RedirectId);
impl_id!(RequestId);
impl_id!(TokenId);
impl_id!(UrlId);