zio / zio-schema

Compositional, type-safe schema definitions, which enable auto-derivation of codecs and migrations.

Version Matrix

ZIO-SCHEMA

Project Stage CI Release Issues Discord
Project stage CI Release Artifacts Average time to resolve an issue badge-discord

ZIO Schema is a ZIO-based library for modeling the schema of data structures as first-class values.

With schema descriptions that can be automatically derived for case classes and sealed traits, ZIO Schema provide powerful features for free:

  • Codecs for any supported protocol (JSON, protobuf, etc.), so data structures can be serialized and deserialized in a principled way
  • Diffing, patching, merging, and other generic-data-based operations (TODO)
  • Migration of data structures from one schema to another compatible schema (TODO)
  • Derivation of arbitrary type classes (Eq, Show, Ord, etc.) from the structure of the data (TODO)

When your data structures need to be serialized, deserialized, persisted, or transported across the wire, then ZIO Schema lets you focus on data modeling and automatically tackle all the low-level, messy details for you.

ZIO Schema is used by a growing number of ZIO libraries, including ZIO Flow, ZIO Redis, and ZIO Web.

Installation

Add in your build.sbt:

libraryDependencies += "dev.zio" %% "zio-schema" % "<version>"