go-cnb 是一个 Go client library 用于访问 CNB API。

该 sdk 由 cnb-sdk-generator 生成

go get cnb.cool/cnb/sdk/go-cnb        # 获取 go-cnb 的最新 tag 代码
go get cnb.cool/cnb/sdk/go-cnb@v1.0.0 # 获取 go-cnb 的特定 tag 代码
go get cnb.cool/cnb/sdk/go-cnb@master # [不推荐]获取 go-cnb 的 master 分支的最新提交代码

import "cnb.cool/cnb/sdk/go-cnb/cnb" 

创建一个 CNB Client, 然后使用一系列的服务来访问 CNB 的 API。

client, _ = cnb.NewClient(nil).WithAuthToken("...your cnb token...").WithURLs("...cnb base url...")
repo, rsp, err := client.Repositories.GetRepo(ctx, repoName)

对于需要鉴权的 URL, 可以在 CNB 的 个人设置 -> 访问令牌中申请合适权限的 TOKEN。BaseURL 的规则为 api. 前缀加主域名，比如 https://api.cnb.cool/

如果您想贡献代码，欢迎提交 PR，我们会尽快处理。如果您发现任何问题，欢迎提交 Issue，我们会尽快处理。

由于该项目由 cnb-sdk-generator 生成，因此大部分情况下，你只需要运行 make 即可生成最新的代码。然后运行 make t 进行必要的测试，测试通过后，提交 PR 即可。

有如下优秀项目基于该项目构建了 CNB 生态

• git-cnb, 一个 cnb 专属的 Git 命令行扩展工具
• release-clean, 一个 cnb release 清理插件
• cnb-docker-mirror, 一个利用 cnb 流水线将 docker 镜像同步到 cnb 制品库的工具
• no-square, 一个 CNB 插件，用于统计组织下所有的开源仓库 star 总数，并将 star 数量作为徽章附着在您的组织头像上
• gsync, 一个用于在 Git 平台（如 GitHub、Gitee 等）之间同步 Releases（包含 Release 元数据及附件）的命令行工具
• start-custom-environment, 一个基于云原生构建启动自定义云原生开发环境插件