Junit5: Test Suite: ExcludeTags

@ExcludeTags specifies the tags or tag expressions to be excluded when running a test suite on the JUnit Platform.

 

For example, below snippet runs all the test cases in the package "com.sample.app.dummy" and its sub packages.

@RunWith(JUnitPlatform.class)
@SuiteDisplayName("JUnit Platform Suite Demo")
@SelectPackages({"com.sample.app.dummy"})
public class IncludePackagesDemo {

}

What if you want to selectively run the test classes that do not matches given tags?

You can use @ExcludeTags annotation to explicitly exclude the classes that do not match to given tags.

 

Example

@RunWith(JUnitPlatform.class)
@SuiteDisplayName("JUnit Platform Suite Demo")
@SelectPackages({"com.sample.app.dummy"})
@ExcludeTags({"prod", "qa"})
public class ExcludeTagsDemo {

}

Above snippet execute below test classes.

a.   Dummy1D2Test

b.   Dummy1Test

c.    Dummy2D1Test

 

Find the below working application.

 

DummyTest.java

package com.sample.app.dummy;

import static org.junit.jupiter.api.Assertions.assertTrue;

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

@Tag("prod")
public class DummyTest {

    @Test
    public void test1() {
        assertTrue(true);
    }
}

Dummy1Test.java

package com.sample.app.dummy.dummy1;

import static org.junit.Assert.assertTrue;

import org.junit.jupiter.api.Test;

public class Dummy1Test {
    @Test
    public void test1() {
        assertTrue(true);
    }
}

Dummy1D1Test.java

package com.sample.app.dummy.dummy1.d1;

import static org.junit.Assert.assertTrue;

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

@Tag("qa")
public class Dummy1D1Test {

    @Test
    public void test1() {
        assertTrue(true);
    }

}

Dummy1D2Test.java

package com.sample.app.dummy.dummy1.d2;

import static org.junit.Assert.assertTrue;

import org.junit.jupiter.api.Test;

public class Dummy1D2Test {
    @Test
    public void test1() {
        assertTrue(true);
    }
}

Dummy2D1Test.java

package com.sample.app.dummy.dummy2.d1;

import static org.junit.Assert.assertTrue;

import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;

@Tag("dev")
public class Dummy2D1Test {
    @Test
    public void test1() {
        assertTrue(true);
    }
}

ExcludeTagsDemo.java

package com.sample.app.suite;

import org.junit.platform.runner.JUnitPlatform;
import org.junit.platform.suite.api.ExcludeTags;
import org.junit.platform.suite.api.SelectPackages;
import org.junit.platform.suite.api.SuiteDisplayName;
import org.junit.runner.RunWith;

@RunWith(JUnitPlatform.class)
@SuiteDisplayName("JUnit Platform Suite Demo")
@SelectPackages({"com.sample.app.dummy"})
@ExcludeTags({"prod", "qa"})
public class ExcludeTagsDemo {

}

Run above application, you will see the executed test classes information in junit report window.

Previous                                                    Next                                                    Home