gitea-rust-sdk

为 gitea 编写的非官方 rust-sdk

实现 API 调用

有关进一步文档，请参阅 https://codeberg.org/api/swagger 或您 gitea 实例的文档。

admin

• GET /admin/cron - 列出 cron 任务
• POST /admin/cron/{task} - 运行 cron 任务
• GET /admin/orgs - 列出所有组织
• GET /admin/unadopted - 列出未采用的组织
• POST /admin/unadopted/{owner}/{repo} - 将未采用文件作为仓库采用
• DELETE /admin/unadopted/{owner}/{repo} - 删除未采用文件
• GET /admin/users - 列出所有用户
• POST /admin/users - 创建用户
• DELETE /admin/users/{username} - 删除用户
• PATCH /admin/users/{username} - 编辑现有用户
• POST /admin/users/{username}/keys - 代表用户添加公钥
• DELETE /admin/users/{usernam}/keys/{id} - 删除用户的公钥
• POST /admin/users/{username}/orgs - 创建组织
• POST /admin/users/{username}/repos - 代表用户创建仓库

杂项

• POST /markdown - 将 markdown 文档渲染为 HTML
• POST /markdown/raw - 将原始 markdown 渲染为 HTML
• GET /nodeinfo - 返回 Gitea 应用的 nodeinfo
• GET /signing-key.gpg - 获取默认的 signing-key.gpg
• GET /version - 返回 Gitea 应用的版本

通知

• GET /notifications - 列出用户的通知线程
• PUT /notifications - 标记通知线程为已读、置顶或未读
• GET /notifications/new - 检查是否存在未读通知
• GET /notifications/threads/{id} - 通过 ID 获取通知线程
• PATCH /notifications/threads/{id} - 通过 ID 标记通知线程为已读
• GET /repos/{owner}/{repo}/notifications - 列出用户在特定仓库上的通知线程
• PUT /repos/{owner}/{repo}/notifications - 在特定仓库上标记通知线程为已读、置顶或未读

组织

• GET /orgs - 获取组织列表
• POST /orgs - 创建组织
• GET /orgs/{org} - 获取组织
• DELETE /orgs/{org} - 删除组织
• PATCH /orgs/{org} - 编辑组织
• GET /orgs/{org}/hooks - 列出组织的webhooks
• POST /orgs/{org}/hooks - 创建一个hook
• GET /orgs/{org}/hooks/{id} - 获取一个hook
• DELETE /orgs/{org}/hooks/{id} - 删除一个hook
• PATCH /orgs/{org}/hooks/{id} - 更新一个hook
• GET /orgs/{org}/labels - 列出组织的标签
• POST /orgs/{org}/labels - 为组织创建标签
• GET /orgs/{org}/labels/{id} - 获取单个标签
• DELETE /orgs/{org}/labels/{id} - 删除标签
• PATCH /orgs/{org}/labels/{id} - 更新标签
• GET /orgs/{org}/members - 列出组织的成员
• GET /orgs/{org}/members/{username} - 检查用户是否是组织成员
• DELETE /orgs/{org}/members/{username} - 从组织中移除成员
• GET /orgs/{org}/public_members - 列出组织的公开成员
• GET /orgs/{org}/public_members/{username} - 检查用户是否是组织的公开成员
• PUT /orgs/{org}/public_members/{username} - 公开用户的成员资格
• DELETE /orgs/{org}/public_members/{username} - 隐藏用户的成员资格
• GET /orgs/{org}/repos - 列出组织的仓库
• POST /orgs/{org}/repos - 在组织中创建仓库
• GET /orgs/{org}/teams - 列出组织的团队
• POST /orgs/{org}/teams - 创建团队
• GET /orgs/{org}/teams/search - 在组织内搜索团队
• GET /teams/{id} - 获取团队
• DELETE /teams/{id} - 删除一个团队
• PATCH /teams/{id} - 编辑一个团队
• GET /teams/{id}/members - 列出团队成员
• GET /teams/{id}/members/{username} - 列出特定团队的成员
• PUT /teams/{id}/members/{username} - 添加团队成员
• DELETE /teams/{id}/members/{username} - 从团队中移除成员
• GET /teams/{id}/repos - 列出团队的仓库
• GET /teams/{id}/repos/{org}/{repo} - 列出特定团队的特定仓库
• PUT /teams/{id}/repos/{org}/{repo} - 将仓库添加到团队
• DELETE /teams/{id}/repos/{org}/{repo} - 从团队中移除仓库
• GET /users/orgs - 列出当前用户的组织
• GET /users/{username}/orgs - 列出用户的组织
• GET /users/{username}/orgs/{org}/permissions - 获取用户在组织中的权限

