org.mockito.junit.MockitoJUnit Maven / Gradle / Ivy

/*
 * Copyright (c) 2016 Mockito contributors
 * This program is made available under the terms of the MIT License.
 */
package org.mockito.junit;

import org.junit.rules.TestRule;
import org.mockito.internal.configuration.plugins.Plugins;
import org.mockito.internal.junit.JUnitRule;
import org.mockito.internal.junit.JUnitTestRule;
import org.mockito.internal.junit.VerificationCollectorImpl;
import org.mockito.quality.Strictness;

/**
 * Mockito supports JUnit via:
 * 
 *     JUnit Rules - see {@link MockitoRule}
 *     JUnit runners - see {@link MockitoJUnitRunner}
 *     JUnit Jupiter extension
 * 
 *
 * @since 1.10.17
 */
public final class MockitoJUnit {

    /**
     * Creates rule instance that initiates @Mocks
     * For more details and examples see {@link MockitoRule}.
     *
     * @return the rule instance
     * @since 1.10.17
     */
    public static MockitoRule rule() {
        return new JUnitRule(Plugins.getMockitoLogger(), Strictness.WARN);
    }

    /**
     * Creates a rule instance that initiates @Mocks and is a {@link TestRule}. Use this method
     * only when you need to explicitly need a {@link TestRule}, for example if you need to compose
     * multiple rules using a {@link org.junit.rules.RuleChain}. Otherwise, always prefer {@link #rule()}
     * See {@link MockitoRule}.
     *
     * @param testInstance The instance to initiate mocks for
     * @return the rule instance
     * @since 3.3.0
     */
    public static MockitoTestRule testRule(Object testInstance) {
        return new JUnitTestRule(Plugins.getMockitoLogger(), Strictness.WARN, testInstance);
    }

    /**
     * Creates a rule instance that can perform lazy verifications.
     *
     * @see VerificationCollector
     * @return the rule instance
     * @since 2.1.0
     */
    public static VerificationCollector collector() {
        return new VerificationCollectorImpl();
    }

    private MockitoJUnit() {}
}