SHAFT: Unified Test Automation Engine

Fully documented	Award Winning	Selenium Ecosystem

🏃 Quick Start Guide

Option 1: Maven Archetype

(Recommended for new local sandbox projects)

• The easiest and most straightforward way to create a new project that uses SHAFT.
• Just follow the simple steps here to generate your new project with one command (all configurations included).

Option 2: Template Project

(Recommended for new source controlled projects)

• Use our Template Project to create a new project with one click.
• Follow the steps in the ReadMe to handle project configuration.

Option 3: Start from scratch

(Recommended if you're upgrading an existing project from Native Selenium WebDriver to SHAFT)

Step 1: Initial Setup

• Create a new Java/Maven project using Eclipse, IntelliJ or your favourite IDE.
• Copy the highlighted contents of this pom.xml file into yours inside the <project> tag.
• Follow the steps in this footnote in case you are using IntelliJ[^1].

Step 2: Creating Tests

• Create a new Package TestPackage under src/test/java and create a new Java Class TestClass under that package.
• Copy the below imports into your newly created java class.

import com.shaft.driver.SHAFT;
import org.openqa.selenium.By;
import org.openqa.selenium.Keys;
import org.testng.annotations.AfterClass;
import org.testng.annotations.BeforeClass;
import org.testng.annotations.Test;

• Copy the below code snippet into your newly created java class.

SHAFT.GUI.WebDriver driver;
SHAFT.TestData.JSON testData;

By searchBox = By.name("q");
By resultStats = By.id("result-stats");

@Test
public void test() {
    driver.browser().navigateToURL("https://www.google.com/");
    driver.verifyThat().browser().title().isEqualTo("Google").perform();
    driver.element().type(searchBox, testData.getTestData("searchQuery"))
            .keyPress(searchBox, Keys.ENTER);
    driver.assertThat().element(resultStats).text().doesNotEqual("")
            .withCustomReportMessage("Check that result stats is not empty").perform();
}

@BeforeClass
public void beforeClass() {
    driver = new SHAFT.GUI.WebDriver();
    testData = new SHAFT.TestData.JSON("simpleJSON.json");
    }

@AfterClass(alwaysRun = true)
public void afterClass(){
        driver.quit();
    }

Step 3: Managing Test Data

• Create the following file src/test/resources/testDataFiles/simpleJSON.json.
• Copy the below code snippet into your newly created json file.

{
  "searchQuery": "SHAFT_Engine"
}

Step 4: Running Tests

• Run your TestClass.java as a TestNG Test Class.
• The execution report will open automatically in your default web browser after the test run is completed.
• Join our to get notified by email when a new release is pushed out.
• After upgrading your Engine to a new major release it is sometimes recommended to delete the properties folder src\main\resources\properties and allow SHAFT to regenerate the defaults by running any test method. [^1]: If you're using Cucumber due to a known issue with IntelliJ you need to edit your run configuration template before running your tests by following these steps:
  - Open 'Edit Run/Debug Configurations' dialog > Edit Configurations... > Edit configuration templates...
  - Select Cucumber Java > Program Arguments > and add this argument:
  --plugin com.shaft.listeners.CucumberFeatureListener
  - After saving the changes, remember to delete any old runs you may have triggered by mistake before adding the needed config.

📚 User Guide

• Check out our comprehensive user guide for details on the features we support.

👨‍💻 Tech Stack

🦸 Powered by

🙏 Big thanks for the open source licenses and support

🤝 Support & Contributions

• Join us via Slack & Facebook
  
• And feel free to create PRs directly. This lovely tutorial will help.

🌍 Who else is using SHAFT? [^4]

[^4]: Company names are collected via anonymous surveys and provided freely by engineers who claimed to be using SHAFT_Engine within these companies.

Stop Reinventing the wheel! Start using SHAFT!