包

• GET /packages/{owner} - 获取所有拥有者的包
• GET /packages/{owner}/{type}/{name}/{version} - 获取一个包
• DELETE /packages/{owner}/{type}/{name}/{version} - 删除一个包
• GET /packages/{owner}/{type}/{name}/{version}/files - 获取一个包的所有文件

问题

• GET /repos/issues/search - 在用户可访问的仓库中搜索问题
• GET /repos/{owner}/{repo}/issues - 列出仓库的问题
• POST /repos/{owner}/{repo}/issues - 创建一个问题。如果使用截止日期，则只考虑日期，忽略一天中的时间
• GET /repos/{owner}/{repo}/issues/comments - 列出仓库中的所有评论
• GET /repos/{owner}/{repo}/issues/comments/{id} - 获取一个评论
• DELETE /repos/{owner}/{repo}/issues/comments/{id} - 删除一个评论
• PATCH /repos/{owner}/{repo}/issues/comments/{id} - 编辑一个评论
• GET /repos/{owner}/{repo}/issues/commets/{id}/reactions - 获取一个问题的评论的所有反应列表
• POST /repos/{owner}/{repo}/issues/comments/{id}/reactions - 向一个问题的评论添加反应
• DELETE /repos/{owner}/{repo}/issues/comments/{id}/reactions - 从一个问题的评论中移除反应
• GET /repos/{owner}/{repo}/issues/{index} - 获取一个问题
• DELETE /repos/{owner}/{repo}/issues/{index} - 删除一个问题
• PATCH /repos/{owner}/{repo}/issues/{index} - 编辑一个问题。如果只使用截止日期，则只考虑日期，忽略时间。
• GET /repos/{owner}/{repo}/issues/{index}/comments - 列出问题上的所有评论
• POST /repos/{owner}/{repo}/issues/{index}/comments - 向一个问题添加评论
• POST /repos/{owner}/{repo}/issues/{index}/deadline - 设置问题的截止日期。如果设置为null，则删除截止日期。如果使用截止日期，则只考虑日期，忽略时间。
• GET /repos/{owner}/{repo}/issues/{index}/labels - 获取问题的标签
• PUT /repos/{owner}/{repo}/issues/{index}/labels - 替换一个问题的标签
• POST /repos/{owner}/{repo}/issues/{index}/labels - 向一个问题添加标签
• DELETE /repos/{owner}/{repo}/issues/{index}/labels - 从一个问题中移除所有标签
• DELETE /repos/{owner}/{repo}/issues/{index}/labels/{id} - 从一个问题中移除标签
• GET /repos/{owner}/{repo}/issues/{index}/reactions - 获取一个问题反应列表
• POST /repos/{owner}/{repo}/issues/{index}/reactions - 向一个问题添加反应
• DELETE /repos/{owner}/{repo}/issues/{index}/reactions - 从一个问题中移除反应
• DELETE /repos/{owner}/{repo}/issues/{index}/stopwatch/delete - 删除一个问题的现有计时器
• POST /repos/{owner}/{repo}/issues/{index}/stopwatch/start - 开始一个问题的计时器
• POST /repos/{owner}/{repo}/issues/{index}/stopwatch/stop - 停止一个问题的现有计时器
• GET /repos/{owner}/{repo}/issues/{index}/subscriptions - 获取订阅了一个问题的用户列表
• GET /repos/{owner}/{repo}/issues/{index}/subscriptions/check - 检查用户是否订阅了一个问题
• PUT /repos/{owner}/{repo}/issues/{index}/subscriptions/{user} - 订阅用户到问题
• DELETE /repos/{owner}/{repo}/issues/{index}/subscriptions/{user} - 从问题中取消订阅用户
• GET /repos/{owner}/{repo}/issues/{index}/timeline - 列出问题上的所有评论和事件
• GET /repos/{owner}/{repo}/issues/{index}/times - 列出问题的跟踪时间
• POST /repos/{owner}/{repo}/issues/{index}/times - 向问题添加跟踪时间
• DELETE /repos/{owner}/{repo}/issues/{index}/times - 重置问题的跟踪时间
• DELETE /repos/{owner}/{repo}/issues/{index}/times/{id} - 删除特定的跟踪时间
• GET /repos/{owner}/{repo}/labels - 获取存储库的所有标签
• POST /repos/{owner}/{repo}/labels/{id} - 创建标签
• GET /repos/{owner}/{repo}/labels/{id} - 获取单个标签
• DELETE /repos/{owner}/{repo}/labels/{id} - 删除标签
• PATCH /repos/{owner}/{repo}/labels/{id} - 更新标签
• GET /repos/{owner}/{repo}/milestones - 获取仓库的所有开启里程碑
• POST /repos/{owner}/{repo}/milestones - 创建里程碑
• GET /repos/{owner}/{repo}/milestones/{id} - 获取里程碑
• DELETE /repos/{owner}/{repo}/milestones/{id} - 删除里程碑
• PATCH /repos/{owner}/{repo}/milestones/{id} - 更新里程碑

