Packages

p

kantan

codecs

package codecs

Ordering
  1. Alphabetic
Visibility
  1. Public
  2. Protected

Package Members

  1. package cats
  2. package enumeratum
  3. package error
  4. package export

    Provides a simple mechanism to insert derived type class instances in the implicit resolution mechanism.

    Provides a simple mechanism to insert derived type class instances in the implicit resolution mechanism.

    By default, when imported, such instances have the highest possible priority, which is typically problematic with shapeless instance derivation: bespoke instances for Option or Either, for example, find themselves shadowed by the generically derived ones.

    If such instances are of type kantan.codecs.export.DerivedDecoder / kantan.codecs.export.DerivedEncoder rather than Decoder / Encoder, however, they'll find themselves with a lower precedence and only be used if no other, more specific instance is found.

  5. package laws
  6. package libra

    Provides codecs for https://to-ithaca.github.io/libra/ types.

  7. package refined

    Provides codecs for refined types.

  8. package resource
  9. package scalaz
  10. package shapeless
  11. package strings

    Defines codecs for encoding to and decoding from strings.

    Defines codecs for encoding to and decoding from strings.

    These codecs are not necessary meant to use directly, but more as part of larger ones. kantan.csv, for example, works with CSV files but delegates the act of encoding to or decoding from a CSV cell to string codecs.

    Default instances can be found in kantan.codecs.strings.codecs.

Type Members

  1. trait Codec[E, D, F, T] extends Decoder[E, D, F, T] with Encoder[E, D, T]

    Combines a Decoder and an Encoder.

    Combines a Decoder and an Encoder.

    Codecs are only meant as a convenience, and should not be considered more powerful or desirable than encoders or decoders. Some types can be both encoded to and decoded from, and being able to define both instances in one call is convenient. It's however very poor practice to request a type to have a Codec instance - a much preferred alternative would be to require it to have a Decoder and an Encoder instance, which a Codec would fulfill.

  2. trait CodecCompanion[E, F, T] extends AnyRef
  3. trait Decoder[E, D, F, T] extends Serializable

    Type class for types that can be decoded from other types.

    Type class for types that can be decoded from other types.

    E

    encoded type - what to decode from.

    D

    decoded type - what to decode to.

    F

    failure type - how to represent errors.

    T

    tag type - used to specialise decoder instances, and usually where default implementations are declared.

  4. trait DecoderCompanion[E, F, T] extends Serializable

    Provides methods commonly declared by companion objects for specialised decoder types.

    Provides methods commonly declared by companion objects for specialised decoder types.

    Most libraries that use kantan.codecs will declare type aliases for decoders - CellDecoder in kantan.csv, for example. DecoderCompanion lets such types have a useful companion object without a lot of code duplication.

  5. trait Encoder[E, D, T] extends Serializable

    Type class for types that can be encoded into others.

    Type class for types that can be encoded into others.

    E

    encoded type - what to encode to.

    D

    decoded type - what to encode from.

    T

    tag type.

  6. trait EncoderCompanion[E, T] extends AnyRef
  7. trait Optional[A] extends Serializable

    Type class that represents data types that have an "empty" value.

    Type class that represents data types that have an "empty" value.

    The purpose of this type class is to allow automatic derivation of Decoder for decoded types that might not have a value - Option, List...

    In theory, there should rarely be a need to interact directly with this type class, and one is usually better served by obtaining the Decoder instance for Option and mapping on it.

Value Members

  1. object Codec extends Serializable

    Provides instance creation methods for Codec.

  2. object Decoder extends Serializable
  3. object Encoder extends Serializable
  4. object Optional extends Serializable
  5. object ResultCompanion

    Provides trait that result companion object can extend.

    Provides trait that result companion object can extend.

    The idea is that libraries that rely on kantan.codecs are likely to provide type-constrained versions of result, such as DecodeResult in kantan.csv. Users are likely to expect goodies such as fromTry or sequence on DecodeResult's companion object, which can be achieved by extending kantan.codecs.ResultCompanion.WithDefault.

  6. object VersionSpecificResultCompanion

Ungrouped