Metadata-Version: 2.1
Name: aiotieba
Version: 2.10.1
Summary: Asynchronous I/O Client for Baidu Tieba
Author-email: Starry-OvO <starry.qvq@gmail.com>
Project-URL: Repository, https://github.com/Starry-OvO/aiotieba/
Project-URL: Documentation, https://v-8.top/
Keywords: tieba,crawler,spider
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP :: Session
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiomysql (<0.2,>=0.1.0)
Requires-Dist: beautifulsoup4 (<5,>=4.0.0)
Requires-Dist: httpx (<0.24,>=0.23.0)
Requires-Dist: httpx-ws (<0.3,>=0.2.2)
Requires-Dist: lxml (<5,>=4.0.0)
Requires-Dist: opencv-contrib-python-headless (<4.8,>=4.6.0.66)
Requires-Dist: protobuf (<5,>=4.12.0)
Requires-Dist: pycryptodome (<4,>=3.0.0)
Requires-Dist: pysimdjson (<5.1,>=5.0.0)
Requires-Dist: tomli (<3,>=2.0.0) ; python_version < "3.11"

<p align="center">

<a href="https://socialify.git.ci">
    <img src="https://raw.githubusercontent.com/Starry-OvO/aiotieba/master/docs/img/aiotieba.svg">
</a>

</p>

<div align="center">
<p>
<a href="https://github.com/Starry-OvO/aiotieba/actions">
    <img src="https://img.shields.io/github/actions/workflow/status/Starry-OvO/aiotieba/CI.yml?branch=develop&label=CI&logo=github" alt="GitHub Workflow Status">
</a>
<a href="https://pypi.org/project/aiotieba">
    <img src="https://img.shields.io/pypi/v/aiotieba?color=g" alt="PyPI - Version">
</a>
<a href="https://pypi.org/project/aiotieba">
    <img src="https://img.shields.io/pypi/pyversions/aiotieba" alt="PyPI - Python Version">
</a>
</p>
</div>

---

## 简介

**aiotieba**使用[**asyncio**](https://docs.python.org/zh-cn/3/library/asyncio.html)和[**httpx**](https://github.com/encode/httpx)封装了大量[百度贴吧核心API](https://github.com/Starry-OvO/aiotieba/blob/master/aiotieba/client)

本框架以提高二次开发速度为首要设计目标。规范且符合直觉的命名规律、全覆盖的类型注解和方法注释让你体验飞一般的开发体验

<details>

<summary>贴吧接口列表</summary>

+ 按回复时间/发布时间/热门序获取贴吧主题帖/精华帖列表。支持获取带转发/投票/转发嵌套投票/各种卡片的主题帖信息
+ 获取带图片链接/小尾巴内容/点赞情况/用户信息（[用户名](https://v-8.top/tutorial/quickstart#user_name)/[portrait](https://v-8.top/tutorial/quickstart#portrait)/[user_id](https://v-8.top/tutorial/quickstart#user_id)/等级/性别/是否锁回复）/每条回复的前排楼中楼（支持按或不按点赞数排序）的楼层列表
+ 获取带所有前述用户信息的楼中楼列表
+ 根据[用户名](https://v-8.top/tutorial/quickstart#user_name)/[portrait](https://v-8.top/tutorial/quickstart#portrait)/[user_id](https://v-8.top/tutorial/quickstart#user_id)中的任一项反查其他用户信息，或通过用户主页的[tieba_uid](https://v-8.top/tutorial/quickstart#tieba_uid)反查其他用户信息
+ 使用小吧主、语音小编的账号删帖/屏蔽/封禁。支持删除视频帖/批量删帖/多于1天的封禁
+ 使用已被大吧主分配解封/恢复/处理申诉权限的吧务账号解封/恢复/处理申诉
+ 使用大吧主账号推荐帖子到首页/移动帖子到指定分区/加精/撤精/置顶/撤置顶/添加黑名单/查看黑名单/取消黑名单
+ 获取其他用户的主页信息/关注贴吧列表/关注用户列表/粉丝列表/发布的主题帖列表
+ 使用当前账号关注贴吧/取关贴吧/关注用户/取关用户/移除粉丝/获取屏蔽贴吧列表/屏蔽贴吧/取消屏蔽贴吧/点赞点踩/取消点赞点踩/签到/水帖/发送私信/获取回复历史
+ 获取一个贴吧的最新关注用户列表/等级排行榜/吧务列表/吧详情

</details>

## 安装并使用

+ 检查Python版本 (**>=3.9**)

+ 安装

```shell
pip install aiotieba
```

+ 体验一下

```python
import asyncio

import aiotieba


async def main():
    async with aiotieba.Client() as client:
        print(await client.get_threads("天堂鸡汤"))


asyncio.run(main())
```

+ 继续阅读[**入门教程**](https://v-8.top/tutorial/quickstart)

## 友情链接

+ [另一个仍在活跃更新的贴吧管理器（有用户界面）](https://github.com/dog194/TiebaManager)
+ [用户反馈（我的个人吧）](https://tieba.baidu.com/starry)

## 客户名单

<details><summary>2023.01.04更新</summary>

|      吧名      | 关注用户数 | 最近29天日均访问量 | 日均主题帖数 | 日均回复数 |
| :------------: | :--------: | :----------------: | :----------: | :--------: |
|    抗压背锅    | 4,488,913  |      905,120       |    1,551     |   68,482   |
|     孙笑川     | 3,119,576  |      675,274       |    6,000     |  191,947   |
|    lol半价     | 2,000,354  |       87,455       |     661      |   10,339   |
|      宫漫      | 1,462,777  |       42,304       |     155      |   2,146    |
|    逆水寒ol    |  747,120   |       29,761       |     106      |   1,996    |
|    新孙笑川    |  521,467   |       40,696       |     289      |   13,692   |
|     vtuber     |  220,628   |       10,668       |      57      |    733     |
|     asoul      |  155,950   |       10,517       |      76      |    440     |
|      嘉然      |   59,345   |       10,724       |      78      |   1,043    |
|      向晚      |   30,738   |       7,205        |      54      |    689     |
|      贝拉      |   21,773   |       7,075        |      33      |    495     |
|      乃琳      |   17,328   |       3,544        |      21      |    264     |
| vtuber自由讨论 |   17,196   |       4,040        |      1       |     34     |

</details>
