sh0vel / conductor

The Selenium framework that takes you where you want to go

Conductor

See the site

Getting Started

Using maven, include it as a dependency:

<dependency>
  <groupId>io.ddavison</groupId>
  <artifactId>conductor</artifactId>
  <version>2.2.2</version>
</dependency>

Create a Java Class, and extend it from io.ddavison.conductor.Locomotive

Drivers

Drivers should be put in the root of your project, and be named like this:

Mac

chromedriver.mac

Windows

chromedriver.exe

Linux

chromedriver.linux

So as an example, your project structure could be:

Project
| src
|   main
|     java
|       TestClass.java
| pom.xml
| chromedriver.mac
| chromedriver.exe
| chromedriver.linux

Currently, six browsers are supported and they are Firefox, HTMLUnit, Chrome, Internet Explorer, Safari, and PhantomJS

Goals

The primary goals of this project are to...

• Take advantage of method chaining, to create a fluent interface.
• Abstract the programmer from bloated scripts resulting from using too many css selectors, and too much code.
• Provide a quick and easy framework in Selenium 2 using Java, to get started writing scripts.
• Provide a free to use framework for any starting enterprise, or individual programmer.
• Utilize the power of CSS!

Actions

You can perform any action that you could possibly do, using the inline actions.

• click(By)
• setText(By, text)
• getText(By)
• hoverOver(By)
• check(By)
• uncheck(By)
• navigateTo(url)
• goBack()
• isPresent(By)
• getAttribute(By, attribute)
• etc.

In-line validations

This is one of the most important features that I want to accentuate.

• validateText
• validateTextNot
• validateChecked
• validateUnchecked
• validatePresent
• validateNotPresent
• validateTextPresent
• validateTextNotPresent

All of these methods are able to be called in-line, and fluently without ever having to break your tests.

Switching Windows

Another nice feature that is offered, is the simplicity of window switching in Selenium.

• switchToWindow(regex)
• waitForWindow(regex)
• closeWindow(regex)

All of these functions take a regular expression argument, and match either the url or title of the window that you want to interact with.

Switching Frames

• switchToFrame(idOrName)
• switchToDefaultContent()

Implicit Waiting

In addition to the Selenium 2 implicit waiting, the AutomationTest class extends on this concept by implenting a sort of waitFor functionality which ensures that an object appears before interacting with it. This rids of most ElementNotFound exceptions that Selenium will cough up.

See a working example of what a test script written using this framework might look like.

Pull requests

If you have an idea for the framework, fork it and submit a pull-request!