fetcher 0.15.3

Data automation and pipelining 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

/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */

//! This module contains the [`HtmlError`] and [`ErrorLocation`] types

use std::fmt::Display;

use scraper::{Selector, error::SelectorErrorKind, selector::ToCss};

use super::DataSelector;
use crate::actions::transforms::error::RawContentsNotSetError;

/// An error that occured during parsing the HTML tree
#[expect(missing_docs, reason = "error message is self-documenting")]
#[derive(thiserror::Error, Debug)]
pub enum HtmlError {
	#[error(transparent)]
	RawContentsNotSet(#[from] RawContentsNotSetError),

	#[error("Unable to get the {}", .r#where)]
	Inner {
		r#where: ErrorLocation,
		#[source]
		error: HtmlErrorInner,
	},
}

#[expect(missing_docs, reason = "error message is self-documenting")]
#[derive(thiserror::Error, Debug)]
pub enum HtmlErrorInner {
	#[error("Selector {} didn't match anything", .0.to_css_string())]
	SelectorNotMatched(Selector),

	#[error("Data not found in element selected by {} in {:?}", .0.selector.to_css_string(), .0.locations)]
	DataNotFoundInElement(DataSelector),

	#[error("HTML element at {} ({:?}) is empty", .0.selector.to_css_string(), .0.locations)]
	ElementEmpty(DataSelector),
}

/// String is not a valid CSS selector
// Note: scrapper has SelectorErrorKind but it's not Send...
#[derive(thiserror::Error, Debug)]
#[error("{0}")]
pub struct SelectorError(String);

/// The error occured while parsing which field?
#[expect(missing_docs, reason = "self-explanatory")]
#[derive(Clone, Copy, Debug)]
pub enum ErrorLocation {
	Item,
	Title,
	/// `index` contains the index of the selector in the [`Html::text`](`super::Html::text`) array
	Text {
		index: usize,
	},
	Id,
	Link,
	Img,
}

impl Display for ErrorLocation {
	fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
		match *self {
			Self::Item => f.write_str("item"),
			Self::Title => f.write_str("title"),
			Self::Text { index } => write!(f, "text:{index}"),
			Self::Id => f.write_str("id"),
			Self::Link => f.write_str("link"),
			Self::Img => f.write_str("img"),
		}
	}
}

impl From<SelectorErrorKind<'_>> for SelectorError {
	fn from(value: SelectorErrorKind<'_>) -> Self {
		Self(value.to_string())
	}
}