Simple PyYuQue

一个非官方的 “语雀” 的Python API 封装。提供和官方 API 类似的调用方式。设计简单，运行高效。

详细文档说明参考https://www.yuque.com/yuque/developer/api

安装

pip 安装

pip install simple-pyyuque

pipenv 安装

pipenv install simple-pyyuque

快速开始

1. 实例化

spyq = SimplePyYuQueAPI(token="token", app_name="py_yuque")

其中 token 是在语雀中 setting -> token 中申请， app_name 为你的应用名称。

2. 简单调用

获取认证的用户的个人信息

spyq = SimplePyYuQueAPI(token="token", app_name="py_yuque")
u = spyq.User()
user_serializer = u.get_user()

可以更加简洁一点

user_serializer = SimplePyYuQueAPI(token="token", app_name="py_yuque1").User().get_user()

你还可以打印出原始报文

print(user_serializer.base_response)

基于用户 login 或 id 获取一个用户的基本信息。

user = SimplePyYuQueAPI(token="token", app_name="py_yuque").User()
print("==> Helixcs is %s", user.get_users(login="Helixcs").base_response)

# ==> Helixcs is {'id': 104023, 'type': 'User', 'space_id': 0, 'account_id': 10838, 'login': 'helixcs', 'name': 'Helixcs', 'avatar_url': 'https://cdn.nlark.com/yuque/0/2018/png/104023/1539315567419-aad17f80-8365-4a08-af1e-e301a3c2c7f5.png', 'large_avatar_url': 'https://cdn.nlark.com/yuque/0/2018/png/104023/1539315567419-aad17f80-8365-4a08-af1e-e301a3c2c7f5.png?x-oss-process=image/resize,m_fill,w_320,h_320', 'medium_avatar_url': 'https://cdn.nlark.com/yuque/0/2018/png/104023/1539315567419-aad17f80-8365-4a08-af1e-e301a3c2c7f5.png?x-oss-process=image/resize,m_fill,w_160,h_160', 'small_avatar_url': 'https://cdn.nlark.com/yuque/0/2018/png/104023/1539315567419-aad17f80-8365-4a08-af1e-e301a3c2c7f5.png?x-oss-process=image/resize,m_fill,w_80,h_80', 'books_count': 3, 'public_books_count': 2, 'followers_count': 3, 'following_count': 3, 'public': 1, 'description': 'Java 糊口，Python 兴趣', 'created_at': '2018-04-23T02:43:33.000Z', 'updated_at': '2018-12-07T17:00:03.000Z', '_serializer': 'v2.user_detail'}

详细API参考官方文档：https://www.yuque.com/yuque/developer/user

API 说明与示例

1. User 用户

获取认证的用户的个人信息

 user_api = SimplePyYuQueAPI(token="token", app_name="py_yuque1").User()
 print(user_api.get_user())
 print(user_api.user)

返回: UserSerializer

获取单个用户信息

user.get_users(login="Helixcs")

user.get_users(id=104023)

返回: UserSerializer

获取我创建的文档

user.get_user_docs()

user_api.get_user_docs(q='',offset=1)

返回: Array<DocSerializer>

获取我最近参与的文档/知识库

user.get_user_recent_updated()

user.get_user_recent_updated(type=UserDescriptionType.BOOK)

user.get_user_recent_updated(type="Doc")

返回: Array<DocSerializer> 或 Array<BookSerializer>

2. Group 组织

获取某个用户的加入的组织列表

group_api = SimplePyYuQueAPI(token="token", app_name="py_yuque1").Group()

group_api.get_users_groups(login="Helixcs")

返回：Array<UserSerializer>

获取公开组织列表

group_api.get_public_groups()

group_api.public_groups

返回：Array<UserSerializer>

创建 Group

group_api.post_group(name="Helixcs 的组织名称", login="Helixcs123",description="Helixcs 的组织描述")

返回：UserSerializer

访问：https://www.yuque.com/<login> 查看新建 Group。

获取单个组织的详细信息

group_api.get_groups_detail(id=225250)

group_api.get_groups_detail(login="Helixcs123")

# https://www.yuque.com/helixcs123

返回：UserSerializer

更新单个组织的详细信息

group_api.put_groups(login="Helixcs123",name="Helixcs 的组织名称更新1次",login_update="Helixcs456",description="Helixcs123 更新为Helixcs456")

group_api.update_groups(login="Helixcs123",name="Helixcs 的组织名称更新2次",login_update="Helixcs123",description="Helixcs123 更新为Helixcs456")

# 访问: https://www.yuque.com/helixcs123

返回：UserSerializer

访问：https://www.yuque.com/<login>

删除组织

group_api.delete_groups(login="Helixcs456")

group_api.delete_groups(id=225250)

返回：UserSerializer

获取组织成员信息

# 这里的 login 为 group name
group_api.get_groups_users(login="Helixcs456")

# 这里的 id 为 group_id
group_api.get_groups_users(id=225250)

返回：Array<GroupUserSerializer>

增加或更新组织成员

group_api.put_groups_users(group_login="Helixcs456",login="OtherUser",role=1)

group_api.update_group_users(group_login="Helixcs456",login="OtherUser",role=1)

返回：GroupUserSerializer

删除组织成员

group_api.delete_groups_users(group_login="Helixcs456",
                              login="OtherUser")

group_api.delete_groups_users(group_id=225250,
                              login="OtherUser")

返回：GroupUserSerializer

3. Repo 资源

获取某个用户/组织的仓库列表

repo_api = SimplePyYuQueAPI(token="token", app_name="py_yuque1").Repo()

repo_api.get_users_repos(type="all",login="Helixcs")

返回：Array<BookSerializer>

创建新仓库

