JEP-17 JSON functions (GorillaStack)

[springcomp]

JSON Functions (GorillaStack)

JEP	17
Author	Chris Armstrong (Gorilla Stack)
Status	draft
Created	31-10-2019

Abstract

This document proposes adding functions for manipulating JSON data, including
a parse_json and to_json function.

Motivation

There is separate requirements to both parse JSON strings and to serialise
full or partial object structures to JSON.

Specification

The following functions will be added to the specification:

parse_json

any parse_json(string $json_data)

Parse string $json_data containing JSON data and produce an object structure that can be
further manipulated by JMESPath.

If the string contains invalid JSON, an error should be generated.

to_json

string to_json(any $value)

Serialise $value to a JSON string. No guarantees are made about formatting - this is
implementation dependent.

Impact

Although this introduces no changes to existing syntax or functions, it may be challenging
to support correctly in implementations other than JavaScript if the underlying language
does not contain a spec-compliant JSON parser or producing arbitrary object structures for
use with JMESPath is difficult.

[springcomp]

I think this presents a challenge in how we represents JSON data.
Is this a json-value from the specification ?
Is this a regular string ? Is escaping required ?

[springcomp]

Closed in favor of corresponding discussion.