Kris
1022121bee
添加了channels限界上下文的大量单元测试文件，包括： 1. 各层级通用与专用的conftest夹具 2. 核心领域模型、事件、服务测试 3. 应用层流水线、扩展处理器测试 4. 适配器与插件层测试 5. 修复并补充了pool manager测试用例
92 lines
3.2 KiB
Python
92 lines
3.2 KiB
Python
"""channels 限界上下文单元测试跨层通用 fixture。
|
||
|
||
本文件提供横跨 core / application / adapters / plugins 各层复用的被驱动
|
||
端口桩（LoggerPort / ConfigPort / CachePort / EventPublisherPort /
|
||
TracerPort）。桩使用 ``unittest.mock`` 的 ``MagicMock`` / ``AsyncMock``，
|
||
不实现真实逻辑；端口方法签名以 ``yuxi.channels.contract.ports.driven``
|
||
下的 Protocol 为准。
|
||
|
||
注意：LoggerPort / TracerPort 的方法在端口协议中均为 ``async def``，因此
|
||
此处使用 ``MagicMock(spec=...)`` —— MagicMock 会自动为 async 方法生成
|
||
AsyncMock（可 ``await``），与端口协议保持一致。单文件独有的 helper 应保
|
||
留在对应测试文件内（见 testing-guidelines.md）。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from unittest.mock import AsyncMock, MagicMock
|
||
|
||
import pytest
|
||
|
||
from yuxi.channels.contract.ports.driven.cache_port import CachePort
|
||
from yuxi.channels.contract.ports.driven.config_port import ConfigPort
|
||
from yuxi.channels.contract.ports.driven.event_publisher_port import (
|
||
EventPublisherPort,
|
||
)
|
||
from yuxi.channels.contract.ports.driven.logger_port import LoggerPort
|
||
from yuxi.channels.contract.ports.driven.tracer_port import TracerPort
|
||
|
||
|
||
@pytest.fixture
|
||
def fake_logger() -> LoggerPort:
|
||
"""LoggerPort 桩。
|
||
|
||
``MagicMock(spec=LoggerPort)`` 自动为 ``log`` / ``debug`` / ``info`` /
|
||
``warn`` / ``error`` / ``exception`` 生成 AsyncMock（可 ``await``），
|
||
默认返回 None。需要断言调用参数时直接使用对应方法的 ``assert_*``。
|
||
"""
|
||
return MagicMock(spec=LoggerPort)
|
||
|
||
|
||
@pytest.fixture
|
||
def fake_config() -> ConfigPort:
|
||
"""ConfigPort 桩，``get`` 默认返回 None，``update`` 默认返回 None。"""
|
||
mock = AsyncMock(spec=ConfigPort)
|
||
mock.get.return_value = None
|
||
mock.update.return_value = None
|
||
return mock
|
||
|
||
|
||
@pytest.fixture
|
||
def fake_cache() -> CachePort:
|
||
"""CachePort 桩，预设常用方法返回值。
|
||
|
||
``get`` 返回 None，``set`` / ``delete`` / ``expire`` /
|
||
``acquireAdvisoryLock`` / ``releaseAdvisoryLock`` / ``ping`` 返回 True，
|
||
``incr`` 返回 1。
|
||
"""
|
||
mock = AsyncMock(spec=CachePort)
|
||
mock.get.return_value = None
|
||
mock.set.return_value = True
|
||
mock.delete.return_value = True
|
||
mock.incr.return_value = 1
|
||
mock.expire.return_value = True
|
||
mock.acquireAdvisoryLock.return_value = True
|
||
mock.releaseAdvisoryLock.return_value = True
|
||
mock.ping.return_value = True
|
||
return mock
|
||
|
||
|
||
@pytest.fixture
|
||
def fake_event_publisher() -> EventPublisherPort:
|
||
"""EventPublisherPort 桩，``publish`` 默认返回 None。"""
|
||
mock = AsyncMock(spec=EventPublisherPort)
|
||
mock.publish.return_value = None
|
||
return mock
|
||
|
||
|
||
@pytest.fixture
|
||
def fake_tracer() -> TracerPort:
|
||
"""TracerPort 桩。
|
||
|
||
``MagicMock(spec=TracerPort)`` 自动为 ``startSpan`` / ``endSpan`` /
|
||
``getCurrentTrace`` 生成 AsyncMock（可 ``await``）。``startSpan`` 默认
|
||
返回 Span-like MagicMock，``endSpan`` 返回 None，``getCurrentTrace``
|
||
返回 Option-like MagicMock，调用方可按需覆盖。
|
||
"""
|
||
mock = MagicMock(spec=TracerPort)
|
||
mock.startSpan.return_value = MagicMock()
|
||
mock.endSpan.return_value = None
|
||
mock.getCurrentTrace.return_value = MagicMock()
|
||
return mock
|