json

README

JSON

A single, platform-agnostic JSON codec for Go that optimizes WebAssembly binary size by using zero reflection. It relies on fmt.Fielder for struct encoding/decoding, which is typically generated by ormc.

Architecture

• Zero Reflection: Uses type switches and fmt.Fielder instead of the reflect package.
• Platform-Agnostic: Identical behavior on all platforms (WASM, Linux, macOS, etc.).
• TinyGo Compatible: Optimized for minimal binary size and memory usage.
• Fielder-Only: Only types implementing fmt.Fielder can be directly encoded or decoded.

Usage

Structs

Structs MUST implement fmt.Fielder to be supported. This is normally handled by generating code with ormc.

package main

import (
    "github.com/tinywasm/fmt"
    "github.com/tinywasm/json"
)

// User implements fmt.Fielder (typically via ormc)
type User struct {
    Name string
}

func (u *User) Schema() []fmt.Field {
    return []fmt.Field{{Name: "Name", Type: fmt.FieldText, JSON: "name"}}
}
func (u *User) Values() []any   { return []any{u.Name} }
func (u *User) Pointers() []any { return []any{&u.Name} }

func main() {
    u := User{Name: "Alice"}

    var out string
    if err := json.Encode(&u, &out); err != nil {
        panic(err)
    }
    // out: {"name":"Alice"}

    var result User
    if err := json.Decode(out, &result); err != nil {
        panic(err)
    }
}

API

Encode(data fmt.Fielder, output any) error

Serializes a Fielder to JSON.

• data: Must implement fmt.Fielder.
• output: *[]byte, *string, or io.Writer.

Decode(input any, data fmt.Fielder) error

Parses JSON into a Fielder.

• input: []byte, string, or io.Reader.
• data: Must implement fmt.Fielder.

---

Contributing

License

See LICENSE for details.

Documentation

Index

• func Decode(input any, data fmt.Fielder) error
• func Encode(data fmt.Fielder, output any) error

Functions

func Decode

func Decode(input any, data fmt.Fielder) error

Decode parses JSON into a Fielder. input: []byte | string | io.Reader.

func Encode

func Encode(data fmt.Fielder, output any) error

Encode serializes a Fielder to JSON. output: *[]byte | *string | io.Writer.