Main Site: https://autonomx.io/

Documentation: https://docs.autonomx.io

Autonomx Core: https://github.com/autonomx/AutonomxCore

Autonomx

Autonomx provides a complete testing platform for UI (Web, iOS, Android, Win) and API testing. It provides a feature rich and viable testing solution for end to end testing. They’re designed to be fast, scalable, reliable and adaptable to any requirements for ever growing projects. 

Overview

• Open source UI automation testing framework based on Webdriver/Appium, TestNG/Junit, with maven integration.
• Unifies mobile and web testing, using a common, version controlled code base (Autonomx Core)
• Each testing project is treated as a client for the Autonomx Core, meaning one central code base for all UI testing projects
• A client can have multiple test projects, as well as multiple platforms (web, Android, iOS, Win), associated with it.
• Modular design. Each project/component is treated as a module,  fully capable of interacting with one another. This allows for multi component and multiplatform testing. Eg. Create user through component A (API), validate in component B (web), do action in component C (Android), validate results in component D (iOS)
• All interaction with the UI are through utility functions called Helpers, which are stable and optimized set of wrapper functions, removing inconsistencies in coding styles and enforcing testing best practices
• Integrates seamlessly with the API testing framework for end to end testing
• Detailed reports through ExtentTest reports

Prerequisites:

Web:

• Java jdk-1.8 or higher
• maven 3.3.x or higher (maven will automatically download by running setup.bat/sh script)
• https://docs.autonomx.io/prerequisites

Android:

• appium "npm install -g appium"
• Android SDK (for Android execution | with ANDROID_HOME and PATH configured)
• https://docs.autonomx.io/prerequisites/android
• https://docs.autonomx.io/getting-started/android-tests

iOS:

• appium
• XCode and an iPhone Simulator (for iOS execution)
• https://docs.autonomx.io/prerequisites/ios
• https://docs.autonomx.io/getting-started/ios-tests

IDE Setup

• For Intellij IDE, navigate to Intellij Setup Page: https://docs.autonomx.io/getting-started/ide/intellij
• For Eclipse IDE, navigate to Eclipse Setup Page: https://docs.autonomx.io/getting-started/ide/eclipse

Getting Started:

• Download the latest release of Autonomx based on your project needs
• Run the setup:
• setup.bat (windows), setup.sh (osx, linux)
• This will download maven if not installed, and all the required dependencies
• Navigate to runner//. eg. runner/mac/restTests.sh
• The run scripts are generated from testng testSuites by runner/generateScripts.sh. Each script is associated with a suite of tests
• https://docs.autonomx.io/quick-start

Reporting

• Extent Reports is used for BDD style reporting of the test results

Web Tests

• https://docs.autonomx.io/getting-started/web-tests
• Example project: Autonomx ▸ ⁨automation⁩ ▸ ⁨src⁩ ▸ ⁨main⁩ ▸ ⁨java⁩ ▸ ⁨modules⁩ ▸ ⁨webApp⁩
• Setup locators webApp ▸ LoginPanel.java

     public static class elements {
            public static EnhancedBy USER_NAME_FIELD = Element.byCss("[placeholder='John Doe']", "username field");
            public static EnhancedBy PASSWORD_FIELD = Element.byCss("#password", "password field");
            public static EnhancedBy LOGIN_SUBMIT = Element.byCss("[type='submit']", "submit button");
            public static EnhancedBy LOGOUT_BUTTON = Element.byCss("[href*='logout']", "logout button");
            public static EnhancedBy MAIN_SITE = Element.byCss(".main-site", "main site button");
            public static EnhancedBy ERROR_MESSAGE = Element.byCss("[class*='InputErrors']", "input errors");

            public static EnhancedBy LOADING_INDICATOR = Element.byCss("[class*='Loading']", "loading indicator");

        }

    

• Define actions webApp ▸ LoginPanel.java

        /**
      * enter login info and click login button
      * 
      * @param user
      */
     public void login(User user) {
         setLoginFields(user);
         Helper.form.formSubmit(elements.LOGIN_SUBMIT, MainPanel.elements.ADMIN_LOGO, elements.LOADING_INDICATOR);

     }

     public void loginError(User user) {
         setLoginFields(user);
         Helper.form.formSubmit(elements.LOGIN_SUBMIT, elements.ERROR_MESSAGE);
     }

     public void relogin(User user) {
         manager.main.logout();
         login(user);
     }

     public void setLoginFields(User user) {
         Helper.form.setField(elements.USER_NAME_FIELD, user.username().get());
         Helper.form.setField(elements.PASSWORD_FIELD, user.password().get());
     }

• Define objects

  • autonomx⁩ ▸ ⁨automation⁩ ▸ ⁨src⁩ ▸ ⁨main⁩ ▸ ⁨java⁩ ▸ ⁨module ▸ webApp ▸ user.csv
  • We are going to use the csv file to setup our data. For more info Csv

• setup test

     @BeforeMethod
     public void beforeMethod() throws Exception {
        setupWebDriver(app.webApp.getWebDriver());
    }

    @Test
    public void validate_user_Login() {
        UserObject user = UserObject.user().withAdminLogin();
        TestLog.When("I login with admin user");
        app.strapi.login.login(user);

        TestLog.Then("I verify admin logo is displayed");
        Helper.verifyElementIsDisplayed(MainPanel.elements.ADMIN_LOGO);

        TestLog.When("I logout");
        app.strapi.main.logout();

        TestLog.Then("I should see the login panel");
        Helper.verifyElementIsDisplayed(LoginPanel.elements.LOGIN_SUBMIT);
    }
    

Service Level Tests

• https://docs.autonomx.io/service-level-testing

  • Service level testing encompasses any backend, service, api, and database level testing
  • These tests are compromised of: request, response, and verification
  • Since these follow the same template, we have opted for using csv file to write the tests
  • 1 line 1 complete test
  • This allows us to add lots of tests to each csv file, covering large number of permutations

• Add Test cases in CSV file at apiTestData/testCases

• Run tests using the runner at apiTestData/runner//apiRunner

• CSV files will run in parallel

• Parallel run value can be set at automation/resources/properties.property "parallel_test_count"

Service Code Integration

• https://docs.autonomx.io/service-level-testing/service-code-integration

• We can run our service test with the UI based tests

• There are 2 methods of achieving this goal

  • Creating a service object and calling the service interface directly

  public Response loginWithServiceObject(CommonUser user) {
      
      ServiceObject loginApi = Service.create()
              .withUriPath("/auth/local")
              .withContentType("application/json")
              .withMethod("POST")
              .withRequestBody("{" + 
                      "\"identifier\": \""+ user.username +"\",\r\n" + 
                      "\"password\": \"" +user.password + "\"" + 
                      "}")
              .withOutputParams(
                      "user.role.id:<$roles>;"
                      + "jwt:<$accessTokenAdmin>;"
                      + "user.id:<$userId>");
              
      return RestApiInterface.RestfullApiInterface(loginApi);
  }

  • Creating a service keyword in a csv file and calling the test case name

  public void login(CommonUser user) {
      Service.getToken
              .withUsername(user.username)
              .withPassword(user.password)
              .build();
  }

Script Runner

• https://docs.autonomx.io/script-runner-1/installation
• Script Server will run the test suites on a web browser
• Script Server will run the tests defined in Test Suite