Super loose JSON + TOML parsers and unmarshaller for Go.
JSONC and JSON5 can also be read.
- Loose JSON | TOML normalizer (WebAssembly)
- Normalize loose JSON | TOML to strict JSON
- Code
package main
import (
"fmt"
"github.com/shellyln/go-loose-json-parser/jsonlp"
)
func main() {
// src: Loose JSON
//
// plafLb:
// * Platform-dependent line break.
// * `Linebreak_Lf` | `Linebreak_CrLf` | `Linebreak_Cr`
// * Line break codes in multi-line string are replaced by this specified line break.
// (Excluding line breaks by escape sequences)
//
// interop:
// * If `Interop_JSON` is set,
// replace NaN, Infinity, complex number
// by `{nan:true}`, `{inf:+/-1}`, `{re:re,im:im}` .
// * If `Interop_TOML` is set,
// replace complex number by `{re:re,im:im}` .
// * If `Interop_JSON_AsNull` is set,
// replace NaN, Infinity, complex number by null.
// * If `Interop_TOML_AsNull` is set,
// replace complex number by null.
//
// parsed:
// nil | []any | map[string]any |
// float64 | int64 | uint64 | complex128 |
// string | bool | time.Time
parsed, err := jsonlp.ParseJSON(`{
// comment
config: {
addr: '127.0.0.1',
}
}`, jsonlp.Linebreak_Lf, jsonlp.Interop_None)
if err != nil {
fmt.Printf("Parse: error = %v\n", err)
return
}
fmt.Printf("Parsed = %v\n", parsed)
}package main
import (
"fmt"
"github.com/shellyln/go-loose-json-parser/jsonlp"
)
func main() {
// src: Loose TOML
//
// plafLb:
// * Platform-dependent line break.
// * `Linebreak_Lf` | `Linebreak_CrLf` | `Linebreak_Cr`
// * Line break codes in multi-line string are replaced by this specified line break.
// (Excluding line breaks by escape sequences)
//
// interop:
// * If `Interop_JSON` is set,
// replace NaN, Infinity, complex number
// by `{nan:true}`, `{inf:+/-1}`, `{re:re,im:im}` .
// * If `Interop_TOML` is set,
// replace complex number by `{re:re,im:im}` .
// * If `Interop_JSON_AsNull` is set,
// replace NaN, Infinity, complex number by null.
// * If `Interop_TOML_AsNull` is set,
// replace complex number by null.
//
// parsed:
// nil | []any | map[string]any |
// float64 | int64 | uint64 | complex128 |
// string | bool | time.Time
parsed, err := jsonlp.ParseTOML(`
# comment
[config]
addr = '127.0.0.1'
`, jsonlp.Linebreak_Lf, jsonlp.Interop_None)
if err != nil {
fmt.Printf("Parse: error = %v\n", err)
return
}
fmt.Printf("Parsed = %v\n", parsed)
}Mapping untyped data to a typed variable.
package main
import (
"fmt"
"github.com/shellyln/go-loose-json-parser/jsonlp"
"github.com/shellyln/go-loose-json-parser/marshal"
)
type config struct {
Addr string `json:"addr"`
}
type response struct {
Config config `json:"config"`
}
func main() {
parsed, err := jsonlp.ParseJSON(`{
// comment
config: {
addr: '127.0.0.1',
}
}`, jsonlp.Linebreak_Lf, jsonlp.Interop_None)
if err != nil {
fmt.Printf("Parse: error = %v\n", err)
return
}
var typed response
// src: Source data. Untyped in typical use.
// dst: Pointer to result data. Typed in typical use.
// opts: Pointer to struct of the `Unmarshal` options. If nil, use default.
// Default options are {
// TagName: "json", // Tag name of the struct fields
// NoCopyUnexportedFields: false, // If true, no shallow copying of unexported fields
// NoCustomMarshaller: false, // If true, IMarshal and IUnmarshal are not used
// }
if err := marshal.Unmarshal(parsed, &typed, nil); err != nil {
fmt.Printf("Unmarshal: error = %v\n", err)
return
}
fmt.Printf("Typed = %v\n", typed)
}Note
Unmarshalalso works well for typed to untyped conversions and as deep cloning.
- ✅ Can read strict TOML.
- ✅ Can read loose JSON, JSONC, JSON5, and TOML for configuration files.
- ✅ Can be mapped to structs, untyped maps/slices, or primitives.
- ✅ Can read many list and map literals in JavaScript, Python, PHP, Ruby, etc.
- ✅
Marshalling from any to typed
- ✅
Datetime format with date and time delimited by space (RFC 3339 section 5.6)e.g.2006-01-02 15:04:05Z
- ✅
Datetime format without timezonee.g.2006-01-02T15:04:05
- ✅
Platform-dependent newline in multiline string - Error detection when values are overwritten
# Hash comment
{
// Line comment
/* Block comment */
// Object keys can be enclosed in either double-quote, single-quote, back-quote.
// It is also allowed not to enclose them.
"foo": [
123, // -> float64(123)
-123.45, // -> float64(-123.45)
-1.2345e+6, // -> float64(-1234500)
-123_456_789, // -> float64(-123456789)
0x12345678, // -> float64(305419896)
0x1234_5678, // -> float64(305419896)
0o7654_3210, // -> float64(16434824)
0b0101_0101, // -> float64(85)
],
'bar': null, // -> nil
baz: undefined, // -> nil
"qux": -Infinity, // -> -Inf // Infinity, +Infinity are also available
"quux": NaN, // -> NaN
// Non-ASCII identifiers can also be used.
あいうえお: {
key: "value1",
bare_key: "value2",
bare-key: "value3", // Keys containing hyphens are allowed.
1234: "value4", // Keys starting with a number are allowed.
-3.14: "value5", // "-3": { "14": "value5" }
},
"corge": [
// Escape sequences are available
'Hello, World!\r\n',
// Unicode escape sequences (\uXXXX and \u{XXXXXX}) are available
"\u0048\u0065\u006c\u006c\u006f\u002c\u0020\u0057\u006f\u0072\u006c\u0064\u0021",
// Byte escape sequence is also available
"\x48\x65\x6c\x6c\x6f\x2c\x20\x57\x6f\x72\x6c\x64\x21",
// Multiline string literal
`Tempor adipiscing amet velit ipsum diam ut ea takimata lorem gubergren sed laoreet.
Congue possim facilisis sea justo dolore amet eos dolores est magna.`
],
"grault": [
// Date, Time, DateTime literals are available
2020-12-31, // -> time.Time 2020-12-31:00:00.000Z
18:20:30.001, // -> time.Time 1870-01-01T18:20:30.001Z
2020-12-31T18:20:30.001Z // -> time.Time 2020-12-31:20:30.001Z
],
// "key = value" syntax is allowed
garply = true,
// "key => value" syntax is allowed
waldo => false,
// Trailing commas are allowed.
fred: 10,
}See also: Introducing JSON, JSON5 Spec
# Hash comment
// Line comment (non-standard)
/* Block comment (non-standard) */
"quoted-key" = "value0"
key = "value1"
bare_key = "value2"
bare-key = "value3" # Keys containing hyphens are allowed.
1234 = "value4" # Keys starting with a number are allowed.
-3.14 = "value5" # "-3": { "14": "value5" }
あいうえお = "value6" # // Non-ASCII identifiers are allowed. (non-standard)
[table-A]
item-a = 1
item-b = 2
item-c = "standard\n string"
item-d = '\literal string'
item-e = """\
Multiline \
standard string"""
item-f = '''
Multiline
literal string''' "\t" '''!!'''
[table-A.sub-table-P]
item-m = 11
item-n = 12
sub-table-X.sub-table-Y = 111
[[array-of-table-U]]
foo = 1
[array-of-table-U.sub-table-V]
bar = 11
[[array-of-table-U]]
foo = 2
[array-of-table-U.sub-table-V]
bar = 22See also: TOML Spec
[][1][1,][1, 2][1, 2,]{}{ "foo": 1 }{ "foo": 1, }{ 'foo': 1, }{ `foo`: 1, }{ foo: 1, }{ "foo": 1, "bar": 2, }{ "foo" => 1 }{ "foo" = 1 }{ foo.bar.baz = 1 }
// -> { "foo": { "bar": { "baz": 1 } } }{ "foo".bar."baz" = 1 }
// -> { "foo": { "bar": { "baz": 1 } } }123-123-123s64123u64-123.45-1.2345e+6-123_456_789-123_456.789_0120x123456780x1234_56780o7654_32100b0101_01010x1p-20x1.Fp+00X_1_FFF_P-16NaNnanInfinity+Infinity-Infinityinf+inf-inf1.23 - 34.5i1.23e+1 - 34.5e-1i0x1.8p+1 - 0x1.8p-1iNaN-NaNiNaN - NaN_iInfinity-InfinityiInfinity - Infinity_i"foobar"'foobar'`foo
bar`"""foo
bar"""'''foo
bar'''"Hello\n\r\v\t\b\fWorld!""\u0048\u0065\u006c\u006c\u006f\u002c\u0020\u0057\u006f\u0072\u006c\u0064\u0021""\u{000048}\u{000065}\u{00006c}\u{00006c}\u{00006f}\u{00002c}\u{000020}\u{000057}\u{00006f}\u{000072}\u{00006c}\u{000064}\u{000021}""\x48\x65\x6c\x6c\x6f\x2c\x20\x57\x6f\x72\x6c\x64\x21""foo" "bar"
// -> "foobar"'foo' 'bar'
// -> 'foobar'truefalsenull
// -> nilundefined
// -> nilNone
// -> nil# Hash line comment// Line comment/*
Block comment
*/MIT
Copyright (c) 2023 Shellyl_N and Authors.
Powered by takenoco Parser Combinator Library