aost

Tellurium Automated Testing Framework

Tellurium Automated Testing Framework

Looking for Contributors

  • We are looking for a devoted and self-motivated developer with ambition and open source project management experience to be the joint project owner (but first start as a sub-project leader)
  • We are looking for a dedicated JavaScript expert as the Engine subproject leader
  • We are looking for a dedicated JavaScript expert as the Tellurium IDE subproject leader
  • We are looking for Java, Groovy, Javascript/jQuery developers, and technical writers to join our team.

Please email telluriumsource at gmail dot com if interested.

Latest Update

Introduction

The Tellurium Automated Testing Framework (Tellurium) is a UI module-based automated testing framework for web applications. The UI module is a collection of UI elements you group together. Usually, the UI module represents a composite UI object in the format of nested basic UI elements. For example, the Google search UI module can be expressed as follows,

ui.Container(uid: "GoogleSearchModule", clocator: [tag: "td"], group: "true"){ InputBox(uid: "Input", clocator: [title: "Google Search"]) SubmitButton(uid: "Search", clocator: [name: "btnG", value: "Google Search"]) SubmitButton(uid: "ImFeelingLucky", clocator: [value: "I'm Feeling Lucky"]) }

The UI module makes it possible to build UI elements' locators at run time. The framework does Object to Locator Mapping (OLM) automatically at run time so that you can define UI objects simply by their attributes, i.e., Composite Locators denoted by the "clocator". Furthermore, Tellurium uses the Group Locating Concept (GLC) to exploit information inside a collection of UI components to help finding their locators and the GLC is denoted by the "group" attribute in the above UI module.

The Tellurium framework defines a new Domain Specific Language (DSL) for web testing. Still take the above Google search module as an example, you can use the following DSLs to do a Google search,

type "GoogleSearchModule.Input", "Tellurium test" click "GoogleSearchModule.Search" waitForPageToLoad 30000

One very powerful feature of Tellurium is that you can use UI templates to represent many identical UI elements or dynamic size of different UI elements at runtime, which are extremely useful to test dynamic web such as a data grid. One typical data grid example is as follows,

ui.Table(uid: "table", clocator: [:]){ InputBox(uid: "{row: 1, column: 1} as Input", clocator: [:]) Selector(uid: "{row: all, column: 2}", clocator: [:]) UrlLink(uid: "{row: 3, column: all}", clocator: [:]) TextBox(uid: "{row: all, column: all}", clocator: [:]) }

Data Driven Testing is another important feature of Tellurium. You can define data format in an expressive way. In you data file, you can specify which test you want to run, the input parameters, and expected results. Tellurium automatically binds the input data to variables defined in your test script and run the tests you specified in the input file. The test results will be recorded by a test listener and output in different formats, for example, an XML file.

Tellurium UI Model Plugin (Trump) is a Firefox plugin to automatically create UI modules for users. Tellurium IDE is a Firefox plugin to record, generate, and run Tellurium DSL test scripts. TelluriumWorks is a Java Swing IDE to run Tellurium DSL test scripts.

In addition, Tellurium provides you the capability to composite UI objects into a Tellurium widget object. You can pack Tellurium widgets as a jar file and then use a Tellurium widget just like a single tellurium UI object once you include the jar file. As a result, Tellurium is robust, expressive, flexible, and reusable.

In summary, the main features of Tellurium include:

  • Abstract UI objects to encapsulate web UI elements
  • UI module for structured test code and re-usability
  • DSL for UI definition, actions, and testing
  • Composite Locator to use a set of attributes to describe a UI element
  • Group locating to exploit information inside a collection of UI components
  • Dynamically generate runtime locators to localize changes
  • UI templates for dynamic web content
  • XPath support
  • jQuery selector support to improve test speed in IE
  • Locator caching to improve speed
  • Javascript event support
  • Use Tellurium Firefox plugin, Trump, to automatically generate UI modules
  • Dojo and ExtJS widget extensions
  • Data driven test support
  • Selenium Grid support
  • JUnit and TestNG support
  • Ant and Maven support

