huma

package module

Go to main page

Versions in this module

v2

v2.26.0

Nov 13, 2024

v2.25.0

Nov 4, 2024

Changes in this version

+ var ValidateStrictCasing = false

v2.24.0

Oct 18, 2024

Changes in this version

+ var DefaultArrayNullable = true

type Context

+ TLS func() *tls.ConnectionState

+ Version func() ProtoVersion

+ type ProtoVersion struct

+ Proto string

+ ProtoMajor int

+ ProtoMinor int

v2.23.0

Sep 23, 2024

Changes in this version

+ var NewErrorWithContext = func(_ Context, status int, msg string, errs ...error) StatusError

v2.22.1

Aug 20, 2024

v2.22.0

Aug 19, 2024

v2.21.0

Aug 12, 2024

v2.20.0

Jul 29, 2024

Changes in this version

+ var ErrorFormatter func(format string, a ...any) string = fmt.Sprintf

v2.19.0

Jul 15, 2024

Changes in this version

type FormFile

+ Filename string

+ Size int64

v2.18.0

Jun 3, 2024

Changes in this version

+ type FormFile struct

+ ContentType string

+ IsSet bool

+ type MimeTypeValidator struct

+ func NewMimeTypeValidator(encoding *Encoding) MimeTypeValidator

+ func (v MimeTypeValidator) Validate(fh *multipart.FileHeader, location string) (string, *ErrorDetail)

+ type MultipartFormFiles struct

+ Form *multipart.Form

+ func (m *MultipartFormFiles[T]) Data() *T

+ func (m *MultipartFormFiles[T]) Decode(opMediaType *MediaType) []error

+ type SchemaTransformer interface

+ TransformSchema func(r Registry, s *Schema) *Schema

v2.17.0

May 20, 2024

Changes in this version

+ func OperationTags(tags ...string) func(o *Operation)

type Context

+ RemoteAddr func() string

v2.16.0

May 5, 2024

v2.15.0

Apr 29, 2024

Changes in this version

+ type Discriminator struct

+ Mapping map[string]string

+ PropertyName string

+ func (d *Discriminator) MarshalJSON() ([]byte, error)

type Schema

+ Discriminator *Discriminator

v2.14.0

Apr 22, 2024

Changes in this version

+ func ErrorWithHeaders(err error, headers http.Header) error

+ type HeadersError interface

+ Error func() string

+ GetHeaders func() http.Header

v2.13.1

Apr 19, 2024

v2.13.0

Apr 15, 2024

Changes in this version

+ var DefaultFormats = map[string]Format

type Context

+ Status func() int

type Operation

+ Middlewares Middlewares

v2.12.0

Apr 8, 2024

Changes in this version

type OpenAPI

+ func (o *OpenAPI) DowngradeYAML() ([]byte, error)

+ func (o OpenAPI) Downgrade() ([]byte, error)

type Schema

+ Nullable bool

v2.11.0

Apr 1, 2024

Changes in this version

type Config

+ CreateHooks []func(Config) Config

v2.10.0

Mar 25, 2024

Changes in this version

type Registry

+ RegisterTypeAlias func(t reflect.Type, alias reflect.Type)

v2.9.0

Mar 18, 2024

Changes in this version

type Schema

+ DependentRequired map[string][]string

+ PatternDescription string

v2.8.0

Mar 11, 2024

Changes in this version

+ var GenerateSummary = func(method, path string, response any) string

type Context

+ func WithContext(ctx Context, override context.Context) Context

+ func WithValue(ctx Context, key, value any) Context

v2.7.0

Mar 5, 2024

Changes in this version

+ var GenerateOperationID = func(method, path string, response any) string

+ func Delete[I, O any](api API, path string, handler func(context.Context, *I) (*O, error))

+ func Get[I, O any](api API, path string, handler func(context.Context, *I) (*O, error))

+ func Patch[I, O any](api API, path string, handler func(context.Context, *I) (*O, error))

+ func Post[I, O any](api API, path string, handler func(context.Context, *I) (*O, error))

