pping-lang 0.1.0__py3-none-any.whl

pping_lang/__init__.py

@@ -0,0 +1,18 @@
+"""pping-lang — vLLM 性能诊断插件。
+
+主入口：PpingLangStatLogger（通过 vllm.stat_logger_plugins entry point 自动加载）。
+"""
+from pping_lang.plugin import PpingLangStatLogger
+from pping_lang.sink import LocalSink, Sink
+from pping_lang.types import Diagnosis, MetricPoint, Severity
+
+__version__ = "0.1.0a2"
+__all__ = [
+    "PpingLangStatLogger",
+    "MetricPoint",
+    "Diagnosis",
+    "Severity",
+    "Sink",
+    "LocalSink",
+    "__version__",
+]

pping_lang/api/__init__.py

@@ -0,0 +1,11 @@
+"""HTTP API server — Day 6 实现。
+
+子模块：
+- routes:  FastAPI app + 核心端点 (health, metrics, diagnoses, rules)
+- server:  ApiServer — uvicorn 在 daemon 线程跑
+- queries: DuckDB 查询辅助
+"""
+from pping_lang.api.routes import build_app
+from pping_lang.api.server import ApiServer
+
+__all__ = ["ApiServer", "build_app"]

pping_lang/api/queries.py

@@ -0,0 +1,17 @@
+"""DuckDB 连接辅助 —— 现仅供 bench_runs 用。
+
+历史：这里曾有一整套指标/诊断的 DuckDB 查询(latest_per_metric / bucketed_quantiles /
+recent_diagnoses / list_instances …)。随着「插件去 DuckDB、指标落 JSONL」,这些读路径
+已迁到 `sink.metric_log.JsonlStore`(长窗扫描)与 Sink 内存环(实时短窗)。只剩 bench 的
+`bench_runs`(可变行,UPDATE 语义)仍用 DuckDB,故保留 `open_conn`。
+"""
+from __future__ import annotations
+
+from typing import Any
+
+import duckdb
+
+
+def open_conn(db_path: str) -> Any:
+    """Open a DuckDB connection. Caller is responsible for close()."""
+    return duckdb.connect(db_path)