httpio

package module

Go to main page

Versions in this module

v0

v0.7.11

Apr 26, 2026

Changes in this version

+ func HasBadGateway(err error) bool

+ func HasGatewayTimeout(err error) bool

+ func HasMethodNotAllowed(err error) bool

+ func HasNotImplemented(err error) bool

+ func HasRequestTimeout(err error) bool

+ func HasUnprocessableEntity(err error) bool

+ func NewBadGateway() errors.Chain

+ func NewBadGatewayMessage(message string) errors.Chain

+ func NewBadGatewayMessageWithError(err error, message string) errors.Chain

+ func NewBadGatewayMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewBadGatewayMessagef(format string, a ...any) errors.Chain

+ func NewBadGatewayWithError(err error) errors.Chain

+ func NewGatewayTimeout() errors.Chain

+ func NewGatewayTimeoutMessage(message string) errors.Chain

+ func NewGatewayTimeoutMessageWithError(err error, message string) errors.Chain

+ func NewGatewayTimeoutMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewGatewayTimeoutMessagef(format string, a ...any) errors.Chain

+ func NewGatewayTimeoutWithError(err error) errors.Chain

+ func NewMethodNotAllowed() errors.Chain

+ func NewMethodNotAllowedMessage(message string) errors.Chain

+ func NewMethodNotAllowedMessageWithError(err error, message string) errors.Chain

+ func NewMethodNotAllowedMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewMethodNotAllowedMessagef(format string, a ...any) errors.Chain

+ func NewMethodNotAllowedWithError(err error) errors.Chain

+ func NewNotImplemented() errors.Chain

+ func NewNotImplementedMessage(message string) errors.Chain

+ func NewNotImplementedMessageWithError(err error, message string) errors.Chain

+ func NewNotImplementedMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewNotImplementedMessagef(format string, a ...any) errors.Chain

+ func NewNotImplementedWithError(err error) errors.Chain

+ func NewRequestTimeout() errors.Chain

+ func NewRequestTimeoutMessage(message string) errors.Chain

+ func NewRequestTimeoutMessageWithError(err error, message string) errors.Chain

+ func NewRequestTimeoutMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewRequestTimeoutMessagef(format string, a ...any) errors.Chain

+ func NewRequestTimeoutWithError(err error) errors.Chain

+ func NewUnprocessableEntity() errors.Chain

+ func NewUnprocessableEntityMessage(message string) errors.Chain

+ func NewUnprocessableEntityMessageWithError(err error, message string) errors.Chain

+ func NewUnprocessableEntityMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewUnprocessableEntityMessagef(format string, a ...any) errors.Chain

+ func NewUnprocessableEntityWithError(err error) errors.Chain

type Encoder

+ func (e *Encoder) BadGateway(ctx context.Context) error

+ func (e *Encoder) BadGatewayMessage(ctx context.Context, message string) error

+ func (e *Encoder) BadGatewayMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) BadGatewayMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) BadGatewayMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) BadGatewayWithError(ctx context.Context, err error) error

+ func (e *Encoder) GatewayTimeout(ctx context.Context) error

+ func (e *Encoder) GatewayTimeoutMessage(ctx context.Context, message string) error

+ func (e *Encoder) GatewayTimeoutMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) GatewayTimeoutMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) GatewayTimeoutMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) GatewayTimeoutWithError(ctx context.Context, err error) error

+ func (e *Encoder) MethodNotAllowed(ctx context.Context) error

+ func (e *Encoder) MethodNotAllowedMessage(ctx context.Context, message string) error

+ func (e *Encoder) MethodNotAllowedMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) MethodNotAllowedMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) MethodNotAllowedMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) MethodNotAllowedWithError(ctx context.Context, err error) error

+ func (e *Encoder) NotImplemented(ctx context.Context) error

+ func (e *Encoder) NotImplementedMessage(ctx context.Context, message string) error

+ func (e *Encoder) NotImplementedMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) NotImplementedMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) NotImplementedMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) NotImplementedWithError(ctx context.Context, err error) error

+ func (e *Encoder) RequestTimeout(ctx context.Context) error

+ func (e *Encoder) RequestTimeoutMessage(ctx context.Context, message string) error

+ func (e *Encoder) RequestTimeoutMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) RequestTimeoutMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) RequestTimeoutMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) RequestTimeoutWithError(ctx context.Context, err error) error

+ func (e *Encoder) UnprocessableEntity(ctx context.Context) error

+ func (e *Encoder) UnprocessableEntityMessage(ctx context.Context, message string) error

