Git Product home page Git Product logo

latte's Introduction

License

Latte

Latte is a lightweight and easy to use UI testing framework for Android utilizing Kotlin DSL.

Features

  • Has a very small footprint
  • Is a standalone framework
  • Utilizes Kotlin DSL
  • Uses Android API for matching, interactions and verifications
  • Narrows the scope of matches, interactions and verifications to a given type of View
  • Enables easy debugging of View's current state
  • Gives a fine grained control over view matching process
  • Provides a separate library artifact with helper interactions and verifications

Requirements

  • Minimum Android SDK: 21
  • Compile Android SDK: 34 or later

Setup

In {root}/build.gradle add:

allprojects {
    repositories {
        maven {
            url "https://maven.pkg.github.com/malloth/latte"
        }
    }
}

In {module}/build.gradle add:

dependencies {
    androidTestImplementation "pl.codesamurai.latte:core:{LATEST_VERSION}"
    androidTestImplementation "pl.codesamurai.latte:core-ktx:{LATEST_VERSION}"
}

For current {LATEST_VERSION} please check GitHub's releases tab.

Usage

Matching View of a specific type:

val viewMatcher: (View) -> Boolean = { /* matching view's conditions */ }

match(viewMatcher)

Ensuring that no matching Views exists in the view hierarchy:

val viewMatcher: (View) -> Boolean = { /* matching view's conditions */ }

noMatch(viewMatcher)

Performing actions with matched View:

val viewMatcher: (View) -> Boolean = { /* matching view's conditions */ }

match(viewMatcher) {
    // actions performed on a view(s)
}

Verifying View's expected state:

val viewMatcher: (View) -> Boolean = { /* matching view's conditions */ }

match(viewMatcher) {
    verify {
        // assertion(s) performed on a view(s)
    }
}

or

// GIVEN
val viewMatcher: (View) -> Boolean = { /* matching view's conditions */ }

// WHEN
val matching = match(viewMatcher) {
    // actions performed on a view(s)
}

// THEN
matching.verify {
    // assertion(s) performed on a view(s)
}

Sample use case matching EditText with an id R.id.edit1:

// GIVEN
val editTextWithId: (EditText) -> Boolean = { id == R.id.edit1 }

// WHEN
val matching = match(editTextWithId) {
    tap()
    type("123")
}

// THEN
matching.verify {
    isFocused && hasText("123")
}

Sample

Inside this repository there's a sample app module with a couple of UI tests, showing how to write those using this framework.

To run all the tests:

./gradlew :sample:pixel2DebugAndroidTest

latte's People

Contributors

malloth avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.