huma

This is a major new release with a completely rewritten interface using Go generics. Please see https://huma.rocks/ for documentation!

What's Changed

• docs: new mkdocs based documentation site by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/166
• fix: mkdocs deploy path by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/167
• fix: trigger docs workflow on edits by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/168
• docs: fix a few links by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/169
• docs: add social plugin & descriptions, various small fixes by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/170
• docs: switch to huma.rocks docs by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/171
• docs: make CNAME permanent [ci skip] by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/172
• chore: add linter & rules config by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/173
• test: add body and nested defaults test by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/174
• docs: remove logos [ci skip] by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/175
• fix: support custom errors with private fields; docs updates by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/176
• fix: use 415 status for bad input content type by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/177
• fix: enable validation for map[any]any used by some formats by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/178

Full Changelog: https://github.com/danielgtaylor/huma/compare/v2.0.0-rc.1...v2.0.0

What's Changed

• docs: fix content type typo [ci skip] by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/153
• feat: simplify humatest, allow sending body slice/map/struct, docs by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/155
• feat: split transform/marshal, reorg tests & dogfood humatest by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/156
• fix: autopatch fixes, add tests by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/157
• docs: lots of docs updates, a few more tests/examples by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/158
• feat: operation metadata and autopatch disable by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/159
• feat: add Server Sent Events example by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/160
• fix: better paths for resolvers, prevent subtle mistakes by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/161
• feat: add more examples by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/162
• fix: omit empty string/time headers from response by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/163
• fix: set response status after transforms by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/165
• fix: better comparison of encoded payloads for patch, fixes #73 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/164

Full Changelog: https://github.com/danielgtaylor/huma/compare/v2.0.0-beta.3...v2.0.0-rc.1

What's Changed

• fix: backport Huma v2 example pointer fix from #148 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/154

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.14.1...v1.14.2

What's Changed

• chore(deps): bump github.com/gofiber/fiber/v2 from 2.45.0 to 2.49.2 by @dependabot in https://github.com/danielgtaylor/huma/pull/129
• feat: oneOf, anyOf, allOf, not schema support by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/131
• fix: set explode=false for query params by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/136
• huma: v2: add middlewares support by @Insei in https://github.com/danielgtaylor/huma/pull/134
• chore(deps): bump golang.org/x/net from 0.10.0 to 0.17.0 by @dependabot in https://github.com/danielgtaylor/huma/pull/135
• fix: allow fiber without StreamRequestBody, fixes #127 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/138
• Fix: Update transforms.go to use explicit Host function from huma.Context by @james-andrewsmith in https://github.com/danielgtaylor/huma/pull/139
• chore(deps): bump github.com/gofiber/fiber/v2 from 2.49.2 to 2.50.0 by @dependabot in https://github.com/danielgtaylor/huma/pull/140
• docs: improve CLI docs around option naming by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/141
• Fixed a typo in Readme.md (cliend -> client) by @jmichael7 in https://github.com/danielgtaylor/huma/pull/142
• Minor update to SSE example in README.md by @james-andrewsmith in https://github.com/danielgtaylor/huma/pull/143
• fix: support v1 middleware, add example by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/144
• fix: add param re-use example, fixes #94 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/146
• feat: support custom field schemas; add omittable example by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/145
• feat: add example for oneOf response, fix custom schema usage by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/147
• fix: prevent panic on examples for pointer field types by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/148
• feat: allow making query/header params required by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/149
• feat: better support for file uploads by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/150
• fix: add $schema field to input to allow round-trips by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/151
• feat: allow resolvers to set a custom response status code by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/152

New Contributors

• @Insei made their first contribution in https://github.com/danielgtaylor/huma/pull/134
• @james-andrewsmith made their first contribution in https://github.com/danielgtaylor/huma/pull/139
• @jmichael7 made their first contribution in https://github.com/danielgtaylor/huma/pull/142

Full Changelog: https://github.com/danielgtaylor/huma/compare/v2.0.0-beta.2...v2.0.0-beta.3

What's Changed

• chore(deps): bump github.com/gin-gonic/gin from 1.9.0 to 1.9.1 by @dependabot in https://github.com/danielgtaylor/huma/pull/112
• docs: fix docs links by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/114
• fix: better support of generic named types by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/115
• fix: incorrect schema for embedded structs by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/116
• docs: fix minor typos by @omahs in https://github.com/danielgtaylor/huma/pull/117
• fix: param date/time parsing, better tests/coverage by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/118
• Add GetMultipartForm method to huma context by @lordspinach in https://github.com/danielgtaylor/huma/pull/119
• doc: update cli OnStart example to use v2 API by @nickajacks1 in https://github.com/danielgtaylor/huma/pull/120
• fix: improved tests, fixed a few small issues by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/122
• docs: improve docs & examples by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/123
• feat: upgrade to Chi v5 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/124
• docs: fix example by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/125
• feat: add convenience model validator by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/126

New Contributors

• @omahs made their first contribution in https://github.com/danielgtaylor/huma/pull/117
• @lordspinach made their first contribution in https://github.com/danielgtaylor/huma/pull/119
• @nickajacks1 made their first contribution in https://github.com/danielgtaylor/huma/pull/120

Full Changelog: https://github.com/danielgtaylor/huma/compare/v2.0.0-beta.1...v2.0.0-beta.2

Please see the main project README for what is new in v2. This is a major breaking change with a significantly different API.

