nonebot-plugin-receipts 0.2.0__tar.gz → 0.2.2__tar.gz

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot_plugin_receipts
-Version: 0.2.0
+Version: 0.2.2
 Summary: NoneBot2 plugin for sending text and image messages to receipts-spooler
 Project-URL: homepage, https://github.com/Effect-Wei/nonebot_plugin_receipts
 Project-URL: repository, https://github.com/Effect-Wei/nonebot_plugin_receipts
@@ -46,22 +46,22 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 插件通过 NoneBot 全局配置读取以下环境变量：
 
-| 变量                          | 默认值                  | 说明                                  |
-| ----------------------------- | ----------------------- | ------------------------------------- |
-| `RECEIPTS_SPOOLER_URL`        | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
-| `RECEIPTS_SPOOLER_TOKEN`      | 空                      | 对应 `X-Spooler-Token`                |
-| `RECEIPTS_SPOOLER_TIMEOUT`    | `5.0`                   | 调用 spooler 的 HTTP 超时             |
-| `RECEIPT_IMAGE_FETCH_TIMEOUT` | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
-| `RECEIPT_RENDER_MODE`         | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
-| `RECEIPT_PRINTER_WIDTH`       | `576`                   | 小票像素宽度，最大 `576`              |
-| `RECEIPT_TEMPLATE_PATH`       | 空                      | 可选，指向渲染模板 JSON 文件          |
-| `RECEIPT_FONT_PATH`           | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
-| `RECEIPT_FONT_SIZE`           | `24`                    | 文本字号                              |
-| `RECEIPT_LINE_SPACING`        | `6`                     | 文本行距                              |
-| `RECEIPT_SECTION_GAP`         | `6`                     | 文本和图片之间的垂直间距              |
-| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`               | 等待用户补发打印内容的超时时间（秒）   |
-| `RECEIPT_FEED_LINES`          | `4`                     | 打印后走纸行数                        |
-| `RECEIPT_ENABLE_CUT`          | `true`                  | 是否附加切纸命令                      |
+| 变量                              | 默认值                  | 说明                                  |
+| --------------------------------- | ----------------------- | ------------------------------------- |
+| `RECEIPTS_SPOOLER_URL`            | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
+| `RECEIPTS_SPOOLER_TOKEN`          | 空                      | 对应 `X-Spooler-Token`                |
+| `RECEIPTS_SPOOLER_TIMEOUT`        | `5.0`                   | 调用 spooler 的 HTTP 超时             |
+| `RECEIPT_IMAGE_FETCH_TIMEOUT`     | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
+| `RECEIPT_RENDER_MODE`             | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
+| `RECEIPT_PRINTER_WIDTH`           | `576`                   | 小票像素宽度，最大 `576`              |
+| `RECEIPT_TEMPLATE_PATH`           | 空                      | 可选，指向渲染模板 JSON 文件          |
+| `RECEIPT_FONT_PATH`               | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
+| `RECEIPT_FONT_SIZE`               | `24`                    | 文本字号                              |
+| `RECEIPT_LINE_SPACING`            | `6`                     | 文本行距                              |
+| `RECEIPT_SECTION_GAP`             | `6`                     | 文本和图片之间的垂直间距              |
+| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
+| `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
+| `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
 
 ### 渲染模式
 
@@ -138,6 +138,38 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 在 `raster` 模式下会使用更大的字号和额外留白；在 `hybrid` 模式下会尽量映射为 ESC/POS 的加粗和放大文本。  
 如果需要打印以 `#` 开头的普通文本，可以写成 `\# 普通文本`。
 
