RxJava 3.x Espresso Idling Resources

RxJava Espresso IdlingResources

License

License

Categories

Categories

Square Business Logic Libraries Financial
GroupId

GroupId

com.squareup.rx.idler
ArtifactId

ArtifactId

rx3-idler
Last Version

Last Version

0.11.0
Release Date

Release Date

Type

Type

aar
Description

Description

RxJava 3.x Espresso Idling Resources
RxJava Espresso IdlingResources
Project URL

Project URL

https://github.com/square/RxIdler/
Source Code Management

Source Code Management

https://github.com/square/RxIdler/

Download rx3-idler

How to add to project

<!-- https://jarcasting.com/artifacts/com.squareup.rx.idler/rx3-idler/ -->
<dependency>
    <groupId>com.squareup.rx.idler</groupId>
    <artifactId>rx3-idler</artifactId>
    <version>0.11.0</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.squareup.rx.idler/rx3-idler/
implementation 'com.squareup.rx.idler:rx3-idler:0.11.0'
// https://jarcasting.com/artifacts/com.squareup.rx.idler/rx3-idler/
implementation ("com.squareup.rx.idler:rx3-idler:0.11.0")
'com.squareup.rx.idler:rx3-idler:aar:0.11.0'
<dependency org="com.squareup.rx.idler" name="rx3-idler" rev="0.11.0">
  <artifact name="rx3-idler" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.squareup.rx.idler', module='rx3-idler', version='0.11.0')
)
libraryDependencies += "com.squareup.rx.idler" % "rx3-idler" % "0.11.0"
[com.squareup.rx.idler/rx3-idler "0.11.0"]

Dependencies

compile (3)

Group / Artifact Type Version
androidx.annotation » annotation jar 1.1.0
io.reactivex.rxjava3 : rxjava jar 3.0.3
androidx.test.espresso » espresso-core jar 3.1.0

Project Modules

There are no modules declared in this project.

RxIdler

An IdlingResource for Espresso which wraps an RxJava Scheduler.

Usage

Set the wrapping functions as the delegate for handling scheduler initialization to RxJava:

  • RxJava 3.x:

    RxJavaPlugins.setInitComputationSchedulerHandler(
        Rx3Idler.create("RxJava 3.x Computation Scheduler"));
    RxJavaPlugins.setInitIoSchedulerHandler(
        Rx3Idler.create("RxJava 3.x IO Scheduler"));
    // etc...
  • RxJava 2.x:

    RxJavaPlugins.setInitComputationSchedulerHandler(
        Rx2Idler.create("RxJava 2.x Computation Scheduler"));
    RxJavaPlugins.setInitIoSchedulerHandler(
        Rx2Idler.create("RxJava 2.x IO Scheduler"));
    // etc...
  • RxJava 1.x:

    RxJavaPlugins.getInstance().registerSchedulersHook(RxIdler.hooks());

When that Scheduler is first accessed via Schedulers, the RxIdler function will wrap it with an Espresso IdlingResource and side-effect by registering it to the Espresso class.

This code is most frequently put in a custom test runner's onStart() method:

public final class MyTestRunner extends AndroidJUnitRunner {
  @Override public void onStart() {
    RxJavaPlugins.setInitComputationSchedulerHandler(
        Rx3Idler.create("RxJava 3.x Computation Scheduler"));
    // etc...
    
    super.onStart();
  }
}

If you have custom Scheduler implementations you can wrap them directly and then register them with Espresso:

  • RxJava 3.x:

    IdlingResourceScheduler wrapped = Rx3Idler.wrap(myScheduler, "My Scheduler");
    IdlingRegistry.getInstance().register(wrapped);
    // Use 'wrapped' now instead of 'myScheduler'...
  • RxJava 2.x:

    IdlingResourceScheduler wrapped = Rx2Idler.wrap(myScheduler, "My Scheduler");
    IdlingRegistry.getInstance().register(wrapped);
    // Use 'wrapped' now instead of 'myScheduler'...
  • RxJava 1.x:

    IdlingResourceScheduler wrapped = RxIdler.wrap(myScheduler, "My Scheduler");
    IdlingRegistry.getInstance().register(wrapped);
    // Use 'wrapped' now instead of 'myScheduler'...

Ensure that you provide unique name for your wrapped schedulers as Espresso will ignore multiple idling resources registered with the same name.

Download

  • RxJava 3.x:

    dependencies {
      androidTestImplementation 'com.squareup.rx.idler:rx3-idler:0.11.0'
    }
  • RxJava 2.x:

    dependencies {
      androidTestImplementation 'com.squareup.rx.idler:rx2-idler:0.11.0'
    }
  • RxJava 1.x:

    dependencies {
      androidTestImplementation 'com.squareup.rx.idler:rx1-idler:0.11.0'
    }

Snapshots of the development version are available in Sonatype's snapshots repository.

ProGuard

If you use ProGuard on Espresso test builds, you may need to add the following rules into your ProGuard configuration.

RxJava 3.x:

-keep class io.reactivex.rxjava3.plugins.RxJavaPlugins { *; }
-keep class io.reactivex.rxjava3.disposables.CompositeDisposable { *; }

RxJava 2.x:

-keep class io.reactivex.plugins.RxJavaPlugins { *; }
-keep class io.reactivex.disposables.CompositeDisposable { *; }

RxJava 1.x:

-keep class rx.plugins.RxJavaPlugins { *; }
-keep class rx.subscriptions.CompositeSubscription { *; }

License

Copyright 2017 Square, Inc.

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.
com.squareup.rx.idler

Square

Versions

Version
0.11.0