2 * Back 2 Browser Bytecode Translator
3 * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, version 2 of the License.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. Look for COPYING file in the top folder.
16 * If not, see http://opensource.org/licenses/GPL-2.0.
18 package org.apidesign.bck2brwsr.vmtest;
20 import org.apidesign.bck2brwsr.launcher.Launcher;
21 import org.apidesign.bck2brwsr.vmtest.impl.CompareCase;
22 import org.testng.annotations.Factory;
24 /** A TestNG {@link Factory} that seeks for {@link Compare} and {@link BrwsrTest} annotations
25 * in provided class and builds set of tests that verify the functionality of <b>Bck2Brwsr</b>
26 * based system. Use as:
28 * {@code @}{@link Factory} public static create() {
29 * return @{link VMTest}.{@link #create(java.lang.Class) create}(YourClass.class);
31 * where <code>YourClass</code> contains methods annotated with
32 * {@link Compare} and {@link BrwsrTest} annotations.
34 * @author Jaroslav Tulach <jtulach@netbeans.org>
36 public final class VMTest {
40 /** Inspects <code>clazz</code> and for each method annotated by
41 * {@link Compare} or {@link BrwsrTest} creates
44 * Each {@link Compare} instance runs the test in different virtual
45 * machine and at the end they compare the results.
47 * Each {@link BrwsrTest} annotated method is executed once in {@link Launcher started
50 * @param clazz the class (or classes) to inspect
51 * @return the set of created tests
53 public static Object[] create(Class... clazz) {
54 return CompareCase.create(clazz);