+ func (e *Encoder) UnprocessableEntityMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) UnprocessableEntityMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) UnprocessableEntityMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) UnprocessableEntityWithError(ctx context.Context, err error) error

v0.7.10

Mar 16, 2026

v0.7.9

Dec 13, 2025

v0.7.8

Jul 14, 2025

v0.7.7

Feb 12, 2025

v0.7.6

Jan 31, 2025

v0.7.5

Dec 17, 2024

v0.7.4

Dec 5, 2024

Changes in this version

+ type DomainFromCtx func(context.Context) accesstypes.Domain

+ type QueryDecoder struct

+ func NewQueryDecoder[T any](rSet *resource.ResourceSet, permissionChecker accesstypes.Enforcer, ...) (*QueryDecoder[T], error)

+ func (d *QueryDecoder[T]) Decode(request *http.Request) (*resource.QuerySet, error)

+ type UserFromCtx func(context.Context) accesstypes.User

v0.7.3

Nov 22, 2024

v0.7.2

Nov 21, 2024

v0.7.1

Nov 16, 2024

Changes in this version

+ func HasTooManyRequests(err error) bool

+ func NewTooManyRequests() errors.Chain

+ func NewTooManyRequestsMessage(message string) errors.Chain

+ func NewTooManyRequestsMessageWithError(err error, message string) errors.Chain

+ func NewTooManyRequestsMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewTooManyRequestsMessagef(format string, a ...any) errors.Chain

+ func NewTooManyRequestsWithError(err error) errors.Chain

+ func Operations(r *http.Request, pattern string) iter.Seq2[*Operation, error]

type DecoderWithPermissionChecker

+ func (d *DecoderWithPermissionChecker[T]) DecodeOperation(oper *Operation) (*patchset.PatchSet, error)

type Encoder

+ func (e *Encoder) TooManyRequests(ctx context.Context) error

+ func (e *Encoder) TooManyRequestsMessage(ctx context.Context, message string) error

+ func (e *Encoder) TooManyRequestsMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) TooManyRequestsMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) TooManyRequestsMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) TooManyRequestsWithError(ctx context.Context, err error) error

type Operation

+ Req *http.Request

+ Type OperationType

+ type OperationType string

+ const OperationCreate

+ const OperationDelete

+ const OperationUpdate

v0.7.0

Nov 10, 2024

v0.6.4

Nov 9, 2024

Changes in this version

+ func PermissionFromRequest(r *http.Request) (accesstypes.Permission, error)

+ func Requests(r *http.Request) iter.Seq2[*http.Request, error]

+ type ConsolidatedDecoder struct

+ func NewConsolidatedDecoder[T any](d *DecoderWithPermissionChecker[T]) *ConsolidatedDecoder[T]

+ func (d *ConsolidatedDecoder[T]) Decode(r *http.Request) (*patchset.PatchSet, accesstypes.Permission, error)

+ type Operation struct

+ Op string

+ Path string

+ Value json.RawMessage

+ type StructDecoderWithPermissionChecker struct

+ func (d *StructDecoderWithPermissionChecker[T]) Decode(request *http.Request, perm accesstypes.Permission) (*T, error)

+ func (d *StructDecoderWithPermissionChecker[T]) WithValidator(v ValidatorFunc) *StructDecoderWithPermissionChecker[T]

v0.6.3

Oct 26, 2024

Changes in this version

type ValidatorFunc

+ Struct func(s interface{}) error

+ StructPartial func(s interface{}, fields ...string) error

v0.6.2

Oct 23, 2024

v0.6.1

Oct 23, 2024

v0.6.0

Oct 23, 2024

Changes in this version

+ type CustomDecoderWithPermissionChecker struct

+ func (d *CustomDecoderWithPermissionChecker[T]) Decode(request *http.Request) (*T, error)

+ func (d *CustomDecoderWithPermissionChecker[T]) WithValidator(v ValidatorFunc) *CustomDecoderWithPermissionChecker[T]

+ type NamedPatchSet interface

+ Instance func() any

+ NamedPatchSet func(*patchset.PatchSet) *P

+ type StructDecoder struct

+ func NewStructDecoder[T any]() (*StructDecoder[T], error)

+ func (d *StructDecoder[T]) Decode(request *http.Request) (*T, error)

+ func (d *StructDecoder[T]) WithPermissionChecker(domainFromReq DomainFromReq, userFromReq UserFromReq, ...) *CustomDecoderWithPermissionChecker[T]

+ func (d *StructDecoder[T]) WithValidator(v ValidatorFunc) *StructDecoder[T]

v0.5.1

Oct 16, 2024

