#126 Expose core.ErrFailedToParseRequestForm for handling decoding error.

Nothing but dependencies upgrade to resolve security alerts.

New Features

httpin now supports encoding and decoding path variables when using the native net/http package for routing.

This feature was brough in #113 by @chriss-de, thanks :)

import httpin_integration "github.com/ggicci/httpin/integration"

func init() {
	httpin_integration.UseHttpPathVariable("path")
}

Breaking Changes

The API UseEchoPathRouter(e) was removed due to unnecessary abstraction, please migrate to use UseEchoPathRouter("path", e) instead.

New Feature

Introduced a new directive omitempty, which works on encoding a Go struct to an http.Request. Just think of how omitempty works in encoding/json package. Here in httpin, omitempty will omit adding keys to Query, Form, Header when the corresponding value is empty. See reflect.Value.IsZero for more details about how we judge an empty value.

#107

Thanks to @alecsammon who made this feature availalbe for all httpin users.

Remove indirect dependency to echo by moving the testing code under _test package.

Fixes #101

Breaking Change and Migration Guide

func DecodeTo(req *http.Request, input any, opts ...core.Option) error API has been renamed to DecodeTo, it will populate the given input value instead of creating a new instance internally.

How to migrate to v0.18.0?

Since we haven't changed the signature of this function, we can migrate by replacing httpin.Decode with httpin.DecodeTo in your codebase.

New API

Added new func Decode[T any](req *http.Request, opts ...core.Option) (*T, error) API, example usage:

type AddUserInput struct {
	Username string `in:"form=username"`
}
if input, err := httpin.Decode[AddUserInput](req); err != nil { ... }
// input.Username

#99 Added echo integration, register a "path" directive that can work with echo router.

import httpin_integration "github.com/ggicci/httpin/integration"

func init() {
    e := echo.New()
    httpin_integration.UseEchoRouter("path", e)

    // or
    httpin_integration.UseEchoPathRouter(e)
}

Thanks

@sorenmat

API Changes

Added optional parameter opts ...core.Option to the following APIs:

• httpin.Decode(req *http.Request, input any) error -> httpin.Decode(req *http.Request, input any, opts ...core.Option) error
• httpin.NewRequest(method, url string, input any) (*http.Request, error) -> httpin.NewRequest(method, url string, input any, opts ...core.Option) (*http.Request, error)
• httpin.NewRequestWithContext(ctx context.Context, method, url string, input any) (*http.Request, error) -> httpin.NewRequestWithContext(ctx context.Context, method, url string, input any, opts ...core.Option) (*http.Request, error)

Added a new variable httpin.Option where is a collection of the options.

Fixed #88 - make httpin able to stream uploading large files.

Thanks @excavador

Register the path directive by default, but it only supports encoding function. For a complete path directive, users still need to use the integration subpackage:

import httpin_integration "github.com/ggicci/httpin/integration"

func init() {
	httpin_integration.UseGochiURLParam("gochi", chi.URLParam)
}