Packages

trait TestRandom extends Restorable

TestRandom allows for deterministically testing effects involving randomness.

TestRandom operates in two modes. In the first mode, TestRandom is a purely functional pseudo-random number generator. It will generate pseudo-random values just like scala.util.Random except that no internal state is mutated. Instead, methods like nextInt describe state transitions from one random state to another that are automatically composed together through methods like flatMap. The random seed can be set using setSeed and TestRandom is guaranteed to return the same sequence of values for any given seed. This is useful for deterministically generating a sequence of pseudo-random values and powers the property based testing functionality in ZIO Test.

In the second mode, TestRandom maintains an internal buffer of values that can be "fed" with methods such as feedInts and then when random values of that type are generated they will first be taken from the buffer. This is useful for verifying that functions produce the expected output for a given sequence of "random" inputs.

import zio.Random
import zio.test.TestRandom

for {
  _ <- TestRandom.feedInts(4, 5, 2)
  x <- Random.nextIntBounded(6)
  y <- Random.nextIntBounded(6)
  z <- Random.nextIntBounded(6)
} yield x + y + z == 11

TestRandom will automatically take values from the buffer if a value of the appropriate type is available and otherwise generate a pseudo-random value, so there is nothing you need to do to switch between the two modes. Just generate random values as you normally would to get pseudo-random values, or feed in values of your own to get those values back. You can also use methods like clearInts to clear the buffer of values of a given type so you can fill the buffer with new values or go back to pseudo-random number generation.

Linear Supertypes
Restorable, Serializable, AnyRef, Any
Known Subclasses
Test
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TestRandom
  2. Restorable
  3. Serializable
  4. AnyRef
  5. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Abstract Value Members

  1. abstract def clearBooleans(implicit trace: ZTraceElement): UIO[Unit]
  2. abstract def clearBytes(implicit trace: ZTraceElement): UIO[Unit]
  3. abstract def clearChars(implicit trace: ZTraceElement): UIO[Unit]
  4. abstract def clearDoubles(implicit trace: ZTraceElement): UIO[Unit]
  5. abstract def clearFloats(implicit trace: ZTraceElement): UIO[Unit]
  6. abstract def clearInts(implicit trace: ZTraceElement): UIO[Unit]
  7. abstract def clearLongs(implicit trace: ZTraceElement): UIO[Unit]
  8. abstract def clearStrings(implicit trace: ZTraceElement): UIO[Unit]
  9. abstract def clearUUIDs(implicit trace: ZTraceElement): UIO[Unit]
  10. abstract def feedBooleans(booleans: Boolean*)(implicit trace: ZTraceElement): UIO[Unit]
  11. abstract def feedBytes(bytes: Chunk[Byte]*)(implicit trace: ZTraceElement): UIO[Unit]
  12. abstract def feedChars(chars: Char*)(implicit trace: ZTraceElement): UIO[Unit]
  13. abstract def feedDoubles(doubles: Double*)(implicit trace: ZTraceElement): UIO[Unit]
  14. abstract def feedFloats(floats: Float*)(implicit trace: ZTraceElement): UIO[Unit]
  15. abstract def feedInts(ints: Int*)(implicit trace: ZTraceElement): UIO[Unit]
  16. abstract def feedLongs(longs: Long*)(implicit trace: ZTraceElement): UIO[Unit]
  17. abstract def feedStrings(strings: String*)(implicit trace: ZTraceElement): UIO[Unit]
  18. abstract def feedUUIDs(UUIDs: UUID*)(implicit trace: ZTraceElement): UIO[Unit]
  19. abstract def getSeed(implicit trace: ZTraceElement): UIO[Long]
  20. abstract def save(implicit trace: ZTraceElement): UIO[UIO[Unit]]
    Definition Classes
    Restorable
  21. abstract def setSeed(seed: => Long)(implicit trace: ZTraceElement): UIO[Unit]

Concrete Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  6. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  7. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  9. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  10. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  11. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  12. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  13. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  14. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  15. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  16. def toString(): String
    Definition Classes
    AnyRef → Any
  17. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  18. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  19. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from Restorable

Inherited from Serializable

Inherited from AnyRef

Inherited from Any

Ungrouped