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
// Copyright 2023 Google LLC
// Copyright 2026 Bradford Hovinen <bradford@hovinen.me>
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#![doc(hidden)]
use crate::{
description::Description,
matcher::{Describable, Matcher, MatcherResult},
};
use core::{fmt::Debug, marker::PhantomData};
/// Matches precisely values matched by `inner`.
///
/// The returned matcher produces a description prefixed by the string
/// `description`. This is useful in contexts where the test assertion failure
/// output must include the additional description.
pub fn is<'a, ActualT: Debug + 'a, InnerMatcherT: Matcher<ActualT> + 'a>(
description: &'a str,
inner: InnerMatcherT,
) -> impl Matcher<ActualT> + 'a {
IsMatcher { description, inner, phantom: Default::default() }
}
struct IsMatcher<'a, ActualT, InnerMatcherT> {
description: &'a str,
inner: InnerMatcherT,
phantom: PhantomData<ActualT>,
}
impl<'a, ActualT: Debug, InnerMatcherT: Matcher<ActualT>> Matcher<ActualT>
for IsMatcher<'a, ActualT, InnerMatcherT>
{
fn matches(&self, actual: &ActualT) -> MatcherResult {
self.inner.matches(actual)
}
fn explain_match(&self, actual: &ActualT) -> Description {
self.inner.explain_match(actual)
}
}
impl<'a, ActualT, InnerMatcherT: Describable> Describable
for IsMatcher<'a, ActualT, InnerMatcherT>
{
fn describe(&self, matcher_result: MatcherResult) -> Description {
match matcher_result {
MatcherResult::Match => format!(
"is {} which {}",
self.description,
self.inner.describe(MatcherResult::Match)
)
.into(),
MatcherResult::NoMatch => format!(
"is not {} which {}",
self.description,
self.inner.describe(MatcherResult::Match)
)
.into(),
}
}
}