Highlights
- Code generation ergonomics:
- Add code generation headers to safe-to-edit files for clearer ownership and customization boundaries.
- Fix array type generation issues to ensure accurate code output.
- API developer experience:
- Add complete test scaffolding for API projects via the
--test
flag.
- Add complete test scaffolding for API projects via the
- Swagger/OpenAPI correctness:
- Correct
$ref
placement in array definitions whenuseDefinitions
is enabled.
- Correct
- Stability and optimizations:
- Fix SSE handler blocking.
- Optimize slice lookups and
Unquote
utility function performance.
Detailed Changes
Code Generation
- Add code generation headers in safe-to-edit files to clarify which files are intended for user modifications while keeping generated segments intact.
PR: feat: add code generation headers in safe to edit files by @kevwan (@5136) - Fix array type generation error to produce correct types in generated code.
PR: fix array type generation error by @kesonan (@5142)
API/CLI
- Add complete test scaffolding support for API projects using the
--test
flag, enabling quicker setup of testable services.
PR: Add complete test scaffolding support with --test flag for API projects by @Copilot (@5176)
Swagger/OpenAPI
- Fix
$ref
placement in array definitions whenuseDefinitions
is enabled to align with the OpenAPI/Swagger schema expectations.
PR: fix(goctl/swagger): correct $ref placement in array definitions when useDefinitions is enabled by @Copilot (@5199)
Stability
- Fix SSE handler blocking behavior that could stall event delivery under certain conditions.
PR: fix: SSE handler blocking by @wuqinqiang (@5181)
Performance and Utilities
- Optimize slice find routines and the
Unquote
function for better runtime efficiency.
PR: update: optimize slice find and Unquote func by @me-cs (@5108)
Upgrade Notes
- Swagger regeneration: If you rely on
useDefinitions
, regenerate your Swagger/OpenAPI specs to pick up the corrected$ref
placement. - Codegen headers: Newly generated safe-to-edit files will include headers clarifying edit expectations; no action required, but helpful for code review and maintenance.
Acknowledgements
- Thanks to all contributors in this release: @kevwan, @kesonan, @me-cs, @wuqinqiang, and first-time contributor @Copilot. Your improvements enhance correctness, stability, and developer productivity for goctl users.