The Tellurium Core is written in Groovy and Java. Tellurium Engine, Tellurium IDE, and Trump are implemented using JavaScript and jQuery. The test cases can be written in Java, Groovy, or pure DSL. You do not really need to know Groovy before you use it because the UI module definition and actions on UIs are written in DSLs and the rest could be written in Java syntax. Detailed User Guide, Frequent Asked Questions, and illustrative examples are provided. We expect and welcome your contributions.

For a quick start, please read Ten Minutes To Tellurium.

Tellurium Subprojects

Tellurium subprojects include UDL, Injector, Core, Reference projects, Widget extensions, TrUMP, Tellurium IDE, TelluriumWorks, and Engine projects as shown in the following diagram.

  • Tellurium UDL: Tellurium UID Description Language (UDL) grammars and parser.
  • Tellurium Injector: Groovy dependency injection module for Tellurium.
  • Tellurium Engine: Test driving engine with group locating, CSS selector, command bundle, and UI module caching support.
  • Tellurium Core: UI module, APIs, DSL, Object to Runtime Locator mapping, and test support.
  • Tellurium Extensions: Dojo Javascript widgets and ExtJS Javascript widgets.
  • Tellurium UI Module Plugin (Trump): A Firefox plugin to automatically generate the UI module after users select the UI elements from the web under testing.
  • Tellurium IDE: A Firefox plugin to record, generate, and run Tellurium DSL test scripts.
  • TelluriumWorks: A Java Swing IDE to run Tellurium DSL test scripts.
  • Tellurium Maven Archetypes: Maven archetypes to generate skeleton Tellurium JUnit and Tellurium TestNG projects using one Maven command.
  • Tellurium Reference Projects: Sample projects to illustrate how to use different features in Tellurium and how to create Tellurium test cases.

How to use Tellurium ?

There are three ways, i.e., use the reference project as a base, use Tellurium Maven archetype, or manually create Tellurium project using tellurium jar and Tellurium configuration file. Alternatively, you could create your own Tellurium Maven project manually using the sample POM file.

http://tellurium-users.googlegroups.com/web/HowToUseTellurium.png?gda=E2fneEcAAACXZPxEX7Ki-M5C2JpeBoXXwOvr7XA0t7SnOHKVzf4DhFd6vDxrTQI8X2xdNkWs9mIVeY4b49xGcMK802iZZ8SFeV4duv6pDMGhhhZdjQlNAw&gsc=YyVqmwsAAABmHtz3tZj6NRBcOVGYgXTk

Tellurium Maven Repository

Tellurium supports Maven 2 and here is the guide on how to use Maven for Tellurium.

Tellurium snapshots can be found at our Maven snapshot repository and the releases are at our Maven release repository. The customized Selenium server and some other dependencies are at our Maven third party repository.

Tellurium provides two Maven archetypes, tellurium-junit-archetype and tellurium-testng-archetype for Tellurium JUnit and TestNG project, respectively. You can use one Maven command to create a new Tellurium test project.

Tellurium 0.8.0 core snapshots are at

http://maven.kungfuters.org/content/repositories/snapshots/org/telluriumsource/tellurium-core/0.8.0-SNAPSHOT/

Custom Selenium Server 1.0.1-te5 snapshots with Tellurium Engine are at

http://maven.kungfuters.org/content/repositories/snapshots/org/seleniumhq/selenium/server/selenium-server/1.0.1-te5-SNAPSHOT/

Tellurium IDE 0.8.0 snapshots are at

http://maven.kungfuters.org/content/repositories/snapshots/org/telluriumsource/tellurium-ide/0.8.0-SNAPSHOT/

Trump 0.8.0 snapshots are at

http://maven.kungfuters.org/content/repositories/snapshots/org/telluriumsource/trump/0.8.0-SNAPSHOT/

Videos and Presentations

Tellurium Support

If you have any questions or problems with Tellurium, please join our Tellurium user group and then post them there. You will get the response very shortly.

Acknowledgments

Special thanks to JetBrains for providing us the Open Source License for IntelliJ IDEA.

Special thanks to ej-technologies for providing us the Open Source License for JProfiler.

Special Thanks to AquaFold for providing us the Open Source Software Developer License of Aqua Data Studio.

News

Project Information

Labels:
Groovy Selenium JUnit Java DSL Griffon DataDriven JQuery Firefox TestNG Maven Ant Web Testing AntLR3