All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.scalacheck.Shrink.scala Maven / Gradle / Ivy

/*
 * ScalaCheck
 * Copyright (c) 2007-2021 Rickard Nilsson. All rights reserved.
 * http://www.scalacheck.org
 *
 * This software is released under the terms of the Revised BSD License.
 * There is NO WARRANTY. See the file LICENSE for the full text.
 */

package org.scalacheck

import scala.concurrent.duration.Duration
import scala.concurrent.duration.FiniteDuration

import util.Buildable
import util.SerializableCanBuildFroms.*

sealed abstract class Shrink[T] extends Serializable {
  def shrink(x: T): Stream[T]

  /** Create a new shrink that only produces values satisfying the given condition.
   */
  def suchThat(f: T => Boolean): Shrink[T] = Shrink(v => this.shrink(v).filter(f))
}

trait ShrinkLowPriority {

  /** Default shrink instance */
  implicit def shrinkAny[T]: Shrink[T] = Shrink(_ => Stream.empty)
}

object Shrink extends ShrinkLowPriority with ShrinkVersionSpecific with time.JavaTimeShrink {

  import Stream.{cons, empty}
  import scala.collection.*

  /** Interleaves two streams */
  private def interleave[T](xs: Stream[T], ys: Stream[T]): Stream[T] =
    if (xs.isEmpty) ys
    else if (ys.isEmpty) xs
    else cons(xs.head, cons(ys.head, interleave(xs.tail, ys.tail)))

  /** Shrink instance factory */
  def apply[T](s: T => Stream[T]): Shrink[T] = new Shrink[T] {
    override def shrink(x: T) = s(x)
  }

  /** Shrink a value */
  def shrink[T](x: T)(implicit s: Shrink[T]): Stream[T] = s.shrink(x)

  /** Shrink a value, but also return the original value as the first element in the resulting stream
   */
  def shrinkWithOrig[T](x: T)(implicit s: Shrink[T]): Stream[T] =
    cons(x, s.shrink(x))

  /** Shrink instance of container */
  implicit def shrinkContainer[C[_], T](implicit
      v: C[T] => Traversable[T],
      s: Shrink[T],
      b: Buildable[T, C[T]]
  ): Shrink[C[T]] = Shrink { (xs: C[T]) =>
    val ys = v(xs)
    val zs = ys.toStream
    removeChunks(ys.size, zs).append(shrinkOne(zs)).map(b.fromIterable)
  }

  /** Shrink instance of container2 */
  implicit def shrinkContainer2[C[_, _], T, U](implicit
      v: C[T, U] => Traversable[(T, U)],
      s: Shrink[(T, U)],
      b: Buildable[(T, U), C[T, U]]
  ): Shrink[C[T, U]] = Shrink { (xs: C[T, U]) =>
    val ys = v(xs)
    val zs = ys.toStream
    removeChunks(ys.size, zs).append(shrinkOne(zs)).map(b.fromIterable)
  }

  private def removeChunks[T](n: Int, xs: Stream[T]): Stream[Stream[T]] =
    if (xs.isEmpty) empty
    else if (xs.tail.isEmpty) cons(empty, empty)
    else {
      val n1 = n / 2
      val n2 = n - n1
      lazy val xs1 = xs.take(n1)
      lazy val xs2 = xs.drop(n1)
      lazy val xs3 =
        for (ys1 <- removeChunks(n1, xs1) if !ys1.isEmpty) yield ys1 append xs2
      lazy val xs4 =
        for (ys2 <- removeChunks(n2, xs2) if !ys2.isEmpty) yield xs1 append ys2

      cons(xs1, cons(xs2, interleave(xs3, xs4)))
    }

  private def shrinkOne[T: Shrink](zs: Stream[T]): Stream[Stream[T]] =
    if (zs.isEmpty) empty
    else {
      val x = zs.head
      val xs = zs.tail
      shrink(x).map(cons(_, xs)).append(shrinkOne(xs).map(cons(x, _)))
    }

  /** Shrink instances for numeric data types */

  implicit def shrinkFractional[T: Fractional]: Shrink[T] =
    new ShrinkFractional[T]

  implicit def shrinkIntegral[T: Integral]: Shrink[T] =
    new ShrinkIntegral[T]

  /** Shrink instance of String */
  implicit lazy val shrinkString: Shrink[String] = Shrink { s =>
    shrinkContainer[List, Char].shrink(s.toList).map(_.mkString)
  }

