harn-stdlib 0.8.25

Embedded Harn standard library source catalog
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

/**
 * std/json/stream - incremental JSON stream validation
 *
 * Import with: import { stream_validator } from "std/json"
 */
pub enum JsonStreamStatus {
  Pending
  Valid
  Invalid(error)
}

type JsonStreamValidator = {
  feed: fn(any) -> JsonStreamStatus,
  value: fn() -> any,
  status: fn() -> JsonStreamStatus,
}

/**
 * Create an incremental validator for UTF-8 JSON string or bytes chunks.
 * `feed(chunk)` returns JsonStreamStatus.Pending, JsonStreamStatus.Valid, or
 * JsonStreamStatus.Invalid({reason, path}). `value()` returns the parsed JSON
 * value after Valid and nil otherwise.
 */
pub fn stream_validator(schema) -> JsonStreamValidator {
  let handle = __json_stream_validator(schema)
  return {
    _namespace: "json_stream_validator",
    feed: fn(chunk) { return __json_stream_validator_feed(handle, chunk) },
    value: fn() { return __json_stream_validator_value(handle) },
    status: fn() { return __json_stream_validator_status(handle) },
  }
}