com.galenframework.utils.GalenUtils Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of galen-core Show documentation
Show all versions of galen-core Show documentation
A library for layout testing of websites
/*******************************************************************************
* Copyright 2018 Ivan Shubin http://galenframework.com
*
* 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 com.galenframework.utils;
import java.awt.Dimension;
import java.awt.Graphics2D;
import java.awt.Image;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.security.DigestInputStream;
import java.security.MessageDigest;
import java.util.*;
import java.util.regex.Pattern;
import javax.imageio.ImageIO;
import com.galenframework.browser.SeleniumGridBrowserFactory;
import com.galenframework.page.selenium.ByChain;
import com.galenframework.reports.TestReport;
import com.galenframework.reports.model.LayoutReport;
import com.galenframework.reports.nodes.LayoutReportNode;
import com.galenframework.reports.nodes.MutationReportNode;
import com.galenframework.reports.nodes.TestReportNode;
import com.galenframework.specs.page.Locator;
import com.galenframework.suite.actions.mutation.MutationReport;
import com.galenframework.tests.GalenProperties;
import com.galenframework.tests.TestSession;
import com.galenframework.browser.SeleniumBrowser;
import com.galenframework.browser.SeleniumBrowserFactory;
import com.galenframework.config.GalenConfig;
import com.galenframework.config.GalenProperty;
import com.galenframework.rainbow4j.Rainbow4J;
import org.apache.commons.io.FileUtils;
import org.apache.commons.lang3.StringEscapeUtils;
import org.openqa.selenium.*;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import static com.galenframework.config.GalenProperty.FILE_CREATE_TIMEOUT;
import static java.lang.String.format;
public class GalenUtils {
private final static Logger LOG = LoggerFactory.getLogger(GalenUtils.class);
private static final String URL_REGEX = "[a-zA-Z0-9]+://.*";
public static final String JS_RETRIEVE_DEVICE_PIXEL_RATIO =
"window.devicePixelRatio = window.devicePixelRatio || " +
"window.screen.deviceXDPI / window.screen.logicalXDPI; " +
"var pr = window.devicePixelRatio; if (pr != undefined && pr != null) return pr; else return 1.0;";
public static final int ZERO_WIDTH_SPACE_CHAR = 65279;
public static boolean isUrl(String url) {
if (url == null) {
return false;
}
return url.matches(URL_REGEX) || url.equals("-");
}
public static String formatScreenSize(Dimension screenSize) {
if (screenSize != null) {
return format("%dx%d", screenSize.width, screenSize.height);
}
else return "0x0";
}
public static Dimension readSize(String sizeText) {
if (sizeText == null) {
return null;
}
if (!sizeText.matches("[0-9]+x[0-9]+")) {
throw new IllegalArgumentException("Incorrect size: " + sizeText);
}
else {
String[] arr = sizeText.split("x");
return new Dimension(Integer.parseInt(arr[0]), Integer.parseInt(arr[1]));
}
}
public static File findFile(String specFile) {
URL resource = GalenUtils.class.getResource(specFile);
if (resource != null) {
return new File(resource.getFile());
}
else return new File(specFile);
}
public static File makeFullScreenshot(WebDriver driver) throws IOException, InterruptedException {
// scroll up first
scrollVerticallyTo(driver, 0);
byte[] bytes = ((TakesScreenshot)driver).getScreenshotAs(OutputType.BYTES);
BufferedImage image = ImageIO.read(new ByteArrayInputStream(bytes));
int capturedWidth = image.getWidth();
int capturedHeight = image.getHeight();
long longScrollHeight = ((Number)((JavascriptExecutor)driver).executeScript("return Math.max(" +
"document.body.scrollHeight, document.documentElement.scrollHeight," +
"document.body.offsetHeight, document.documentElement.offsetHeight," +
"document.body.clientHeight, document.documentElement.clientHeight);"
)).longValue();
Double devicePixelRatio = ((Number)((JavascriptExecutor)driver).executeScript(JS_RETRIEVE_DEVICE_PIXEL_RATIO)).doubleValue();
int scrollHeight = (int)longScrollHeight;
File file = File.createTempFile("screenshot", ".png");
int adaptedCapturedHeight = (int)(((double)capturedHeight) / devicePixelRatio);
BufferedImage resultingImage;
if (Math.abs(adaptedCapturedHeight - scrollHeight) > 40) {
int scrollOffset = adaptedCapturedHeight;
int times = scrollHeight / adaptedCapturedHeight;
int leftover = scrollHeight % adaptedCapturedHeight;
final BufferedImage tiledImage = new BufferedImage(capturedWidth, (int)(((double)scrollHeight) * devicePixelRatio), BufferedImage.TYPE_INT_RGB);
Graphics2D g2dTile = tiledImage.createGraphics();
g2dTile.drawImage(image, 0,0, null);
int scroll = 0;
for (int i = 0; i < times - 1; i++) {
scroll += scrollOffset;
scrollVerticallyTo(driver, scroll);
BufferedImage nextImage = ImageIO.read(new ByteArrayInputStream(((TakesScreenshot)driver).getScreenshotAs(OutputType.BYTES)));
g2dTile.drawImage(nextImage, 0, (i+1) * capturedHeight, null);
}
if (leftover > 0) {
scroll += scrollOffset;
scrollVerticallyTo(driver, scroll);
BufferedImage nextImage = ImageIO.read(new ByteArrayInputStream(((TakesScreenshot)driver).getScreenshotAs(OutputType.BYTES)));
BufferedImage lastPart = nextImage.getSubimage(0, nextImage.getHeight() - (int)(((double)leftover) * devicePixelRatio), nextImage.getWidth(), leftover);
g2dTile.drawImage(lastPart, 0, times * capturedHeight, null);
}
scrollVerticallyTo(driver, 0);
resultingImage = tiledImage;
}
else {
resultingImage = image;
}
if (GalenConfig.getConfig().shouldAutoresizeScreenshots()) {
try {
resultingImage = GalenUtils.resizeScreenshotIfNeeded(driver, resultingImage);
} catch (Exception ex) {
LOG.trace("Couldn't resize screenshot", ex);
}
}
ImageIO.write(resultingImage, "png", file);
return file;
}
/**
* Check the devicePixelRatio and adapts the size of the screenshot as if the ratio was 1.0
* @param driver
* @param screenshotImage
* @return
*/
public static BufferedImage resizeScreenshotIfNeeded(WebDriver driver, BufferedImage screenshotImage) {
Double devicePixelRatio = 1.0;
try {
devicePixelRatio = ((Number) ((JavascriptExecutor) driver).executeScript(JS_RETRIEVE_DEVICE_PIXEL_RATIO)).doubleValue();
} catch (Exception ex) {
ex.printStackTrace();
}
if (devicePixelRatio > 1.0 && screenshotImage.getWidth() > 0) {
Long screenSize = ((Number) ((JavascriptExecutor) driver).executeScript("return Math.max(" +
"document.body.scrollWidth, document.documentElement.scrollWidth," +
"document.body.offsetWidth, document.documentElement.offsetWidth," +
"document.body.clientWidth, document.documentElement.clientWidth);"
)).longValue();
Double estimatedPixelRatio = ((double)screenshotImage.getWidth()) / ((double)screenSize);
if (estimatedPixelRatio > 1.0) {
int newWidth = (int) (screenshotImage.getWidth() / estimatedPixelRatio);
int newHeight = (int) (screenshotImage.getHeight() / estimatedPixelRatio);
Image tmp = screenshotImage.getScaledInstance(newWidth, newHeight, Image.SCALE_SMOOTH);
BufferedImage scaledImage = new BufferedImage(newWidth, newHeight, BufferedImage.TYPE_INT_RGB);
Graphics2D g2d = scaledImage.createGraphics();
g2d.drawImage(tmp, 0, 0, null);
g2d.dispose();
return scaledImage;
}
else return screenshotImage;
}
else return screenshotImage;
}
public static void scrollVerticallyTo(WebDriver driver, int scroll) {
((JavascriptExecutor)driver).executeScript("window.scrollTo(0, " + scroll + ");");
try {
waitUntilItIsScrolledToPosition(driver, scroll);
} catch (InterruptedException e) {
LOG.trace("Interrupt error during scrolling occurred.", e);
}
}
private static void waitUntilItIsScrolledToPosition(WebDriver driver, int scrollPosition) throws InterruptedException {
int hardTime = GalenConfig.getConfig().getIntProperty(GalenProperty.SCREENSHOT_FULLPAGE_SCROLLWAIT);
if (hardTime > 0) {
Thread.sleep(hardTime);
}
int time = GalenConfig.getConfig().getIntProperty(GalenProperty.SCREENSHOT_FULLPAGE_SCROLLTIMEOUT);
boolean isScrolledToPosition = false;
while(time >= 0 && !isScrolledToPosition) {
Thread.sleep(50);
time -= 50;
isScrolledToPosition = Math.abs(obtainVerticalScrollPosition(driver) - scrollPosition) < 3;
}
}
private static int obtainVerticalScrollPosition(WebDriver driver) {
Number scrollLong = (Number) ((JavascriptExecutor)driver).executeScript("return (window.pageYOffset !== undefined) ? window.pageYOffset : (document.documentElement || document.body.parentNode || document.body).scrollTop;");
return scrollLong.intValue();
}
public static String convertToFileName(String name) {
return name.toLowerCase().replaceAll("[^\\dA-Za-z\\.\\-]", " ").replaceAll("\\s+", "-");
}
/**
* Needed for Javascript based tests
* @param browserType
* @return
*/
public static WebDriver createDriver(String browserType, String url, String size) {
if (browserType == null) {
browserType = GalenConfig.getConfig().getDefaultBrowser();
}
SeleniumBrowser browser = (SeleniumBrowser) new SeleniumBrowserFactory(browserType).openBrowser();
if (url != null && !url.trim().isEmpty()) {
browser.load(url);
}
if (size != null && !size.trim().isEmpty()) {
browser.changeWindowSize(GalenUtils.readSize(size));
}
return browser.getDriver();
}
public static WebDriver createGridDriver(String gridUrl, String browserName, String browserVersion, String platform, Map desiredCapabilities, String size) {
SeleniumGridBrowserFactory factory = new SeleniumGridBrowserFactory(gridUrl);
factory.setBrowser(browserName);
factory.setBrowserVersion(browserVersion);
if (platform != null) {
factory.setPlatform(Platform.valueOf(platform));
}
if (desiredCapabilities != null) {
factory.setDesiredCapabilites(desiredCapabilities);
}
WebDriver driver = ((SeleniumBrowser)factory.openBrowser()).getDriver();
GalenUtils.resizeDriver(driver, size);
return driver;
}
public static void resizeDriver(WebDriver driver, String sizeText) {
if (sizeText != null && !sizeText.trim().isEmpty()) {
Dimension size = GalenUtils.readSize(sizeText);
resizeDriver(driver, size.width, size.height);
}
}
public static void resizeDriver(WebDriver driver, int width, int height) {
if (GalenConfig.getConfig().getBooleanProperty(GalenProperty.GALEN_BROWSER_VIEWPORT_ADJUSTSIZE)) {
GalenUtils.autoAdjustBrowserWindowSizeToFitViewport(driver, width, height);
} else {
driver.manage().window().setSize(new org.openqa.selenium.Dimension(width, height));
}
}
public static File takeScreenshot(WebDriver driver) throws IOException {
File file = ((TakesScreenshot)driver).getScreenshotAs(OutputType.FILE);
if (GalenConfig.getConfig().shouldAutoresizeScreenshots()) {
BufferedImage image = Rainbow4J.loadImage(file.getAbsolutePath());
File newFile = File.createTempFile("screenshot", ".png");
image = GalenUtils.resizeScreenshotIfNeeded(driver, image);
Rainbow4J.saveImage(image, newFile);
return newFile;
}
else return file;
}
public static Properties loadProperties(String fileName) throws IOException {
GalenProperties properties = null;
if (TestSession.current() != null) {
properties = TestSession.current().getProperties();
}
else properties = new GalenProperties();
properties.load(new File(fileName));
return properties.getProperties();
}
public static void cookie(WebDriver driver, String cookie) {
String script = "document.cookie=\"" + StringEscapeUtils.escapeJava(cookie) + "\";";
injectJavascript(driver, script);
}
public static Object injectJavascript(WebDriver driver, String script) {
return ((JavascriptExecutor)driver).executeScript(script);
}
public static Object[] listToArray(List list) {
if (list == null) {
return new Object[]{};
}
Object[] arr = new Object[list.size()];
return list.toArray(arr);
}
public static String getParentForFile(String filePath) {
if (filePath != null) {
return new File(filePath).getParent();
}
else return null;
}
public static InputStream findFileOrResourceAsStream(String filePath) {
File file = new File(filePath);
if (file.exists()) {
try {
return new FileInputStream(file);
} catch (FileNotFoundException e) {
throw new RuntimeException(e);
}
}
else {
if (!filePath.startsWith("/")) {
filePath = "/" + filePath;
}
InputStream stream = GalenUtils.class.getResourceAsStream(filePath);
if (stream != null) {
return stream;
}
else {
String windowsFilePath = filePath.replace("\\", "/");
return GalenUtils.class.getResourceAsStream(windowsFilePath);
}
}
}
public static String calculateFileId(String fullPath) {
InputStream is = GalenUtils.findFileOrResourceAsStream(fullPath);
return calculateFileId(fullPath, is);
}
public static String calculateFileId(String fullPath, InputStream inputStream) {
try {
String fileName = new File(fullPath).getName();
MessageDigest md = MessageDigest.getInstance("MD5");
new DigestInputStream(inputStream, md);
byte [] hashBytes = md.digest();
return fileName + convertHashBytesToString(hashBytes);
} catch (Exception ex) {
throw new RuntimeException("Could not calculate file id", ex);
}
}
private static String convertHashBytesToString(byte[] hashBytes) {
StringBuilder builder = new StringBuilder();
for (byte b : hashBytes) {
builder.append(Integer.toHexString(0xFF & b));
}
return builder.toString();
}
public static Pattern convertObjectNameRegex(String regex) {
String jRegex = regex.replace("#", "[0-9]+").replace("*", ".*");
return Pattern.compile(jRegex);
}
public static boolean isObjectsSearchExpression(String singleExpression) {
//check if it is group
if (singleExpression.startsWith("&")) {
return true;
}
for (int i = 0; i < singleExpression.length(); i++) {
char symbol = singleExpression.charAt(i);
if (symbol == '*' || symbol == '#') {
return true;
}
}
return false;
}
public static String toCommaSeparated(List list) {
if (list != null) {
StringBuffer buff = new StringBuffer();
boolean comma = false;
for (String item : list) {
if (comma) {
buff.append(',');
}
comma = true;
buff.append(item);
}
return buff.toString();
}
return "";
}
public static String removeNonPrintableControlSymbols(String line) {
StringBuilder builder = new StringBuilder();
char ch;
for (int i = 0; i < line.length(); i++) {
ch = line.charAt(i);
if (ch >= 32 && ch < ZERO_WIDTH_SPACE_CHAR || ch == 9) {
builder.append(ch);
}
}
return builder.toString();
}
public static Dimension getViewportArea(WebDriver driver) {
List size = (List)((JavascriptExecutor)driver).executeScript("return [document.documentElement.clientWidth" +
"|| document.body.clientWidth" +
"|| window.innerWidth," +
"document.documentElement.clientHeight" +
"|| document.body.clientHeight" +
"|| window.innerHeight];"
);
return new Dimension(size.get(0).intValue(), size.get(1).intValue());
}
public static void autoAdjustBrowserWindowSizeToFitViewport(WebDriver driver, int width, int height) {
driver.manage().window().setSize(new org.openqa.selenium.Dimension(width, height));
Dimension viewport = getViewportArea(driver);
if (viewport.getWidth() < width) {
int delta = (int) (width - viewport.getWidth());
driver.manage().window().setSize(new org.openqa.selenium.Dimension(width + delta, height));
}
}
public static List fromCommaSeparated(String parameters) {
List items = new LinkedList<>();
String[] paramArray = parameters.split(",");
for (String param : paramArray) {
String trimmed = param.trim();
if (!trimmed.isEmpty()) {
items.add(trimmed);
}
}
return items;
}
public static boolean isObjectGroup(String singleExpression) {
return singleExpression.startsWith("&");
}
public static String extractGroupName(String singleExpression) {
return singleExpression.substring(1);
}
public static InputStream findMandatoryFileOrResourceAsStream(String imagePath) throws FileNotFoundException {
InputStream stream = findFileOrResourceAsStream(imagePath);
if (stream == null) {
throw new FileNotFoundException(imagePath);
}
return stream;
}
public static WebElement findWebElement(WebDriver driver, Locator locator) {
return ByChain.fromLocator(locator).findElement(driver);
}
public static List findWebElements(WebDriver driver, Locator locator) {
return ByChain.fromLocator(locator).findElements(driver);
}
public static void attachLayoutReport(LayoutReport layoutReport, TestReport report, String fileName, List includedTagsList) {
if (report != null) {
String reportTitle = "Check layout: " + fileName + " included tags: " + GalenUtils.toCommaSeparated(includedTagsList);
TestReportNode layoutReportNode = new LayoutReportNode(report.getFileStorage(), layoutReport, reportTitle);
if (layoutReport.errors() > 0) {
layoutReportNode.setStatus(TestReportNode.Status.ERROR);
}
report.addNode(layoutReportNode);
}
}
public static void attachMutationReport(MutationReport mutationReport, TestReport report, String specPath, List includedTags) {
if (report != null) {
String reportTitle = "Mutation testing: " + specPath + " included tags: " + GalenUtils.toCommaSeparated(includedTags);
TestReportNode mutationReportNode = new MutationReportNode(report.getFileStorage(), mutationReport, reportTitle);
if (mutationReport.hasErrors()) {
mutationReportNode.setStatus(TestReportNode.Status.ERROR);
}
report.addNode(mutationReportNode);
}
}
public static List findFilesOrResourcesMatchingSearchExpression(String imagePossiblePath) {
String slash = File.separator;
int lastSlashPosition = imagePossiblePath.lastIndexOf(slash);
if (lastSlashPosition < 0) {
lastSlashPosition = imagePossiblePath.lastIndexOf("/");
if (lastSlashPosition >=0 ) {
slash = "/";
}
}
List foundFilePaths = new LinkedList<>();
if (lastSlashPosition > 0) {
String dirPath = imagePossiblePath.substring(0, lastSlashPosition);
String namePatternText = imagePossiblePath.substring(lastSlashPosition + 1);
Pattern namePattern = convertObjectNameRegex(namePatternText);
File dir = new File(dirPath);
if (!dir.exists()) {
dir = new File(GalenUtils.class.getResource(dirPath).getFile());
}
if (dir.exists()) {
String[] candidateNames = dir.list();
for (String candidateName : candidateNames) {
if (namePattern.matcher(candidateName).matches()) {
foundFilePaths.add(dirPath + slash + candidateName);
}
}
}
} else {
File dir = new File(".");
if (!dir.exists()) {
dir = new File(GalenUtils.class.getResource(".").getFile());
}
if (dir.exists()) {
Pattern namePattern = convertObjectNameRegex(imagePossiblePath);
String[] candidateNames = dir.list();
for (String candidateName : candidateNames) {
if (namePattern.matcher(candidateName).matches()) {
foundFilePaths.add(candidateName);
}
}
}
}
return foundFilePaths;
}
public static void makeSureFolderExists(String reportFolderPath) throws IOException {
File newDirectory = new File(reportFolderPath);
makeSureFolderExists(newDirectory);
}
public static void makeSureFolderExists(File dir) throws IOException {
FileUtils.forceMkdir(dir);
if (!FileUtils.waitFor(dir, GalenConfig.getConfig().getIntProperty(FILE_CREATE_TIMEOUT))) {
throw new IOException(format("Couldn't create folder: %s", dir.getAbsolutePath()));
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy