go-loose-json-parser

README

Go Loose JSON parser

Super loose JSON parser for Go.

🚀 Usage

package main

import (
    "fmt"
    "github.com/shellyln/go-loose-json-parser/jsonlp"
)

func main() {
    // src:     Loose JSON
    // interop: If true, replace NaN, Infinity by null
    // parsed:  nil | []any | map[string]any | float64 | string | bool | time.Time
    parsed, err := jsonlp.Parse(`
    # 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.
        あいうえお: 5,

        "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
        ],

        garply: true,

        // "key => value" syntax is allowed
        waldo => false,

        // Trailing commas are allowed.
        fred: 10,
    }`, false)

    if err != nil {
        fmt.Printf("Parse: error = %v\n", err)
        return
    }

    fmt.Printf("Parsed = %v\n", parsed)
}

📚 Syntax

Array

[]

[1]

[1,]

[1, 2]

[1, 2,]

Object

{}

{ "foo": 1 }

{ "foo": 1, }

{ 'foo': 1, }

{ `foo`: 1, }

{ foo: 1, }

{ "foo": 1, "bar": 2, }

{ "foo" => 1 }

Number

123

-123.45

-1.2345e+6

-123_456_789

0x12345678

0x1234_5678

0o7654_3210

0b0101_0101

NaN

Infinity

+Infinity

-Infinity

String

"foobar"

'foobar'

`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"

Boolean

true

false

Null, Undefined

null

undefined

Comment

# Hash line comment

// Line comment

/*
   Block comment
*/

⚖️ License

MIT
Copyright (c) 2023 Shellyl_N and Authors.