LogMessageMatcher.java

/**
 * Copyright (C) 2022 Christopher J. Stehno
 *
 * 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.
 */
package io.github.cjstehno.testthings.slf4j.match;

import ch.qos.logback.classic.spi.ILoggingEvent;
import lombok.AccessLevel;
import lombok.RequiredArgsConstructor;
import org.hamcrest.BaseMatcher;
import org.hamcrest.Description;
import org.hamcrest.Matcher;

/**
 * A Hamcrest matcher used to match criteria against a log event message.
 */
@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
public class LogMessageMatcher extends BaseMatcher<ILoggingEvent> {

    private final Matcher<String> messageMatcher;

    /**
     * Creates a log message matcher to match against the message string.
     *
     * @param matcher the message string matcher
     * @return the log matcher
     */
    public static Matcher<ILoggingEvent> logMessage(final Matcher<String> matcher) {
        return new LogMessageMatcher(matcher);
    }

    @Override public boolean matches(final Object actual) {
        return messageMatcher.matches(((ILoggingEvent) actual).getFormattedMessage());
    }

    @Override public void describeTo(final Description description) {
        description.appendText("A log-event with message matching ");
        messageMatcher.describeTo(description);
    }
}