gitee-rs

A high-performance, type-safe Gitee API client library for Rust.

⚖️ 免责声明 (Disclaimer): 本项目为第三方开发，并非 Gitee (OSChina) 官方产品。

✨ 功能特性

• 全面覆盖: 支持 Issues, Pull Requests, Repositories, Users, Notifications, Files, Labels, Releases 等。
• 异步支持: 基于 reqwest 和 tokio 实现全异步调用。
• 健壮的数据模型: 针对 Gitee API 的复杂标识符格式做了专门处理，减少反序列化崩溃。
• 可定制性: 支持自定义 API 基地址，适配 Gitee 专有云场景。

🚀 快速开始

在 Cargo.toml 中添加依赖：

[dependencies]
gitee-rs = "0.1.0"
tokio = { version = "1.0", features = ["full"] }

基础用法

use gitee_rs::GiteeClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 初始化客户端 (从环境变量 GITEE_TOKEN 读取)
    let client = GiteeClient::new(None, None)?;

    // 获取仓库信息
    let repo = client.get_repo("owner", "repo").await?;
    println!("Repo name: {}", repo.full_name);

    // 列出 Issue
    let issues = client.list_issues().await?;
    for issue in issues {
        println!("#{} - {}", issue.number, issue.title);
    }

    Ok(())
}

🛠️ 模块概览

📜 开源协议

本项目采用 MIT License 开源。