v0.5.0

Oct 2, 2024

v0.4.1

Sep 23, 2024

v0.4.0

Sep 17, 2024

Changes in this version

type Enforcer

+ RequireResources func(ctx context.Context, user accesstypes.User, domain accesstypes.Domain, ...) error

v0.3.1

Sep 11, 2024

v0.3.0

Aug 30, 2024

Changes in this version

+ func Log(handler func(w http.ResponseWriter, r *http.Request) error) http.HandlerFunc

type Decoder

+ func (d *Decoder[T]) DecodeToPatchSet(request *http.Request) (*patching.PatchSet, error)

+ func (d *Decoder[T]) WithPermissionChecker(domainFromReq DomainFromReq, userFromReq UserFromReq, enforcer Enforcer, ...) *DecoderWithPermissionChecker[T]

+ func (d *Decoder[T]) WithValidator(v ValidatorFunc) *Decoder[T]

+ type DecoderWithPermissionChecker struct

+ func (d *DecoderWithPermissionChecker[T]) Decode(request *http.Request) (*T, error)

+ func (d *DecoderWithPermissionChecker[T]) DecodeToPatchSet(request *http.Request) (*patching.PatchSet, error)

+ func (d *DecoderWithPermissionChecker[T]) WithValidator(v ValidatorFunc) *DecoderWithPermissionChecker[T]

+ type DomainFromReq func(*http.Request) accesstypes.Domain

+ type Enforcer interface

+ RequireResource func(user accesstypes.User, domain accesstypes.Domain, perms accesstypes.Permission, ...) error

+ type UserFromReq func(*http.Request) accesstypes.User

v0.2.5

Jul 3, 2024

v0.2.4

Jun 10, 2024

v0.2.3

Apr 5, 2024

v0.2.2

Mar 30, 2024

v0.2.1

Mar 7, 2024

v0.2.0

Feb 24, 2024

Changes in this version

+ func CauseIsError(err error) bool

+ func HasBadRequest(err error) bool

+ func HasClientMessage(err error) bool

+ func HasConflict(err error) bool

+ func HasForbidden(err error) bool

+ func HasInternalServerError(err error) bool

+ func HasNotFound(err error) bool

+ func HasServiceUnavailable(err error) bool

+ func HasUnauthorized(err error) bool

+ func Message(err error) string

+ func Messages(err error) []string

+ func NewBadRequest() errors.Chain

+ func NewBadRequestMessage(message string) errors.Chain

+ func NewBadRequestMessageWithError(err error, message string) errors.Chain

+ func NewBadRequestMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewBadRequestMessagef(format string, a ...any) errors.Chain

+ func NewBadRequestWithError(err error) errors.Chain

+ func NewConflict() errors.Chain

+ func NewConflictMessage(message string) errors.Chain

+ func NewConflictMessageWithError(err error, message string) errors.Chain

+ func NewConflictMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewConflictMessagef(format string, a ...any) errors.Chain

+ func NewConflictWithError(err error) errors.Chain

+ func NewForbidden() errors.Chain

+ func NewForbiddenMessage(message string) errors.Chain

+ func NewForbiddenMessageWithError(err error, message string) errors.Chain

+ func NewForbiddenMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewForbiddenMessagef(format string, a ...any) errors.Chain

+ func NewForbiddenWithError(err error) errors.Chain

+ func NewInternalServerError() errors.Chain

+ func NewInternalServerErrorMessage(message string) errors.Chain

+ func NewInternalServerErrorMessageWithError(err error, message string) errors.Chain

+ func NewInternalServerErrorMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewInternalServerErrorMessagef(format string, a ...any) errors.Chain

+ func NewInternalServerErrorWithError(err error) errors.Chain

+ func NewNotFound() errors.Chain

+ func NewNotFoundMessage(message string) errors.Chain

+ func NewNotFoundMessageWithError(err error, message string) errors.Chain

+ func NewNotFoundMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewNotFoundMessagef(format string, a ...any) errors.Chain

+ func NewNotFoundWithError(err error) errors.Chain

+ func NewServiceUnavailable() errors.Chain

+ func NewServiceUnavailableMessage(message string) errors.Chain

+ func NewServiceUnavailableMessageWithError(err error, message string) errors.Chain

+ func NewServiceUnavailableMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewServiceUnavailableMessagef(format string, a ...any) errors.Chain

+ func NewServiceUnavailableWithError(err error) errors.Chain

+ func NewUnauthorized() errors.Chain

+ func NewUnauthorizedMessage(message string) errors.Chain

