test-that 0.1.0

// Copyright 2022 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.

use crate::description::Description;
use crate::matcher::{Describable, Matcher, MatcherResult};
use std::fmt::Debug;
use std::ops::Deref;

/// Matches a (smart) pointer pointing to a value matched by the [`Matcher`]
/// `expected`.
///
/// This allows easily matching smart pointers such as `Box`, `Rc`, and `Arc`
/// as well as slices.
///
/// For example:
///
/// ```
/// # use test_that::prelude::*;
/// # use std::rc::Rc;
/// # fn should_pass() -> TestResult<()> {
/// verify_that!(Box::new(123), points_to(eq(123)))?;
/// verify_that!(Rc::new(123), points_to(eq(123)))?;
/// verify_that!(&[123], points_to(contains(eq(123))))?;
/// #     Ok(())
/// # }
/// # should_pass().unwrap();
/// ```
pub fn points_to<MatcherT>(expected: MatcherT) -> __internal::PointsToMatcher<MatcherT> {
    __internal::PointsToMatcher { expected }
}

pub mod __internal {
    use super::*;

    #[doc(hidden)]
    pub struct PointsToMatcher<MatcherT> {
        pub(super) expected: MatcherT,
    }

    impl<ExpectedT, MatcherT, ActualT> Matcher<ActualT> for PointsToMatcher<MatcherT>
    where
        ExpectedT: Debug + ?Sized,
        MatcherT: Matcher<ExpectedT>,
        ActualT: Deref<Target = ExpectedT> + Debug + ?Sized,
    {
        fn matches(&self, actual: &ActualT) -> MatcherResult {
            self.expected.matches(actual.deref())
        }

        fn explain_match(&self, actual: &ActualT) -> Description {
            self.expected.explain_match(actual.deref())
        }
    }

    impl<MatcherT: Describable> Describable for PointsToMatcher<MatcherT> {
        fn describe(&self, matcher_result: MatcherResult) -> Description {
            self.expected.describe(matcher_result)
        }
    }
}

#[cfg(test)]
mod tests {
    use super::points_to;
    use crate::prelude::*;
    use indoc::indoc;
    use std::rc::Rc;

    #[test]
    fn points_to_matches_box_of_int_with_int() -> TestResult<()> {
        verify_that!(Box::new(123), points_to(eq(123)))
    }

    #[test]
    fn points_to_matches_rc_of_int_with_int() -> TestResult<()> {
        verify_that!(Rc::new(123), points_to(eq(123)))
    }

    #[test]
    fn points_to_matches_box_of_owned_string_with_string_reference() -> TestResult<()> {
        verify_that!(Rc::new("A string".to_string()), points_to(eq("A string")))
    }

    #[test]
    fn match_explanation_references_actual_value() -> TestResult<()> {
        let result = verify_that!(&vec![1], points_to(container_eq([])));

        verify_that!(
            result,
            err(displays_as(contains_substring(indoc!(
                "
                    Actual: [1],
                      which contains the unexpected element 1
                "
            ))))
        )
    }
}