CulebraTester

Welcome to CulebraTester.

Android testing can be complicated, time-consuming, and tedious. What if it didn’t have to be? CulebraTester provides a real-time point and click test recording through a web browser. This browser is connected to the Android device under test. Not sure what we mean?

Here’s how CulebraTester works.

Why CulebraTester?

The tests that are generated:

cover real-world as well as edge case user scenarios
are repeatable
are scalable
are human-readable and editable
are written in Java for use with UiAutomator (also in python, kotlin, javascript, espresso, etc.)
can be used across different devices and device types
can be wrapped and integrated into test suites

CulebraTester makes writing tests for Android interesting. The user scenario can simply be intuitively executed one time via the UI itself on one instance of the application and then saved to be run forever across any installation on any device. This can be done for all scenarios, forming the basis of a suite of functional, performance, system, and integration test cases.

Polishing the Generated Tests

The test generated looks like the one you see above. It traces the recorded actions, including:

Events using as particular UiAutomator BySelectors as possible.
Intelligent swipes, drags, and other complex interactions - e.g. 'pressHome' - which include sleeps when necessary.
UiAutomator Test Class boilerplate.
A Java file which can be loaded directly into an Android Studio project and edited to add asserts.

The test created by Culebra with point-and-click interaction includes most of the labour-intensive UiDevice, UiObject, UiObject2 calls, as well as the BySelector, and UiSelectors with the correct values. From here, you the developer or test engineer can:

add assertions
customize or add complex if branches
add dependencies
customize sleep and wait times

About CulebraTester

A Culebra is a snake, and CulebraTester is snaky because it is small, and sometimes hidden, but still a dangerously powerful tool which can slither it's way into any Android application's dark corner. CulebraTester grew out of the AndroidViewClient Android testing toolkit project, and it's own python child: Culebra.

Want to learn more?
Technical details can be found in the CulebraTester wiki

Authors and Contributors

Culebra is developed and maintained by dtmilano, with help from awkasem and steve-the-edwards.

Support

We are currently in open beta, so if you are interested in participating of this programme please use this Opt-in URL.
Issues found can be reported at Github Issues