res = repo_api.post_users_repos(name="Helixcs 的仓库123",
                                slug="helixcs123",
                                description="Helixcs 的仓库123",
                                public=RepoPublic.ALL_OPEN,
                                type=RepoType.BOOK,
                                login="Helixcs",)

res = repo_api.create_repos(name="Helixcs 的仓库123",
                            slug="helixcs123",
                            description="Helixcs 的仓库123",
                            public=RepoPublic.ALL_OPEN,
                            type=RepoType.BOOK,
                            login="Helixcs",)

# 访问：`https://www.yuque.com/helixcs/helixcs123`

返回：BookDetailSerializer

访问：https://www.yuque.com/helixcs/<slug>

获取仓库详情

res = repo_api.get_repos_detail(namespace="helixcs/helixcs123")
res = repo_api.get_repos(namespace="helixcs/helixcs123")
res = repo_api.get_repos_detail(id=189411)
res = repo_api.get_repos(id=189411)

返回：BookDetailSerializer

更新仓库信息

repo_api.put_repos(name="helixcs234 仓库",
                                 slug="helixcs234",
                                 toc="",
                                 description="Helixcs 仓库234",
                                 public=RepoPublic.PRIVATE,
                                 namespace="helixcs/helixcs123").base_response

repo_api.update_repos(name="helixcs234 仓库",
                                 slug="helixcs234",
                                 toc="",
                                 description="Helixcs 仓库234",
                                 public=RepoPublic.PRIVATE,
                                 namespace="helixcs/helixcs123").base_response

# 访问：`https://www.yuque.com/helixcs/helixcs123` 跳转 `https://www.yuque.com/helixcs/helixcs234`

返回：BookDetailSerializer

访问：https://www.yuque.com/<older namespace> 跳转 https://www.yuque.com/<new namespace>

删除仓库

repo_api.delete_repo(namespace="helixcs/helixcs234")
repo_api.delete_repo(id=189411)

返回：BookDeleteSerializer

repo_api.repos_toc(namespace="helixcs/helixcs234")
repo_api.repos_toc(id=189411)

返回：RepoTocSerializerList

基于关键字搜索仓库

repo_api.search_repos(q='a',type=RepoType.BOOK)

返回：Array<BookSerializer>

4. Doc 资源

获取一个仓库的文档列表

doc_api = SimplePyYuQueAPI(token="token", app_name="py_yuque1").Doc()

doc_api.get_repos_docs(namespace="helixcs/helixcs234").base_response
doc_api.get_repos_docs(id=189411).base_response

返回：Array<DocSerializer>

获取单篇文档的详细信息

doc_api.get_repos_docs_detail(namespace="helixcs/tuyepi", slug="taosm3").base_response
doc_api.get_docs_detail(namespace="helixcs/tuyepi", slug="taosm3").base_response

返回：DocDetailSerializer

创建文档

doc_api.post_repos_docs(namespace="helixcs/helixcs234", slug="randomstring", title="测试",body="你好世界!").base_response

doc_api.create_docs(namespace="helixcs/helixcs234", slug="randomstring", title="测试",body="你好世界!").base_response


# 访问：https://www.yuque.com/helixcs/helixcs234/randomstring

返回：DocDetailSerializer

访问：https://www.yuque.com/<namespace>/<slug>

更新文档

doc_api.put_repos_docs(namespace="helixcs/helixcs234", id=1057879, title="测试更新", slug="randomstring",
                       public=DocPublic.OPEN,
                       body="你好世界! (修改body)").base_response

doc_api.update_docs(namespace="helixcs/helixcs234", id=1057879, title="测试更新", slug="randomstring",
                    public=DocPublic.OPEN,
                    body="你好世界! (修改body)").base_response

doc_api.put_repos_docs(repo_id=189411, id=1057879, title="测试更新", slug="randomstring",
                       public=DocPublic.OPEN,
                       body="你好世界! (修改body)").base_response

doc_api.update_docs(repo_id=189411, id=1057879, title="测试更新", slug="randomstring",
                    public=DocPublic.OPEN,
                    body="你好世界! (修改body)").base_response

访问：https://www.yuque.com/helixcs/helixcs234/randomstring

返回：DocDetailSerializer

访问：https://www.yuque.com/<namespace>/<slug>

删除文档

doc_api.delete_repos_docs(namespace="helixcs/helixcs234", id=1057879).base_response
doc_api.delete_repos_docs(repo_id=189411, id=1057879).base_response


doc_api.delete_docs(namespace="helixcs/helixcs234", id=1057879).base_response
doc_api.delete_docs(repo_id=189411, id=1057879).base_response

返回：DocDetailSerializer

版本说明

v0.1.1 初始化
v0.1.3 修复部分 bug ，新增语雀更新字段，为下一个版本更新准备

问题排查

TODO：

LICENSE

MIT

simple-pyyuque
Release 0.1.3

Release 0.1.3

0.1.3

0.1.2

0.1.1

0.1

Documentation

Simple PyYuQue

安装

快速开始

1. 实例化

2. 简单调用

API 说明与示例

1. User 用户

2. Group 组织

3. Repo 资源

4. Doc 资源

版本说明

问题排查

LICENSE

Stats

Development practices

Releases

Contributors

simple-pyyuque Release 0.1.3

Release 0.1.3 Toggle Dropdown 0.1.3 0.1.2 0.1.1 0.1

Documentation

Simple PyYuQue

安装

快速开始

1. 实例化

2. 简单调用

API 说明与示例

1. User 用户

2. Group 组织

3. Repo 资源

4. Doc 资源

版本说明

问题排查

LICENSE

Stats

Development practices

Releases

Contributors

simple-pyyuque
Release 0.1.3

Release 0.1.3

0.1.3

0.1.2

0.1.1

0.1