How do I serve text/html

[Jameswood-vega]

Hello Daniel,
we have recently adopted huma at my current employer, and have had great success with a data api we have built.
I am trying to expand my understanding of how to use this framework, but I can't figure out how to get it to serve good old html content.

for example I have modified the greetings example to return basic html.

I expected this to work.

package main

import (
	"context"
	"fmt"
	"net/http"

	"github.com/danielgtaylor/huma/v2"
	"github.com/danielgtaylor/huma/v2/adapters/humachi"
	"github.com/danielgtaylor/huma/v2/humacli"
	"github.com/go-chi/chi/v5"

	_ "github.com/danielgtaylor/huma/v2/formats/cbor"
)

// Options for the CLI. Pass `--port` or set the `SERVICE_PORT` env var.
type Options struct {
	Port int `help:"Port to listen on" short:"p" default:"8080"`
}

// GreetingOutput represents the greeting operation response.
type GreetingOutput struct {
	ContentType string `header:"Content-Type"`
	Body        struct {
		Message string `json:"message" example:"Hello, world!" doc:"Greeting message"`
	}
}

func main() {
	// Create a CLI app which takes a port option.
	cli := humacli.New(func(hooks humacli.Hooks, options *Options) {
		// Create a new router & API
		router := chi.NewMux()
		api := humachi.New(router, huma.DefaultConfig("My API", "1.0.0"))

		// Add the operation handler to the API.
		huma.Get(api, "/greeting/{name}", func(ctx context.Context, input *struct {
			Name string `path:"name" maxLength:"30" example:"world" doc:"Name to greet"`
		}) (*GreetingOutput, error) {
			resp := &GreetingOutput{}
			resp.Body.Message = fmt.Sprintf("<h1>Hello, %s!</h1>", input.Name)
			resp.ContentType = "text/html"
			return resp, nil
		})

		// Tell the CLI how to start your router.
		hooks.OnStart(func() {
			http.ListenAndServe(fmt.Sprintf(":%d", options.Port), router)
		})
	})

	// Run the CLI. When passed no commands, it starts the server.
	cli.Run()
}

But I get

2024/07/31 16:19:14 http: panic serving 127.0.0.1:44448: error marshaling response for GET /greeting/{name} 200: unknown content type: text/html

I have tried to figure it out on my own and I am stuck please help.

[baderj]

You probably shouldn't return plain HTML at all, but you can always set the Body to []byte to avoid serialization and just return raw bytes:

type GreetingOutput struct {
	ContentType string `header:"Content-Type"`
	Body        []byte `example:"<h1>Hello, world!</h1>" doc:"Greeting message"`
}

Then return the HTML as follows:

resp := &GreetingOutput{}
resp.Body = []byte(fmt.Sprintf("<h1>Hello, %s!</h1>", input.Name))
resp.ContentType = "text/html"
return resp, nil