go-zero Files

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.
• Swagger/OpenAPI correctness:
• Correct $ref placement in array definitions when useDefinitions is enabled.
• 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 when useDefinitions 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.

Full Changelog

• tools/goctl v1.9.0 → v1.9.1