unicex 0.17.3__tar.gz → 0.17.4__tar.gz

{unicex-0.17.3/unicex.egg-info → unicex-0.17.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.17.3
+Version: 0.17.4
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License

{unicex-0.17.3 → unicex-0.17.4}/pyproject.toml

@@ -4,7 +4,7 @@ name = "unicex"
 # •	PATCH (x.y.Z) → увеличивается при багфиксе, который не ломает совместимость.
 # •	MINOR (x.Y.z) → увеличивается при добавлении новой функциональности, но без ломающих изменений (backward-compatible).
 # •	MAJOR (X.y.z) → увеличивается при изменениях, которые ломают обратную совместимость.
-version = "0.17.3"
+version = "0.17.4"
 
 description = "Unified Crypto Exchange API "
 readme = "README.md"

{unicex-0.17.3 → unicex-0.17.4}/unicex/extra.py

@@ -13,6 +13,7 @@ __all__ = [
 ]
 
 import time
+from collections import defaultdict
 from typing import Literal
 
 from .enums import Exchange, MarketType
@@ -93,6 +94,66 @@ class TimeoutTracker[T]:
         self._blocked_items[item] = time.time() + duration
 
 
+class SignalCounter[T]:
+    """Класс, который считает количество сигналов за отведенный интервал."""
+
+    def __init__(self, window_sec: int = 86400) -> None:
+        """Инициализация класса SignalCounter."""
+        self._window_sec = window_sec
+        self._signals: dict[T, list[float]] = defaultdict(list)
+
+    def is_within_limit(self, item: T, limit: int) -> bool:
+        """Проверяет, что количество сигналов НЕ превышает допустимый лимит.
+
+        Лимит считается превышенным, если количество сигналов
+        равно или больше limit.
+
+        Параметры:
+            item (T): Объект (сигнал), для которого проверяется количество срабатываний.
+            limit (int): Максимально допустимое количество сигналов.
+
+        Возвращает:
+            bool:
+                True  — если количество сигналов строго меньше limit
+                        (лимит не превышен).
+                False — если количество сигналов равно или больше limit
+                        (лимит считается превышенным).
+
+        """
+        return self.get(item) < limit
+
+    def get(self, item: T) -> int:
+        """Возвращает количество сигналов за интервал.
+
+        Параметры:
+            item (T): Сигнал.
+
+        Возвращает:
+            int: Количество сигналов за интервал.
+
+        """
+        timestamp = time.time()
+        threshold = timestamp - self._window_sec
+        self._signals[item] = [t for t in self._signals[item] if t > threshold]
+        return len(self._signals[item])
+
+    def add(self, item: T) -> int:
+        """Добавляет сигнал и возвращает количество сигналов за интервал.
+
+        Параметры:
+            item (T): Сигнал.
+
+        Возвращает:
+            int: Количество сигналов за интервал.
+
+        """
+        timestamp = time.time()
+        self._signals[item].append(timestamp)
+        threshold = timestamp - self._window_sec
+        self._signals[item] = [t for t in self._signals[item] if t > threshold]
+        return len(self._signals[item])
+
+
 def normalize_ticker(raw_ticker: str) -> str:
     """Нормализует тикер и возвращает базовую валюту (например, `BTC`).
 

{unicex-0.17.3 → unicex-0.17.4/unicex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unicex
-Version: 0.17.3
+Version: 0.17.4
 Summary: Unified Crypto Exchange API 
 Author-email: LoveBloodAndDiamonds <ayazshakirzyanov27@gmail.com>
 License: BSD 3-Clause License