- Notifications
You must be signed in to change notification settings - Fork21
Easy Espresso UI testing for Android applications using RxJava.
License
novoda/rxpresso
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
No maintainance is intended.
Easy Espresso UI testing for Android applications using RxJava.
RxPresso makes testing your presentation layer using RxJava as easy as a Unit test.
RxPresso usesMockito to generate mocks of your repositories that you can use with RxPresso to control data in your Espresso tests.The binding with Espresso Idling resource is handled for you so Espresso will wait until the data you expect to inject in your UIhas been delivered to you UI.
No more data you don't control in your Espresso test.
This project is in its early stages, feel free to comment, and contribute back to help us improve it.
To integrate RxPresso into your project, add the following at the beginning of thebuild.gradle of your project:
buildscript { repositories { jcenter() } dependencies { androidTestCompile'com.novoda:rxpresso:0.2.0' }}To generate a mocked repo simply use Mockito.
Example repository
publicinterfaceDataRepository {Observable<User>getUser(Stringid);Observable<Articles>getArticles();}
Mocking this repository
DataRepositorymockedRepo =Mockito.mock(DataRepository.class)
You should then replace the repository used by your activities by this mocked one.If you use Dagger or Dagger2 you can replace the module by a test one providing the mock.If your repo lives in the application class you can have a setter or user reflection to set it during tests.Any other option as long as your UI reads from the mocked repo.
Set up RxPresso in your tests
DataRepositorymockedRepo =getSameRepoUsedByUi();RxPressorxpresso =RxPresso.from(mockedRepo);Espresso.registerIdlingResources(rxPresso);
Use it to inject data in your UI
rxPresso.given(mockedRepo.getUser("id")) .withEventsFrom(Observable.just(newUser("some name"))) .expect(any(User.class)) .thenOnView(withText("some name")) .perform(click());
Use it to inject data from local sources
Observable<User>testAssetObservable =testAssetRepo.getUser("id");rxPresso.given(mockedRepo.getUser("id")) .withEventsFrom(testAssetObservable) .expect(any(User.class)) .thenOnView(withText("some name")) .perform(click());
Use custom matchers
Observable<User>testAssetObservable =testAssetRepo.getUser("id");rxPresso.given(mockedRepo.getUser("id")) .withEventsFrom(testAssetObservable) .expect(newRxMatcher<Notification<User>>() {@Overridepublicbooleanmatches(Notification<User>actual) {returnactual.getValue().name().equals("some name"); }@OverridepublicStringdescription() {return"User with name " +"some name"; } }) .thenOnView(withText("some name")) .perform(click());
Use it to inject errors in your UI
rxPresso.given(mockedRepo.getUser("id")) .withEventsFrom(Observable.error(newCustomError())) .expect(anyError(User.class,CustomError.class)) .thenOnView(withText("Custom Error Message")) .matches(isDisplayed());
Reset mocks between tests
rxPresso.resetMocks();
You can also use RxPresso with multiple repositories.Just setup using all the repositories your UI is using.The usage doesn't change RxPresso will detect from what repo the observable provided comes from and send the data to the correct pipeline.
Setup with multiple repositories
DataRepositorymockedRepo =getSameRepoUsedByUi();AnotherDataRepositorymockedRepo2 =getSameSecondRepoUsedByUi();RxPressorxpresso =RxPresso.from(mockedRepo,mockedRepo2);Espresso.registerIdlingResources(rxPresso);
Here are a list of useful links:
- We always welcome people to contribute new features or bug fixes,here is how
- If you have a problem check theIssues Page first to see if we are working on it
- Looking for community help, browse the already askedStack Overflow Questions or use the tag:
support-rxpressowhen posting a new question
About
Easy Espresso UI testing for Android applications using RxJava.