demo

httpbind demo

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

Streaming model

httpbind.WriteStream(w, r, func(s *httpbind.Stream[ChatEvent]) error {
    if err := s.Write(ChatEvent{Type: "delta", Delta: "hi"}); err != nil {
        return err
    }
    return s.Write(ChatEvent{Type: "done"})
})

Format selection (automatic)

Write is safe to call many times. Headers and status are sent once, when the stream opens.
The entry closes the stream, so JSON array mode gets its trailing ] even when the callback fails halfway.

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

# listen port via configbind (env name follows CLI long opt: port -> PORT)
PORT=9090 go run ./examples/demo
# or:
go run ./examples/demo -- --port 9090

Optional TOML (configdir / --config-path):

[server]
port = 9090

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 + WriteStream chat
  index.tb.html               # typed, context-safe HTML template
  index_script.go             # JavaScript passed as trusted script content
  types.go                    # includes ServerConfig (configbind)
  generate.go                 # go:generate
  tinybind_gen.go             # generated Bind/Write
  tinybind_openapi_gen.go     # generated OpenAPI embed
  tinybind_templates_gen.go   # generated typed HTML renderer
  configbind_gen.go           # generated config apply / flags / env
  demo_test.go
  README.md

Regenerate

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