What's Changed

• Initial v2 Beta by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/111

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.14.1...v2.0.0-beta.1

What's Changed

• fix: enforce path params are required by @iwong-isp in https://github.com/danielgtaylor/huma/pull/103

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.14.0...v1.14.1

Note: The generated schema reference behavior from Huma v1.13.0 has been reverted as it breaks things. This release uses the original behavior by default, and provides an opt-in fixed v1.13.0 behavior via schema.GenerateInline = false! If you rely on the broken behavior you will want to set that value when upgrading.

What's Changed

• fix: implement Flusher interface for wrapped ResponseWriters by @mtiller in https://github.com/danielgtaylor/huma/pull/89
• fix: add missing CORS headers by @mtiller in https://github.com/danielgtaylor/huma/pull/90
• Add stoplight elements docs handler option by @lp-disco in https://github.com/danielgtaylor/huma/pull/95
• fix: properly instantiate nested schemas, replaces #86 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/100
• chore(deps): bump golang.org/x/crypto from 0.0.0-20220112180741-5e0467b6c7ce to 0.1.0 in /benchmark by @dependabot in https://github.com/danielgtaylor/huma/pull/91
• chore(deps): bump golang.org/x/sys from 0.0.0-20220318055525-2edf467146b5 to 0.1.0 by @dependabot in https://github.com/danielgtaylor/huma/pull/93

New Contributors

• @mtiller made their first contribution in https://github.com/danielgtaylor/huma/pull/89
• @lp-disco made their first contribution in https://github.com/danielgtaylor/huma/pull/95

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.13.0...v1.14.0

What's Changed

• chore(deps): bump github.com/labstack/echo/v4 from 4.1.15 to 4.9.0 in /benchmark by @dependabot in https://github.com/danielgtaylor/huma/pull/72
• feat: avoids infinite recursion by @mt35-rs in https://github.com/danielgtaylor/huma/pull/77
• feat: schema handler can now handle schema names with special characters by @mt35-rs in https://github.com/danielgtaylor/huma/pull/81
• feat: ability to fetch router from huma context by @mt35-rs in https://github.com/danielgtaylor/huma/pull/82
• Fix typo by @sdil in https://github.com/danielgtaylor/huma/pull/85
• fix: this uses proper schema path for errors by @mt35-rs in https://github.com/danielgtaylor/huma/pull/80

New Contributors

• @mt35-rs made their first contribution in https://github.com/danielgtaylor/huma/pull/77
• @sdil made their first contribution in https://github.com/danielgtaylor/huma/pull/85

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.12.3...v1.13.0

What's Changed

• fix: don't override vary header by @iwong-isp in https://github.com/danielgtaylor/huma/pull/76

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.12.2...v1.12.3

What's Changed

• fix: stable OpenAPI property and param ordering by @iwong-isp in https://github.com/danielgtaylor/huma/pull/71

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.12.1...v1.12.2

What's Changed

• fix: auto-mark patch deprecated by @iwong-isp in https://github.com/danielgtaylor/huma/pull/70

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.12.0...v1.12.1

What's Changed

• feat: add deprecated flag to operations by @iwong-isp in https://github.com/danielgtaylor/huma/pull/69

New Contributors

• @iwong-isp made their first contribution in https://github.com/danielgtaylor/huma/pull/69

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.11.2...v1.12.0

What's Changed

• fix: panic on put without body by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/67

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.11.1...v1.11.2

What's Changed

• fix: ensure PATCH operation IDs are unique by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/66

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.11.0...v1.11.1

What's Changed

• Fix DisableSchemaProperty by @Fishwaldo in https://github.com/danielgtaylor/huma/pull/60
• add AddAllowedHeaders function to whitelist common headers by @Fishwaldo in https://github.com/danielgtaylor/huma/pull/61
• fix: add all security scheme object in OpenAPI 3.0.3 by @DavidFeng in https://github.com/danielgtaylor/huma/pull/55
• fix: $schema in request, fixes #48 by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/62
• feat: automatic PATCH operation generation by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/64
• Fix GraphQL field casing by camel casing the path by @jpkalbacher in https://github.com/danielgtaylor/huma/pull/65

New Contributors

• @Fishwaldo made their first contribution in https://github.com/danielgtaylor/huma/pull/60
• @DavidFeng made their first contribution in https://github.com/danielgtaylor/huma/pull/55

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.10.0...v1.11.0

What's Changed

• feat: Add ClientClosedRequest to responses by @jpkalbacher in https://github.com/danielgtaylor/huma/pull/58

New Contributors

• @jpkalbacher made their first contribution in https://github.com/danielgtaylor/huma/pull/58

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.9.0...v1.10.0

What's Changed

• docs: add TOC to README.md plus Install section by @hagemt in https://github.com/danielgtaylor/huma/pull/54
• feat(graphql): add ignore prefixes config option by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/57

New Contributors

• @hagemt made their first contribution in https://github.com/danielgtaylor/huma/pull/54

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.8.0...v1.9.0

What's Changed

• feat: make the path for static openapi routes configurable by @lgarrett-isp in https://github.com/danielgtaylor/huma/pull/52

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.7.0...v1.8.0

What's Changed

• feat: add RawBody support and UnsupportedMediaType response by @danielgtaylor in https://github.com/danielgtaylor/huma/pull/51

Full Changelog: https://github.com/danielgtaylor/huma/compare/v1.6.0...v1.7.0