/* * Copyright 2010-2012 JetBrains s.r.o. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.jetbrains.jet; import com.google.common.collect.ImmutableMap; import com.google.common.collect.Lists; import com.google.common.collect.Sets; import com.intellij.openapi.Disposable; import com.intellij.openapi.editor.Document; import com.intellij.openapi.project.Project; import com.intellij.openapi.util.ShutDownTracker; import com.intellij.openapi.util.io.FileUtil; import com.intellij.openapi.vfs.CharsetToolkit; import com.intellij.psi.PsiFileFactory; import com.intellij.psi.impl.PsiFileFactoryImpl; import com.intellij.testFramework.LightVirtualFile; import junit.framework.TestCase; import org.jetbrains.annotations.NonNls; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.TestOnly; import org.jetbrains.jet.analyzer.AnalyzeExhaust; import org.jetbrains.jet.cli.jvm.compiler.JetCoreEnvironment; import org.jetbrains.jet.lang.diagnostics.Diagnostic; import org.jetbrains.jet.lang.diagnostics.Severity; import org.jetbrains.jet.lang.diagnostics.UnresolvedReferenceDiagnosticFactory; import org.jetbrains.jet.lang.diagnostics.rendering.DefaultErrorMessages; import org.jetbrains.jet.lang.psi.JetFile; import org.jetbrains.jet.lang.resolve.AnalyzerScriptParameter; import org.jetbrains.jet.lang.resolve.BindingContext; import org.jetbrains.jet.lang.resolve.BindingTrace; import org.jetbrains.jet.lang.resolve.java.AnalyzerFacadeForJVM; import org.jetbrains.jet.plugin.JetLanguage; import org.jetbrains.jet.test.InnerTestClasses; import org.jetbrains.jet.test.TestMetadata; import org.jetbrains.jet.util.slicedmap.ReadOnlySlice; import org.jetbrains.jet.util.slicedmap.SlicedMap; import org.jetbrains.jet.util.slicedmap.WritableSlice; import org.junit.Assert; import javax.tools.*; import java.io.File; import java.io.IOException; import java.lang.reflect.Method; import java.nio.charset.Charset; import java.util.*; import java.util.regex.Matcher; import java.util.regex.Pattern; /** * @author abreslav */ public class JetTestUtils { private static List filesToDelete = new ArrayList(); public static final BindingTrace DUMMY_TRACE = new BindingTrace() { @Override public BindingContext getBindingContext() { return new BindingContext() { @Override public Collection getDiagnostics() { throw new UnsupportedOperationException(); // TODO } @Override public V get(ReadOnlySlice slice, K key) { return DUMMY_TRACE.get(slice, key); } @NotNull @Override public Collection getKeys(WritableSlice slice) { return DUMMY_TRACE.getKeys(slice); } @NotNull @TestOnly @Override public ImmutableMap getSliceContents(@NotNull ReadOnlySlice slice) { return ImmutableMap.of(); } }; } @Override public void record(WritableSlice slice, K key, V value) { } @Override public void record(WritableSlice slice, K key) { } @Override public V get(ReadOnlySlice slice, K key) { if (slice == BindingContext.PROCESSED) return (V)Boolean.FALSE; return SlicedMap.DO_NOTHING.get(slice, key); } @NotNull @Override public Collection getKeys(WritableSlice slice) { assert slice.isCollective(); return Collections.emptySet(); } @Override public void report(@NotNull Diagnostic diagnostic) { if (diagnostic.getFactory() instanceof UnresolvedReferenceDiagnosticFactory) { throw new IllegalStateException("Unresolved: " + diagnostic.getPsiElement().getText()); } } }; public static BindingTrace DUMMY_EXCEPTION_ON_ERROR_TRACE = new BindingTrace() { @Override public BindingContext getBindingContext() { return new BindingContext() { @Override public Collection getDiagnostics() { throw new UnsupportedOperationException(); } @Override public V get(ReadOnlySlice slice, K key) { return DUMMY_EXCEPTION_ON_ERROR_TRACE.get(slice, key); } @NotNull @Override public Collection getKeys(WritableSlice slice) { return DUMMY_EXCEPTION_ON_ERROR_TRACE.getKeys(slice); } @NotNull @TestOnly @Override public ImmutableMap getSliceContents(@NotNull ReadOnlySlice slice) { return ImmutableMap.of(); } }; } @Override public void record(WritableSlice slice, K key, V value) { } @Override public void record(WritableSlice slice, K key) { } @Override public V get(ReadOnlySlice slice, K key) { return null; } @NotNull @Override public Collection getKeys(WritableSlice slice) { assert slice.isCollective(); return Collections.emptySet(); } @Override public void report(@NotNull Diagnostic diagnostic) { if (diagnostic.getSeverity() == Severity.ERROR) { throw new IllegalStateException(DefaultErrorMessages.RENDERER.render(diagnostic)); } } }; @SuppressWarnings("unchecked") private static final Class[] NO_INNER_CLASSES = new Class[0]; private JetTestUtils() { } public static AnalyzeExhaust analyzeFile(@NotNull JetFile namespace) { return AnalyzerFacadeForJVM.analyzeOneFileWithJavaIntegration(namespace, Collections.emptyList()); } public static JetCoreEnvironment createEnvironmentWithFullJdk(Disposable disposable) { return createEnvironmentWithJdkAndNullabilityAnnotationsFromIdea(disposable, ConfigurationKind.ALL, TestJdkKind.FULL_JDK); } public static JetCoreEnvironment createEnvironmentWithMockJdkAndIdeaAnnotations(Disposable disposable) { return createEnvironmentWithMockJdkAndIdeaAnnotations(disposable, ConfigurationKind.ALL); } public static JetCoreEnvironment createEnvironmentWithMockJdkAndIdeaAnnotations(Disposable disposable, @NotNull ConfigurationKind configurationKind) { return createEnvironmentWithJdkAndNullabilityAnnotationsFromIdea(disposable, configurationKind, TestJdkKind.MOCK_JDK); } public static JetCoreEnvironment createEnvironmentWithJdkAndNullabilityAnnotationsFromIdea( @NotNull Disposable disposable, @NotNull ConfigurationKind configurationKind, @NotNull TestJdkKind jdkKind ) { return new JetCoreEnvironment(disposable, CompileCompilerDependenciesTest.compilerConfigurationForTests( configurationKind, jdkKind, getAnnotationsJar())); } public static File findMockJdkRtJar() { return new File(JetTestCaseBuilder.getHomeDirectory(), "compiler/testData/mockJDK-1.7/jre/lib/rt.jar"); } public static File getAnnotationsJar() { return new File(JetTestCaseBuilder.getHomeDirectory(), "compiler/testData/mockJDK-1.7/jre/lib/annotations.jar"); } public static void mkdirs(File file) throws IOException { if (file.isDirectory()) { return; } if (!file.mkdirs()) { if (file.exists()) { throw new IOException("failed to create " + file + " file exists and not a directory"); } throw new IOException(); } } public static File tmpDirForTest(TestCase test) throws IOException { File answer = FileUtil.createTempDirectory(test.getClass().getSimpleName(), test.getName()); deleteOnShutdown(answer); return answer; } public static File tmpDir(String name) throws IOException { // we should use this form. otherwise directory will be deleted on each test File answer = FileUtil.createTempDirectory(new File(System.getProperty("java.io.tmpdir")), name, ""); deleteOnShutdown(answer); return answer; } public static void deleteOnShutdown(File file) { if (filesToDelete.isEmpty()) { ShutDownTracker.getInstance().registerShutdownTask(new Runnable() { @Override public void run() { ShutDownTracker.invokeAndWait(true, true, new Runnable() { @Override public void run() { for (File victim : filesToDelete) { FileUtil.delete(victim); } } }); } }); } filesToDelete.add(file); } public static void rmrf(File file) { if (file == null) { return; } if (!FileUtil.delete(file)) { throw new RuntimeException("failed to delete " + file); } } public static final Pattern FILE_PATTERN = Pattern.compile("//\\s*FILE:\\s*(.*)$", Pattern.MULTILINE); public static JetFile createFile(@NonNls String name, String text, @NotNull Project project) { LightVirtualFile virtualFile = new LightVirtualFile(name, JetLanguage.INSTANCE, text); virtualFile.setCharset(CharsetToolkit.UTF8_CHARSET); return (JetFile) ((PsiFileFactoryImpl) PsiFileFactory.getInstance(project)).trySetupPsiForFile(virtualFile, JetLanguage.INSTANCE, true, false); } public static String doLoadFile(String myFullDataPath, String name) throws IOException { String fullName = myFullDataPath + File.separatorChar + name; return doLoadFile(new File(fullName)); } public static String doLoadFile(@NotNull File file) throws IOException { return FileUtil.loadFile(file, CharsetToolkit.UTF8, true).trim(); } public static String getFilePath(File file) { return FileUtil.toSystemIndependentName(file.getPath()); } public interface TestFileFactory { F create(String fileName, String text); } public static List createTestFiles(String testFileName, String expectedText, TestFileFactory factory) { List testFileFiles = Lists.newArrayList(); Matcher matcher = FILE_PATTERN.matcher(expectedText); if (!matcher.find()) { // One file testFileFiles.add(factory.create(testFileName, expectedText)); } else { int processedChars = 0; // Many files while (true) { String fileName = matcher.group(1); int start = matcher.start(); assert start == processedChars : "Characters skipped from " + processedChars + " to " + matcher.start(); boolean nextFileExists = matcher.find(); int end; if (nextFileExists) { end = matcher.start(); } else { end = expectedText.length(); } String fileText = expectedText.substring(start, end); processedChars = end; testFileFiles.add(factory.create(fileName, fileText)); if (!nextFileExists) break; } assert processedChars == expectedText.length() : "Characters skipped from " + processedChars + " to " + (expectedText.length() - 1); } return testFileFiles; } public static String getLastCommentedLines(@NotNull Document document) { List resultLines = new ArrayList(); for (int i = document.getLineCount() - 1; i >= 0; i--) { int lineStart = document.getLineStartOffset(i); int lineEnd = document.getLineEndOffset(i); if (document.getCharsSequence().subSequence(lineStart, lineEnd).toString().trim().isEmpty()) { continue; } if ("//".equals(document.getCharsSequence().subSequence(lineStart, lineStart + 2).toString())) { resultLines.add(document.getCharsSequence().subSequence(lineStart + 2, lineEnd)); } else { break; } } Collections.reverse(resultLines); StringBuilder result = new StringBuilder(); for (CharSequence line : resultLines) { result.append(line).append("\n"); } result.delete(result.length() - 1, result.length()); return result.toString(); } public static void compileJavaFiles(@NotNull Collection files, List options) throws IOException { JavaCompiler javaCompiler = ToolProvider.getSystemJavaCompiler(); StandardJavaFileManager fileManager = javaCompiler.getStandardFileManager(null, Locale.ENGLISH, Charset.forName("utf-8")); try { Iterable javaFileObjectsFromFiles = fileManager.getJavaFileObjectsFromFiles(files); JavaCompiler.CompilationTask task = javaCompiler.getTask(null, fileManager, null, options, null, javaFileObjectsFromFiles); Assert.assertTrue(task.call()); } finally { fileManager.close(); } } public static void assertAllTestsPresentByMetadata( @NotNull Class testCaseClass, @NotNull String generatorClassFqName, @NotNull File testDataDir, @NotNull String extension, boolean recursive ) { TestMetadata testClassMetadata = testCaseClass.getAnnotation(TestMetadata.class); Assert.assertNotNull("No metadata for class: " + testCaseClass, testClassMetadata); String rootPath = testClassMetadata.value(); File rootFile = new File(rootPath); Set filePaths = Sets.newHashSet(); for (Method method : testCaseClass.getDeclaredMethods()) { TestMetadata testMetadata = method.getAnnotation(TestMetadata.class); if (testMetadata != null) { filePaths.add(testMetadata.value()); } } File[] files = testDataDir.listFiles(); if (files != null) { for (File file : files) { if (file.isDirectory()) { if (recursive && containsTestData(file, extension)) { assertTestClassPresentByMetadata(testCaseClass, generatorClassFqName, file); } } else { if (file.getName().endsWith("." + extension)) { String relativePath = FileUtil.getRelativePath(rootFile, file); if (!filePaths.contains(relativePath)) { Assert.fail("Test data file missing from the generated test class: " + file + pleaseReRunGenerator(generatorClassFqName)); } } } } } } private static boolean containsTestData(File dir, String extension) { File[] files = dir.listFiles(); assert files != null; for (File file : files) { if (file.isDirectory()) { if (containsTestData(file, extension)) { return true; } } else { if (FileUtil.getExtension(file.getName()).equals(extension)) { return true; } } } return false; } private static void assertTestClassPresentByMetadata( @NotNull Class outerClass, @NotNull String generatorClassFqName, @NotNull File testDataDir ) { InnerTestClasses innerClassesAnnotation = outerClass.getAnnotation(InnerTestClasses.class); Class[] innerClasses = innerClassesAnnotation == null ? NO_INNER_CLASSES : innerClassesAnnotation.value(); for (Class innerClass : innerClasses) { TestMetadata testMetadata = innerClass.getAnnotation(TestMetadata.class); if (testMetadata != null && testMetadata.value().equals(getFilePath(testDataDir))) { return; } } Assert.fail("Test data directory missing from the generated test class: " + testDataDir + pleaseReRunGenerator(generatorClassFqName)); } private static String pleaseReRunGenerator(String generatorClassFqName) { return "\nPlease re-run the generator: " + generatorClassFqName + getLocationFormattedForConsole(generatorClassFqName); } private static String getLocationFormattedForConsole(String generatorClassFqName) { return "(" + getSimpleName(generatorClassFqName) + ".java:1)"; } private static String getSimpleName(String generatorClassFqName) { return generatorClassFqName.substring(generatorClassFqName.lastIndexOf(".") + 1); } }