com.coveros.selenified.utilities

Class TestSetup

java.lang.Object

com.coveros.selenified.utilities.TestSetup

public class TestSetup
extends Object

Assists with Selenified class in setting up proxy, hub, and browser details

Author:

Max Saperstone

Constructor Summary

Constructors

Constructor and Description
TestSetup() A constructor which sets up the default empty desired capabilities

Method Summary

Modifier and Type	Method and Description
static boolean	areBrowserDetailsSet() determines if the browser information provided has details, or just the browser name
static String	capitalizeFirstLetters(String word) Capitalizes the first letter of each word in the provided string
org.openqa.selenium.remote.DesiredCapabilities	getDesiredCapabilities() returns the classes defined desired capabilities
static String	getRandomString(int length) Generates a random string of alpha-numeric characters
static String	getTestName(Method method, Object... dataProvider) Determines the unique test name, based on the parameters passed in
static String	getTestName(String packageName, String className, String methodName, Object... dataProvider) Determines the unique test name, based on the parameters passed in
static Map<String,String>	parseMap(String input) Breaks up a string, and places it into a map.
static String	removeNonWordCharacters(String value) Removes all non alphanumeric characters from a provided string
static List<Browser>	setBrowser() looks at the browser information passed in, and loads that data into a list
void	setupBrowserCapability(Browser browser) Sets the device capabilities based on the browser selection
void	setupBrowserDetails(Map<String,String> browserDetails) sets the browser details (name, version, device, orientation, os) into the device capabilities
static org.openqa.selenium.WebDriver	setupDriver(Browser browser, org.openqa.selenium.remote.DesiredCapabilities capabilities) this creates the webdriver object, which will be used to interact with for all browser web tests
void	setupProxy() Obtains the set system values for the proxy, and adds them to the desired capabilities

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TestSetup

public TestSetup()

A constructor which sets up the default empty desired capabilities

Method Detail

getDesiredCapabilities

public org.openqa.selenium.remote.DesiredCapabilities getDesiredCapabilities()

returns the classes defined desired capabilities

Returns:

DesiredCapabilities

setupProxy

public void setupProxy()

Obtains the set system values for the proxy, and adds them to the desired capabilities

areBrowserDetailsSet

public static boolean areBrowserDetailsSet()

determines if the browser information provided has details, or just the browser name

Returns:

Boolean: are there details associated with the browser, such as version, os, etc

setBrowser

public static List<Browser> setBrowser()
                                throws InvalidBrowserException

looks at the browser information passed in, and loads that data into a list

Returns:

List: a list of all browsers

Throws:

InvalidBrowserException - If a browser that is not one specified in the Selenium.Browser class is used, this exception will be thrown

setupBrowserDetails

public void setupBrowserDetails(Map<String,String> browserDetails)

sets the browser details (name, version, device, orientation, os) into the device capabilities

Parameters:

browserDetails - - a map containing all of the browser details

setupBrowserCapability

public void setupBrowserCapability(Browser browser)
                            throws InvalidBrowserException

Sets the device capabilities based on the browser selection

Parameters:

browser - - which browser are we running with

Throws:

InvalidBrowserException - If a browser that is not one specified in the Selenium.Browser class is used, this exception will be thrown

setupDriver

public static org.openqa.selenium.WebDriver setupDriver(Browser browser,
                                                        org.openqa.selenium.remote.DesiredCapabilities capabilities)
                                                 throws InvalidBrowserException

this creates the webdriver object, which will be used to interact with for all browser web tests

Parameters:

browser - - what browser is being tested on

capabilities - - what capabilities are being tested with

Returns:

WebDriver: the driver to interact with for the test

Throws:

InvalidBrowserException - If a browser that is not one specified in the Selenium.Browser class is used, this exception will be thrown

getRandomString

public static String getRandomString(int length)

Generates a random string of alpha-numeric characters

Parameters:

length - the length of the random string

Returns:

String: random string of characters

removeNonWordCharacters

public static String removeNonWordCharacters(String value)

Removes all non alphanumeric characters from a provided string

Parameters:

value - - the string to cleanup

Returns:

String: the provided string with all alphanumeric characters removed

getTestName

public static String getTestName(Method method,
                                 Object... dataProvider)

Determines the unique test name, based on the parameters passed in

Parameters:

method - - the method under test to extract the name from

dataProvider - - an array of objects being passed to the test as data providers

Returns:

String: a unique name

getTestName

public static String getTestName(String packageName,
                                 String className,
                                 String methodName,
                                 Object... dataProvider)

Determines the unique test name, based on the parameters passed in

Parameters:

packageName - - the package name of the test method as a string

className - - the class name of the test method as a string

methodName - - the method name of the test as a string

dataProvider - - an array of objects being passed to the test as data providers

Returns:

String: a unique name

capitalizeFirstLetters

public static String capitalizeFirstLetters(String word)

Capitalizes the first letter of each word in the provided string

Parameters:

word - - the string to be capitalized on

Returns:

String: the new string

parseMap

public static Map<String,String> parseMap(String input)

Breaks up a string, and places it into a map. ampersands (&) are used to split into key value pairs, while equals (=) are used to assign key vs values

Parameters:

input - - a string, with key and values separated by an equals (=) and pairs separated by an ampersand (&)

Returns:

Map: a map with values