Introduction

APORT (Advance Page Object Resolver Toolkit) is a library for resolving of elements in a web page. It is built on top of Selenium2 WebDriver. it's purpose is to replace all the WebDriver.findElementBy() and related calls with declarative, annotation-based, description of the page.

Design Principles

• simple -- complexity is hidden inside the library
• small -- the library consist only of classes and interfaces related to resolving and form filling
• easy to use -- the API allows to create easy to understand, component-oriented, description of web pages
• flexible -- the library provides deferred resolving, dependency injection of resolved objects, form filling, ...

Documentation

Core Classes

examples

Below are links to commented examples of code using APORT APIs. They more or less describe the most used features, although not all.

For more examples please see unit tests in the project repository.

basic

simple page

advanced

• resolving lists
• resolving with placeholders

tutorial

1. Automating Google Search
2. Google Search with Widget

Needs Work

Features that lack documentation, tests or part of functionality:

• resolving fields with custom waits - no test, do documentation, tested manually -- ResolveBy.explicitWait
• placeholders in locators - no test, needs more documentation, tested manually -- Resolvable.placeholders
• loading data to forms - has simple test, works only on text inputs and selects -- Resolvable.loadData()
• querying resolved web elements - has test, not documented, usable mainly for debugging - class Find