仓库

• POST /repos/migrate - 迁移远程 Git 仓库
• GET /repos/search - 搜索仓库
• GET /repos/{owner}/{repo} - 获取一个仓库
• DELETE /repos/{owner}/{repo} - 删除一个仓库
• PATCH /repos/{owner}/{repo} - 编辑仓库属性。只有设置的字段会被更改
• GET /repos/{owner}/{repo}/archives/{archive} - 获取一个仓库的归档
• GET /repos/{owner}/{repo}/assignees - 返回所有具有写入访问权限并可以分配给问题的用户
• GET /repos/{owner}/{repo}/branch_protections - 列出仓库的分支保护
• POST /repos/{owner}/{repo}/branch_protections - 为仓库创建分支保护
• GET /repos/{owner}/{repo}/branch_protections/{name} - 获取仓库的特定分支保护
• DELETE /repos/{owner}/{repo}/branch_protections/{name} - 删除仓库的特定分支保护
• PATCH /repos/{owner}/{repo}/branch_protections/{name} - 编辑仓库的分支保护设置。只有设置的字段将被更改
• GET /repos/{owner}/{repo}/branches/{branch} - 获取仓库中的特定分支，包括其有效的分支保护
• DELETE /repos/{owner}/{repo}/branches/{branch} - 从仓库中删除特定分支
• GET /repos/{owner}/{repo}/collaborators - 列出仓库的协作者
• GET /repos/{owner}/{repo}/collaborators/{collaborator} - 检查用户是否是仓库的协作者
• PUT /repos/{owner}/{repo}/collaborators/{collaborator} - 将协作者添加到仓库
• DELETE /repos/{owner}/{repo}/collaborators/{collaborator} - 从仓库中删除协作者
• GET /repos/{owner}/{repo}/collaborators/{collaborator}/permissions - 获取用户的仓库权限
• GET /repos/{owner}/{repo}/commits - 获取一个仓库的所有提交列表
• GET /repos/{owner}/{repo}/commits/{ref}/status - 通过分支/标签/提交引用获取一个提交的合并状态
• GET /repos/{owner}/{repo}/commits/{ref}/statuses - 通过分支/标签/提交引用获取一个提交的状态
• GET /repos/{owner}/{repo}/contents - 获取根目录下所有条目的元数据
• GET /repos/{owner}/{repo}/contents/{filepath} - 获取仓库中一个条目的元数据和内容（如果是文件），或者获取目录下条目的列表
• PUT /repos/{owner}/{repo}/contents/{filepath} - 更新仓库中的一个文件
• POST /repos/{owner}/{repo}/contents/{filepath} - 在仓库中创建一个文件
• DELETE /repos/{owner}/{repo}/contents/{filepath} - 在仓库中删除文件
• POST /repos/{owner}/{repo}/diffpatch - 将diff补丁应用到仓库
• GET /repos/{owner}/{repo}/editorconfig/{filepath} - 获取仓库中文件的EditorConfig定义
• GET /repos/{owner}/{repo}/forks - 列出仓库的分支
• POST /repos/{owner}/{repo}/forks - 将仓库分支
• GET /repos/{owner}/{repo}/git/blobs/{sha} - 获取仓库的blob
• GET /repos/{owner}/{repo}/git/commits/{sha} - 从仓库中获取单个提交
• GET /repos/{owner}/{repo}/git/commits/{sha}.{diffType} - 获取提交的diff或补丁
• GET /repos/{owner}/{repo}/git/notes/{sha} - 从存储库获取与单个提交对应的笔记
• GET /repos/{owner}/{repo}/git/refs - 获取指定的引用或筛选存储库的引用
• GET /repos/{owner}/{repo}/git/refs/{ref} - 获取指定的引用或筛选存储库的引用
• GET /repos/{owner}/{repo}/git/tags/{sha} - 获取带注解标签的标签对象（非轻量级标签）
• GET /repos/{owner}/{repo}/git/trees/{sha} - 获取存储库的树
• GET /repos/{owner}/{repo}/hooks - 列出存储库中的钩子
• POST /repos/{owner}/{repo}/hooks - 创建钩子
• GET /repos/{owner}/{repo}/hooks/git - 列出存储库中的 Git 钩子
• GET /repos/{owner}/{repo}/hooks/git/{id} - 获取 Git 钩子
• DELETE /repos/{owner}/{repo}/hooks/git/{id} - 在仓库中删除 Git 钩子
• PATCH /repos/{owner}/{repo}/hooks/git/{id} - 更新仓库中的 Git 钩子
• GET /repos/{owner}/{repo}/hooks/{id} - 获取钩子
• DELETE /repos/{owner}/{repo}/hooks/{id} - 在仓库中删除钩子
• PATCH /repos/{owner}/{repo}/hooks/{id} - 编辑仓库中的钩子
• POST /repos/{owner}/{repo}/hooks/{id}/tests - 测试推送 webhook
• GET /repos/{owner}/{repo}/issue_templates - 获取仓库中可用的 Issue 模板
• GET /repos/{owner}/{repo}/keys - 列出仓库的密钥
• POST /repos/{owner}/{repo}/keys - 向仓库添加密钥
• GET /repos/{owner}/{repo}/keys/{id} - 通过ID获取仓库的密钥
• DELETE /repos/{owner}/{repo}/keys/{id} - 从仓库中删除密钥
• GET /repos/{owner}/{repo}/languages - 获取编写代码的语言及字节数
• GET /repos/{owner}/{repo}/media/{filepath} - 从仓库获取文件或其LFS对象
• POST /repos/{owner}/{repo}/mirror-sync - 同步镜像仓库
• GET /repos/{owner}/{repo}/pulls - 列出仓库的拉取请求
• POST /repos/{owner}/{repo}/pulls - 创建拉取请求
• GET /repos/{owner}/{repo}/pulls/{index} - 获取拉取请求
• PATCH /repos/{owner}/{repo}/pulls/{index} - 更新拉取请求。如果仅使用截止日期，则只考虑日期，忽略时间
• GET /repos/{owner}/{repo}/pulls/{index}.{diffType} - 获取拉取请求的diff或补丁
• GET /repos/{owner}/{repo}/pulls/{index}/commits - 获取拉取请求的提交
• GET /repos/{owner}/{repo}/pulls/{index}/merge - 检查拉取请求是否已合并
• POST /repos/{owner}/{repo}/pulls/{index}/merge - 合并拉取请求
• DELETE /repos/{owner}/{repo}/pulls/{index}/merge - 取消给定拉取请求的预定自动合并
• POST /repos/{owner}/{repo}/pulls/{index}/requested_reviewers - 为拉取请求创建审查请求
• DELETE /repos/{owner}/{repo}/pulls/{index}/requested_reviewers - 取消拉取请求的审查请求
• GET /repos/{owner}/{repo}/pulls/{index}/reviews - 列出拉取请求的所有审查
• POST /repos/{owner}/{repo}/pulls/{index}/reviews - 为拉取请求创建审查
• GET /repos/{owner}/{repo}/pulls/{index}/reviews/{id} - 获取拉取请求的特定审查
• POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id} - 提交挂起的审查到拉取请求
• DELETE /repos/{owner}/{repo}/pulls/{index}/reviews/{id} - 从拉取请求中删除特定评论
• GET /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/comments - 获取拉取请求的特定评论
• POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/dismissals - 拉取请求中驳回评论
• POST /repos/{owner}/{repo}/pulls/{index}/reviews/{id}/indismissals - 取消驳回拉取请求中的评论
• POST /repos/{owner}/{repo}/pulls/{index}/update - 合并PR的baseBranch到headBranch
• GET /repos/{owner}/{repo}/raw/{filepath} - 从仓库中获取文件
• GET /repos/{owner}/{repo}/releases - 列出仓库的发布版本
• POST /repos/{owner}/{repo}/releases - 创建一个发行版
• GET /repos/{owner}/{repo}/releases/tags/{tag} - 通过标签名称获取一个发行版
• DELETE /repos/{owner}/{repo}/release/tags/{tag} - 通过标签名称删除一个发行版
• GET /repos/{owner}/{repo}/releses/{id} - 获取一个发行版
• DELETE /repos/{owner}/{repo}/releases/{id} - 删除一个发行版
• PATCH /repos/{owner}/{repo}/releases/{id} - 更新一个发行版
• GET /repos/{owner}/{repo}/releases/{id}/assets - 列出发行版的附件
• POST /repos/{owner}/{repo}/releases/{id}/assets - 创建发行版附件
• GET /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} - 获取发布附件
• DELETE /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} - 删除发布附件
• PATCH /repos/{owner}/{repo}/releases/{id}/assets/{attachment_id} - 更新发布附件
• GET /repos/{owner}/{repo}/reviewers - 列出可以请求在该仓库中审查的所有用户
• GET /repos/{owner}/{repo}/signing-key.gpg - 获取指定仓库的signing-key.gpg
• GET /repos/{owner}/{repo}/stargazers - 列出仓库的star用户
• GET /repos/{owner}/{repo}/statuses/{sha} - 获取提交的状态
• POST /repos/{owner}/{repo}/statuses/{sha} - 创建提交状态
• GET /repos/{owner}/{repo}/subscribers - 列出仓库的关注者
• GET /repos/{owner}/{repo}/subscription - 检查当前用户是否关注该仓库
• PUT /repos/{owner}/{repo}/subscription - 关注一个仓库
• DELETE /repos/{owner}/{repo}/subscription - 取消关注一个仓库
• GET /repos/{owner}/{repo}/tags - 列出仓库的标签
• POST /repos/{owner}/{repo}/tags - 在仓库中创建一个新的 Git 标签
• GET /repos/{owner}/{repo}/tags/{tag} - 通过标签名称获取仓库的标签
• DELETE /repos/{owner}/{repo}/tags/{tag} - 通过名称删除仓库的标签
• GET /repos/{owner}/{repo}/teams - 列出仓库的团队
• GET /repos/{owner}/{repo}/teams/{team} - 检查团队是否分配给仓库
• PUT /repos/{owner}/{repo}/teams/{team} - 将团队添加到仓库
• DELETE /repos/{owner}/{repo}/teams/{team} - 从仓库中删除团队
• GET /repos/{owner}/{repo}/times - 列出仓库跟踪的时间
• GET /repos/{owner}/{repo}/topics - 获取仓库拥有的主题列表
• PUT /repos/{owner}/{repo}/topics - 替换仓库的主题列表
• PUT /repos/{owner}/{repo}/topics/{topic} - 将主题添加到仓库
• DELETE /repos/{owner}/{repo}/topics/{topic} - 从仓库中删除主题
• POST /repos/{owner}/{repo}/transfer - 转移仓库所有权
• POST /repos/{owner}/{repo}/transfer/accept - 接受仓库转移
• POST /repos/{owner}/{repo}/transfer/reject - 拒绝仓库转移
• POST /repos/{owner}/{repo}/wiki/new - 创建维基页面
• GET /repos/{owner}/{repo}/wiki/page/{pageName} - 获取维基页面
• DELETE /repos/{owner}/{repo}/wiki/page/{pageName} - 删除维基页面
• PATCH /repos/{owner}/{repo}/wiki/page/{pageName} - 编辑维基页面
• GET /repos/{owner}/{repo}/wiki/pages - 获取所有维基页面
• GET /repos/{owner}/{repo}/wiki/revisions/{pageName} - 获取维基页面的修订版本
• POST /repos/template_owner}/{template_repo}/generate - 使用模板创建仓库
• GET /repositories/{id} - 通过ID获取仓库
• GET /topics/search - 通过关键字搜索主题
• POST /user/repos - 创建仓库

