v2.2.0: Pure-Go 1.22+ server, documentation overhaul. JSON schema and several bug fixes #1637
jamietanna
announced in
Announcements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Big announcements
In case you've missed it, we've got a few big announcements as maintainers of
oapi-codegenwhich we'd recommend you read in more depth.oapi-codegenis moving to its own orgoapi-codegenin the futureWe'd also like to thank our sponsors for this release:
🔊 Notable features
The v2.2.0 release was largely focussed on the following big changes, alongside a number of other bug fixes.
Generate a pure Go 1.22+
net/httpserverWith Go 1.22+'s enhanced routing, it's now easier than ever to be able to write a pure-Go HTTP service, and thanks to a contribution from @thedadams we now have a
std-http-server, further documented in the Supported Servers section in the README.Note
Not seeing this working, i.e. seeing a
404 page not found? Make sure that thegodirective in your project'sgo.modis updated!In the future we're going to see if we can preemptively warn you if you're not quite set up correctly.
Documentation overhaul
A significant undertaking in this release was to rewrite pretty much every line of documentation we had, as well as introducing a number of additional examples and test cases.
We're excited to hear your feedback on the new structure of the README, the additional docs added, and whether there are any additional examples that may be of use.
JSON Schema configuration
In the spirit of documentation, we now also have a JSON schema which can be found further documented in the Usage section in the README.
This not only gives a separate definition of fields and their meaning, but it can be used with IDEs for autocompletion and validation, allowing for a much better Developer Experience.
kin-openapi upgrade
A few big upgrades have come in kin-openapi, which we use for the underlying OpenAPI parsing and validation, which included a significant breaking change that meant that consumers of
oapi-codegencouldn't upgrade the kin-openapi version until we had made changes inoapi-codegen.This has additionally been set up as an FAQ as it's one we commonly get.
🚀 New features and improvements
🐛 Bug fixes
nullable(fix: ensure we pre-importnullable#1585) @jamietanna📝 Documentation updates
echoserver (docs(examples): document how to set up authenticated middleware with a non-echoserver #1627) @jamietannax-go-type-namedocs (docs(extensions): add missingx-go-type-namedocs #1616) @jamietannastd-http-serverexample (docs: correctstd-http-serverexample #1576) @sajjanjyothimainbranch (docs: update OpenAPI spec links tomainbranch #1493) @dharsanb👻 Maintenance
mergeOpenapiSchemas(Simplify extensions merge inmergeOpenapiSchemas#1424) @Juneezeegolang.org/x/lint(chore(deps): remove dependency ongolang.org/x/lint#1588) @jamietannaadditionalPropertiesbug (chore: add test case foradditionalPropertiesbug #1528) @jamietanna📦 Dependency updates
16 changes
Beta Was this translation helpful? Give feedback.
All reactions