https://github.com/zio/zio-nio

A small, unopinionated ZIO interface to NIO.
https://github.com/zio/zio-nio

nio scala zio

Last synced: 7 days ago
JSON representation

A small, unopinionated ZIO interface to NIO.

• Host: GitHub
• URL: https://github.com/zio/zio-nio
• Owner: zio
• License: apache-2.0
• Created: 2019-07-27T20:54:20.000Z (over 5 years ago)
• Default Branch: series/2.x
• Last Pushed: 2024-08-20T01:45:03.000Z (5 months ago)
• Last Synced: 2024-12-23T04:02:26.088Z (21 days ago)
• Topics: nio, scala, zio
• Language: Scala
• Homepage: https://zio.dev/zio-nio
• Size: 3.89 MB
• Stars: 189
• Watchers: 15
• Forks: 75
• Open Issues: 105
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-zio - ZIO NIO - functional, low-level, and unopinionated wrapper around Java NIO functionality (Official ZIO Libraries)

README

        
# ZIO-NIO

| Project Stage | CI | Release | Snapshot | Discord |

| --- | --- | --- | --- | --- |

| [![Project stage][Stage]][Stage-Page] | ![CI][Badge-CI] | [![Release Artifacts][badge-releases]][link-releases] | [![Snapshot Artifacts][badge-snapshots]][link-snapshots] | [![badge-discord]][link-discord] |

ZIO interface to Java NIO.

Java NIO is unsafe, and can surprise you a lot with e.g. hiding the actual error in IO operation and giving you only true/false values when IO was successful/not successful. ZIO-NIO on the other hand embraces the full power of ZIO effects, environment, error and resource management to provide type-safe, performant, purely-functional, low-level, and unopinionated wrapping of Java NIO functionality.

ZIO-NIO comes in two flavours:

 - `zio.nio.core` - a small and unopinionated ZIO interface to NIO that just wraps NIO API in ZIO effects,

 - `zio.nio` - an opinionated interface with deeper ZIO integration that provides more type and resource safety.

Learn more about ZIO-NIO at:

 - [Homepage](https://zio.github.io/zio-nio/)

## Background

* [Scala IO](https://www.scala-lang.org/api/2.12.3/scala/io/index.html)

* [Http4s Blaze](https://github.com/http4s/blaze)

* [Ammonite](https://github.com/lihaoyi/Ammonite/)

* [Better Files](https://github.com/pathikrit/better-files)

* [Towards a safe, sane I O library in Scala](https://www.youtube.com/watch?feature=player_embedded&v=uaYKkpqs6CE)

* [Haskell NIO](https://wiki.haskell.org/NIO)

* [Non Blocking IO](https://www.youtube.com/watch?v=uKc0Gx_lPsg)

* [Blocking vs Non-blocking IO](http://tutorials.jenkov.com/java-nio/nio-vs-io.html)

[Badge-CI]: https://github.com/zio/zio-nio/workflows/CI/badge.svg

[badge-discord]: https://img.shields.io/discord/629491597070827530?logo=discord "chat on discord"

[badge-releases]: https://img.shields.io/nexus/r/https/oss.sonatype.org/dev.zio/zio-nio_2.12.svg "Sonatype Releases"

[badge-snapshots]: https://img.shields.io/nexus/s/https/oss.sonatype.org/dev.zio/zio-nio_2.12.svg "Sonatype Snapshots"

[link-discord]: https://discord.gg/2ccFBr4 "Discord"

[link-releases]: https://oss.sonatype.org/content/repositories/releases/dev/zio/zio-nio_2.12/ "Sonatype Releases"

[link-snapshots]: https://oss.sonatype.org/content/repositories/snapshots/dev/zio/zio-nio_2.12/ "Sonatype Snapshots"

[Stage]: https://img.shields.io/badge/Project%20Stage-Development-yellowgreen.svg

[Stage-Page]: https://github.com/zio/zio/wiki/Project-Stages