tiebameow 0.2.8__py3-none-any.whl

tiebameow-0.2.8.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: tiebameow
+Version: 0.2.8
+Summary: Shared library for TiebaMeow services
+License-Expression: MIT
+License-File: LICENSE
+Keywords: tieba
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Requires-Dist: aiolimiter>=1.2.1
+Requires-Dist: aiotieba>=4.6.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyparsing>=3.3.1
+Requires-Dist: tenacity>=9.1.2
+Requires-Dist: tzdata>=2025.2
+Provides-Extra: orm
+Requires-Dist: sqlalchemy>=2.0.44; extra == 'orm'
+Provides-Extra: renderer
+Requires-Dist: jinja2>=3.1.5; extra == 'renderer'
+Requires-Dist: playwright>=1.49.1; extra == 'renderer'
+Description-Content-Type: text/markdown
+
+# tiebameow
+
+[![License](https://img.shields.io/github/license/TiebaMeow/tiebameow)](https://github.com/TiebaMeow/tiebameow/blob/main/LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/tiebameow)](https://pypi.org/project/tiebameow/)
+[![Python](https://img.shields.io/pypi/pyversions/tiebameow)](https://pypi.org/project/tiebameow/)
+[![CI](https://github.com/TiebaMeow/tiebameow/actions/workflows/CI.yml/badge.svg)](https://github.com/TiebaMeow/tiebameow/actions/workflows/CI.yml)
+[![codecov](https://codecov.io/gh/TiebaMeow/tiebameow/graph/badge.svg)](https://codecov.io/gh/TiebaMeow/tiebameow)
+
+Tiebameow 项目通用模块
+
+## 简介
+
+`tiebameow` 是在 Tiebameow 项目内使用的通用模块，提供了通用的数据模型、序列化/反序列化工具、日志模块以及辅助函数。
+
+## 目录
+
+- `client`: 包含增强的 `aiotieba.Client` 与 `httpx` 客户端。
+- `models`: 定义了通用数据交换模型和 ORM 数据模型。
+- `parser`: 提供解析和处理 `aiotieba` 数据和审查规则的解析器。
+- `renderer`: 提供将 DTO 内容或简单文本渲染为图片的功能。
+- `schemas`: 定义了各种数据片段与审查规则的 Pydantic 模型。
+- `serializer`: 提供数据交换模型的序列化和反序列化方法。
+- `utils`: 包含通用日志模块和一些辅助函数和工具类。
+
+## 安装
+
+推荐使用 `uv` 进行环境管理和依赖安装。
+
+仅安装基础功能：
+
+```bash
+uv add tiebameow
+```
+
+如需使用数据库模型，请安装 `orm` 额外依赖：
+
+```bash
+uv add tiebameow[orm]
+```
+
+如需使用渲染功能，请安装 `renderer` 额外依赖和 `Playwright` 所需浏览器：
+
+```bash
+uv add tiebameow[renderer]
+uv run playwright install chromium-headless-shell
+```
+
+## 基本用法
+
+更多用法请参阅源码。
+
+### Client
+
+#### Tieba Client
+
+```python
+from tiebameow.client import Client
+async with Client() as client:
+    user_info = await client.get_user_info("some_username")
+```
+
+#### HTTP Client
+
+```python
+from tiebameow.client import HTTPXClient
+response = await HTTPXClient.get("https://example.com")
+```
+
+### Parser
+
+#### 数据转换器
+
+将 `aiotieba` 对象转换为通用数据交换模型：
+
+```python
+from tiebameow.parser import convert_aiotieba_thread
+from tiebameow.client import Client
+async with Client() as client:
+    threads = await client.get_threads("some_tieba")
+    for thread in threads:
+        converted_thread = convert_aiotieba_thread(thread)
+```
+
+#### 规则引擎解析器
+
+以 DSL 或 CNL 模式解析规则和动作：
+
+```python
+from tiebameow.parser import RuleEngineParser
+parser = RuleEngineParser()
+rule_node = parser.parse_rule("(title contains 'A' AND title contains 'B') OR NOT title contains 'C'")
+actions = parser.parse_actions("DO: delete(reason='spam content'), ban(days=1)")
+```
+
+### Renderer
+
+```python
+from tiebameow.renderer import Renderer
+async with Renderer() as renderer:
+    image_bytes = await renderer.text_to_image("Hello, World!")
+```
+
+## 开发指南
+
+欢迎贡献代码，请确保遵循项目的编码规范，并在提交前运行 pre-commit hooks:
+
+```bash
+uv sync --dev
+pre-commit install
+pre-commit run --all-files
+```
+
+有关详细信息，请参阅 `CONTRIBUTING.md` 文件。

tiebameow-0.2.8.dist-info/RECORD

@@ -0,0 +1,36 @@
+tiebameow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tiebameow/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tiebameow/client/__init__.py,sha256=oDIpFubIaQLXEL-XV3x16qh8o_BVkF6SAazLl0IUFlg,107
+tiebameow/client/http_client.py,sha256=0QD-KaRjKVCO_F2l9My-nkiZQFoHTALbWYy2O7ifink,3594
+tiebameow/client/tieba_client.py,sha256=zlkCRp2H-kXD8OOCO3qWgZ8XOwlivzXZYo7uHM_q8A0,17240
+tiebameow/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tiebameow/models/dto.py,sha256=LhrsDJSiqq6j4huNJGHtrIU9N662olIiXP9qzKTd0Ko,10075
+tiebameow/models/orm.py,sha256=MGco1lStB9TZ73FPu3sC9iDI_8EiIrw5rUvn1L72PLw,20207
+tiebameow/parser/__init__.py,sha256=LSkPkz7RKGOpiKpNj5LLrMaVxmhw0ALWGj5aubwcvWk,1319
+tiebameow/parser/parser.py,sha256=m52VsZoZMknOcDIFt-pV5b76kTzUS781JIwQO5zAK8A,11607
+tiebameow/parser/rule_parser.py,sha256=HReDjC_C8CFyYQZWYdkl7rvQ9lgPoypBWKc9q3vNbvM,37122
+tiebameow/renderer/__init__.py,sha256=p_EtWNsiTetGGgtGQaHgcEqwdUBqFe8wmt6q1K9hGm8,166
+tiebameow/renderer/config.py,sha256=45oVjrcGJSL28vkjH-w7670xelAbYQRkH0up9G71U3c,484
+tiebameow/renderer/playwright_core.py,sha256=MuGv6MidkEYFZLneicY0z98NFpAfBhpCRxFfK7IG8xY,4915
+tiebameow/renderer/renderer.py,sha256=madO9rZcUEtRE2m3L1ul0oJNVm8GQ7zoPVtyztMaHOE,17776
+tiebameow/renderer/style.py,sha256=oGUYC9tTPZ6hJ9K9SD7Uvq79H3uqnJNPK_FuPWRNea4,743
+tiebameow/renderer/static/fonts/NotoSansSC-Regular.woff2,sha256=KsZkKouZc8g1eQ_5wzOWuGkIcSYzGGsHYZJhyu0hFDg,4182468
+tiebameow/renderer/templates/base.html,sha256=O34oGzyZR3nBUgFhf8Oh7THTg0BH8BM1xK9vaP3-vVw,6109
+tiebameow/renderer/templates/macros.html,sha256=-npkG2U7ZARhkksFdqrL5ffAm3S6hQ54wkdRJAH3a-M,3114
+tiebameow/renderer/templates/text.html,sha256=zrryzgnY_B7TrYqsMkRDEpSDmDqcBHUF5WnUMOOQNyo,2283
+tiebameow/renderer/templates/text_simple.html,sha256=iWisu1XdIP2cSynTXHGXzbUxfOTsoUmdsIeXdJrRJUk,1995
+tiebameow/renderer/templates/thread.html,sha256=os3-qlBTbIgwtLQFcC94zZgmE4-95JtBuO4ndTw_YwI,251
+tiebameow/renderer/templates/thread_detail.html,sha256=Io4cRr40gav_4irXqNLn11S7QVFFJMA3auK5mDbonbE,481
+tiebameow/renderer/templates/thread_info.html,sha256=BS_j-XUxcMYzmw1IIQ6p86HN6nUgbs0vL0HvbC17vU4,7628
+tiebameow/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tiebameow/schemas/fragments.py,sha256=lLJZ88rj2N8Fy166sHF5wJoSuG1H_Y9Ordke1426cH0,4244
+tiebameow/schemas/rules.py,sha256=zg0Rr6OoL1ByF70JziFvKDSp9sxjHAU9M1qoAs1D8Ac,6515
+tiebameow/serializer/__init__.py,sha256=HzNJRqUBbMaw5eenPQze90_crEba-DyKV8UMAfYGUSk,259
+tiebameow/serializer/serializer.py,sha256=45jXTC6qhSWcG2JpxcWHpvD8Sf3ZNndHOPrBt_klECs,3184
+tiebameow/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tiebameow/utils/logger.py,sha256=FIWreeOyRYtOhtinb1iahWNenzzkLreo2rR3cE97kgk,4283
+tiebameow/utils/time_utils.py,sha256=b71lsrw-o5LBVGtg9WpAdOvnL7CY1ugjq513fgGHg4A,325
+tiebameow-0.2.8.dist-info/METADATA,sha256=4op3F8_HFy-nqkugVYENivCLJJZhWvlyWQzIq74ZVe8,4197
+tiebameow-0.2.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+tiebameow-0.2.8.dist-info/licenses/LICENSE,sha256=bq5BsmRGHKrtjWJpDXgnQx1IpFBigzsr-SvKOZRy78Y,1079
+tiebameow-0.2.8.dist-info/RECORD,,

tiebameow-0.2.8.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

tiebameow-0.2.8.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TiebaMeow Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.