Fuego：为忙碌的Go开发者打造的框架

Fuego：为忙碌的Go开发者打造的框架 🚀

fuegoGolang Fuego - web framework generating OpenAPI 3 spec from source code项目地址:https://gitcode.com/gh_mirrors/fueg/fuego

Fuego 是一个为Go开发者量身定制的轻量级框架，旨在简化API和web应用的开发流程。灵感源自Nest，但针对现代Go语言特性进行了优化，特别是利用了Go的泛型功能来自动从代码中生成OpenAPI文档。

项目简介

Fuego的核心理念是帮助开发者快速构建应用，它提供了自动化OpenAPI文档生成、内置路由系统、序列化与反序列化、验证以及错误处理等功能。这个框架是完全兼容net/http的，因此你可以无缝对接现有的http.Handler中间件或处理器。

技术分析

• OpenAPI自动化：基于代码而非注释或YAML文件自动生成OpenAPI规格，得益于Go泛型的支持。
• net/http 兼容性：Fuego构建于net/http之上，确保了与现有生态的良好集成。
• 数据处理：支持JSON、XML和HTML表单的自动序列化和反序列化，并可自定义结构体进行操作。
• 验证：内建基于go-playground/validator的简单高效验证器。
• 转换：通过实现fuego.InTransform和fuego.OutTransform接口，轻松进行数据转换和验证。
• 中间件：易于添加自定义中间件或使用内置中间件。

应用场景

无论你是创建一个新的RESTful API还是构建一个复杂的Web应用，Fuego都能够提供所需的工具。它的优秀之处在于，即使在处理大量请求时，也能保持高性能。特别适合于那些希望利用Go语言的强类型和高效率，但又不想在API设计和文档编写上花费过多时间的开发者。

项目特点

1. 代码驱动的OpenAPI：无需手动维护OpenAPI文件，所有规范直接来源于你的函数签名。
2. 易用的路由：简化的API让你能够快速设置路由。
3. 自带验证和转换：通过结构体标签进行输入和输出验证，且可以自定义转化逻辑。
4. 全面的错误处理：遵循RFC 9457标准进行集中式的错误处理。
5. 强大的中间件支持：无缝整合net/http中间件，或者直接使用框架提供的中间件。
6. 渲染系统：基于html/template的渲染系统，同时也兼容如templ和gomponents等其他模板库。

示例

Fuego的示例清晰直观，展示如何快速搭建简单的GET和POST接口，以及如何进行数据变换和验证。更多的特性可以通过查看项目仓库中的例子进一步了解。

例如，以下是一个简单的POST接口：

type MyInput struct {
	Name string `json:"name" validate:"required"`
}

type MyOutput struct {
	Message string `json:"message"`
}

fuego.Post(s, "/", func(c *fuego.ContextWithBody[MyInput]) (MyOutput, error) {
	body, err := c.Body()
	if err != nil {
		return MyOutput{}, err
	}

	return MyOutput{
		Message: "Hello, " + body.Name,
	}, nil
})

结论

如果你正在寻找一种能提升Go开发效率并帮你快速构建强大API的方法，那么Fuego绝对值得尝试。它将为你节省大量的文档编写时间，同时提供了一套强大的工具来管理你的请求和响应。立即加入社区，探索更多可能吧！

GitHub项目地址 | 文档 | 贡献指南 | 许可证

fuegoGolang Fuego - web framework generating OpenAPI 3 spec from source code项目地址:https://gitcode.com/gh_mirrors/fueg/fuego