kite

Kite

一个为微服务开发而设计的 Go 语言框架。

核心特性

• 简洁的 API 语法 - 轻松定义路由和处理器
• RESTful 规范 - 默认遵循 REST 最佳实践
• 配置管理 - 灵活的配置加载和管理
• 完整的可观测性 - 内置日志、追踪和指标支持
• 认证中间件 - 开箱即用的认证和自定义中间件
• gRPC 支持 - 原生支持 gRPC 服务
• HTTP 服务客户端 - 内置熔断器的 HTTP 客户端
• 发布/订阅 - 简化的消息队列集成
• 健康检查 - 所有数据源的自动健康检查
• 数据库迁移 - 内置迁移管理工具
• 定时任务 - Cron 任务调度支持
• 动态日志级别 - 无需重启即可更改日志级别
• Swagger 文档 - 自动生成和渲染 API 文档
• 文件系统抽象 - 统一的文件操作接口
• WebSocket - 原生 WebSocket 支持

快速开始

安装

go get github.com/sllt/kite

简单示例

package main

import "github.com/sllt/kite/pkg/kite"

func main() {
    app := kite.New()

    app.GET("/greet", func(ctx *kite.Context) (any, error) {
        return "Hello World!", nil
    })

    app.Run() // 监听 localhost:8000
}

运行应用：

go run main.go

访问 http://localhost:8000/greet 查看结果。

使用数据库

package main

import (
    "fmt"
    "github.com/sllt/kite/pkg/kite"
)

func main() {
    app := kite.New()

    app.GET("/redis", func(c *kite.Context) (any, error) {
        val, err := c.Redis.Get(c, "key").Result()
        if err != nil {
            return nil, err
        }
        return val, nil
    })

    app.GET("/sql", func(c *kite.Context) (any, error) {
        var result int
        err := c.SQL.QueryRowContext(c, "SELECT 2+2").Scan(&result)
        if err != nil {
            return nil, err
        }
        return result, nil
    })

    app.Run()
}

支持的数据源

Kite 支持广泛的数据存储和服务：

项目结构

kite/
├── pkg/kite/              # 核心框架代码
│   ├── datasource/        # 数据源连接器
│   ├── metrics/           # 指标收集
│   └── ...
├── examples/              # 示例应用
│   ├── http-server/       # HTTP 服务示例
│   ├── grpc/              # gRPC 示例
│   ├── using-migrations/  # 数据库迁移示例
│   └── ...
└── docs/                  # 文档

文档

• GoDoc - API 参考文档
• 示例目录 - 更多可运行示例

许可证

本项目采用 Apache License 2.0 许可证。

贡献

欢迎贡献代码、提出建议或报告问题。