Metadata-Version: 2.4
Name: yuque-toolkit
Version: 0.1.0
Summary: Reusable Python toolkit for Yuque OpenAPI
Author: fenyuan
License-Expression: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Yuque Toolkit

`yuque-toolkit` 是一个面向 Python 项目的语雀 SDK，封装了常用的语雀 OpenAPI 调用能力，适合在自动化脚本、内容同步任务和内部业务系统中复用。

## Features

- Get current user info
- Get repository detail
- List repository documents
- Get document detail
- Create document
- Update document
- Get repository TOC
- Update repository TOC

## Installation

```bash
pip install yuque-toolkit
```

## Environment Variables

```env
YUQUE_BASE_URL=https://www.yuque.com
YUQUE_TOKEN=your_token_here
YUQUE_GROUP_LOGIN=your_group_or_user_login
YUQUE_BOOK_SLUG=your_book_slug
```

## Quick Start

```python
import os

from yuque_toolkit import YuqueClient, load_dotenv

load_dotenv()

client = YuqueClient(
    token=os.getenv("YUQUE_TOKEN", ""),
    base_url=os.getenv("YUQUE_BASE_URL", "https://www.yuque.com"),
)

result = client.list_docs(
    os.getenv("YUQUE_GROUP_LOGIN", ""),
    os.getenv("YUQUE_BOOK_SLUG", ""),
    limit=10,
)

print(result)
```

## CLI

```bash
yuque-toolkit me
yuque-toolkit repo
yuque-toolkit docs --limit 10
yuque-toolkit toc
```
