Packages

final class Pull[+F[_], +O, +R] extends AnyVal

A p: Pull[F,O,R] reads values from one or more streams, returns a result of type R, and produces a Stream[F,O] when calling p.stream.

Any resources acquired by p are freed following the call to stream.

Laws:

Pull forms a monad in R with pure and flatMap:

  • pure >=> f == f
  • f >=> pure == f
  • (f >=> g) >=> h == f >=> (g >=> h) where f >=> g is defined as a => a flatMap f flatMap g

raiseError is caught by handleErrorWith:

  • handleErrorWith(raiseError(e))(f) == f(e)
Source
Pull.scala
Linear Supertypes
AnyVal, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Pull
  2. AnyVal
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    Any
  2. final def ##(): Int
    Definition Classes
    Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    Any
  4. def >>[F2[x] >: F[x], O2 >: O, R2](p2: ⇒ Pull[F2, O2, R2]): Pull[F2, O2, R2]

    Alias for flatMap(_ => p2).

  5. def as[R2](r2: R2): Pull[F, O, R2]

    Alias for _.map(_ => o2).

  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def attempt: Pull[F, O, Either[Throwable, R]]

    Returns a pull with the result wrapped in Right, or an error wrapped in Left if the pull has failed.

  8. def covary[F2[x] >: F[x]]: Pull[F2, O, R]

    Lifts this pull to the specified effect type.

  9. def covaryAll[F2[x] >: F[x], O2 >: O, R2 >: R]: Pull[F2, O2, R2]

    Lifts this pull to the specified effect type, output type, and resource type.

  10. def covaryOutput[O2 >: O]: Pull[F, O2, R]

    Lifts this pull to the specified output type.

  11. def covaryResource[R2 >: R]: Pull[F, O, R2]

    Lifts this pull to the specified resource type.

  12. def flatMap[F2[x] >: F[x], O2 >: O, R2](f: (R) ⇒ Pull[F2, O2, R2]): Pull[F2, O2, R2]

    Applies the resource of this pull to f and returns the result.

  13. def getClass(): Class[_ <: AnyVal]
    Definition Classes
    AnyVal → Any
  14. def handleErrorWith[F2[x] >: F[x], O2 >: O, R2 >: R](h: (Throwable) ⇒ Pull[F2, O2, R2]): Pull[F2, O2, R2]

    If this terminates with Pull.raiseError(e), invoke h(e).

  15. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  16. def map[R2](f: (R) ⇒ R2): Pull[F, O, R2]

    Applies the resource of this pull to f and returns the result in a new Pull.

  17. def mapOutput[O2](f: (O) ⇒ O2): Pull[F, O2, R]

    Applies the outputs of this pull to f and returns the result in a new Pull.

  18. def onComplete[F2[x] >: F[x], O2 >: O, R2 >: R](p2: ⇒ Pull[F2, O2, R2]): Pull[F2, O2, R2]

    Run p2 after this, regardless of errors during this, then reraise any errors encountered during this.

  19. def stream(implicit ev: <:<[R, Unit]): Stream[F, O]

    Interpret this Pull to produce a Stream, introducing a scope.

    Interpret this Pull to produce a Stream, introducing a scope.

    May only be called on pulls which return a Unit result type. Use p.void.stream to explicitly ignore the result type of the pull.

  20. def streamNoScope(implicit ev: <:<[R, Unit]): Stream[F, O]

    Interpret this Pull to produce a Stream without introducing a scope.

    Interpret this Pull to produce a Stream without introducing a scope.

    Only use this if you know a scope is not needed. Scope introduction is generally harmless and the risk of not introducing a scope is a memory leak in streams that otherwise would execute in constant memory.

    May only be called on pulls which return a Unit result type. Use p.void.stream to explicitly ignore the result type of the pull.

  21. def toString(): String
    Definition Classes
    Any
  22. def void: Pull[F, O, Unit]

    Discards the result type of this pull.

Inherited from AnyVal

Inherited from Any

Ungrouped