Bump fs2.version from 0.10.0-M6 to 3.0.1

[dependabot-preview]

Bumps fs2.version from 0.10.0-M6 to 3.0.1.
Updates fs2-io_2.12 from 0.10.0-M6 to 3.0.1

Release notes

Sourced from fs2-io_2.12's releases.

v3.0.0

FS2 3.0.0 is the first official release built for Cats Effect 3, focusing on integration with the new Cats Effect typeclasses and standard library.

Concurrency Support

The biggest API changes to FS2 are in the fs2.concurrent package:

• The Queue (and InspectableQueue) types are gone in favor of cats.effect.std.Queue (#2201)
• There's a brand new implementation of Topic which no longer requires an initial element and is significantly faster. (#2252)
• There's a Channel type -- a multiple producer, single consumer concurrency primitive (#2326)
• Support for fanout via broadcast operations has been revamped and simplified (#2312)
• Support for balanced fanout has been removed, though it may return in a future release (#2340)
• The experimental PubSub type has been removed
• There's a new TimedPull API which allows simpler implementations of custom pulls that timeout while awaiting elements (#2062)
• There's a new implementation of groupWithin which is significantly faster (#2327)

Core Changes

One of the most exciting changes yet least visible changes in FS2 3.0.0 is the new interpreter. Stream compilation and evaluation is now handled by the Pull type thanks primarily to the work of @diesalbla. This new interpreter is much easier to work with than the old FreeC based implementation.

Another notable change to core APIs is that they no longer take Sync constraints. Instead, they take the least powerful type class or capability trait possible. For example, Stream.duration requires a Clock[F] constraint instead of Sync[F].

No More Blocker

The cats.effect.Blocker type was removed in CE 3 -- instead, Sync[F] supports blocking calls via Sync[F].blocking(thunk). As a result, FS2 APIs that took a Blocker have been simplified and in some cases, operations have been combined (e.g., lines & linesAsync have been combined to just lines).

Sinks

The deprecated Sink trait has finally been removed and we now represent sinks via a stream transformation that discards all output values -- Stream[F, O] => Stream[F, Nothing] aka Pipe[F, O, Nothing]. This is different than the old definition of Sink which emitted an undefined number of Unit values -- and as a result of the behavior being undefined, implementations varied widely. Implementations included emitting:

• 0 unit values
• 1 unit at termination of the source stream
• 1 unit per output element from source stream
• 1 unit per output chunk from source stream
• etc.

There are a few ergonomic improvements related to the new encoding of sinks:

• Stream.exec(IO.println(...)) - Stream.exec takes an F[Unit] and returns a Stream[F, Nothing]
• Stream(1, 2, 3).foreach(IO.println) - The foreach method on Stream takes a O => F[Unit] and returns a Stream[F, Nothing]
• s.unitary - The unitary method on Stream converts a Stream[F, Nothing] to a Stream[F, Unit] which emits a single unit at termination of s
• Calling flatMap on a Stream[F, Nothing] no longer compiles, which avoids mistakes that result in unexpected behavior.

Capability Traits

The fs2-io project provides support for working with files and networks, abstracting the Java NIO APIs. The implementations require either Async[F] or Sync[F] depending on whether the underlying NIO API is non-blocking or blocking.

One of the main features of CE3 is the position of the Sync and Async type classes in the hierarchy. As the most powerful type classes, they are now firmly at the bottom of the hierarchy. To avoid requiring Sync / Async constraints in code that uses fs2-io, we are adding capability traits -- traits which limit the capabilities of an effect to a discrete set of operations. The new fs2.io.file.Files[F] capability trait provides the ability to work with files in the effect F. For example:

def readAllText[F[_]: Files](https://github.com/typelevel/fs2/blob/HEAD/directory: Path): Stream[F, String] =
  Files[F].directoryStream(directory).flatMap { f =>
    Files[F].readAll(f, 1024*1024)
</tr></table> 

... (truncated)

Commits

• bc108e8 Merge pull request #2347 from mpilquist/topic/scala-3-rc2
• 43d8b11 Update workflow
• d0d7c21 Upgrade to Scala 3 RC2
• c84a31d Update sbt-mdoc to 2.2.19 (#2346)
• 1d699a1 Merge pull request #2345 from scala-steward/update/sbt-scalafix-0.9.27
• 2262868 Update sbt-scalafix to 0.9.27
• a96dc77 Update README and site for 3.0 release
• d3d2b64 Merge branch 'main' of https://github.com/typelevel/fs2 into main
• ac78be9 Upgrade to CE3 final
• 2801bdc Merge pull request #2342 from mpilquist/topic/compression-capability
• Additional commits viewable in compare view

Updates fs2-core_2.12 from 0.10.0-M6 to 3.0.1

Release notes

Sourced from fs2-core_2.12's releases.

v3.0.0

FS2 3.0.0 is the first official release built for Cats Effect 3, focusing on integration with the new Cats Effect typeclasses and standard library.

Concurrency Support

The biggest API changes to FS2 are in the fs2.concurrent package:

• The Queue (and InspectableQueue) types are gone in favor of cats.effect.std.Queue (#2201)
• There's a brand new implementation of Topic which no longer requires an initial element and is significantly faster. (#2252)
• There's a Channel type -- a multiple producer, single consumer concurrency primitive (#2326)
• Support for fanout via broadcast operations has been revamped and simplified (#2312)
• Support for balanced fanout has been removed, though it may return in a future release (#2340)
• The experimental PubSub type has been removed
• There's a new TimedPull API which allows simpler implementations of custom pulls that timeout while awaiting elements (#2062)
• There's a new implementation of groupWithin which is significantly faster (#2327)

Core Changes

One of the most exciting changes yet least visible changes in FS2 3.0.0 is the new interpreter. Stream compilation and evaluation is now handled by the Pull type thanks primarily to the work of @diesalbla. This new interpreter is much easier to work with than the old FreeC based implementation.

Another notable change to core APIs is that they no longer take Sync constraints. Instead, they take the least powerful type class or capability trait possible. For example, Stream.duration requires a Clock[F] constraint instead of Sync[F].

No More Blocker

The cats.effect.Blocker type was removed in CE 3 -- instead, Sync[F] supports blocking calls via Sync[F].blocking(thunk). As a result, FS2 APIs that took a Blocker have been simplified and in some cases, operations have been combined (e.g., lines & linesAsync have been combined to just lines).

Sinks

The deprecated Sink trait has finally been removed and we now represent sinks via a stream transformation that discards all output values -- Stream[F, O] => Stream[F, Nothing] aka Pipe[F, O, Nothing]. This is different than the old definition of Sink which emitted an undefined number of Unit values -- and as a result of the behavior being undefined, implementations varied widely. Implementations included emitting:

• 0 unit values
• 1 unit at termination of the source stream
• 1 unit per output element from source stream
• 1 unit per output chunk from source stream
• etc.

There are a few ergonomic improvements related to the new encoding of sinks:

• Stream.exec(IO.println(...)) - Stream.exec takes an F[Unit] and returns a Stream[F, Nothing]
• Stream(1, 2, 3).foreach(IO.println) - The foreach method on Stream takes a O => F[Unit] and returns a Stream[F, Nothing]
• s.unitary - The unitary method on Stream converts a Stream[F, Nothing] to a Stream[F, Unit] which emits a single unit at termination of s
• Calling flatMap on a Stream[F, Nothing] no longer compiles, which avoids mistakes that result in unexpected behavior.

Capability Traits

The fs2-io project provides support for working with files and networks, abstracting the Java NIO APIs. The implementations require either Async[F] or Sync[F] depending on whether the underlying NIO API is non-blocking or blocking.

One of the main features of CE3 is the position of the Sync and Async type classes in the hierarchy. As the most powerful type classes, they are now firmly at the bottom of the hierarchy. To avoid requiring Sync / Async constraints in code that uses fs2-io, we are adding capability traits -- traits which limit the capabilities of an effect to a discrete set of operations. The new fs2.io.file.Files[F] capability trait provides the ability to work with files in the effect F. For example:

def readAllText[F[_]: Files](https://github.com/typelevel/fs2/blob/HEAD/directory: Path): Stream[F, String] =
  Files[F].directoryStream(directory).flatMap { f =>
    Files[F].readAll(f, 1024*1024)
</tr></table> 

... (truncated)

Commits

• bc108e8 Merge pull request #2347 from mpilquist/topic/scala-3-rc2
• 43d8b11 Update workflow
• d0d7c21 Upgrade to Scala 3 RC2
• c84a31d Update sbt-mdoc to 2.2.19 (#2346)
• 1d699a1 Merge pull request #2345 from scala-steward/update/sbt-scalafix-0.9.27
• 2262868 Update sbt-scalafix to 0.9.27
• a96dc77 Update README and site for 3.0 release
• d3d2b64 Merge branch 'main' of https://github.com/typelevel/fs2 into main
• ac78be9 Upgrade to CE3 final
• 2801bdc Merge pull request #2342 from mpilquist/topic/compression-capability
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
• @dependabot use these labels will set the current labels as the default for future PRs for this repo and language
• @dependabot use these reviewers will set the current reviewers as the default for future PRs for this repo and language
• @dependabot use these assignees will set the current assignees as the default for future PRs for this repo and language
• @dependabot use this milestone will set the current milestone as the default for future PRs for this repo and language
• @dependabot badge me will comment on this PR with code to add a "Dependabot enabled" badge to your readme

Additionally, you can set the following in your Dependabot dashboard:

• Update frequency (including time of day and day of week)
• Pull request limits (per update run and/or open at any time)
• Automerge options (never/patch/minor, and dev/runtime dependencies)
• Out-of-range updates (receive only lockfile updates, if desired)
• Security updates (receive only security updates, if desired)

[dependabot-preview]

Superseded by #140.