Files
tick-stock-panel/backend/app/services/heavy_job_limiter.py
T
shy3130 697c27bb02 feat(v0.2): 市场阶段与主线识别 + 因子挖掘全链路 + 数据层完善
- 市场环境: 新增情绪周期6阶段(冰点/启动/主升/高潮/退潮/修复, 连板梯队驱动,
  EMA平滑+2日确认+弱档否决, 平均段长9.7天)与概念/行业主线排名(涨停梯队聚合,
  可配置宽基/风格标签过滤); 市场环境页重构, regime 透明加列, 与5档state并存
- 挖掘: 因子与策略挖掘全链路(API/worker/进程锁/候选库/前端工作台/文档),
  周度调度默认关闭且永不自动发布
- 回测: 财务快照因子(点时口径), 批量回测预计算共享下期收益,
  信号路径矩阵列依赖展开修复(consecutive_limit_ups 缺列报错)
- 数据/性能: enriched 生成与预热治理, 重任务限流, 行情/K线缓存复用, 时区修复
- 测试: 后端全量 914 通过; GUI 黑盒验证截图存证 gui-test-screenshots/
2026-08-16 23:39:07 +08:00

122 lines
4.3 KiB
Python

"""Weighted process-local limiter for memory-heavy jobs."""
from __future__ import annotations
import threading
import time
from collections.abc import Iterator
from contextlib import contextmanager
from typing import ClassVar, Literal
HeavyJobKind = Literal["normal", "mining"]
class HeavyJobLimitTimeoutError(TimeoutError):
"""Raised when a heavy-job slot cannot be acquired before its deadline."""
class HeavyJobCancelledError(RuntimeError):
"""Raised when slot acquisition is cancelled while waiting."""
class HeavyJobLimiter:
"""A weighted limiter where normal jobs cost one slot and mining costs two."""
_WEIGHTS: ClassVar[dict[HeavyJobKind, int]] = {"normal": 1, "mining": 2}
def __init__(self, capacity: int = 2, *, cancel_poll_interval: float = 0.05) -> None:
if capacity <= 0:
raise ValueError("capacity must be positive")
if cancel_poll_interval <= 0:
raise ValueError("cancel_poll_interval must be positive")
self.capacity = capacity
self._cancel_poll_interval = cancel_poll_interval
self._used = 0
self._acquired = {"normal": 0, "mining": 0}
self._condition = threading.Condition()
@property
def in_use(self) -> int:
with self._condition:
return self._used
@property
def available(self) -> int:
with self._condition:
return self.capacity - self._used
def acquire(
self,
kind: HeavyJobKind = "normal",
*,
timeout: float | None = None,
cancel_event: threading.Event | None = None,
) -> bool:
"""Wait for capacity and return ``False`` on cancellation or timeout."""
weight = self._weight(kind)
if weight > self.capacity:
raise ValueError(f"{kind} requires {weight} slots, capacity is {self.capacity}")
if timeout is not None and timeout < 0:
raise ValueError("timeout must be non-negative")
deadline = None if timeout is None else time.monotonic() + timeout
with self._condition:
while True:
if cancel_event is not None and cancel_event.is_set():
return False
if self._used + weight <= self.capacity:
self._used += weight
self._acquired[kind] += 1
return True
remaining = None if deadline is None else deadline - time.monotonic()
if remaining is not None and remaining <= 0:
return False
wait_for = remaining
if cancel_event is not None:
wait_for = self._cancel_poll_interval
if remaining is not None:
wait_for = min(wait_for, remaining)
self._condition.wait(wait_for)
def release(self, kind: HeavyJobKind = "normal") -> None:
"""Return capacity previously acquired for ``kind``."""
weight = self._weight(kind)
with self._condition:
if self._acquired[kind] == 0:
raise RuntimeError(f"cannot release unacquired {kind} capacity")
self._acquired[kind] -= 1
self._used -= weight
self._condition.notify_all()
@contextmanager
def slot(
self,
kind: HeavyJobKind = "normal",
*,
timeout: float | None = None,
cancel_event: threading.Event | None = None,
) -> Iterator[HeavyJobLimiter]:
"""Acquire weighted capacity for the duration of a ``with`` block."""
acquired = self.acquire(kind, timeout=timeout, cancel_event=cancel_event)
if not acquired:
if cancel_event is not None and cancel_event.is_set():
raise HeavyJobCancelledError(f"{kind} job was cancelled while waiting")
raise HeavyJobLimitTimeoutError(f"timed out waiting for {kind} job capacity")
try:
yield self
finally:
self.release(kind)
@classmethod
def _weight(cls, kind: HeavyJobKind) -> int:
try:
return cls._WEIGHTS[kind]
except KeyError as exc:
raise ValueError(f"unsupported heavy job kind: {kind!r}") from exc
shared_heavy_job_limiter = HeavyJobLimiter(capacity=2)
# Short alias for entry points that prefer the existing module-singleton naming style.
heavy_job_limiter = shared_heavy_job_limiter