ghyll

License	MIT
GroupId	com.gaborpihaj
ArtifactId	ghyll_2.13
Last Version	0.1.0
Release Date	Feb 1, 2021
Type	jar
Description	ghyll ghyll
Project URL	https://github.com/voidcontext/ghyll
Project Organization	com.gaborpihaj
Source Code Management	https://github.com/voidcontext/ghyll

Download ghyll_2.13

Filename	Size
ghyll_2.13-0.1.0.pom
ghyll_2.13-0.1.0.jar	68 KB
ghyll_2.13-0.1.0-sources.jar	5 KB
ghyll_2.13-0.1.0-javadoc.jar	1 MB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.gaborpihaj/ghyll_2.13/ -->
<dependency>
    <groupId>com.gaborpihaj</groupId>
    <artifactId>ghyll_2.13</artifactId>
    <version>0.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.gaborpihaj/ghyll_2.13/
implementation 'com.gaborpihaj:ghyll_2.13:0.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.gaborpihaj/ghyll_2.13/
implementation ("com.gaborpihaj:ghyll_2.13:0.1.0")

Apache Buildr

'com.gaborpihaj:ghyll_2.13:jar:0.1.0'

Apache Ivy

<dependency org="com.gaborpihaj" name="ghyll_2.13" rev="0.1.0">
  <artifact name="ghyll_2.13" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.gaborpihaj', module='ghyll_2.13', version='0.1.0')
)

Scala SBT

libraryDependencies += "com.gaborpihaj" % "ghyll_2.13" % "0.1.0"

Leiningen

[com.gaborpihaj/ghyll_2.13 "0.1.0"]

Dependencies

compile (6)

Group / Artifact	Type	Version
org.scala-lang : scala-library	jar	2.13.3
org.typelevel : cats-core_2.13	jar	2.3.0
org.typelevel : cats-effect_2.13	jar	2.3.0
co.fs2 : fs2-core_2.13	jar	2.4.6
com.google.code.gson : gson	jar	2.8.6
com.chuusai : shapeless_2.13	jar	2.3.3

test (1)

Group / Artifact	Type	Version
org.scalatest : scalatest_2.13	jar	3.2.3

Project Modules

There are no modules declared in this project.

ghyll

ghyll is a streaming JSON decoder library for Scala

Overview

In some cases datasets are not nicely organised into an array that's easy to parse in a streaming fashion with existing libraries (e.g. circe-fs2). When the dataset is represented as a huge map/object/hash where keys are e.g. identifiers it's not feasible to read the whole JSON into the memory and/or build a full AST representing the data. Another scenario when this approach can get problematic (or resource intensive) when only a small subset/subtree of a JSON object needs to be decoded.

ghyll provides a way to parse and decode:

• large JSON objects as key-value pairs, where there are many keys and the payload under each key is smaller
• large JSON arrays
• large JSON objects that only partially need to be decoded

Note: ghyll currently doesn't support encoding data as JSON

How it works

Under the hood ghyll is using gson for parsing the JSON payload, then it's using its own Decoder implementation to turn the JSON tokens emitted by gson into Scala data structures.

Disclaimer

ghyll is under active development and it's in an early stage when its functionality is limited and the API can change substantially.

Versions

Version
0.1.0 Feb 1, 2021