bump version to 1.0.0

[ggicci]

I'm planing to publish the first stable release of this program. If any of you were using this library in your production environment, please feel free to leave a comment below. A breif description of your application scenarios will bring great helps ❤️

[emilien-puget]

Hi, i'm looking at using your lib like this

package main

import (
	"encoding/json"
	"log/slog"
	"net/http"

	"github.com/ggicci/httpin"
)

type Request[T any] struct {
	*http.Request
	Data *T
}

type Response[T any] struct {
	StatusCode int
	Data       *T
}

// Handler defines generic HTTP handler function.
type Handler[I, O any] func(*Request[I]) (*Response[O], error)

// Wrap wraps generic handler into Go idiomatic HTTP handler function.
// Request is parsed using [httpin.Decode].
// Response from generic handler is automatically JSON encoded and passed to idiomatic HTTP handler.
func Wrap[I, O any](handler Handler[I, O]) func(http.ResponseWriter, *http.Request) {
	return func(res http.ResponseWriter, req *http.Request) {
		var reqData I

		err := httpin.Decode(req, &reqData)
		if err != nil {
			return
		}

		r, err := handler(&Request[I]{Request: req, Data: &reqData})
		if err != nil {
			slog.Error("handler", "error", err)
			res.WriteHeader(http.StatusInternalServerError)
			return
		}
		render(res, r)
	}
}

func render[O any](res http.ResponseWriter, response *Response[O]) {
	res.Header().Set("Content-Type", "application/json")

	resData, err := json.Marshal(response.Data)
	if err != nil {
		res.WriteHeader(http.StatusInternalServerError)

		return
	}

	if response.StatusCode == 0 {
		response.StatusCode = http.StatusOK
	}

	res.WriteHeader(response.StatusCode)
	_, _ = res.Write(resData)
}

[ggicci]

Hi @emilien-puget , sorry I missed the message. But I still want to say thank you for your sharing your use case!

[chriss-de]

What is missing for a 1.0.0 ?

[ggicci]

hey @chriss-de, I think for now nothing is missing for a 1.0.0 actually in the perspective of functionalities. What I would like to do before releasing 1.0.0:

1. Evaulating the current API set, make sure it will be persistent without changes for a relatively long time. Bascially, Feature Request: non-global directives #109 blocks the evaluation, because it requires API changes. So I still need some time to make the decision.
2. Dealing with nested structs (again) and OpenAPI v3 - deepObject #87 is a complex one. But we can leave it open and come back later after 1.0.0.
3. I need one more refactoring which adopts strconvx in httpin. I already have started the work in use-strconvx branch.
4. Update the docs to reflect the latest changes.

[ggicci]

I also have a performance test task on my plate. I would like to compare performance with exsiting similar packages. I guess some Go developers are interested in seeing the report.