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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
//! Error type.

use proc_macro2::Span;

/// Easy API to create all [`syn::Error`] messages in this crate.
pub struct Error;

impl Error {
	/// `derive_where` was already applied on this item before.
	pub fn visited(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`#[derive_where(..)` was already applied to this item before, this occurs when using \
			 a qualified path for any `#[derive_where(..)`s except the first",
		)
	}

	/// Unnecessary `crate` option because it is equal to the default.
	pub fn path_unnecessary(span: Span, default: &str) -> syn::Error {
		syn::Error::new(
			span,
			format!(
				"unnecessary path qualification, `{}` is used by default",
				default
			),
		)
	}

	/// The `crate` option was defined together with traits.
	pub fn crate_(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"the `crate` option has to be defined in it's own `#[derive_where(..)` attribute",
		)
	}

	/// No `derive_where` with [`Trait`](crate::Trait) found.
	pub fn none(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"no traits found to implement, use `#[derive_where(..)` to specify some",
		)
	}

	/// Unsupported empty `derive_where` on item.
	pub fn empty(span: Span) -> syn::Error {
		syn::Error::new(span, "empty `derive_where` found")
	}

	/// Item has no use-case because it's covered by standard `#[derive(..)]`.
	pub fn use_case(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"this can be handled by standard `#[derive(..)]`, use a `skip` or `incomparable` \
			 attribute, implement `Default` on an enum, or different generic type parameters",
		)
	}

	/// Unsupported empty item.
	pub fn item_empty(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"derive-where doesn't support empty items, as this can already be handled by standard \
			 `#[derive(..)]`",
		)
	}

	/// Unsupported trait for union.
	pub fn union(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"traits other then `Clone` and `Copy` aren't supported by unions",
		)
	}

	/// Unsupported option in attribute.
	#[cfg(feature = "zeroize")]
	pub fn option_trait(span: Span, attribute: &str) -> syn::Error {
		syn::Error::new(span, format!("`{}` doesn't support this option", attribute))
	}

	/// Unsupported option in attribute.
	pub fn option(span: Span) -> syn::Error {
		syn::Error::new(span, "unknown option")
	}

	/// Unsupported options in attribute.
	pub fn options(span: Span, trait_: &str) -> syn::Error {
		syn::Error::new(span, format!("`{}` doesn't support any options", trait_))
	}

	/// Invalid syntax for an option in attribute.
	pub fn option_syntax(span: Span) -> syn::Error {
		syn::Error::new(span, "unexpected option syntax")
	}

	/// Unsupported empty attribute option.
	pub fn option_empty(span: Span) -> syn::Error {
		syn::Error::new(span, "empty attribute option found")
	}

	/// Missing sub-option for an option.
	#[cfg(feature = "zeroize")]
	pub fn option_required(span: Span, option: &str) -> syn::Error {
		syn::Error::new(span, format!("`{}` requires an option", option))
	}

	/// Duplicate option in attribute.
	pub fn option_duplicate(span: Span, option: &str) -> syn::Error {
		syn::Error::new(span, format!("duplicate `{}` option", option))
	}

	/// Unsupported `skip_inner` on an enum.
	pub fn option_enum_skip_inner(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"enums don't support `skip_inner`, use it on a variant instead",
		)
	}

	/// Unexpected `skip` on a field when `skip_inner` is already used on the
	/// item or variant with this [`Trait`](crate::Trait).
	pub fn option_skip_inner(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"unexpected `skip` on a field when parent already uses `skip_inner` with this trait",
		)
	}

	/// Unsupported `skip_inner` on empty variant.
	pub fn option_skip_empty(span: Span) -> syn::Error {
		syn::Error::new(span, "no fields to skip")
	}

	/// Unexpected constrained field skipping when configured to skip all traits
	/// anyway.
	pub fn option_skip_all(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"unexpected constraint on `skip` when unconstrained `skip` already used",
		)
	}

	/// Duplicate trait constraint on `skip`.
	pub fn option_skip_duplicate(span: Span, trait_: &str) -> syn::Error {
		syn::Error::new(span, format!("duplicate `{}` constraint on `skip`", trait_))
	}

	/// No trait that can be skipped is being implemented.
	pub fn option_skip_no_trait(span: Span) -> syn::Error {
		syn::Error::new(span, "no trait that can be skipped is being implemented")
	}

	/// Trait to be skipped isn't being implemented
	pub fn option_skip_trait(span: Span) -> syn::Error {
		syn::Error::new(span, "trait to be skipped isn't being implemented")
	}

	/// Unsupported [`SkipGroup`](crate::SkipGroup).
	pub fn skip_group(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			format!(
				"unsupported skip group, expected one of {}",
				Self::skip_group_list()
			),
		)
	}

	/// Invalid value for the `derive_where` or `Zeroize` `crate` option.
	pub fn path(span: Span, parse_error: syn::Error) -> syn::Error {
		syn::Error::new(span, format!("expected path, {}", parse_error))
	}

	/// Unsupported [`Trait`](crate::Trait).
	pub fn trait_(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			format!("unsupported trait, expected one of {}", Self::trait_list()),
		)
	}

	/// Invalid syntax for a [`Trait`](crate::Trait).
	pub fn trait_syntax(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			format!(
				"unsupported trait syntax, expected one of {}",
				Self::trait_list()
			),
		)
	}

	/// Invalid delimiter in `derive_where` attribute for
	/// [`Trait`](crate::Trait)s.
	pub fn derive_where_delimiter(span: Span) -> syn::Error {
		syn::Error::new(span, "expected `;` or `,")
	}

	/// Unsupported predicate type in `derive_where` attribute for where clause.
	pub fn generic(span: Span) -> syn::Error {
		syn::Error::new(span, "only type predicates are supported")
	}

	/// Invalid syntax in `derive_where` attribute for generics.
	pub fn generic_syntax(span: Span, parse_error: syn::Error) -> syn::Error {
		syn::Error::new(span, format!("expected type to bind to, {}", parse_error))
	}

	/// Duplicate trait with the same bound.
	pub fn trait_duplicate(span: Span) -> syn::Error {
		syn::Error::new(span, "duplicate trait with the same bound")
	}

	/// Unsupported default option if [`Default`] isn't implemented.
	pub fn default(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`default` is only supported if `Default` is being implemented",
		)
	}

	/// Missing `default` option on a variant when [`Default`] is implemented
	/// for an enum.
	pub fn default_missing(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"required `default` option on a variant if `Default` is being implemented",
		)
	}

	/// Duplicate `default` option on a variant.
	pub fn default_duplicate(span: Span) -> syn::Error {
		syn::Error::new(span, "multiple `default` options in enum")
	}

	/// Unsupported `incomparable` option if [`PartialEq`] or [`PartialOrd`]
	/// isn't implemented.
	pub fn incomparable(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`incomparable` is only supported if `PartialEq` or `PartialOrd` is being implemented",
		)
	}

	/// Unsupported `incomparable` option if [`Eq`] or [`Ord`] is implemented.
	pub fn non_partial_incomparable(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`incomparable` is not supported if `Eq` or `Ord` is being implemented",
		)
	}

	/// Unsupported `incomparable` option on both enum and variant.
	pub fn incomparable_on_item_and_variant(item: Span, variant: Span) -> syn::Error {
		syn::Error::new(
			// This will only produce joint spans on nightly.
			item.join(variant).unwrap_or(item),
			"`incomparable` cannot be specified on both item and variant",
		)
	}

	/// List of available [`Trait`](crate::Trait)s.
	fn trait_list() -> String {
		[
			"Clone",
			"Copy",
			"Debug",
			"Default",
			"Eq",
			"Hash",
			"Ord",
			"PartialEq",
			"PartialOrd",
			#[cfg(feature = "zeroize")]
			"Zeroize",
			#[cfg(feature = "zeroize")]
			"ZeroizeOnDrop",
		]
		.join(", ")
	}

	/// List of available [`SkipGroup`](crate::SkipGroup)s.
	fn skip_group_list() -> String {
		[
			"Debug",
			"EqHashOrd",
			"Hash",
			#[cfg(feature = "zeroize")]
			"Zeroize",
		]
		.join(", ")
	}

	/// Unsupported `Zeroize` option if [`Zeroize`](https://docs.rs/zeroize/latest/zeroize/trait.Zeroize.html) isn't implemented.
	#[cfg(feature = "zeroize")]
	pub fn zeroize(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`Zeroize` option is only supported if `Zeroize` is being implemented",
		)
	}

	/// Deprecated use of `Zeroize(drop)`.
	#[cfg(feature = "zeroize")]
	pub fn deprecated_zeroize_drop(span: Span) -> syn::Error {
		syn::Error::new(
			span,
			"`Zeroize(drop)` is deprecated, use `ZeroizeOnDrop` instead",
		)
	}
}