+ func Put[I, O any](api API, path string, handler func(context.Context, *I) (*O, error))

v2.6.0

Feb 23, 2024

Changes in this version

+ func ReadCookie(ctx Context, name string) (*http.Cookie, error)

+ func ReadCookies(ctx Context) []*http.Cookie

v2.5.0

Feb 20, 2024

v2.4.0

Feb 2, 2024

Changes in this version

type Components

+ func (c *Components) MarshalJSON() ([]byte, error)

type Contact

+ func (c *Contact) MarshalJSON() ([]byte, error)

type Encoding

+ func (e *Encoding) MarshalJSON() ([]byte, error)

type Example

+ func (e *Example) MarshalJSON() ([]byte, error)

type ExternalDocs

+ func (e *ExternalDocs) MarshalJSON() ([]byte, error)

type Info

+ func (i *Info) MarshalJSON() ([]byte, error)

type License

+ func (l *License) MarshalJSON() ([]byte, error)

type Link

+ func (l *Link) MarshalJSON() ([]byte, error)

type MediaType

+ func (m *MediaType) MarshalJSON() ([]byte, error)

type OAuthFlow

+ func (o *OAuthFlow) MarshalJSON() ([]byte, error)

type OAuthFlows

+ func (o *OAuthFlows) MarshalJSON() ([]byte, error)

type OpenAPI

+ func (o *OpenAPI) YAML() ([]byte, error)

type Operation

+ func (o *Operation) MarshalJSON() ([]byte, error)

type Param

+ func (p *Param) MarshalJSON() ([]byte, error)

type PathItem

+ func (p *PathItem) MarshalJSON() ([]byte, error)

type RequestBody

+ func (r *RequestBody) MarshalJSON() ([]byte, error)

type Response

+ func (r *Response) MarshalJSON() ([]byte, error)

type SecurityScheme

+ func (s *SecurityScheme) MarshalJSON() ([]byte, error)

type Server

+ func (s *Server) MarshalJSON() ([]byte, error)

type ServerVariable

+ func (v *ServerVariable) MarshalJSON() ([]byte, error)

type Tag

+ func (t *Tag) MarshalJSON() ([]byte, error)

v2.3.0

Jan 24, 2024

v2.2.0

Jan 5, 2024

v2.1.0

Dec 13, 2023

v2.0.1

Dec 10, 2023

v2.0.0

Nov 22, 2023

Changes in this version

+ const TypeArray

+ const TypeBoolean

+ const TypeInteger

+ const TypeNumber

+ const TypeObject

+ const TypeString

+ var DefaultCBORFormat = Format

+ var DefaultJSONFormat = Format

+ var ErrSchemaInvalid = errors.New("schema is invalid")

+ var ErrUnknownContentType = errors.New("unknown content type")

+ var NewError = func(status int, msg string, errs ...error) StatusError

+ func AutoRegister(api API, server any)

+ func DefaultSchemaNamer(t reflect.Type, hint string) string

+ func FieldSelectTransform(ctx Context, status string, v any) (any, error)

+ func Register[I, O any](api API, op Operation, handler func(context.Context, *I) (*O, error))

+ func SetReadDeadline(w http.ResponseWriter, deadline time.Time) error

+ func Validate(r Registry, s *Schema, path *PathBuffer, mode ValidateMode, v any, ...)

+ func WithOptions[Options any](f func(cmd *cobra.Command, args []string, options *Options)) func(*cobra.Command, []string)

+ func WriteErr(api API, ctx Context, status int, msg string, errs ...error) error

+ type API interface

+ Adapter func() Adapter

+ Marshal func(w io.Writer, contentType string, v any) error

+ Middlewares func() Middlewares

+ Negotiate func(accept string) (string, error)

+ OpenAPI func() *OpenAPI

+ Transform func(ctx Context, status string, v any) (any, error)

+ Unmarshal func(contentType string, data []byte, v any) error

+ UseMiddleware func(middlewares ...func(ctx Context, next func(Context)))

+ func NewAPI(config Config, a Adapter) API

+ type Adapter interface

+ Handle func(op *Operation, handler func(ctx Context))