设置

• GET /settings/api - 获取实例的API全局设置
• GET /settings/attachment - 获取实例的附件全局设置
• GET /settings/repository - 获取实例的仓库全局设置
• GET /settings/ui - 获取实例的UI全局设置

用户

• GET /user - 获取认证用户
• GET /user/applications/oauth2 - 列出认证用户的OAuth2应用
• POST /user/applications/oauth2 - 创建新的OAuth2应用
• GET /user/applications/oauth2/{id} - 获取OAuth2应用
• DELETE /user/applications/oauth2/{id} - 删除OAuth2应用
• PATCH /user/applications/oauth2/{id} - 更新OAuth2应用，包括重新生成客户端密钥
• GET /user/emails - 列出认证用户的电子邮件地址
• POST /user/emails - 添加电子邮件地址
• DELETE /user/emails - 删除电子邮件地址
• GET /user/followers - 列出认证用户的关注者
• GET /user/following - 列出认证用户关注的用户
• GET /user/following/{username} - 检查认证用户是否关注了某个用户
• PUT /user/following/{username} - 关注一个用户
• DELETE /user/following/{username} - 取消关注一个用户
• GET /user/gpg_key_token - 获取用于验证的令牌
• POST /user/gpg_key_verify - 验证GPG密钥
• GET /user/gpg_keys - 列出认证用户的GPG密钥
• POST /user/gpg_keys - 创建GPG密钥
• GET /user/gpg_keys/{id} - 获取GPG密钥
• DELETE /user/gpg_keys/{id} - 删除GPG密钥
• GET /user/keys - 列出认证用户的公钥
• POST /user/keys - 创建公钥
• GET /user/keys/{id} - 获取公钥
• DELETE /user/keys/{id} - 删除公钥
• GET /user/repos - 列出认证用户拥有的仓库
• POST /user/repos - 创建仓库
• GET /user/settings - 获取用户设置
• PATCH /user/settings - 更新用户设置
• GET /user/starred - 列出认证用户已收藏的仓库
• GET /user/starred/{owner}/{repo} - 检查认证用户是否收藏了指定的仓库
• PUT /user/starred/{owner}/{repo} - 收藏指定的仓库
• DELETE /user/starred/{owner}/{repo} - 取消收藏指定的仓库
• GET /user/stopwatches - 获取所有现有的计时器列表
• GET /user/subscriptions - 列出认证用户关注的仓库
• GET /user/teams - 列出用户所属的所有团队
• GET /user/times - 列出当前用户的追踪时间
• GET /user/search - 搜索用户
• GET /users/{username} - 获取一个用户
• GET /users/{username}/followers - 列出指定用户的关注者
• GET /users/{username}/following - 列出指定用户关注的用户
• GET /users/{username}/following/{target} - 检查一个用户是否关注了另一个用户
• GET /users/{username}/gpg_keys - 列出指定用户的GPG密钥
• GET /users/{username}/heatmap - 获取用户的热图
• GET /users/{username}/keys - 列出指定用户的公钥
• GET /users/{username}/repos - 列出给定用户的仓库
• GET /users/{username}/starred - 列出给定用户已星标的仓库
• GET /users/{username}/subscriptions - 列出用户关注的仓库
• GET /users/{username}/tokens - 列出认证用户的访问令牌
• POST /users/{username}/tokens - 创建访问令牌
• DELETE /users/{username}/tokens/{token} - 删除访问令牌

测试

为了运行所有单元测试，您首先需要提供您的 gitea API 密钥和 gitea 实例 URL。为此，请将它们复制到 .txt 文件中，该文件位于 rsc/ 文件夹中。

之后，您可以安全地运行 cargo test。如果失败，请尝试运行 cargo test -- --nocapture 以检查您是否正确输入了令牌和 URL。