+## 手动实机测试（不启动 NoneBot）
+
+可直接运行脚本把测试内容渲染为 ESC/POS 并提交到 `receipts-spooler`：
+
+```powershell
+python scripts/manual_print_test.py --mode hybrid --spooler-url http://127.0.0.1:8000
+```
+
+常用参数：
+
+- `--mode hybrid|raster`：渲染模式，默认 `hybrid`
+- `--text`：测试文本（支持 `#` 标题语法）
+- `--spooler-url`：spooler 地址
+- `--spooler-token`：可选鉴权 token
+- `--printer-width`：打印宽度（像素）
+- `--feed-lines`：走纸行数
+- `--cut`：追加切纸命令（默认不切）
+- `--divider-only`：只打印一条分割线（用于实机校准）
+- `--divider-chars`：分割线字符数（默认按 `printer_width / 12`）
+
+也支持通过环境变量传参：
+
+- `RENDER_MODE`
+- `SPOOLER_URL`
+- `SPOOLER_TOKEN`
+- `PRINTER_WIDTH`
+- `FEED_LINES`
+- `SENDER_NAME`
+- `SENDER_ID`
+
+该脚本仅用于手动联调与实机验证，不参与自动化测试流程。
+
 ## 注意事项
 
 - 如果你需要打印中文，最好配置 `RECEIPT_FONT_PATH` 指向支持中文的字体文件。

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/README.md

@@ -29,22 +29,22 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 插件通过 NoneBot 全局配置读取以下环境变量：
 
-| 变量                          | 默认值                  | 说明                                  |
-| ----------------------------- | ----------------------- | ------------------------------------- |
-| `RECEIPTS_SPOOLER_URL`        | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
-| `RECEIPTS_SPOOLER_TOKEN`      | 空                      | 对应 `X-Spooler-Token`                |
-| `RECEIPTS_SPOOLER_TIMEOUT`    | `5.0`                   | 调用 spooler 的 HTTP 超时             |
-| `RECEIPT_IMAGE_FETCH_TIMEOUT` | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
-| `RECEIPT_RENDER_MODE`         | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
-| `RECEIPT_PRINTER_WIDTH`       | `576`                   | 小票像素宽度，最大 `576`              |
-| `RECEIPT_TEMPLATE_PATH`       | 空                      | 可选，指向渲染模板 JSON 文件          |
-| `RECEIPT_FONT_PATH`           | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
-| `RECEIPT_FONT_SIZE`           | `24`                    | 文本字号                              |
-| `RECEIPT_LINE_SPACING`        | `6`                     | 文本行距                              |
-| `RECEIPT_SECTION_GAP`         | `6`                     | 文本和图片之间的垂直间距              |
-| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`               | 等待用户补发打印内容的超时时间（秒）   |
-| `RECEIPT_FEED_LINES`          | `4`                     | 打印后走纸行数                        |
-| `RECEIPT_ENABLE_CUT`          | `true`                  | 是否附加切纸命令                      |
+| 变量                              | 默认值                  | 说明                                  |
+| --------------------------------- | ----------------------- | ------------------------------------- |
+| `RECEIPTS_SPOOLER_URL`            | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
+| `RECEIPTS_SPOOLER_TOKEN`          | 空                      | 对应 `X-Spooler-Token`                |
+| `RECEIPTS_SPOOLER_TIMEOUT`        | `5.0`                   | 调用 spooler 的 HTTP 超时             |
+| `RECEIPT_IMAGE_FETCH_TIMEOUT`     | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
+| `RECEIPT_RENDER_MODE`             | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
+| `RECEIPT_PRINTER_WIDTH`           | `576`                   | 小票像素宽度，最大 `576`              |
+| `RECEIPT_TEMPLATE_PATH`           | 空                      | 可选，指向渲染模板 JSON 文件          |
+| `RECEIPT_FONT_PATH`               | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
+| `RECEIPT_FONT_SIZE`               | `24`                    | 文本字号                              |
+| `RECEIPT_LINE_SPACING`            | `6`                     | 文本行距                              |
+| `RECEIPT_SECTION_GAP`             | `6`                     | 文本和图片之间的垂直间距              |
+| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
+| `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
+| `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
 
 ### 渲染模式
 
@@ -121,6 +121,38 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 在 `raster` 模式下会使用更大的字号和额外留白；在 `hybrid` 模式下会尽量映射为 ESC/POS 的加粗和放大文本。  
 如果需要打印以 `#` 开头的普通文本，可以写成 `\# 普通文本`。
 