+ ServeHTTP func(http.ResponseWriter, *http.Request)

+ type AddOpFunc func(oapi *OpenAPI, op *Operation)

+ type AutoConfig struct

+ Headers map[string]string

+ Params map[string]string

+ Prompt map[string]AutoConfigVar

+ Security string

+ type AutoConfigVar struct

+ Default interface{}

+ Description string

+ Enum []interface{}

+ Example string

+ Exclude bool

+ type CLI interface

+ Root func() *cobra.Command

+ Run func()

+ func NewCLI[O any](onParsed func(Hooks, *O)) CLI

+ type Components struct

+ Callbacks map[string]*PathItem

+ Examples map[string]*Example

+ Extensions map[string]any

+ Headers map[string]*Header

+ Links map[string]*Link

+ Parameters map[string]*Param

+ PathItems map[string]*PathItem

+ RequestBodies map[string]*RequestBody

+ Responses map[string]*Response

+ Schemas Registry

+ SecuritySchemes map[string]*SecurityScheme

+ type Config struct

+ DefaultFormat string

+ DocsPath string

+ Formats map[string]Format

+ OpenAPIPath string

+ SchemasPath string

+ Transformers []Transformer

+ func DefaultConfig(title, version string) Config

+ type Contact struct

+ Email string

+ Extensions map[string]any

+ Name string

+ URL string

+ type ContentTypeFilter interface

+ ContentType func(string) string

+ type Context interface

+ AppendHeader func(name, value string)

+ BodyReader func() io.Reader

+ BodyWriter func() io.Writer

+ Context func() context.Context

+ EachHeader func(cb func(name, value string))

+ GetMultipartForm func() (*multipart.Form, error)

+ Header func(name string) string

+ Host func() string

+ Method func() string

+ Operation func() *Operation

+ Param func(name string) string

+ Query func(name string) string

+ SetHeader func(name, value string)

+ SetReadDeadline func(time.Time) error

+ SetStatus func(code int)

+ URL func() url.URL

+ type Encoding struct

+ AllowReserved bool

+ ContentType string

+ Explode *bool

+ Extensions map[string]any

+ Headers map[string]*Header

+ Style string

+ type ErrorDetail struct

+ Location string

+ Message string

+ Value any

+ func (e *ErrorDetail) Error() string

+ func (e *ErrorDetail) ErrorDetail() *ErrorDetail

+ type ErrorDetailer interface

+ ErrorDetail func() *ErrorDetail

+ type ErrorModel struct

+ Detail string

+ Errors []*ErrorDetail

+ Instance string

+ Status int

+ Title string

+ Type string

+ func (e *ErrorModel) Add(err error)

+ func (e *ErrorModel) ContentType(ct string) string

+ func (e *ErrorModel) Error() string

+ func (e *ErrorModel) GetStatus() int

+ type Example struct

+ Description string

+ Extensions map[string]any

+ ExternalValue string

+ Ref string

+ Summary string

+ Value any

+ type ExternalDocs struct

+ Description string

+ Extensions map[string]any

+ URL string

+ type Format struct

+ Marshal func(writer io.Writer, v any) error

+ Unmarshal func(data []byte, v any) error

+ type Header = Param

+ type Hooks interface

+ OnStart func(func())

+ OnStop func(func())

+ type Info struct

+ Contact *Contact

+ Description string

+ Extensions map[string]any

+ License *License

+ TermsOfService string

+ Title string

+ Version string

+ type License struct

+ Extensions map[string]any

+ Identifier string

+ Name string

+ URL string

+ type Link struct

+ Description string

+ Extensions map[string]any

+ OperationID string

+ OperationRef string

+ Parameters map[string]any

+ Ref string

+ RequestBody any

+ Server *Server

+ type MediaType struct

+ Encoding map[string]*Encoding

+ Example any

+ Examples map[string]*Example

+ Extensions map[string]any

+ Schema *Schema

+ type Middlewares []func(ctx Context, next func(Context))

+ func (m Middlewares) Handler(endpoint func(Context)) func(Context)