  /** Shrink instance of Option */
  implicit def shrinkOption[T: Shrink]: Shrink[Option[T]] = Shrink {
    case None => empty
    case Some(x) => cons(None, for (y <- shrink(x)) yield Some(y))
  }

  /** Shrink instance of 2-tuple */
  implicit def shrinkTuple2[
      T1: Shrink,
      T2: Shrink
  ]: Shrink[(T1, T2)] =
    Shrink { case (t1, t2) =>
      shrink(t1).map((_, t2)) append
        shrink(t2).map((t1, _))
    }

  /** Shrink instance of 3-tuple */
  implicit def shrinkTuple3[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink
  ]: Shrink[(T1, T2, T3)] =
    Shrink { case (t1, t2, t3) =>
      shrink(t1).map((_, t2, t3)) append
        shrink(t2).map((t1, _, t3)) append
        shrink(t3).map((t1, t2, _))
    }

  /** Shrink instance of 4-tuple */
  implicit def shrinkTuple4[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink
  ]: Shrink[(T1, T2, T3, T4)] =
    Shrink { case (t1, t2, t3, t4) =>
      shrink(t1).map((_, t2, t3, t4)) append
        shrink(t2).map((t1, _, t3, t4)) append
        shrink(t3).map((t1, t2, _, t4)) append
        shrink(t4).map((t1, t2, t3, _))
    }

  /** Shrink instance of 5-tuple */
  implicit def shrinkTuple5[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink,
      T5: Shrink
  ]: Shrink[(T1, T2, T3, T4, T5)] =
    Shrink { case (t1, t2, t3, t4, t5) =>
      shrink(t1).map((_, t2, t3, t4, t5)) append
        shrink(t2).map((t1, _, t3, t4, t5)) append
        shrink(t3).map((t1, t2, _, t4, t5)) append
        shrink(t4).map((t1, t2, t3, _, t5)) append
        shrink(t5).map((t1, t2, t3, t4, _))
    }

  /** Shrink instance of 6-tuple */
  implicit def shrinkTuple6[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink,
      T5: Shrink,
      T6: Shrink
  ]: Shrink[(T1, T2, T3, T4, T5, T6)] =
    Shrink { case (t1, t2, t3, t4, t5, t6) =>
      shrink(t1).map((_, t2, t3, t4, t5, t6)) append
        shrink(t2).map((t1, _, t3, t4, t5, t6)) append
        shrink(t3).map((t1, t2, _, t4, t5, t6)) append
        shrink(t4).map((t1, t2, t3, _, t5, t6)) append
        shrink(t5).map((t1, t2, t3, t4, _, t6)) append
        shrink(t6).map((t1, t2, t3, t4, t5, _))
    }

  /** Shrink instance of 7-tuple */
  implicit def shrinkTuple7[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink,
      T5: Shrink,
      T6: Shrink,
      T7: Shrink
  ]: Shrink[(T1, T2, T3, T4, T5, T6, T7)] =
    Shrink { case (t1, t2, t3, t4, t5, t6, t7) =>
      shrink(t1).map((_, t2, t3, t4, t5, t6, t7)) append
        shrink(t2).map((t1, _, t3, t4, t5, t6, t7)) append
        shrink(t3).map((t1, t2, _, t4, t5, t6, t7)) append
        shrink(t4).map((t1, t2, t3, _, t5, t6, t7)) append
        shrink(t5).map((t1, t2, t3, t4, _, t6, t7)) append
        shrink(t6).map((t1, t2, t3, t4, t5, _, t7)) append
        shrink(t7).map((t1, t2, t3, t4, t5, t6, _))
    }

  /** Shrink instance of 8-tuple */
  implicit def shrinkTuple8[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink,
      T5: Shrink,
      T6: Shrink,
      T7: Shrink,
      T8: Shrink
  ]: Shrink[(T1, T2, T3, T4, T5, T6, T7, T8)] =
    Shrink { case (t1, t2, t3, t4, t5, t6, t7, t8) =>
      shrink(t1).map((_, t2, t3, t4, t5, t6, t7, t8)) append
        shrink(t2).map((t1, _, t3, t4, t5, t6, t7, t8)) append
        shrink(t3).map((t1, t2, _, t4, t5, t6, t7, t8)) append
        shrink(t4).map((t1, t2, t3, _, t5, t6, t7, t8)) append
        shrink(t5).map((t1, t2, t3, t4, _, t6, t7, t8)) append
        shrink(t6).map((t1, t2, t3, t4, t5, _, t7, t8)) append
        shrink(t7).map((t1, t2, t3, t4, t5, t6, _, t8)) append
        shrink(t8).map((t1, t2, t3, t4, t5, t6, t7, _))
    }