+## 手动实机测试（不启动 NoneBot）
+
+可直接运行脚本把测试内容渲染为 ESC/POS 并提交到 `receipts-spooler`：
+
+```powershell
+python scripts/manual_print_test.py --mode hybrid --spooler-url http://127.0.0.1:8000
+```
+
+常用参数：
+
+- `--mode hybrid|raster`：渲染模式，默认 `hybrid`
+- `--text`：测试文本（支持 `#` 标题语法）
+- `--spooler-url`：spooler 地址
+- `--spooler-token`：可选鉴权 token
+- `--printer-width`：打印宽度（像素）
+- `--feed-lines`：走纸行数
+- `--cut`：追加切纸命令（默认不切）
+- `--divider-only`：只打印一条分割线（用于实机校准）
+- `--divider-chars`：分割线字符数（默认按 `printer_width / 12`）
+
+也支持通过环境变量传参：
+
+- `RENDER_MODE`
+- `SPOOLER_URL`
+- `SPOOLER_TOKEN`
+- `PRINTER_WIDTH`
+- `FEED_LINES`
+- `SENDER_NAME`
+- `SENDER_ID`
+
+该脚本仅用于手动联调与实机验证，不参与自动化测试流程。
+
 ## 注意事项
 
 - 如果你需要打印中文，最好配置 `RECEIPT_FONT_PATH` 指向支持中文的字体文件。

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/nonebot_plugin_receipts/command_handlers.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
 from time import monotonic
-from typing import TYPE_CHECKING
 
 from nonebot import get_driver, get_plugin_config
+from nonebot.adapters.onebot.v11 import Message, MessageEvent  # noqa: TC002
+from nonebot.matcher import Matcher  # noqa: TC002
 from nonebot.params import Arg, CommandArg
 
 from .config import Config
@@ -11,11 +12,6 @@ from .renderer import ReceiptRenderError, render_receipt
 from .spooler import SpoolerClient, SpoolerError
 from .template import ReceiptTemplateContext
 
