demo

httpbind demo

Sample app that exercises the main library features end-to-end.

Streaming model

stream, err := httpbind.NewStream[ChatEvent](w, r)
if err != nil { ... }
defer stream.Close()

_ = stream.Write(ChatEvent{Type: "delta", Delta: "hi"})
_ = stream.Write(ChatEvent{Type: "done"})

Format selection (automatic)

Write is safe to call many times. Headers/status are sent only in NewStream.
JSON array mode needs defer stream.Close() so the trailing ] is written.

NDJSON/JSONL ≠ JSON array: JSONL is one object per line; JSON array is a single [obj1,obj2] body.

Run

# from repository root
go generate ./examples/demo   # regenerate Bind/Write + OpenAPI if needed
go run ./examples/demo

ADDR=:9090 go run ./examples/demo

Quick checks

curl -sS http://localhost:8080/health

curl -sS -X POST 'http://localhost:8080/orgs/acme/users' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer secret' \
  -d '{"name":"Alice","email":"a@example.com"}'

# NDJSON / JSONL stream (curl default)
curl -sSN -X POST 'http://localhost:8080/chat' \
  -H 'Content-Type: application/json' \
  -d '{"message":"hello"}'

# SSE stream
curl -sSN -X POST 'http://localhost:8080/chat?stream=sse' \
  -H 'Content-Type: application/json' \
  -d '{"message":"hello"}'

# JSON array stream (single [...] document; not JSONL)
curl -sSN -X POST 'http://localhost:8080/chat' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"message":"hello"}'

Layout

examples/demo/
  main.go
  handlers.go                 # routes + NewStream chat
  types.go
  generate.go                 # go:generate
  tinybind_gen.go           # generated Bind/Write
  tinybind_openapi_gen.go   # generated OpenAPI embed
  demo_test.go
  README.md

Regenerate

go generate ./examples/demo
# equivalent:
# go run ./cmd/tinybind-gen -dir ./examples/demo