open-lark 0.14.0

Enterprise-grade Lark/Feishu Open API SDK with comprehensive Chinese documentation and advanced error handling
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

//! 云盘Drive服务
//!
//! 提供飞书云盘相关的所有API功能，包括文件上传下载、文件夹管理、权限控制等。
//! 支持多种文件操作和高级功能如文件版本管理、文件分享等。
//!
//! # API版本
//!
//! - **v1**: 核心文件操作功能
//! - **v2**: 增强功能和文件浏览器
//!
//! # 主要功能
//!
//! - 📁 文件和文件夹管理
//! - ⬆️ 文件上传和下载
//! - 🔐 权限控制和文件分享
//! - 📂 文件浏览器和导航
//! - 🏷️ 文件元数据和版本管理
//! - 👍 文件点赞和收藏
//!
//! # 快速开始
//!
//! ```rust
//! use open_lark::prelude::*;
//!
//! let client = LarkClient::builder("app_id", "app_secret")
//!     .with_app_type(AppType::SelfBuild)
//!     .build();
//!
//! // 上传文件
//! // let upload_request = UploadAllRequest::builder()
//! //     .file_name("document.pdf")
//! //     .parent_type("folder")
//! //     .parent_node("folder_token")
//! //     .build();
//! // let result = client.drive.v1.files.upload_all(upload_request, None).await?;
//!
//! // 获取文件信息
//! // let file_info = client.drive.v1.file.get(file_token, None).await?;
//! ```

use crate::{
    core::config::Config,
    service::drive::{v1::V1, v2::V2},
};

/// Drive API v1版本
pub mod v1;
/// Drive API v2版本
pub mod v2;

/// 云盘Drive服务
///
/// 聚合所有Drive相关的API版本，提供统一的文件操作接口。
/// 通过不同版本的子服务访问具体的API功能。
pub struct DriveService {
    /// Drive API v1版本服务
    pub v1: V1,
    /// Drive API v2版本服务
    pub v2: V2,
}

impl DriveService {
    /// 创建新的Drive服务实例
    ///
    /// # 参数
    /// - `config`: 客户端配置
    pub fn new(config: Config) -> Self {
        Self {
            v1: V1::new(config.clone()),
            v2: V2::new(config.clone()),
        }
    }

    /// 使用共享配置创建服务（实验性）
    pub fn new_from_shared(shared: std::sync::Arc<Config>) -> Self {
        Self {
            v1: V1::new(shared.as_ref().clone()),
            v2: V2::new(shared.as_ref().clone()),
        }
    }
}