1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/rt/vmtest/src/main/java/org/apidesign/bck2brwsr/vmtest/VMTest.java	Tue Feb 26 16:54:16 2013 +0100
     1.3 @@ -0,0 +1,43 @@
     1.4 +/**
     1.5 + * Back 2 Browser Bytecode Translator
     1.6 + * Copyright (C) 2012 Jaroslav Tulach <jaroslav.tulach@apidesign.org>
     1.7 + *
     1.8 + * This program is free software: you can redistribute it and/or modify
     1.9 + * it under the terms of the GNU General Public License as published by
    1.10 + * the Free Software Foundation, version 2 of the License.
    1.11 + *
    1.12 + * This program is distributed in the hope that it will be useful,
    1.13 + * but WITHOUT ANY WARRANTY; without even the implied warranty of
    1.14 + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    1.15 + * GNU General Public License for more details.
    1.16 + *
    1.17 + * You should have received a copy of the GNU General Public License
    1.18 + * along with this program. Look for COPYING file in the top folder.
    1.19 + * If not, see http://opensource.org/licenses/GPL-2.0.
    1.20 + */
    1.21 +package org.apidesign.bck2brwsr.vmtest;
    1.22 +
    1.23 +import org.apidesign.bck2brwsr.vmtest.impl.CompareCase;
    1.24 +import org.testng.annotations.Factory;
    1.25 +
    1.26 +/** A TestNG {@link Factory} that seeks for {@link Compare} annotations
    1.27 + * in provided class and builds set of tests that compare the computations
    1.28 + * in real as well as JavaScript virtual machines. Use as:<pre>
    1.29 + * {@code @}{@link Factory} public static create() {
    1.30 + *   return @{link VMTest}.{@link #create(YourClass.class);
    1.31 + * }</pre>
    1.32 + *
    1.33 + * @author Jaroslav Tulach <jtulach@netbeans.org>
    1.34 + */
    1.35 +public final class VMTest {
    1.36 +    /** Inspects <code>clazz</code> and for each {@lik Compare} method creates
    1.37 +     * instances of tests. Each instance runs the test in different virtual
    1.38 +     * machine and at the end they compare the results.
    1.39 +     * 
    1.40 +     * @param clazz the class to inspect
    1.41 +     * @return the set of created tests
    1.42 +     */
    1.43 +    public static Object[] create(Class<?> clazz) {
    1.44 +        return CompareCase.create(clazz);
    1.45 +    }
    1.46 +}