![JAR search and dependency download from the Maven repository](/logo.png)
org.hamcrest.core.Is Maven / Gradle / Ivy
package org.hamcrest.core;
import static org.hamcrest.core.IsEqual.equalTo;
import static org.hamcrest.core.IsInstanceOf.instanceOf;
import org.hamcrest.BaseMatcher;
import org.hamcrest.Description;
import org.hamcrest.Factory;
import org.hamcrest.Matcher;
/**
* Decorates another Matcher, retaining the behavior but allowing tests
* to be slightly more expressive.
*
* For example: assertThat(cheese, equalTo(smelly))
* vs. assertThat(cheese, is(equalTo(smelly)))
*/
public class Is extends BaseMatcher {
private final Matcher matcher;
public Is(Matcher matcher) {
this.matcher = matcher;
}
public boolean matches(Object arg) {
return matcher.matches(arg);
}
public void describeTo(Description description) {
description.appendText("is ").appendDescriptionOf(matcher);
}
@Override
public void describeMismatch(Object item, Description mismatchDescription) {
// TODO(ngd): unit tests....
matcher.describeMismatch(item, mismatchDescription);
}
/**
* Decorates another Matcher, retaining the behavior but allowing tests
* to be slightly more expressive.
*
* For example: assertThat(cheese, equalTo(smelly))
* vs. assertThat(cheese, is(equalTo(smelly)))
*/
@Factory
public static Matcher is(Matcher matcher) {
return new Is(matcher);
}
/**
* This is a shortcut to the frequently used is(equalTo(x)).
*
* For example: assertThat(cheese, is(equalTo(smelly)))
* vs. assertThat(cheese, is(smelly))
*/
@Factory
public static Matcher super T> is(T value) {
return is(equalTo(value));
}
/**
* This is a shortcut to the frequently used is(instanceOf(SomeClass.class)).
*
* For example: assertThat(cheese, is(instanceOf(Cheddar.class)))
* vs. assertThat(cheese, is(Cheddar.class))
*/
@Factory
public static Matcher super T> is(Class type) {
return is(instanceOf(type));
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy