Packages

  • package root
    Definition Classes
    root
  • package io
    Definition Classes
    root
  • package dylemma
    Definition Classes
    io
  • package spac
    Definition Classes
    dylemma
  • package json

    This package provides extensions to the core "spac" library which allow for the handling of JSON data.

    This package provides extensions to the core "spac" library which allow for the handling of JSON data.

    Rather than creating explicit classes that extend Parser, Transformer, and Splitter, this package provides type aliases and implicit extensions. For example, JsonParser[A] is just a type alias for Parser[JsonEvent, A], and JsonParser is just a call to Parser[JsonEvent].

    Implicit JsonParsers are available for each of the JSON primitive types:

    • string
    • number (expressed as Int, Long, Float, or Double)
    • boolean
    • null (expressed as None.type)

    Helpers are available for parsing JSON arrays and objects:

    • JsonParser.listOf[A] to parse an array where each value is an A
    • JsonParser.objectOf[A] to parse an object where the value for each field an A
    • JsonParser.objectOfNullable[A] to parse an object where the value for each field is either null or an A, filtering out the nulls
    • JsonParser.fieldOf[A](fieldName) to parse a specific field from an object

    A DSL for creating json-specific ContextMatchers is provided to make it more convenient to call Splitter.json. For example:

    Splitter.json("foo" \ "bar").as[String].parseFirst

    Can be used to capture rootJson.foo.bar as a String in

    {
  "foo": {
    "bar": "hello"
  }
}

    To "split" values inside arrays, index-related context matchers are available, e.g.

    Splitter.json("foo" \ anyIndex).as[Int].parseToList

    Can be used to capture each of the numbers in the "foo" array in

    {
  "foo": [1, 2, 3]
}

    A note about JsonEvents in spac: JSON doesn't have any explicit markers for when a field ends, or when an array index starts or ends; those context changes are essentially inferred by the presence of some other event. For example, instead of a "field end" event, typically there will be either a new "field start" or a token representing the end of the current object. With spac, splitters and context matchers generally operate under the assumption that a "stack push" event (like a field start) will eventually be followed by a corresponding "stack pop" event (i.e. field end).

    To allow for this, these "inferred" events (FieldEnd, IndexStart, IndexEnd) are explicitly represented as JsonEvents in the stream being parsed. Keep this in mind when creating JSON ContextMatchers:

    • field-related matchers will match a stack like case ObjectStart :: FieldStart(_) :: _
    • index-related matchers will match a stack like case ArrayStart :: IndexStart(_) :: _
    Definition Classes
    spac
  • package impl
  • JsonEvent
  • JsonParserApplyOps
  • JsonSplitterApplyOps
  • JsonStackElem
  • JsonStackPop
  • JsonValueEvent

package json

This package provides extensions to the core "spac" library which allow for the handling of JSON data.

Rather than creating explicit classes that extend Parser, Transformer, and Splitter, this package provides type aliases and implicit extensions. For example, JsonParser[A] is just a type alias for Parser[JsonEvent, A], and JsonParser is just a call to Parser[JsonEvent].

Implicit JsonParsers are available for each of the JSON primitive types:

  • string
  • number (expressed as Int, Long, Float, or Double)
  • boolean
  • null (expressed as None.type)

Helpers are available for parsing JSON arrays and objects:

  • JsonParser.listOf[A] to parse an array where each value is an A
  • JsonParser.objectOf[A] to parse an object where the value for each field an A
  • JsonParser.objectOfNullable[A] to parse an object where the value for each field is either null or an A, filtering out the nulls
  • JsonParser.fieldOf[A](fieldName) to parse a specific field from an object

A DSL for creating json-specific ContextMatchers is provided to make it more convenient to call Splitter.json. For example:

Splitter.json("foo" \ "bar").as[String].parseFirst

Can be used to capture rootJson.foo.bar as a String in

{
  "foo": {
    "bar": "hello"
  }
}

To "split" values inside arrays, index-related context matchers are available, e.g.

Splitter.json("foo" \ anyIndex).as[Int].parseToList

Can be used to capture each of the numbers in the "foo" array in

{
  "foo": [1, 2, 3]
}

A note about JsonEvents in spac: JSON doesn't have any explicit markers for when a field ends, or when an array index starts or ends; those context changes are essentially inferred by the presence of some other event. For example, instead of a "field end" event, typically there will be either a new "field start" or a token representing the end of the current object. With spac, splitters and context matchers generally operate under the assumption that a "stack push" event (like a field start) will eventually be followed by a corresponding "stack pop" event (i.e. field end).

To allow for this, these "inferred" events (FieldEnd, IndexStart, IndexEnd) are explicitly represented as JsonEvents in the stream being parsed. Keep this in mind when creating JSON ContextMatchers:

  • field-related matchers will match a stack like case ObjectStart :: FieldStart(_) :: _
  • index-related matchers will match a stack like case ArrayStart :: IndexStart(_) :: _
Source
package.scala
Linear Supertypes
AnyRef, Any
Ordering
  1. Grouped
  2. Alphabetic
  3. By Inheritance
Inherited
  1. json
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Package Members

  1. package impl

Type Members

  1. type JsonContextMatcher[+C] = ContextMatcher[JsonStackElem, C]

  2. sealed trait JsonEvent extends HasLocation

    ADT for tokens in a JSON stream.

  3. type JsonParser[+Out] = Parser[JsonEvent, Out]

    Type alias for a Parser whose input type is JsonEvent

  4. implicit final class JsonParserApplyOps extends AnyVal

    Provides JSON-specific Parser constructor methods to the JsonParser object, for example JsonParser.fieldOf.

    Provides JSON-specific Parser constructor methods to the JsonParser object, for example JsonParser.fieldOf.

    Technically JsonParser is not a companion object, it is a partially-applied version of the Parser companion object which binds the input type to JsonEvent, so "companion methods" must instead be added as extension methods.

  5. type JsonSplitter[+C] = Splitter[JsonEvent, C]

    Type alias for a Splitter whose input type is JsonEvent

  6. implicit final class JsonSplitterApplyOps extends AnyVal

    Adds Splitter.json, for constructing json context matcher-based JsonSplitters

  7. sealed trait JsonStackElem extends JsonEvent

    Subset of JsonEvents that constitute a "context stack push".

  8. sealed trait JsonStackPop extends JsonEvent

    Subset of JsonEvents that constitute a "context stack pop".

  9. type JsonTransformer[+Out] = Transformer[JsonEvent, Out]

    Type alias for a Transformer whose input type is JsonEvent.

  10. sealed trait JsonValueEvent extends JsonEvent

    Subset of JsonEvents that represent a primitive values