-if TYPE_CHECKING:
-    from nonebot.adapters.onebot.v11 import Message, MessageEvent
-    from nonebot.matcher import Matcher
-
-
 RECEIPT_TIMEOUT_DEADLINE_KEY = "receipt_timeout_deadline"
 
 

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/nonebot_plugin_receipts/escpos_backend.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
-from PIL import Image, ImageDraw, ImageOps
+from PIL import Image, ImageOps
 
 from .raster_backend import build_image_section
 from .render_types import (
@@ -11,7 +11,6 @@ from .render_types import (
     ReceiptBlock,
     ReceiptRenderError,
 )
-from .render_utils import load_font, measure_text
 from .text_markup import (
     encode_native_text,
     encode_styled_native_text,
@@ -25,6 +24,11 @@ if TYPE_CHECKING:
     from .template import ReceiptTemplate, ReceiptTemplateContext
 
 
+NATIVE_CHAR_WIDTH_PX = 12
+DIVIDER_BEFORE = "before"
+DIVIDER_AFTER = "after"
+
+
 def render_hybrid_escpos(
     blocks: Sequence[ReceiptBlock],
     config: Config,
@@ -37,21 +41,39 @@ def render_hybrid_escpos(
         raise ReceiptRenderError(ReceiptRenderError.INVALID_LAYOUT)
 
     chunks: list[bytes] = [b"\x1b@"]
+    divider_width_chars = max(1, layout.width // NATIVE_CHAR_WIDTH_PX)
 
     header_text = template.render_header_text(template_context)
     append_hybrid_text_section(
         chunks,
         header_text,
         layout.width_chars,
-        add_divider_after=True,
+        divider_width_chars,
+        divider=DIVIDER_AFTER,
     )
 
-    has_body_content = append_hybrid_body_sections(
-        chunks,
-        blocks,
-        config,
-        layout,
-    )
+    has_body_content = False
+    for block in blocks:
+        if block.kind == "text" and block.text:
+            styled_lines = parse_styled_lines(block.text)
+            if not styled_lines:
+                continue
+            chunks.append(encode_styled_native_text(styled_lines, layout.width_chars))
+            has_body_content = True
+            continue
+
+        if block.kind != "image" or block.image is None:
+            continue
+
+        section = build_image_section(
+            block.image,
+            layout.width,
+            layout.content_width,
+            config.receipt_section_gap,
+        )
+        chunks.append(image_to_escpos(section, config, initialize=False))
+        has_body_content = True
+
     if not has_body_content:
         raise ReceiptRenderError(ReceiptRenderError.EMPTY_CONTENT)
 
@@ -60,7 +82,8 @@ def render_hybrid_escpos(
         chunks,
         footer_text,
         layout.width_chars,
-        add_divider_before=True,
+        divider_width_chars,
+        divider=DIVIDER_BEFORE,
     )
 
     if config.receipt_feed_lines:
@@ -76,11 +99,7 @@ def build_hybrid_layout(config: Config, template: ReceiptTemplate) -> HybridLayo
     margin = template.margin
     content_width = width - margin * 2
 
-    font = load_font(config)
-    probe = Image.new("L", (width, 10), color=255)
-    draw = ImageDraw.Draw(probe)
-    avg_char_width = max(1, measure_text(draw, "AA", font) // 2)
-    width_chars = max(1, content_width // avg_char_width)
+    width_chars = max(1, content_width // NATIVE_CHAR_WIDTH_PX)
     return HybridLayout(
         width=width,
         content_width=content_width,
@@ -88,18 +107,12 @@ def build_hybrid_layout(config: Config, template: ReceiptTemplate) -> HybridLayo
     )
 
 
-def build_native_divider(width_chars: int) -> list[str]:
-    """Build a text divider sized to the current printer width."""
-    return ["-" * max(1, width_chars)]
-
-
 def append_hybrid_text_section(
     chunks: list[bytes],
     text: str,
     width_chars: int,
-    *,
-    add_divider_before: bool = False,
-    add_divider_after: bool = False,
+    divider_width_chars: int,
+    divider: str = "",
 ) -> None:
     """Append wrapped native text lines and an optional divider."""
     if not text:
@@ -109,57 +122,11 @@ def append_hybrid_text_section(
     if not styled_lines:
         return
 
-    if add_divider_before:
-        chunks.append(encode_native_text(build_native_divider(width_chars)))
+    if divider == DIVIDER_BEFORE:
+        chunks.append(encode_native_text(["-" * divider_width_chars]))
     chunks.append(encode_styled_native_text(styled_lines, width_chars))
-    if add_divider_after:
-        chunks.append(encode_native_text(build_native_divider(width_chars)))
-
-
-def append_hybrid_body_sections(
-    chunks: list[bytes],
-    blocks: Sequence[ReceiptBlock],
-    config: Config,
-    layout: HybridLayout,
-) -> bool:
-    """Append mixed native-text and raster-image body sections."""
-    has_body_content = False
-    for block in blocks:
-        appended = append_hybrid_body_section(
-            chunks,
-            block,
-            config,
-            layout,
-        )
-        has_body_content = has_body_content or appended
-    return has_body_content
-
-
-def append_hybrid_body_section(
-    chunks: list[bytes],
-    block: ReceiptBlock,
-    config: Config,
-    layout: HybridLayout,
-) -> bool:
-    """Append one body block to hybrid ESC/POS output."""
-    if block.kind == "text" and block.text:
-        styled_lines = parse_styled_lines(block.text)
-        if not styled_lines:
-            return False
-        chunks.append(encode_styled_native_text(styled_lines, layout.width_chars))
-        return True
-
-    if block.kind == "image" and block.image is not None:
-        section = build_image_section(
-            block.image,
-            layout.width,
-            layout.content_width,
-            config.receipt_section_gap,
-        )
-        chunks.append(image_to_escpos(section, config, initialize=False))
-        return True
-
-    return False
+    if divider == DIVIDER_AFTER:
+        chunks.append(encode_native_text(["-" * divider_width_chars]))
 
 
 def image_to_escpos(

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/nonebot_plugin_receipts.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot_plugin_receipts
-Version: 0.2.0
+Version: 0.2.2
 Summary: NoneBot2 plugin for sending text and image messages to receipts-spooler
 Project-URL: homepage, https://github.com/Effect-Wei/nonebot_plugin_receipts
 Project-URL: repository, https://github.com/Effect-Wei/nonebot_plugin_receipts
@@ -46,22 +46,22 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 
 插件通过 NoneBot 全局配置读取以下环境变量：
 
-| 变量                          | 默认值                  | 说明                                  |
-| ----------------------------- | ----------------------- | ------------------------------------- |
-| `RECEIPTS_SPOOLER_URL`        | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
-| `RECEIPTS_SPOOLER_TOKEN`      | 空                      | 对应 `X-Spooler-Token`                |
-| `RECEIPTS_SPOOLER_TIMEOUT`    | `5.0`                   | 调用 spooler 的 HTTP 超时             |
-| `RECEIPT_IMAGE_FETCH_TIMEOUT` | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
-| `RECEIPT_RENDER_MODE`         | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
-| `RECEIPT_PRINTER_WIDTH`       | `576`                   | 小票像素宽度，最大 `576`              |
-| `RECEIPT_TEMPLATE_PATH`       | 空                      | 可选，指向渲染模板 JSON 文件          |
-| `RECEIPT_FONT_PATH`           | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
-| `RECEIPT_FONT_SIZE`           | `24`                    | 文本字号                              |
-| `RECEIPT_LINE_SPACING`        | `6`                     | 文本行距                              |
-| `RECEIPT_SECTION_GAP`         | `6`                     | 文本和图片之间的垂直间距              |
-| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`               | 等待用户补发打印内容的超时时间（秒）   |
-| `RECEIPT_FEED_LINES`          | `4`                     | 打印后走纸行数                        |
-| `RECEIPT_ENABLE_CUT`          | `true`                  | 是否附加切纸命令                      |
+| 变量                              | 默认值                  | 说明                                  |
+| --------------------------------- | ----------------------- | ------------------------------------- |
+| `RECEIPTS_SPOOLER_URL`            | `http://127.0.0.1:8000` | `receipts-spooler` 服务地址           |
+| `RECEIPTS_SPOOLER_TOKEN`          | 空                      | 对应 `X-Spooler-Token`                |
+| `RECEIPTS_SPOOLER_TIMEOUT`        | `5.0`                   | 调用 spooler 的 HTTP 超时             |
+| `RECEIPT_IMAGE_FETCH_TIMEOUT`     | `5.0`                   | 下载图片消息内容时的 HTTP 超时        |
+| `RECEIPT_RENDER_MODE`             | `raster`                | 渲染模式，可选 `raster`/`hybrid`      |
+| `RECEIPT_PRINTER_WIDTH`           | `576`                   | 小票像素宽度，最大 `576`              |
+| `RECEIPT_TEMPLATE_PATH`           | 空                      | 可选，指向渲染模板 JSON 文件          |
+| `RECEIPT_FONT_PATH`               | 空                      | 可选，建议配置支持中文的 TTF/OTF 字体 |
+| `RECEIPT_FONT_SIZE`               | `24`                    | 文本字号                              |
+| `RECEIPT_LINE_SPACING`            | `6`                     | 文本行距                              |
+| `RECEIPT_SECTION_GAP`             | `6`                     | 文本和图片之间的垂直间距              |
+| `RECEIPT_SESSION_TIMEOUT_SECONDS` | `120`                   | 等待用户补发打印内容的超时时间（秒）  |
+| `RECEIPT_FEED_LINES`              | `4`                     | 打印后走纸行数                        |
+| `RECEIPT_ENABLE_CUT`              | `true`                  | 是否附加切纸命令                      |
 
 ### 渲染模式
 
@@ -138,6 +138,38 @@ nonebot.load_plugin("nonebot_plugin_receipts")
 在 `raster` 模式下会使用更大的字号和额外留白；在 `hybrid` 模式下会尽量映射为 ESC/POS 的加粗和放大文本。  
 如果需要打印以 `#` 开头的普通文本，可以写成 `\# 普通文本`。
 
+## 手动实机测试（不启动 NoneBot）
+
+可直接运行脚本把测试内容渲染为 ESC/POS 并提交到 `receipts-spooler`：
+
+```powershell
+python scripts/manual_print_test.py --mode hybrid --spooler-url http://127.0.0.1:8000
+```
+
+常用参数：
+
+- `--mode hybrid|raster`：渲染模式，默认 `hybrid`
+- `--text`：测试文本（支持 `#` 标题语法）
+- `--spooler-url`：spooler 地址
+- `--spooler-token`：可选鉴权 token
+- `--printer-width`：打印宽度（像素）
+- `--feed-lines`：走纸行数
+- `--cut`：追加切纸命令（默认不切）
+- `--divider-only`：只打印一条分割线（用于实机校准）
+- `--divider-chars`：分割线字符数（默认按 `printer_width / 12`）
+
+也支持通过环境变量传参：
+
+- `RENDER_MODE`
+- `SPOOLER_URL`
+- `SPOOLER_TOKEN`
+- `PRINTER_WIDTH`
+- `FEED_LINES`
+- `SENDER_NAME`
+- `SENDER_ID`
+
+该脚本仅用于手动联调与实机验证，不参与自动化测试流程。
+
 ## 注意事项
 
 - 如果你需要打印中文，最好配置 `RECEIPT_FONT_PATH` 指向支持中文的字体文件。

{nonebot_plugin_receipts-0.2.0 → nonebot_plugin_receipts-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "nonebot_plugin_receipts"
-version = "0.2.0"
+version = "0.2.2"
 description = "NoneBot2 plugin for sending text and image messages to receipts-spooler"
 readme = "README.md"
 requires-python = ">=3.12, <4.0"

nonebot_plugin_receipts-0.2.2/tests/test_renderer.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+import unittest
+from pathlib import Path
+from typing import TYPE_CHECKING, cast
+from unittest.mock import AsyncMock, patch
+
+from nonebot_plugin_receipts.config import Config
+from nonebot_plugin_receipts.escpos_backend import (
+    NATIVE_CHAR_WIDTH_PX,
+    render_hybrid_escpos,
+)
+from nonebot_plugin_receipts.render_types import ReceiptBlock
+from nonebot_plugin_receipts.renderer import render_receipt
+from nonebot_plugin_receipts.template import ReceiptTemplate, ReceiptTemplateContext
+
+if TYPE_CHECKING:
+    from typing import Any
+
+
+EXPECTED_DIVIDER_CHARS = 48
+
+
+class RendererIntegrationTestCase(unittest.IsolatedAsyncioTestCase):
+    def setUp(self) -> None:
+        self.template_path = str(
+            Path(__file__).resolve().parents[1] / "receipt_template.example.json"
+        )
+        self.context = ReceiptTemplateContext(sender_name="Tester", sender_id="10001")
+
+    async def test_render_receipt_returns_bytes_in_raster_mode(self) -> None:
+        config = Config(
+            receipt_render_mode="raster",
+            receipt_template_path=self.template_path,
+        )
+
+        with patch(
+            "nonebot_plugin_receipts.renderer.extract_blocks",
+            new=AsyncMock(
+                return_value=[ReceiptBlock(kind="text", text="# Title\nBody")]
+            ),
+        ):
+            rendered = await render_receipt(cast("Any", []), config, self.context)
+
+        self.assertIsInstance(rendered, bytes)
+        self.assertGreater(len(rendered), 0)
+
+    async def test_render_receipt_returns_bytes_in_hybrid_mode(self) -> None:
+        config = Config(
+            receipt_render_mode="hybrid",
+            receipt_template_path=self.template_path,
+        )
+
+        with patch(
+            "nonebot_plugin_receipts.renderer.extract_blocks",
+            new=AsyncMock(
+                return_value=[ReceiptBlock(kind="text", text="## Title\nBody")]
+            ),
+        ):
+            rendered = await render_receipt(cast("Any", []), config, self.context)
+
+        self.assertIsInstance(rendered, bytes)
+        self.assertGreater(len(rendered), 0)
+
+    async def test_render_receipt_hybrid_uses_48_char_divider(self) -> None:
+        config = Config(
+            receipt_render_mode="hybrid",
+            receipt_template_path=self.template_path,
+            receipt_enable_cut=False,
+            receipt_feed_lines=0,
+        )
+
+        with patch(
+            "nonebot_plugin_receipts.renderer.extract_blocks",
+            new=AsyncMock(
+                return_value=[ReceiptBlock(kind="text", text="# Title\nBody")]
+            ),
+        ):
+            rendered = await render_receipt(cast("Any", []), config, self.context)
+
+        decoded = rendered.decode("gb18030", errors="ignore")
+        divider_lines = [
+            line for line in decoded.splitlines() if line and set(line) == {"-"}
+        ]
+        self.assertEqual(len(divider_lines), 2)
+        self.assertTrue(
+            all(len(line) == EXPECTED_DIVIDER_CHARS for line in divider_lines)
+        )
+
+    def test_hybrid_fixed_native_char_width(self) -> None:
+        self.assertEqual(NATIVE_CHAR_WIDTH_PX, 12)
+
+    def test_hybrid_divider_is_not_wrapped(self) -> None:
+        config = Config(
+            receipt_render_mode="hybrid",
+            receipt_template_path=self.template_path,
+            receipt_enable_cut=False,
+            receipt_feed_lines=0,
+        )
+        template = ReceiptTemplate(
+            margin=16,
+            header_enabled=True,
+            header_text="Header",
+            footer_enabled=True,
+            footer_text="Footer",
+        )
+        rendered = render_hybrid_escpos(
+            [ReceiptBlock(kind="text", text="Body")],
+            config,
+            template,
+            self.context,
+        )
+
+        decoded = rendered.decode("gb18030", errors="ignore")
+        divider_lines = [
+            line for line in decoded.splitlines() if line and set(line) == {"-"}
+        ]
+        self.assertEqual(len(divider_lines), 2)
+        self.assertTrue(
+            all(len(line) == EXPECTED_DIVIDER_CHARS for line in divider_lines)
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()

nonebot_plugin_receipts-0.2.0/tests/test_renderer.py

@@ -1,60 +0,0 @@
-from __future__ import annotations
-
-import unittest
-from pathlib import Path
-from typing import TYPE_CHECKING, cast
-from unittest.mock import AsyncMock, patch
-
-from nonebot_plugin_receipts.config import Config
-from nonebot_plugin_receipts.render_types import ReceiptBlock
-from nonebot_plugin_receipts.renderer import render_receipt
-from nonebot_plugin_receipts.template import ReceiptTemplateContext
-
-if TYPE_CHECKING:
-    from typing import Any
-
-
-class RendererIntegrationTestCase(unittest.IsolatedAsyncioTestCase):
-    def setUp(self) -> None:
-        self.template_path = str(
-            Path(__file__).resolve().parents[1] / "receipt_template.example.json"
-        )
-        self.context = ReceiptTemplateContext(sender_name="Tester", sender_id="10001")
-
-    async def test_render_receipt_returns_bytes_in_raster_mode(self) -> None:
-        config = Config(
-            receipt_render_mode="raster",
-            receipt_template_path=self.template_path,
-        )
-
-        with patch(
-            "nonebot_plugin_receipts.renderer.extract_blocks",
-            new=AsyncMock(
-                return_value=[ReceiptBlock(kind="text", text="# Title\nBody")]
-            ),
-        ):
-            rendered = await render_receipt(cast("Any", []), config, self.context)
-
-        self.assertIsInstance(rendered, bytes)
-        self.assertGreater(len(rendered), 0)
-
-    async def test_render_receipt_returns_bytes_in_hybrid_mode(self) -> None:
-        config = Config(
-            receipt_render_mode="hybrid",
-            receipt_template_path=self.template_path,
-        )
-
-        with patch(
-            "nonebot_plugin_receipts.renderer.extract_blocks",
-            new=AsyncMock(
-                return_value=[ReceiptBlock(kind="text", text="## Title\nBody")]
-            ),
-        ):
-            rendered = await render_receipt(cast("Any", []), config, self.context)
-
-        self.assertIsInstance(rendered, bytes)
-        self.assertGreater(len(rendered), 0)
-
-
-if __name__ == "__main__":
-    unittest.main()