+ func NewUnauthorizedMessageWithError(err error, message string) errors.Chain

+ func NewUnauthorizedMessageWithErrorf(err error, format string, a ...any) errors.Chain

+ func NewUnauthorizedMessagef(format string, a ...any) errors.Chain

+ func NewUnauthorizedWithError(err error) errors.Chain

+ type ClientMessage struct

+ func (c *ClientMessage) Error() string

+ func (c *ClientMessage) Message() string

+ func (c *ClientMessage) Unwrap() error

type Encoder

+ func (e *Encoder) BadRequestMessage(ctx context.Context, message string) error

+ func (e *Encoder) BadRequestMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) BadRequestMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) BadRequestMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) BadRequestWithError(ctx context.Context, err error) error

+ func (e *Encoder) ClientMessage(ctx context.Context, err error) error

+ func (e *Encoder) ConflictMessage(ctx context.Context, message string) error

+ func (e *Encoder) ConflictMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) ConflictMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) ConflictMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) ConflictWithError(ctx context.Context, err error) error

+ func (e *Encoder) ForbiddenMessage(ctx context.Context, message string) error

+ func (e *Encoder) ForbiddenMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) ForbiddenMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) ForbiddenMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) ForbiddenWithError(ctx context.Context, err error) error

+ func (e *Encoder) InternalServerErrorMessage(ctx context.Context, message string) error

+ func (e *Encoder) InternalServerErrorMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) InternalServerErrorMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) InternalServerErrorMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) InternalServerErrorWithError(ctx context.Context, err error) error

+ func (e *Encoder) NotFoundMessage(ctx context.Context, message string) error

+ func (e *Encoder) NotFoundMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) NotFoundMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) NotFoundMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) NotFoundWithError(ctx context.Context, err error) error

+ func (e *Encoder) ServiceUnavailableMessage(ctx context.Context, message string) error

+ func (e *Encoder) ServiceUnavailableMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) ServiceUnavailableMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) ServiceUnavailableMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) ServiceUnavailableWithError(ctx context.Context, err error) error

+ func (e *Encoder) StatusCodeWithBody(statusCode int, body interface{}) error

+ func (e *Encoder) UnauthorizedMessage(ctx context.Context, message string) error

+ func (e *Encoder) UnauthorizedMessageWithError(ctx context.Context, err error, message string) error

+ func (e *Encoder) UnauthorizedMessageWithErrorf(ctx context.Context, err error, format string, a ...any) error

+ func (e *Encoder) UnauthorizedMessagef(ctx context.Context, format string, a ...any) error

+ func (e *Encoder) UnauthorizedWithError(ctx context.Context, err error) error

type MessageResponse

+ TraceID string

v0.1.1

Nov 28, 2023

v0.1.0

Aug 8, 2023

v0.0.2

Jul 7, 2023

Changes in this version

+ func Param(r *http.Request, param ParamType) (val T)

+ func WithParams(next http.Handler) http.Handler

+ type ParamType string

v0.0.1

May 25, 2023

Changes in this version

+ type Decoder struct

+ func NewDecoder(req *http.Request, validator ValidatorFunc) *Decoder

+ func (d *Decoder) Decode(request interface{}) error

+ type Encoder struct

+ func NewEncoder(w http.ResponseWriter) *Encoder

+ func (e *Encoder) BadRequest(err error) error

+ func (e *Encoder) BadRequestWithMessage(message string, err error) error

+ func (e *Encoder) Conflict(err error) error

+ func (e *Encoder) ConflictWithMessage(message string, err error) error

+ func (e *Encoder) Forbidden(err error) error

+ func (e *Encoder) ForbiddenWithMessage(message string, err error) error

+ func (e *Encoder) InternalServerError(err error) error

+ func (e *Encoder) InternalServerErrorWithMessage(message string, err error) error

+ func (e *Encoder) NotFound(err error) error

+ func (e *Encoder) NotFoundWithMessage(message string, err error) error

+ func (e *Encoder) Ok(body interface{}) error

+ func (e *Encoder) ServiceUnavailable(err error) error

+ func (e *Encoder) ServiceUnavailableWithMessage(message string, err error) error

+ func (e *Encoder) StatusCode(statusCode int, err error) error

+ func (e *Encoder) StatusCodeWithMessage(statusCode int, message string, err error) error

+ func (e *Encoder) Unauthorized(err error) error

+ func (e *Encoder) UnauthorizedWithMessage(message string, err error) error

+ type HTTPEncoder interface

+ Encode func(v interface{}) error

+ type MessageResponse struct

+ Message string

+ type ValidatorFunc func(s interface{}) error

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