Get started Working with the TestProject Test Automation Platform

Test automation is a key component of a software development project. Using test automation, developers test their web and mobile software projects to identify bugs and assess the performance of applications. While large enterprises have the budgets and expertise to test their software on a wide array of platforms, browsers, and devices, small and medium companies don't have that luxury. This is where TestProject IO comes to the rescue.

An overview of TestProject

TestProject is the world's first community-powered cloud platform that offers end-to-end test automation solutions for businesses of all sizes. The platform supports multiple platforms such as iOS, Android, Windows, Mac, Linux, Webservices, etc. It allows you to integrate Selenium and Appium for mobile automation testing purposes.

Though the tool is free and open-source, it is a feature-rich platform. It enables you to schedule your tests on any browser or device and record the tests using a cloud recorder. Using customized reports, you can analyze each test and perform analytics. It can also be integrated into your CI/CD tools such as Jenkins. In addition, you can extend your test project environment with 3rd party tools using REST API and other add-ons.

The tool is simple and easy to install and use. There is a minimal learning curve. It actually removes all the complexities involved in the installation and configuration of mobile automation tools such as Appium. By simply installing a .exe file, you can get access to a wealth of testing resources.

TestProject History and Key Features

TestProject was developed by a vibrant team composed of Vitaly Bukhovsky, Mark Kardashov, Eldar Kravetsky, and Marat Strelets. While the test automation platform was developed in 2015, it was launched for the public in April 2018.

Key Features

• Use the recorder tool for a codeless test or use TestProject SDK to write your own test scripts.
• Add team members to your project and seamlessly collaborate with them in real-time.
• Manage all test projects from a single dashboard.
• Use the reporting and analytics features to generate different types of test reports.
• Automate and run test scripts on local as well as remote environments.
• Integrate the project with your CI/CD tools such as Jenkins and Slack using REST API.
• Extend the recording feature using various add-ons.

Installation

Step 1: Create an Account

To begin using the tool, create a free account on the website.

Visit the link here: https://testproject.io

Click on the signup link and provide the required details. You will receive a confirmation email. Click on the link to confirm your email and activate your account. After confirming your email, login to the app.

TestProject offers two options. You can use a codeless recorder or create tests by coding. With the codeless test, you don't need to write a single line of code. You can record actions on your browser and the tool will generate the required Appium and Selenium code. Alternatively, you can write your own code.

Step 2: Install the Agent

After selecting the ‘Create Tests by Coding' option, you need to download and install the TestProject Agent. The next screen will provide the link to download the agent. Select your platform (Windows/Linux/Mac OS X) and download the agent tool.

After the tool gets downloaded, double-click it to begin the installation procedure.

Accept the license agreement on the next screen.

On the next screen, choose the components you want to install.

On the next screen, choose the installation folder and click next. You can choose to add it to the start menu on the next screen. Click next to begin the installation.

After the installation is completed, you will get a message that the Setup was completed successfully. Click Finish.

Now, the agent is successfully installed on your machine.

Step 3: Connect the Agent with the TestProject Platform

After installing the agent on your local machine, you need to connect it with the TestProject platform. To do so, open the agent and it will automatically connect with the servers.

Step 4: Acquire the Developer Key

To run test automation scripts on the cloud platform, you need to acquire a developer key. After the agent connects to the server, it will provide a developer key. Copy the key and save it on your machine.

Choose the Software Development Kit (SDK). Test Project offers Java, Python, and C# SDKs.

Now, the dashboard is ready. You can create tests and run them.

 

Run your First Test

To create your first test, log in to the TestProject platform, and click on New test.

On the next screen, select the type of test (eg: mobile/web/code). The web is selected for this demo.

Click on Create a new project.

Provide the name and details of the project and click Create.

Click next. On the next screen, provide a name and description of the test.

On the next screen, select the web application for testing. When you run the test for the first time, you need to add a new web application. For this demo, the Google site is selected.

On the next screen, select the web application (eg; Google1) and click next.

On the next screen, you will see 3 options. (Record, Edit, Blank Test). For this demo, let us look at the Record option. With this option, you can directly perform actions on the browser or the device and record the tasks. The tool records the actions and automatically generates the Appium/Selenium code.

Select Record and click on Start recording.

The TestProject agent will open the browser and open the Google website. In the search box, type ‘Experitest' and press enter. Google will display search results for the keyword ‘Experitest'. Close the browser.