+ type ModelValidator struct

+ func NewModelValidator() *ModelValidator

+ func (v *ModelValidator) Validate(typ reflect.Type, value any) []error

+ type OAuthFlow struct

+ AuthorizationURL string

+ Extensions map[string]any

+ RefreshURL string

+ Scopes map[string]string

+ TokenURL string

+ type OAuthFlows struct

+ AuthorizationCode *OAuthFlow

+ ClientCredentials *OAuthFlow

+ Extensions map[string]any

+ Implicit *OAuthFlow

+ Password *OAuthFlow

+ type OpenAPI struct

+ Components *Components

+ Extensions map[string]any

+ ExternalDocs *ExternalDocs

+ Info *Info

+ JSONSchemaDialect string

+ OnAddOperation []AddOpFunc

+ OpenAPI string

+ Paths map[string]*PathItem

+ Security []map[string][]string

+ Servers []*Server

+ Tags []*Tag

+ Webhooks map[string]*PathItem

+ func (o *OpenAPI) AddOperation(op *Operation)

+ func (o *OpenAPI) MarshalJSON() ([]byte, error)

+ type Operation struct

+ BodyReadTimeout time.Duration

+ Callbacks map[string]*PathItem

+ DefaultStatus int

+ Deprecated bool

+ Description string

+ Errors []int

+ Extensions map[string]any

+ ExternalDocs *ExternalDocs

+ Hidden bool

+ MaxBodyBytes int64

+ Metadata map[string]any

+ Method string

+ OperationID string

+ Parameters []*Param

+ Path string

+ RequestBody *RequestBody

+ Responses map[string]*Response

+ Security []map[string][]string

+ Servers []*Server

+ SkipValidateBody bool

+ SkipValidateParams bool

+ Summary string

+ Tags []string

+ type Param struct

+ AllowEmptyValue bool

+ AllowReserved bool

+ Deprecated bool

+ Description string

+ Example any

+ Examples map[string]*Example

+ Explode *bool

+ Extensions map[string]any

+ In string

+ Name string

+ Ref string

+ Required bool

+ Schema *Schema

+ Style string

+ type PathBuffer struct

+ func NewPathBuffer(buf []byte, offset int) *PathBuffer

+ func (b *PathBuffer) Bytes() []byte

+ func (b *PathBuffer) Len() int

+ func (b *PathBuffer) Pop()

+ func (b *PathBuffer) Push(s string)

+ func (b *PathBuffer) PushIndex(i int)

+ func (b *PathBuffer) Reset()

+ func (b *PathBuffer) String() string

+ func (b *PathBuffer) With(s string) string

+ type PathItem struct

+ Delete *Operation

+ Description string

+ Extensions map[string]any

+ Get *Operation

+ Head *Operation

+ Options *Operation

+ Parameters []*Param

+ Patch *Operation

+ Post *Operation

+ Put *Operation

+ Ref string

+ Servers []*Server

+ Summary string

+ Trace *Operation

+ type Registry interface

+ Map func() map[string]*Schema

+ Schema func(t reflect.Type, allowRef bool, hint string) *Schema

+ SchemaFromRef func(ref string) *Schema

+ TypeFromRef func(ref string) reflect.Type

+ func NewMapRegistry(prefix string, namer func(t reflect.Type, hint string) string) Registry

+ type RequestBody struct

+ Content map[string]*MediaType

+ Description string

+ Extensions map[string]any

+ Ref string

+ Required bool

+ type Resolver interface

+ Resolve func(ctx Context) []error

+ type ResolverWithPath interface

+ Resolve func(ctx Context, prefix *PathBuffer) []error

+ type Response struct

+ Content map[string]*MediaType

+ Description string

+ Extensions map[string]any

+ Headers map[string]*Param

+ Links map[string]*Link

+ Ref string

+ type Schema struct

+ AdditionalProperties any

+ AllOf []*Schema

+ AnyOf []*Schema

+ ContentEncoding string

+ Default any

+ Deprecated bool

+ Description string

+ Enum []any

+ Examples []any