  /** Shrink instance of 9-tuple */
  implicit def shrinkTuple9[
      T1: Shrink,
      T2: Shrink,
      T3: Shrink,
      T4: Shrink,
      T5: Shrink,
      T6: Shrink,
      T7: Shrink,
      T8: Shrink,
      T9: Shrink
  ]: Shrink[(T1, T2, T3, T4, T5, T6, T7, T8, T9)] =
    Shrink { case (t1, t2, t3, t4, t5, t6, t7, t8, t9) =>
      shrink(t1).map((_, t2, t3, t4, t5, t6, t7, t8, t9)) append
        shrink(t2).map((t1, _, t3, t4, t5, t6, t7, t8, t9)) append
        shrink(t3).map((t1, t2, _, t4, t5, t6, t7, t8, t9)) append
        shrink(t4).map((t1, t2, t3, _, t5, t6, t7, t8, t9)) append
        shrink(t5).map((t1, t2, t3, t4, _, t6, t7, t8, t9)) append
        shrink(t6).map((t1, t2, t3, t4, t5, _, t7, t8, t9)) append
        shrink(t7).map((t1, t2, t3, t4, t5, t6, _, t8, t9)) append
        shrink(t8).map((t1, t2, t3, t4, t5, t6, t7, _, t9)) append
        shrink(t9).map((t1, t2, t3, t4, t5, t6, t7, t8, _))
    }

  implicit def shrinkEither[T1: Shrink, T2: Shrink]: Shrink[Either[T1, T2]] =
    Shrink { x =>
      x.fold(shrink(_).map(Left(_)), shrink(_).map(Right(_)))
    }

  implicit val shrinkFiniteDuration: Shrink[FiniteDuration] =
    xmap[Long, FiniteDuration](Duration.fromNanos, _.toNanos)

  implicit val shrinkDuration: Shrink[Duration] = Shrink {
    case d: FiniteDuration => shrinkFiniteDuration.shrink(d)
    case _ => Stream.empty
  }

  /** Transform a Shrink[T] to a Shrink[U] where T and U are two isomorphic types whose relationship is described by the
   *  provided transformation functions. (exponential functor map)
   */
  def xmap[T, U](from: T => U, to: U => T)(implicit st: Shrink[T]): Shrink[U] = Shrink[U] { (u: U) =>
    st.shrink(to(u)).map(from)
  }
}

final class ShrinkIntegral[T](implicit ev: Integral[T]) extends Shrink[T] {
  import ev.{fromInt, gteq, quot, negate, equiv, zero, one}

  val two = fromInt(2)

  // see if T supports negative values or not. this makes some
  // assumptions about how Integral[T] is defined, which work for
  // Integral[Char] at least. we can't be sure user-defined
  // Integral[T] instances will be reasonable.
  val skipNegation = gteq(negate(one), one)

  // assumes x is non-zero.
  private def halves(x: T): Stream[T] = {
    val q = quot(x, two)
    if (equiv(q, zero)) Stream(zero)
    else if (skipNegation) q #:: halves(q)
    else q #:: negate(q) #:: halves(q)
  }

  def shrink(x: T): Stream[T] =
    if (equiv(x, zero)) Stream.empty[T] else halves(x)
}

final class ShrinkFractional[T](implicit ev: Fractional[T]) extends Shrink[T] {
  import ev.{fromInt, abs, zero, one, div, lteq, negate, lt}

  val two = fromInt(2)

  // this makes some assumptions, namely that we can support 1e-5 as a
  // fractional value. fortunately, if that is not true, it's likely
  // that our divisions will converge to zero quickly enough anyway.
  val small = div(one, fromInt(100000))
  def closeToZero(x: T): Boolean = lteq(abs(x), small)

  // assumes x is not close to zero
  private def halves(x: T): Stream[T] = {
    val q = div(x, two)
    if (closeToZero(q)) Stream(zero)
    else q #:: negate(q) #:: halves(q)
  }

  // this catches things like NaN and Infinity. it's not clear that we
  // should be shrinking those values, since they are sentinels.
  def isUnusual(x0: T): Boolean = {
    val x = abs(x0)
    // the negation here is important -- if we wrote this as gteq(...)
    // then it would not handle the NaN case correctly.
    !lt(div(x, two), x)
  }

  def shrink(x: T): Stream[T] =
    if (closeToZero(x) || isUnusual(x)) Stream.empty[T]
    else halves(x)
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy