Reference Guide

This is an aquascape-based reference guide to fs2.

It describes the semantics of fs2 operators — the technical details of how they behave.

Consult this guide when you need detailed information about an operator, such as when it terminates, how it propagates errors, when it executes finalizers, and how it manages chunks.

Operators

Learn how to read aquascapes, then learn about an operator:

• compile.toList, compile.last, compile.onlyOrError, compile.count, compile.drain

• take, takeWhile, takeThrough, takeRight

• drop, dropWhile, dropThrough, dropLast, dropLastIf

• filter, filterNot, filterWithPrevious, changes, mapFilter

• evalMap, evalTap, evalMapChunk, evalTapChunk

• bracket, bracketCase, resource, onFinalize, onFinalizeCase

• merge, mergeHaltL, mergeHaltR

• flatMap

• append, ++

• raiseError, handleError, handleErrorWith, attempt

• chunks, unchunks, chunkLimit, chunkMin, chunkN

• sleep, delayBy, fixedDelay, awakeDelay, fixedRate, fixedRateStartImmediately, awakeEvery, spaced, metered, meteredStartImmediately

Not all operators are documented yet. If you want to learn about one that's not listed, raise an issue on GitHub.

Concurrency primitives

This guide also describes the technical details of concurrency primitives. These are used to communicate between streams.

Learn how to read aquascapes, then learn about a primitive:

• Topic