+ ExclusiveMaximum *float64

+ ExclusiveMinimum *float64

+ Extensions map[string]any

+ Format string

+ Items *Schema

+ MaxItems *int

+ MaxLength *int

+ MaxProperties *int

+ Maximum *float64

+ MinItems *int

+ MinLength *int

+ MinProperties *int

+ Minimum *float64

+ MultipleOf *float64

+ Not *Schema

+ OneOf []*Schema

+ Pattern string

+ Properties map[string]*Schema

+ ReadOnly bool

+ Ref string

+ Required []string

+ Title string

+ Type string

+ UniqueItems bool

+ WriteOnly bool

+ func SchemaFromField(registry Registry, f reflect.StructField, hint string) *Schema

+ func SchemaFromType(r Registry, t reflect.Type) *Schema

+ func (s *Schema) MarshalJSON() ([]byte, error)

+ func (s *Schema) PrecomputeMessages()

+ type SchemaLinkTransformer struct

+ func NewSchemaLinkTransformer(prefix, schemasPath string) *SchemaLinkTransformer

+ func (t *SchemaLinkTransformer) OnAddOperation(oapi *OpenAPI, op *Operation)

+ func (t *SchemaLinkTransformer) Transform(ctx Context, status string, v any) (any, error)

+ type SchemaProvider interface

+ Schema func(r Registry) *Schema

+ type SecurityScheme struct

+ BearerFormat string

+ Description string

+ Extensions map[string]any

+ Flows *OAuthFlows

+ In string

+ Name string

+ OpenIDConnectURL string

+ Scheme string

+ Type string

+ type Server struct

+ Description string

+ Extensions map[string]any

+ URL string

+ Variables map[string]*ServerVariable

+ type ServerVariable struct

+ Default string

+ Description string

+ Enum []string

+ Extensions map[string]any

+ type StatusError interface

+ Error func() string

+ GetStatus func() int

+ func Error400BadRequest(msg string, errs ...error) StatusError

+ func Error401Unauthorized(msg string, errs ...error) StatusError

+ func Error403Forbidden(msg string, errs ...error) StatusError

+ func Error404NotFound(msg string, errs ...error) StatusError

+ func Error405MethodNotAllowed(msg string, errs ...error) StatusError

+ func Error406NotAcceptable(msg string, errs ...error) StatusError

+ func Error409Conflict(msg string, errs ...error) StatusError

+ func Error410Gone(msg string, errs ...error) StatusError

+ func Error412PreconditionFailed(msg string, errs ...error) StatusError

+ func Error415UnsupportedMediaType(msg string, errs ...error) StatusError

+ func Error422UnprocessableEntity(msg string, errs ...error) StatusError

+ func Error429TooManyRequests(msg string, errs ...error) StatusError

+ func Error500InternalServerError(msg string, errs ...error) StatusError

+ func Error501NotImplemented(msg string, errs ...error) StatusError

+ func Error502BadGateway(msg string, errs ...error) StatusError

+ func Error503ServiceUnavailable(msg string, errs ...error) StatusError

+ func Error504GatewayTimeout(msg string, errs ...error) StatusError

+ func Status304NotModified() StatusError

+ type StreamResponse struct

+ Body func(ctx Context)

+ type Tag struct

+ Description string

+ Extensions map[string]any

+ ExternalDocs *ExternalDocs

+ Name string

+ type Transformer func(ctx Context, status string, v any) (any, error)

+ type ValidateMode int

+ const ModeReadFromServer

+ const ModeWriteToServer

+ type ValidateResult struct

+ Errors []error

+ func (r *ValidateResult) Add(path *PathBuffer, v any, msg string)

+ func (r *ValidateResult) Addf(path *PathBuffer, v any, format string, args ...any)

+ func (r *ValidateResult) Reset()

v2.0.0-rc.1

Nov 6, 2023

v2.0.0-beta.3

Oct 23, 2023

v2.0.0-beta.2

Sep 11, 2023

v2.0.0-beta.1

Aug 25, 2023

Other modules containing this package

github.com/danielgtaylor/huma

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