parser

parser — JSON & CSV parsing with schema validation

import "github.com/downsized-devs/sdk-go/parser"

Stability: Stable — see STABILITY.md

JSON parsing via json-iterator/go (configurable presets), CSV via gocsv, and optional JSON-Schema validation via gojsonschema.

Features

• JsonInterface with Marshal/Unmarshal variants (5 modes: standard, default, fastest, custom, etc.)
• JSON Schema validation against a registered schema set
• CsvInterface for typed CSV reads
• Single InitParser factory returns both

Installation

go get github.com/downsized-devs/sdk-go/parser

Quick Start

p := parser.InitParser(log, parser.Options{
    Json: parser.JsonOptions{ Config: parser.DefaultConfig },
})
jp := p.JSONParser()

raw, _ := jp.Marshal(map[string]any{"hello": "world"})
var out map[string]any
_ = jp.Unmarshal(raw, &out)

API Reference

Configuration

Examples

JSON Schema validation

p := parser.InitParser(log, parser.Options{
    Json: parser.JsonOptions{
        Schema: map[string]string{ "user": "file://schemas/user.json" },
    },
})
if err := p.JSONParser().ValidateAgainstSchema("user", raw); err != nil {
    return errors.WrapWithCode(err, codes.CodeJSONSchemaInvalid, "user payload")
}

Error Handling

Validation/parse errors are wrapped with codes parser codes.

Dependencies

• Internal: codes, errors, logger
• External: github.com/json-iterator/go, github.com/xeipuuv/gojsonschema, github.com/gocarina/gocsv

Testing

go test ./parser/...

JSON path is covered; CSV path currently has no tests.

Contributing

See CONTRIBUTING.md.

Related Packages

• auth, messaging — primary consumers.
• convert — primitive type conversion.