https://github.com/monix/monix-bio

Asynchronous data type with typed errors.
https://github.com/monix/monix-bio

cats-effect functional-programming monix scala typelevel

Last synced: 3 days ago
JSON representation

Asynchronous data type with typed errors.

• Host: GitHub
• URL: https://github.com/monix/monix-bio
• Owner: monix
• License: other
• Created: 2019-11-29T19:38:08.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-12T23:45:55.000Z (5 months ago)
• Last Synced: 2025-01-11T05:12:27.810Z (10 days ago)
• Topics: cats-effect, functional-programming, monix, scala, typelevel
• Language: Scala
• Homepage: https://bio.monix.io
• Size: 4.69 MB
• Stars: 80
• Watchers: 7
• Forks: 26
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# Monix-BIO

[![Maven Central](https://img.shields.io/maven-central/v/io.monix/monix-bio_2.12.svg)](https://search.maven.org/search?q=g:io.monix%20AND%20a:monix-bio_2.12)

[![Discord](https://img.shields.io/discord/632277896739946517.svg?label=&logo=discord&logoColor=ffffff&color=404244&labelColor=6A7EC2)](https://discord.gg/wsVZSEx4Nw)

[![Join the chat at https://gitter.im/monix/monix-bio](https://badges.gitter.im/monix/monix-bio.svg)](https://gitter.im/monix/monix-bio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Snapshot](https://img.shields.io/nexus/s/https/oss.sonatype.org/io.monix/monix-bio_2.12.svg)](https://oss.sonatype.org/content/repositories/snapshots/io/monix/monix-bio_2.12/)

Asynchronous data type with typed errors.

An enhanced version of [monix.eval.Task](https://monix.io/api/3.1/monix/eval/Task.html).

[Visit Documentation Website](https://monix.github.io/monix-bio/)

## The latest version

The latest stable version, compatible with Monix 3.x, Cats 2.x and Cats-Effect 2.x:

```scala

libraryDependencies += "io.monix" %% "monix-bio" % "1.2.0"

```

Published for ScalaJS1.x, Scala 2.12, 2.13, and 3.0.0.

## Roadmap

- Complete documentation (see [#133](https://github.com/monix/monix-bio/issues/113) for current progress)

- `reactive` module to use `monix.reactive.Observable` with `monix.bio.IO`

- built-in interop with `monix.eval.Task` without any imports

- (?) `UIO`-friendy builders for `cats.effect.concurrent` and `monix-catnap`

- (?) `Coeval` with typed errors

## Contributing

I will really appreciate feedback, bugs and complaints about the project.

If you'd like to contribute code then look for issues tagged with [good first issue](https://github.com/monix/monix-bio/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)

or just ask me on gitter and I should be able to find something regardless of your level of expertise. :)

I'm happy to mentor anyone interested in contributing.

## Credits

Most of the code comes from [Monix](https://github.com/monix/monix) which was customized to include support for error type parameter directly in the internals.

The idea of a second type parameter comes from [ZIO](https://github.com/zio/zio). Its implementation and API for error handling with two error channels served as an inspiration to the entire idea and some of the solutions. A lot of the benchmarks also come from their repository.

[Cats-bio](https://github.com/LukaJCB/cats-bio) has been extremely useful at the beginning because of many similarities between `monix.eval.Task` and `cats.effect.IO` internals.