//
// FormatReaderTestFactory.java
//
/*
LOCI software automated test suite for TestNG. Copyright (C) 2007-@year@
Melissa Linkert and Curtis Rueden. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the UW-Madison LOCI nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE UW-MADISON LOCI ``AS IS'' AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package loci.tests.testng;
import java.io.File;
import java.util.Vector;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Factory for scanning a directory structure and generating instances of
* {@link FormatReaderTest} based on the image files found.
*
* <dl><dt><b>Source code:</b></dt>
* <dd><a href="http://trac.openmicroscopy.org.uk/ome/browser/bioformats.git/components/test-suite/src/loci/tests/testng/FormatReaderTestFactory.java">Trac</a>,
* <a href="http://git.openmicroscopy.org/?p=bioformats.git;a=blob;f=components/test-suite/src/loci/tests/testng/FormatReaderTestFactory.java;hb=HEAD">Gitweb</a></dd></dl>
*/
public class FormatReaderTestFactory {
// -- Constants --
private static final Logger LOGGER =
LoggerFactory.getLogger(FormatReaderTestFactory.class);
// -- TestNG factory methods --
/**
* @testng.factory
*/
public Object[] createInstances() {
Vector files = new Vector();
// parse explicit filename, if any
final String nameProp = "testng.filename";
String filename = System.getProperty(nameProp);
if (filename != null && filename.equals("${" + nameProp + "}")) {
filename = null;
}
if (filename != null && !new File(filename).exists()) {
LOGGER.error("Invalid filename: {}", filename);
return new Object[0];
}
String baseDir = null;
if (filename == null) {
// parse base directory
final String baseDirProp = "testng.directory";
baseDir = System.getProperty(baseDirProp);
if (!new File(baseDir).isDirectory()) {
if (baseDir == null || baseDir.equals("${" + baseDirProp + "}")) {
LOGGER.error("No base directory specified.");
}
else LOGGER.error("Invalid base directory: {}", baseDir);
LOGGER.error("Please specify a directory containing files to test:");
LOGGER.error(" ant -D{}=\"/path/to/data\" test-all", baseDirProp);
return new Object[0];
}
FormatReaderTest.configTree = new ConfigurationTree(baseDir);
// create log file
TestTools.createLogFile();
LOGGER.info("testng.directory = {}", baseDir);
}
// parse multiplier
final String multProp = "testng.multiplier";
String mult = System.getProperty(multProp);
float multiplier = 1;
if (mult != null && !mult.equals("${" + multProp + "}")) {
try {
multiplier = Float.parseFloat(mult);
}
catch (NumberFormatException exc) {
LOGGER.warn("Invalid multiplier: {}", mult);
}
}
LOGGER.info("testng.multiplier = {}", multiplier);
// detect whether or not the map the files into memory
final String inMemoryProp = "testng.in-memory";
String inMemoryValue = System.getProperty(inMemoryProp);
boolean inMemory = Boolean.parseBoolean(inMemoryValue);
LOGGER.info("testng.in-memory = {}", inMemory);
// check for an alternate top level configuration file
final String toplevelConfig = "testng.toplevel-config";
String configFile = System.getProperty(toplevelConfig);
LOGGER.info("testng.toplevel-config = {}", configFile);
// detect maximum heap size
long maxMemory = Runtime.getRuntime().maxMemory() >> 20;
LOGGER.info("Maximum heap size = {} MB", maxMemory);
if (filename == null) {
// scan for files
System.out.println("Scanning for files...");
long start = System.currentTimeMillis();
try {
TestTools.getFiles(baseDir, files, FormatReaderTest.configTree,
configFile);
}
catch (Exception e) {
LOGGER.info("Failed to retrieve complete list of files", e);
}
long end = System.currentTimeMillis();
double time = (end - start) / 1000.0;
LOGGER.info(TestTools.DIVIDER);
LOGGER.info("Total files: {}", files.size());
long avg = (end - start);
if (files.size() > 0) avg /= files.size();
LOGGER.info("Scan time: {} s ({} ms/file)", time, avg);
LOGGER.info(TestTools.DIVIDER);
}
else {
files.add(filename);
}
// create test class instances
System.out.println("Building list of tests...");
Object[] tests = new Object[files.size()];
for (int i=0; i<tests.length; i++) {
String id = (String) files.get(i);
try {
if (FormatReaderTest.configTree.get(id) == null) {
LOGGER.warn("{} not configured.", id);
}
}
catch (Exception e) { }
tests[i] = new FormatReaderTest(id, multiplier, inMemory);
}
if (tests.length == 1) System.out.println("Ready to test " + files.get(0));
else System.out.println("Ready to test " + tests.length + " files");
return tests;
}
}