Android Espresso made more fluent :coffee:
Check out my blog :squirrel: or say hi on Twitter.
Cortado provides a layer of abstraction above Espresso, so it's a bit easier to use.
Remember: It is Google Espresso underneath. You can still mess up your tests the same way you would when using pure Espresso. Cortado just gives you a bit nicer way to communicate with Espresso.
Get a Matcher
for clickable
views with R.id.text
and with text NOT "Example"
Framework | Code example |
---|---|
Espresso | Matchers.allOf(withId(R.id.text), isClickable(), Matchers.not(withText("Example"))); |
Cortado | Cortado.view().withId(R.id.text).and().isClickable().and().not().withText("Example"); |
Get a Matcher
for views that have text example
or have parent FrameLayout
Framework | Code example |
---|---|
Espresso | Matchers.anyOf(withText("example"), withParent(isAssignableFrom(FrameLayout.class))); |
Cortado | Cortado.view().withText("example").or().withParent(isAssignableFrom(FrameLayout.class)); |
Click on a View
with R.id.button
Framework | Code example |
---|---|
Espresso | Espresso.onView(withId(R.id.button)).perform(ViewActions.click()); |
Cortado | Cortado.onView().withId(R.id.button).perform().click(); |
Check if a View
with text example
is visible
Framework | Code example |
---|---|
Espresso | Espresso.onView(withText("example")).check(ViewAssertions.matches(isDisplayed())); |
Cortado | Cortado.onView().withText("example").check().matches(isDisplayed()); |
Replace a text on enabled
view with R.id.edit
Framework | Code example |
---|---|
Espresso | Espresso.onView(Matchers.allOf(withId(R.id.edit),isEnabled())).perform(ViewActions.replaceText("changed")); |
Cortado | Cortado.onView().withId(R.id.edit).and().isEnabled().perform().replaceText("changed"); |
Creating an instance of org.hamcrest.Matcher<View>
org.hamcrest.Matcher<View> matcher = Cortado.view().withId(R.id.example);
Creating an instance of android.support.test.espresso.ViewInteraction
ViewInteraction viewInteraction = Cortado.onView().withId(R.id.example).perform(click());
Fluently creating Matchers.allOf(...)
Cortado.view().withId(R.id.example).and().withText("example").and().isClickable();
Fluently creating Matchers.anyOf(...)
Cortado.view().withId(R.id.example).or().withText("example").or().isClickable();
Fluently negating conditions
Cortado.view().not().withId(R.id.example).and().withText("example").and().not().isClickable();
Fluently performing single action (on ViewInteraction
)
Cortado.onView().withId(R.id.example).perform().click();
Fluently checking matches (on ViewInteraction
)
Cortado.onView().withId(R.id.example).check().matches(Cortado.view().withText("example"));
I wanted the api of Cortado to be compatible with Espresso as much as possible. That's why you can do stuff like that:
Espresso.onView(Cortado.view().withId(R.id.example).and().withText("Example")).perform(click());
dependencies {
androidTestImplementation 'com.bartoszlipinski:cortado:1.2.0'
}
Copyright 2017 Bartosz Lipiński
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.