guff_css 0.11.3

A simple SASS/SCSS compiler and CSS parser/minifier.
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

/*!
# Guff: Errors
*/

use lightningcss::error::{
	MinifyErrorKind,
	ParserError,
	PrinterErrorKind,
};
use std::{
	error::Error,
	fmt,
};



#[derive(Debug, Clone)]
/// # Error type.
pub enum GuffError {
	#[cfg(feature = "bin")]
	/// # Browser.
	Browser(String),

	#[cfg(feature = "bin")]
	/// # Invalid CLI.
	Cli(String),

	/// # CSS Parse Error.
	Css(String),

	#[cfg(feature = "bin")]
	/// # No Source.
	NoSource,

	/// # Invalid Path Extension.
	PathExt,

	/// # Invalid Path UTF-8.
	PathUtf8,

	/// # SCSS Parse Error.
	Scss(String),

	/// # Source File Name.
	SourceFileName,

	/// # Invalid Source.
	SourceInvalid,

	#[cfg(feature = "bin")]
	/// # Write Error.
	Write,

	#[cfg(feature = "bin")]
	/// # Print Help (Not an Error).
	PrintHelp,

	#[cfg(feature = "bin")]
	/// # Print Version (Not an Error).
	PrintVersion,
}

impl Error for GuffError {}

impl fmt::Display for GuffError {
	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
		match self {
			Self::Css(s) | Self::Scss(s) => write!(f, "{} {s}", self.as_str()),

			#[cfg(feature = "bin")]
			Self::Browser(s) | Self::Cli(s) => write!(f, "{} {s}", self.as_str()),

			_ => f.write_str(self.as_str()),
		}
	}
}

impl From<Box<grass::Error>> for GuffError {
	#[inline]
	fn from(err: Box<grass::Error>) -> Self { Self::Scss(err.to_string()) }
}

/// # Helper: From Parcel.
macro_rules! from_parcel {
	($($ty:ty),+) => ($(
		impl From<lightningcss::error::Error<$ty>> for GuffError {
			#[inline]
			fn from(err: lightningcss::error::Error<$ty>) -> Self {
				Self::Css(err.kind.to_string())
			}
		}
	)+);
}

from_parcel!(MinifyErrorKind, ParserError<'_>, PrinterErrorKind);

impl GuffError {
	#[must_use]
	/// # As Str.
	pub const fn as_str(&self) -> &'static str {
		match self {
			#[cfg(feature = "bin")]
			Self::Browser(_) => "Invalid browser:",

			#[cfg(feature = "bin")]
			Self::Cli(_) => "Invalid/unknown option:",

			Self::Css(_) => "Unable to parse CSS:",

			#[cfg(feature = "bin")]
			Self::NoSource => "An SCSS/CSS source is required.",

			Self::PathExt => "Paths must contain a .css, .sass, or .scss extension.",
			Self::PathUtf8 => "Paths must be valid UTF-8.",
			Self::Scss(_) => "Unable to parse SCSS:",
			Self::SourceFileName => "File paths must be valid UTF-8.",
			Self::SourceInvalid => "Invalid/unreadable SCSS/CSS source.",

			#[cfg(feature = "bin")]
			Self::Write => "The output could not be saved to disk.",

			#[cfg(feature = "bin")]
			Self::PrintHelp | Self::PrintVersion => "",
		}
	}
}