echotools 2.4.7__tar.gz → 2.4.8__tar.gz

{echotools-2.4.7 → echotools-2.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echotools
-Version: 2.4.7
+Version: 2.4.8
 Summary: 通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链
 Home-page: https://github.com/nichengfuben/echotools
 Author: nichengfuben
@@ -58,7 +58,7 @@ Requires-Dist: ruff>=0.4.0; extra == "dev"
 
 通用基础设施 SDK：配置、日志、事件、调度、插件、调用链，以及 **entml** LLM 工具调用协议与终端 Console UI。
 
-完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.7**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
+完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.8**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
 
 ## 安装
 

{echotools-2.4.7 → echotools-2.4.8}/README.md

@@ -2,7 +2,7 @@
 
 通用基础设施 SDK：配置、日志、事件、调度、插件、调用链，以及 **entml** LLM 工具调用协议与终端 Console UI。
 
-完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.7**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
+完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.8**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
 
 ## 安装
 

{echotools-2.4.7 → echotools-2.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "echotools"
-version = "2.4.7"
+version = "2.4.8"
 description = "通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -142,6 +142,23 @@ omit = [
     "*/web/application.py",
     "*/web/middleware.py",
     "*/web/utils.py",
+    "*/plat/capture/shared/win_com.py",
+    "*/plat/capture/audio_monitor/api.py",
+    "*/plat/capture/audio_record/api.py",
+    "*/plat/capture/screenshot/api.py",
+    "*/plat/capture/audio_monitor/win.py",
+    "*/plat/capture/audio_monitor/mac.py",
+    "*/plat/capture/audio_monitor/linux.py",
+    "*/plat/capture/audio_record/win.py",
+    "*/plat/capture/audio_record/win_wasapi.py",
+    "*/plat/capture/audio_record/win_winmm.py",
+    "*/plat/capture/audio_record/mac.py",
+    "*/plat/capture/audio_record/linux.py",
+    "*/plat/capture/screenshot/win.py",
+    "*/plat/capture/screenshot/win_dxgi.py",
+    "*/plat/capture/screenshot/win_gdi.py",
+    "*/plat/capture/screenshot/mac.py",
+    "*/plat/capture/screenshot/linux.py",
 ]
 
 [tool.coverage.report]

{echotools-2.4.7 → echotools-2.4.8}/src/echotools/plat/capture/shared/__init__.py

@@ -10,29 +10,28 @@ from echotools.plat.capture.shared.platform import (
     load_lib,
 )
 from echotools.plat.capture.shared.wav import write_wav
-from echotools.plat.capture.shared.win_com import (
-    GUID,
-    com_call,
-    com_qi,
-    com_release,
-    make_guid,
-)
+
+if IS_WINDOWS:
+    from echotools.plat.capture.shared.win_com import (
+        GUID,
+        com_call,
+        com_qi,
+        com_release,
+        make_guid,
+    )
 
 __all__ = [
-    "GUID",
     "IS_LINUX",
     "IS_MACOS",
     "IS_WINDOWS",
     "_OS",
     "clamp",
-    "com_call",
-    "com_qi",
-    "com_release",
     "load_lib",
-    "make_guid",
     "mix_streams",
     "resample_pcm",
     "rgba_to_bgra",
     "write_bmp",
     "write_wav",
 ]
+if IS_WINDOWS:
+    __all__ += ["GUID", "com_call", "com_qi", "com_release", "make_guid"]

{echotools-2.4.7 → echotools-2.4.8}/src/echotools/plat/capture/shared/win_com.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 """Windows COM vtable helpers shared by capture backends."""
 
 from ctypes import (
+    CFUNCTYPE,
     POINTER,
-    WINFUNCTYPE,
     Structure,
     byref,
     c_int,
@@ -16,6 +16,11 @@ from ctypes import (
     sizeof,
 )
 
+try:
+    from ctypes import WINFUNCTYPE
+except ImportError:  # non-Windows: coverage import only
+    WINFUNCTYPE = CFUNCTYPE  # type: ignore[misc,assignment]
+
 HRESULT = c_int
 PTR_SIZE = sizeof(c_void_p)
 

{echotools-2.4.7 → echotools-2.4.8}/src/echotools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: echotools
-Version: 2.4.7
+Version: 2.4.8
 Summary: 通用基础设施 SDK：配置、日志、事件、调度、插件、协议、调用链
 Home-page: https://github.com/nichengfuben/echotools
 Author: nichengfuben
@@ -58,7 +58,7 @@ Requires-Dist: ruff>=0.4.0; extra == "dev"
 
 通用基础设施 SDK：配置、日志、事件、调度、插件、调用链，以及 **entml** LLM 工具调用协议与终端 Console UI。
 
-完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.7**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
+完全项目无关，兼容 Python 3.8–3.14。当前版本：**2.4.8**（详见 [CHANGELOG](docs/CHANGELOG.md)）。
 
 ## 安装
 

{echotools-2.4.7 → echotools-2.4.8}/src/tests/test_plat_capture.py

@@ -12,8 +12,15 @@ from echotools.plat.capture import (
     ScreenshotConfig,
     get_playing_processes,
 )
-from echotools.plat.capture.shared.bmp import write_bmp
-from echotools.plat.capture.shared.pcm import mix_streams
+from echotools.plat.capture.shared.bmp import rgba_to_bgra, write_bmp
+from echotools.plat.capture.shared.pcm import clamp, mix_streams, resample_pcm
+from echotools.plat.capture.shared.platform import (
+    _OS,
+    IS_LINUX,
+    IS_MACOS,
+    IS_WINDOWS,
+    load_lib,
+)
 from echotools.plat.capture.shared.wav import write_wav
 
 
@@ -33,11 +40,96 @@ def test_audio_process_unknown_volume() -> None:
     assert "vol=" not in repr(ap)
 
 
+def test_audio_process_eq_not_implemented() -> None:
+    assert AudioProcess(1, "x").__eq__(None) is NotImplemented
+    assert AudioProcess(0, "anon") == AudioProcess(0, "anon")
+    assert "anon" in repr(AudioProcess(0, "anon"))
+
+
+def test_mix_streams_empty() -> None:
+    assert mix_streams([], 16) == b""
+
+
 def test_mix_streams_single() -> None:
     data = b"\x00\x01\x00\x02"
     assert mix_streams([data], 16) == data
 
 
+def test_mix_streams_pads_shorter_stream() -> None:
+    s1 = struct.pack("<hh", 1000, 2000)
+    s2 = struct.pack("<h", 3000)
+    mixed = mix_streams([s1, s2], 16, mix_normalize=False)
+    assert len(mixed) == len(s1)
+
+
+def test_mix_streams_32bit() -> None:
+    s1 = struct.pack("<ii", 1000, 2000)
+    s2 = struct.pack("<ii", 3000, 4000)
+    mixed = mix_streams([s1, s2], 32, mix_normalize=False)
+    v1, v2 = struct.unpack("<ii", mixed)
+    assert v1 == 2000
+    assert v2 == 3000
+
+
+def test_clamp() -> None:
+    assert clamp(5, 0, 10) == 5
+    assert clamp(-1, 0, 10) == 0
+    assert clamp(100, 0, 10) == 10
+
+
+def test_resample_pcm_identity() -> None:
+    pcm = struct.pack("<hh", 100, 200)
+    assert resample_pcm(pcm, 44100, 2, 16, 44100, 2, 16) == pcm
+
+
+def test_resample_pcm_mono_to_stereo() -> None:
+    pcm = struct.pack("<h", 1000)
+    out = resample_pcm(pcm, 44100, 1, 16, 44100, 2, 16)
+    v1, v2 = struct.unpack("<hh", out)
+    assert v1 == v2 == 1000
+
+
+def test_resample_pcm_downsample() -> None:
+    pcm = struct.pack("<hh", 100, 200) * 20
+    out = resample_pcm(pcm, 44100, 2, 16, 22050, 2, 16)
+    assert len(out) < len(pcm)
+
+
+def test_resample_pcm_multi_channel() -> None:
+    pcm = struct.pack("<hhhh", 1, 2, 3, 4)
+    out = resample_pcm(pcm, 44100, 4, 16, 44100, 3, 16)
+    assert len(out) == 6
+    assert struct.unpack("<hhh", out) == (1, 2, 3)
+
+
+def test_load_lib_missing() -> None:
+    assert load_lib("echotools_nonexistent_lib_xyz") is None
+
+
+def test_platform_flags() -> None:
+    import platform
+
+    assert _OS == platform.system()
+    assert sum((IS_WINDOWS, IS_MACOS, IS_LINUX)) <= 1
+
+
+def test_rgba_to_bgra() -> None:
+    data = bytes([255, 0, 0, 255])
+    out = rgba_to_bgra(data)
+    assert out[0] == 0
+    assert out[2] == 255
+
+
+def test_write_bmp_bottom_up() -> None:
+    pixels = b"\x00" * (4 * 2 * 2)
+    with tempfile.TemporaryDirectory() as tmp:
+        path = str(Path(tmp) / "bottom.bmp")
+        write_bmp(path, 2, 2, pixels, top_down=False)
+        raw = Path(path).read_bytes()
+    (height,) = struct.unpack_from("<i", raw, 22)
+    assert height == 2
+
+
 def test_mix_streams_average() -> None:
     s1 = struct.pack("<hh", 1000, 2000)
     s2 = struct.pack("<hh", 3000, 4000)
@@ -98,6 +190,7 @@ def test_audio_record_config_defaults() -> None:
     assert cfg.buffer_ms == 50
     assert cfg.frame_bytes == 4
     assert cfg.buffer_frames == int(44100 * 50 / 1000)
+    assert cfg.total_frames == int(44100 * cfg.record_seconds)
 
 
 def test_screenshot_config_defaults() -> None: