goctl/v1.8.4

Highlights

• goctl 1.8.4 Features & Beta: New features and improvements in goctl, including mongo model generation with cache prefix and improved swagger consume types (#4849, #4869, #4903, #4907).
• Bug Fixes & Compatibility: Multiple bug fixes for backward compatibility, timeout settings, spelling, type handling, and more (#4852, #4895, #4914, #4916, #4917, #4918, #4920, #4785, #4931).

What's Changed

• goctl features of 1.8.4-alpha by @kesonan in #4849
• goctl: v1.8.4-beta by @kesonan in #4890
• fix(goctl): Fix getting swagger consume types by @jaronnie in #4903
• feat(goctl): generate mongo model with cache prefix by @smiley-yoyo in #4907

New Contributors

• @yguilai made their first contribution in #4874
• @Caplost made their first contribution in #4917
• @smiley-yoyo made their first contribution in #4907

Full Changelog: tools/goctl/v1.8.3...tools/goctl/v1.8.4

v1.8.4

Highlights

• Continuous profiling support (#4867).

  Profiling:
     ServerAddr: http://<pyroscope-server>:<port>

• Embedded File Server Enhancements: Added support to serve files using embed.FS, simplifying static file serving (#4847, #4851).
• Performance Optimizations: Improved performance for hashing and slicing operations (#4891, #4877).

What's Changed

• New Features:
  • File server now supports embed.FS (#4847).
  • Continuous profiling support (#4867).
• Optimizations:
  • Improved slicing and comparison using Go standard library functions (#4841, #4840, #4877, #4879).
  • Time formatting standardized with the Go standard library (#4875).
  • Hashing performance improvements (#4891).

New Contributors

• @yguilai (#4874)
• @Caplost (#4917)
• @smiley-yoyo (#4907)

Thank you to all our contributors!

Full Changelog: v1.8.3...v1.8.4

tools/goctl/v1.8.4-beta

Changes

• Fixed goctl bugs.

👥 New Contributors

We welcome our new contributor:

• @yguilai made their first contribution in #4874

📋 Full Changelog

Full Changelog: tools/goctl/v1.8.3...tools/goctl/v1.8.4-beta

---

🙏 Acknowledgments

Special thanks to all contributors who made this release possible:

• @kevwan
• @dushaoshuai
• @me-cs
• @kesonan
• @yguilai
• @codeErrorSleep
• @dependabot

We encourage testing this beta release and welcome feedback from the community!

goctl/v1.8.4-alpha

What's Changed

goctl Features in 1.8.4-alpha

• Swagger Enhancements:
  • Bug fix: Removed example generation for query, path, and header request bodies, which aren't supported in API spec 2.0.
  • Feature: Added support for response and JSON request body definitions. Enabled via the useDefinitions keyword in the API file.
• API Code Generation Updates:
  • Added --type-group flag for grouping types by file.
  • Introduced group keyword in @server block for type separation.
• API Parser Improvements:
  • Added support for identifier values in info key-value pairs.

Check the PR description for detailed examples and usage.

---

Full Changelog: v1.8.3...v1.8.4-alpha

v1.8.3

🌟 Highlights

• MCP Server SDK: Added comprehensive Model Context Protocol server SDK support with real-time communication, JSON-RPC, prompt management, and more.
• API Route Improvements: Enhanced handling of special characters in API route paths.

🚀 Features

• MCP server SDK:

  • Real-time Communication: Robust SSE-based system with persistent client connections
  • JSON-RPC Support: Complete implementation with proper request processing and response formatting
  • Tool System: Register custom tools with schema validation and support for various return types
  • Prompt Management: Static prompts with templating and dynamic prompts with handler functions
  • Resource Handling: Register and deliver file resources with proper MIME type support
  • Embedded Resources: Include files directly in conversation messages
  • Content Flexibility: Support for text, code, images, and binary content
  • Protocol Features: Proper initialization sequences and capability negotiation
  • Comprehensive Error Handling: Proper error reporting with appropriate error codes
  • Performance Optimizations: Configurable timeouts and efficient resource management
  • Context Awareness: All handlers receive context for timeout and cancellation support

  ⚠️ API Stability Notice: Since this is the initial release of the MCP SDK and AI technology is rapidly evolving, the APIs might change in future releases to improve developer experience and adapt to emerging industry standards.

  📚 Tutorial: For detailed documentation and usage examples, check out the MCP Tutorial

• API Enhancements:

  • Fixed handling of special characters (like periods) in API route paths

🐛 Bug Fixes

• Fixed marshaler bug when handling arrays

📦 Dependency Updates

• Bumped github.com/redis/go-redis/v9 from 9.7.3 to 9.8.0

👋 Welcome to New Contributors

A warm welcome to our new contributors who made their first contributions to go-zero in this release:

• @hthuz
• @Disdjj
• @hoshi200

🔗 Links

• Full Changelog: v1.8.2...v1.8.3
• GitHub Release: https://github.com/zeromicro/go-zero/releases/tag/v1.8.3
• MCP Documentation: https://github.com/zeromicro/go-zero/blob/master/mcp/readme.md

goctl/v1.8.3

✨ Swagger Features

• Built-in Swagger Support: Generate Swagger documents in goctl. Key features include:
  • Custom Authentication: Configure custom Swagger authentication.
  • Complex Structures: Generate Swagger definitions for complex structures.
  • Custom Example Values: Add custom example values in Swagger.
  • Custom Response Body Format: Define response body formats.
  • Custom Business Error Codes: Enumerate error codes for business logic.
  • Custom Generated File: Specify the generated Swagger file name.
  • For more details, refer to:
    • 中文文档 | English

🔧 Fixes

• fix: Form fields of request optional by @soasurs in #4755
• fix: The parameter "required" in the Swagger document generated for repair is incorrect by @kesonan in #4791
• fix: Array schema generation incorrect by @kesonan in #4801
• fix: pg gen model missing cache prefix by @SpectatorNan in #4788
• fix: goctl api tsgen by @wwwfeng in #4726

🧹 Chores

• chore(deps): Bump github.com/emicklei/proto from 1.14.0 to 1.14.1 in /tools/goctl by @dependabot in #4817
• chore(deps): Bump github.com/redis/go-redis/v9 from 9.7.3 to 9.8.0 by @dependabot in #4821

🐛 Bug Fixes

• Fix: The issue of generating Swagger @doc "xxx" that fails and use the right ... by @Rankgice in #4816

🌟 New Contributors

• @hthuz made their first contribution in #4766
• @dushaoshuai made their first contribution in #4809
• @Rankgice made their first contribution in #4816
• @Disdjj made their first contribution in #4790
• @hoshi200 made their first contribution in #4741
• @wwwfeng made their first contribution in #4726

Full Changelog: Compare v1.8.2...v1.8.3

goctl/v1.8.3-beta

We are excited to announce the release of go-zero v1.8.3-beta, bringing new features, important fixes, and experimental capabilities to enhance your development experience.

🔄 What's Changed

✨ Features

• [Experimental] Swagger Enhancements:

  • Built-in support for generating Swagger documents in goctl.
    • Custom Authentication: Configure custom Swagger authentication.
    • Complex Structures: Generate Swagger definitions for complex structures.
    • Custom Example Values: Add custom example values in Swagger.
    • Custom Response Body Format: Define response body formats.
    • Custom Business Error Codes: Enumerate error codes for business logic.
      For more details, refer to:
  • 中文文档 | English

• [Experimental] API Types File Splitting:

  • Supports splitting multiple files according to group names in API types.
    For more details, refer to:
  • 中文文档 | English

🛠 Fixes

• Optional form fields in requests. (#4755)
• Corrected the required parameter in generated Swagger documents. (#4791)
• Fixed Swagger separator issue on Windows OS. (#4799)
• Resolved incorrect array schema generation. (#4801)
• Fixed missing security definition and JSON body data error in Swagger. (#4808)

🌟 New Contributors

• @hthuz made their first contribution in #4766
• @dushaoshuai made their first contribution in #4809

📜 Full Changelog

For a detailed list of changes, refer to the Full Changelog.

---

Thank you to all the contributors who made this release possible! 🎉

goctl/v1.8.2

🐛 Bug Fixes

• PostgreSQL Data Types: Fixed issues with numeric/decimal data types in PostgreSQL (#4686)

👋 New Contributors

We're excited to welcome the following new contributors to the go-zero project:

• @AnlynnLee
• @jk2K

🔭 Coming Soon

• MCP Server Support: We'll be adding Model Context Protocol (MCP) server support in the next release.

🔗 Additional Information

• Full Changelog: v1.8.1...v1.8.2

v1.8.2

We're pleased to announce the release of go-zero v1.8.2. This release includes new features, bug fixes, dependency updates, and code improvements.

🚀 New Features

• SSE Support: Added rest.WithSSE to build Server-Sent Events routes more easily (#4729)
• Redis Command: Added support for Redis GETDEL command (#4709)
• HTTP Client Enhancement: Added support for serialization of anonymous fields in HTTP client (httpc) (#4676)

🐛 Bug Fixes

• PostgreSQL Data Types: Fixed issues with numeric/decimal data types in PostgreSQL (#4686)

📦 Dependency Updates

• Bumped github.com/prometheus/client_golang from 1.21.0 to 1.21.1 (#4683)
• Bumped github.com/fullstorydev/grpcurl from 1.9.2 to 1.9.3 (#4701)
• Bumped github.com/redis/go-redis/v9 from 9.7.1 to 9.7.3 (#4722)
• Bumped github.com/golang-jwt/jwt/v4 from 4.5.1 to 4.5.2 (#4734)
• Bumped github.com/jackc/pgx/v5 from 5.7.2 to 5.7.4 (#4737)

🧹 Code Maintenance

• Added more tests and refactoring improvements (#4677, #4718)

👋 New Contributors

We're excited to welcome the following new contributors to the go-zero project:

• @AnlynnLee
• @jk2K

🔭 Coming Soon

• MCP Server Support: We'll be adding Model Context Protocol (MCP) server support in the next release.

🔗 Additional Information

• Full Changelog: v1.8.1...v1.8.2

goctl/v1.8.1

🐛 Fixes

• Fixed version to match with the release by @chenrui333

🔧 Improvements & Maintenance

• Added version check workflow by @kevwan
• Upgraded go-zero version in goctl by @kevwan

📦 Dependency Updates

This release includes several dependency updates:

• Updated github.com/spf13/cobra from 1.8.1 to 1.9.1
• Updated github.com/go-sql-driver/mysql from 1.8.1 to 1.9.0

For a complete list of changes, please check the full changelog.