Value Members

  1. val JsonParser: ParserApplyWithBoundInput[JsonEvent]

    Like the Parser companion object, but only for creating Parsers whose input type is JsonEvent.

    Like the Parser companion object, but only for creating Parsers whose input type is JsonEvent.

    See also

    JsonParserApplyOps

  2. val JsonSplitter: SplitterApplyWithBoundInput[JsonEvent]

    Like the Splitter companion object, but only for creating Splitters whose input type is JsonEvent.

  3. val JsonTransformer: TransformerApplyWithBoundInput[JsonEvent]

    Like the Transformer companion object, but only for creating Transformers whose input type is JsonEvent.

  4. def anyField: JsonContextMatcher[String]

    Context matcher that matches events with any JSON object field, capturing the name of the field as context.

    Context matcher that matches events with any JSON object field, capturing the name of the field as context. Specifically this matcher looks for an ObjectStart followed by a FieldStart(name), for any name.

  5. def anyIndex: JsonContextMatcher[Int]

    Context matcher that matches events within a JSON array, at any index.

    Context matcher that matches events within a JSON array, at any index. Specifically this matcher looks for an ArrayStart followed by an IndexStart(_) in the JSON context stack. If the match succeeds, the i index will be captured as a context value.

  6. def field[A](contextFromName: (String) => Option[A]): JsonContextMatcher[A]

    Context matcher that matches events within certain JSON object fields, extracting some context value based on the name of the matched field.

    Context matcher that matches events within certain JSON object fields, extracting some context value based on the name of the matched field. Specifically this matcher looks for an ObjectStart followed by a FieldStart(name), then plugs the name into contextFromName. If contextFromName returns a Some, the match succeeds and the value inside the Some is returned.

    contextFromName

    a function that extracts a context value based on the name of the JSON object field

  7. implicit def field(name: String): JsonContextMatcher[Unit]

    Context matcher that matches events within a given JSON object field.

    Context matcher that matches events within a given JSON object field. Specifically this matcher looks for an ObjectStart followed by a FieldStart(name) in the JSON context stack.

    When calling Splitter.json, the fact that this method is implicit allows you to use the underlying field name directly instead of directly calling this method, e.g. Splitter.json("address" \ "street")

    name

    the name of the field

  8. def fieldWhere(f: (String) => Boolean): JsonContextMatcher[String]

    Context matcher that matches events within JSON object fields whose names case the given f predicate to return true.

    Context matcher that matches events within JSON object fields whose names case the given f predicate to return true. Specifically this matcher looks for an ObjectStart followed by a FieldStart(name) where f(name) is true. If the match succeeds, the name of the field is also extracted as a context value.

    f

    A predicate applied to field names to determine whether the current JSON context stack matches

  9. def index[A](contextFromIndex: (Int) => Option[A]): JsonContextMatcher[A]

    Context matcher that matches events within a JSON array, at certain indexes.

    Context matcher that matches events within a JSON array, at certain indexes. Specifically this matcher looks for an ArrayStart followed by an IndexStart(i) in the JSON context stack, where the i from the IndexStart is passed to contextFromIndex. If contextFromIndex(i) returns a Some, the match succeeds and the value inside the Some is returned as a context value.

  10. def index(i: Int): JsonContextMatcher[Unit]

    Context matcher that matches events within a JSON array at a specific index.

    Context matcher that matches events within a JSON array at a specific index. Specifically this matcher looks for an ArrayStart followed by an IndexStart(i) in the JSON context stack.

  11. def indexWhere(f: (Int) => Boolean): JsonContextMatcher[Int]

    Context matcher that matches events within a JSON array, at certain indexes.

    Context matcher that matches events within a JSON array, at certain indexes. Specifically this matcher looks for an ArrayStart followed by an IndexStart(i) in the JSON context stack, where f(i) is true. If the match succeeds, the i index will be captured as a context value.

  12. implicit val jsonParserForPrimitiveBoolean: JsonParser[Boolean]

    Implicit version of JsonParser.forBoolean

  13. implicit val jsonParserForPrimitiveDouble: JsonParser[Double]

    Implicit version of JsonParser.forDouble

  14. implicit val jsonParserForPrimitiveFloat: JsonParser[Float]

    Implicit version of JsonParser.forFloat

  15. implicit val jsonParserForPrimitiveInt: JsonParser[Int]

    Implicit version of JsonParser.forInt

  16. implicit val jsonParserForPrimitiveLong: JsonParser[Long]

    Implicit version of JsonParser.forLong

  17. implicit val jsonParserForPrimitiveNull: JsonParser[None.type]

    Implicit version of JsonParser.forNull

  18. implicit val jsonParserForPrimitiveString: JsonParser[String]

    Implicit version of JsonParser.forString

  19. object JsonEvent

Inherited from AnyRef

Inherited from Any

JSON-specific extensions for Parser and Splitter

JSON-specific Type and Value aliases

JSON Context Matcher Construction

JSON Event Representation

Ungrouped