tiebameow 0.1.1

Shared library for TiebaMeow services

tiebameow

Tiebameow 项目通用模块

简介

tiebameow 是在 Tiebameow 项目内使用的通用模块，提供了通用的数据模型、序列化/反序列化工具、日志模块以及辅助函数。

目录

• client: 包含增强的 aiotieba.Client 与 httpx 客户端。
• models: 定义了通用数据交换模型和 ORM 数据模型。
• parser: 提供解析和处理 aiotieba 数据的解析器。
• renderer: 提供将 DTO 内容或简单文本渲染为图片的功能。
• schemas: 定义了各种数据片段与审查规则的 Pydantic 模型。
• serializer: 提供数据交换模型的序列化和反序列化方法。
• utils: 包含通用日志模块和一些辅助函数和工具类。

安装

推荐使用 uv 进行环境管理和依赖安装。

仅安装基础功能：

uv add tiebameow

如需使用数据库模型，请安装 orm 额外依赖：

uv add tiebameow[orm]

如需使用渲染功能，请安装 renderer 额外依赖和 Playwright 所需浏览器：

uv add tiebameow[renderer]
uv run playwright install chromium-headless-shell

基本用法

更多用法请参阅源码。

Client

Tieba Client

from tiebameow.client import Client
async with Client() as client:
    user_info = await client.get_user_info("some_username")

HTTP Client

from tiebameow.client import HTTPXClient
response = await HTTPXClient.get("https://example.com")

Renderer

from tiebameow.renderer import Renderer
async with Renderer() as renderer:
    image_bytes = await renderer.text_to_image("Hello, World!")

开发指南

欢迎贡献代码，请确保遵循项目的编码规范，并在提交前运行 pre-commit hooks:

uv sync --dev
pre-commit install
pre-commit run --all-files

有关详细信息，请参阅 CONTRIBUTING.md 文件。