As you perform each action, the tool will automatically create steps and generate code.

Now, go to the dashboard. You can see the test under your Tests tab. Click on Run. It will run the test.

On the next screen, choose the browser of your choice.

Click Next and Run.

The test case will open the Agent browser, open Google, search for Experitest keyword, and closes the browser.

You can check the report to see how the test ran.

On the right side, you can see the actions performed as well. You can also download the PDF to see the full execution report.

So, you can run any number of tests using the record feature without writing a single line of code. You can also download the code that is generated by the tool.

Click on three dots ‘…' and select the ‘Generate Code' option.

On the next screen, choose the programming language, browser, and the package name and click on Generate.

When you click on Generate, the code is downloaded in a .zip format.

Writing your own code

While novice users can use the Record option to run tests, advanced users can write their own code using the TestProject SDK. The platforms support three programming SDKs, Java, C#, and Python.

Java SDK is used for this demo.

Here are the steps to run your code using Java SDK.

Step 1: Ensure Java is installed

To run test scripts using Java SDK, you should install Java on your machine. Go to Command Prompt and type the following command to check if Java is installed and running on your machine.

• Java –version

If you don't have Java installed on your machine, you can download and install it from this link:

https://www.oracle.com/in/java/technologies/javase-downloads.html

Step 2: Configure Environment Variables

After java is installed, you need to configure Environment variables in the Advanced System Settings by adding the Java path under ‘User variables' and Java bin folder path under the ‘System Variables'.

Step 3: Install Eclipse

To run your test scripts, you need to install an IDE such as Eclipse, IntelliJ, VS Code etc. You can download and install Eclipse from this link:

https://www.eclipse.org/downloads/

Step 4: Install Build Tool

To automate build processes, you need to install a build tool such as Maven, Gradle or Ant. Visit this link to download Gradle:

https://gradle.org/install/

Step 5: Add Gradle Path to Environment Variables

After downloading Gradle, save it on your machine and add that path to the Environment variables.

Step 6: Log in to TestProject platform

Now, login to the TestProject platform.

Step 7: Start the TestProject Local Agent

Double-click the TestProject local agent and wait till it gets started. You can check in the TestProject dashboard if the agent is running or not.

Step 8: Create your First Test

Now that the test automation environment is ready, you can create your first test.

To do so, open Eclipse. Click on File -> New -> Project

On the next screen, select the Gradle project and click next.

Enter a name for the Gradle project and click finish.

Now, Eclipse creates a Gradle project. Go to Project Explorer and double-click on the build.Gradle file to open it in the editor window.

Now, add the following code to the build.Gradle file. (Java SDK implementation)

• implementation 'io.testproject:java-sdk:0.64.0-RELEASE'

Now, create a new class under src\test\java.

Provide a name and click finish.

Now, add the following code to the Java class file (Experitest1.java).

[java] package ExperiGradle; import io.testproject.sdk.drivers.web.ChromeDriver; import org.openqa.selenium.By; import org.openqa.selenium.chrome.ChromeOptions; public class Experitest1 { public static void main(final String[] args) throws Exception { ChromeDriver driver = new ChromeDriver("Enter your Developer key here", new ChromeOptions()); // Navigate to TestProject Example website driver.navigate().to("https://example.testproject.io/web/"); // Login using provided credentials driver.findElement(By.cssSelector("#name")).sendKeys("John Smith"); driver.findElement(By.cssSelector("#password")).sendKeys("12345"); driver.findElement(By.cssSelector("#login")).click(); boolean passed = driver.findElement(By.cssSelector("#logout")).isDisplayed(); if (passed) { System.out.println("Test Passed"); } else { System.out.println("Test Failed"); } driver.quit(); } } [/java]

When you run the test, it will initiate the Chrome browser from the TestProject platform, opens the test website, performs a login task, and closes the browser.

So, the test has passed. Now, you can write your test scripts and execute them on different browsers and devices offered by the TestProject platform.

Summary

TestProject platform is the world's first community-powered cloud platform for test automation projects. Using this platform, developers can perform test automation on a wide range of platforms, devices, and environments. Built on top of Selenium and Appium, Most importantly, TestProject supports all major browsers and devices. With a large and active community, you can always reach out for help.

Guy Arieli - CTO