request

package

Go to main page

Versions in this module

v0

v0.10.0

Mar 1, 2026

v0.9.0

Feb 27, 2026

v0.8.0

Feb 25, 2026

v0.7.0

Feb 25, 2026

v0.6.0

Feb 24, 2026

v0.5.0

Feb 24, 2026

Changes in this version

+ const DefaultMaxMultipartMemory

+ func BindFormWithConfig[T any](r *http.Request, cfg Config) (T, error)

+ func BindForm[T any](r *http.Request) (T, error)

+ func BindJSONWithConfig[T any](r *http.Request, cfg Config) (T, error)

+ func BindMultipartWithConfig[T any](r *http.Request, cfg Config) (T, error)

+ func BindMultipart[T any](r *http.Request) (T, error)

+ func FormFile(r *http.Request, field string) (*multipart.FileHeader, error)

+ func FormFiles(r *http.Request) map[string][]*multipart.FileHeader

type Config

+ MaxMultipartMemory int64

v0.4.1

Feb 23, 2026

v0.4.0

Feb 23, 2026

v0.3.0

Feb 23, 2026

Changes in this version

+ func IsValidEmail(s string) bool

+ func IsValidURL(s string) bool

+ func IsValidUUID(s string) bool

+ func MatchesRegexp(s, pattern string) bool

+ func ValidateStruct(v any) error

type Validation

+ func (v *Validation) MatchesPattern(field, value, pattern, message string)

+ func (v *Validation) RequireEmail(field, value string)

+ func (v *Validation) RequireURL(field, value string)

+ func (v *Validation) UUID(field, value string)

v0.2.0

Feb 22, 2026

Changes in this version

type Pagination

+ func (p Pagination) HasNext(total int) bool

+ func (p Pagination) HasPrevious() bool

+ func (p Pagination) IsFirstPage() bool

+ func (p Pagination) IsLastPage(total int) bool

+ func (p Pagination) NextPage() int

+ func (p Pagination) PreviousPage() int

+ func (p Pagination) SQLClause() string

+ func (p Pagination) SQLClauseMySQL() string

+ func (p Pagination) TotalPages(total int) int

type PaginationConfig

+ PerPageParams []string

v0.1.0

Feb 21, 2026

Changes in this version

+ const DefaultMaxBodySize

+ const FilterOpEq

+ const FilterOpGt

+ const FilterOpGte

+ const FilterOpIn

+ const FilterOpLt

+ const FilterOpLte

+ const FilterOpNeq

+ func APIKey(r *http.Request, headerName string) string

+ func APIKeyRequired(r *http.Request, headerName string) (string, error)

+ func AcceptsJSON(r *http.Request) bool

+ func BearerToken(r *http.Request) string

+ func BearerTokenRequired(r *http.Request) (string, error)

+ func BindJSON[T any](r *http.Request) (T, error)

+ func BindWithConfig[T any](r *http.Request, cfg Config) (T, error)

+ func Bind[T any](r *http.Request) (T, error)

+ func ClientIP(r *http.Request, trustProxy ...bool) string

+ func ContentType(r *http.Request) string

+ func DecodeJSON(r *http.Request, v any) error

+ func Header(r *http.Request, key, defaultVal string) string

+ func HeaderRequired(r *http.Request, key string) (string, error)

+ func IdempotencyKey(r *http.Request) string

+ func PathParam(r *http.Request, key string) string

+ func PathParamInt(r *http.Request, key string) (int, error)

+ func PathParamInt64(r *http.Request, key string) (int64, error)

+ func PathParamRequired(r *http.Request, key string) (string, error)

+ func QueryBool(r *http.Request, key string, defaultVal bool) (bool, error)

+ func QueryInt(r *http.Request, key string, defaultVal int) (int, error)

+ func QueryInt64(r *http.Request, key string, defaultVal int64) (int64, error)

+ func QueryString(r *http.Request, key, defaultVal string) string

+ func RequestID(r *http.Request) string

+ func SetConfig(cfg Config)

+ func SetPaginationConfig(cfg PaginationConfig)

+ type Config struct

+ DisallowUnknownFields bool

+ MaxBodySize int64

+ func DefaultConfig() Config

+ type CursorPagination struct

+ Cursor string

+ Limit int

+ func PaginateCursor(r *http.Request) (CursorPagination, error)

+ func PaginateCursorWithConfig(r *http.Request, cfg CursorPaginationConfig) (CursorPagination, error)

+ type CursorPaginationConfig struct

+ CursorParam string

+ DefaultLimit int

+ LimitParam string

+ MaxLimit int

+ func DefaultCursorPaginationConfig() CursorPaginationConfig

+ type Filter struct

+ Field string

+ Operator string

+ Value string

+ func ParseFilters(r *http.Request, cfg FilterConfig) ([]Filter, error)

+ type FilterConfig struct

+ AllowedFields []string

+ AllowedOperators []string

+ type Pagination struct

+ Offset int

+ Page int

+ PerPage int

+ func Paginate(r *http.Request) (Pagination, error)

+ func PaginateWithConfig(r *http.Request, cfg PaginationConfig) (Pagination, error)

+ type PaginationConfig struct

+ DefaultPage int

+ DefaultPerPage int

+ MaxPerPage int

+ PageParam string

+ PerPageParam string

+ func DefaultPaginationConfig() PaginationConfig

+ type Query struct

+ func QueryFrom(r *http.Request) *Query

+ func (q *Query) Bool(key string, defaultVal bool) (bool, error)

+ func (q *Query) Float64(key string, defaultVal float64) (float64, error)

+ func (q *Query) Has(key string) bool

+ func (q *Query) Int(key string, defaultVal int) (int, error)

+ func (q *Query) Int64(key string, defaultVal int64) (int64, error)

+ func (q *Query) IntRange(key string, defaultVal, min, max int) (int, error)

+ func (q *Query) String(key, defaultVal string) string

+ func (q *Query) StringRequired(key string) (string, error)

+ func (q *Query) StringSlice(key string) []string

+ func (q *Query) Time(key, layout string) (time.Time, error)

+ type SortConfig struct

+ AllowedFields []string

+ Default []SortField

+ Param string

+ type SortDirection string

+ const SortAsc

+ const SortDesc

+ type SortField struct

+ Direction SortDirection

+ Field string

+ func ParseSort(r *http.Request, cfg SortConfig) ([]SortField, error)

+ type Validation struct

+ func NewValidation() *Validation

+ func (v *Validation) AddError(field, message string)

+ func (v *Validation) Custom(field string, check func() bool, message string)

+ func (v *Validation) Error() error

+ func (v *Validation) Fields() map[string]string

+ func (v *Validation) HasErrors() bool

+ func (v *Validation) MaxLength(field, value string, max int)

+ func (v *Validation) MinLength(field, value string, min int)

+ func (v *Validation) OneOf(field, value string, allowed []string)

+ func (v *Validation) Range(field string, value, min, max int)

+ func (v *Validation) RequireInt(field string, value int)

+ func (v *Validation) RequireString(field, value string)

+ type Validator interface

+ Validate func() error

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL