onesecondtrader 0.12.1__py3-none-any.whl → 0.13.0__py3-none-any.whl

onesecondtrader/core/models.py

@@ -63,8 +63,7 @@ class TimeInForce(enum.Enum):
     | `FOK` | `enum.auto()` | Fill entire order immediately or cancel (Fill-or-Kill) |
     | `GTC` | `enum.auto()` | Active until explicitly cancelled (Good-Till-Cancelled) |
     | `GTD` | `enum.auto()` | Active until specified date (Good-Till-Date) |
-    | `IOC` | `enum.auto()` | Execute available quantity immediately, cancel rest
-        (Immediate-or-Cancel) |
+    | `IOC` | `enum.auto()` | Execute available quantity immediately, cancel rest (Immediate-or-Cancel) |
     """
 
     DAY = enum.auto()
@@ -102,10 +101,8 @@ class OrderLifecycleState(enum.Enum):
 
     | Enum | Value | Description |
     |------|-------|-------------|
-    | `PENDING` | `enum.auto()` | Order has been submitted, but not yet acknowledged by
-        the broker |
-    | `OPEN` | `enum.auto()` | Order has been acknowledged by the broker, but not yet
-        filled or cancelled |
+    | `PENDING` | `enum.auto()` | Order has been submitted, but not yet acknowledged by the broker |
+    | `OPEN` | `enum.auto()` | Order has been acknowledged by the broker, but not yet filled or cancelled |
     | `FILLED` | `enum.auto()` | Order has been filled |
     | `CANCELLED` | `enum.auto()` | Order has been cancelled |
     """
@@ -165,3 +162,27 @@ class RecordType(enum.Enum):
                 return "daily bars"
             case _:
                 return f"unknown ({rtype})"
+
+
+class XMAMode(enum.Enum):
+    """
+    Enum for moving average modes.
+
+    **Attributes:**
+
+    | Enum | Value | Description |
+    |------|-------|-------------|
+    | `OPEN` | `enum.auto()` | Open price |
+    | `HIGH` | `enum.auto()` | High price |
+    | `LOW` | `enum.auto()` | Low price |
+    | `CLOSE` | `enum.auto()` | Close price |
+    | `TYPICAL_PRICE` | `enum.auto()` | Typical price ((H+ L + C) / 3) |
+    | `WEIGHTED_CLOSE` | `enum.auto()` | Weighted close price ((H + L + 2*C) / 4) |
+    """
+
+    OPEN = enum.auto()
+    HIGH = enum.auto()
+    LOW = enum.auto()
+    CLOSE = enum.auto()
+    TYPICAL_PRICE = enum.auto()
+    WEIGHTED_CLOSE = enum.auto()

onesecondtrader/indicators/moving_averages.py

@@ -0,0 +1,132 @@
+"""
+This module provides various moving average indicators.
+"""
+
+import numpy as np
+import collections
+from onesecondtrader.indicators import base_indicator
+from onesecondtrader.core import models
+from onesecondtrader.monitoring import console
+
+
+class SimpleMovingAverage(base_indicator.BaseIndicator):
+    """
+    Simple Moving Average (SMA) indicator for different OHLC-data related time series,
+     the possible modes for the SMA calculation are indicated in the
+     `core.models.XMAMode` enum (currently: `open`, `high`, `low`, `close`,
+     `typical_price`, `weighted close`).
+
+    Examples:
+        >>> from onesecondtrader.indicators import moving_averages
+        >>> from onesecondtrader.core import models
+        >>> sma = moving_averages.SimpleMovingAverage(
+        ...     period=3, mode=models.XMAMode.CLOSE
+        ... )
+        >>> bar1 = models.Bar(
+        ...     open=100.0, high=101.0, low=99.0, close=100.0, volume=1000
+        ... )
+        >>> sma.update(bar1)
+        >>> import numpy as np
+        >>> np.isnan(sma.latest)
+        True
+        >>> bar2 = models.Bar(
+        ...     open=100.0, high=102.0, low=100.0, close=101.0, volume=1500
+        ... )
+        >>> sma.update(bar2)
+        >>> np.isnan(sma.latest)
+        True
+        >>> bar3 = models.Bar(
+        ...     open=101.0, high=103.0, low=101.0, close=102.0, volume=2000
+        ... )
+        >>> sma.update(bar3)
+        >>> np.isnan(sma.latest)
+        False
+        >>> sma.latest
+        101.0
+    """
+
+    def __init__(
+        self,
+        period: int,
+        mode: models.XMAMode = models.XMAMode.CLOSE,
+        max_history: int = 100,
+    ) -> None:
+        """
+        Initialize the indicator with a period and a mode.
+
+        Args:
+            period (int): Period of the moving average. Will be set to 1 if < 1.
+            mode (models.XMAMode): Mode of the moving average. Defaults to `CLOSE`.
+            max_history (int): Maximum lookback history length. Defaults to 100.
+
+        Attributes:
+            self.period (int): Period of the moving average.
+            self.mode (models.XMAMode): Mode of the moving average.
+        """
+        if period < 1:
+            console.logger.warning(
+                f"Period must be >= 1, got {period}; defaulting to 1"
+            )
+            period = 1
+
+        super().__init__(max_history=max_history)
+        self.period: int = period
+        self.mode: models.XMAMode = mode
+        self._window: collections.deque[float] = collections.deque(maxlen=self.period)
+
+    @property
+    def name(self) -> str:
+        return f"SMA_{self.period}_{self.mode.name}"
+
+    def _compute_indicator(self, incoming_bar: models.Bar) -> float:
+        """
+        Compute the specified simple moving average based on the incoming bar.
+
+        Args:
+            incoming_bar (models.Bar): Incoming bar with OHLCV data.
+
+        Returns:
+            float: Simple moving average value, or np.nan if insufficient data or
+            errors occur.
+        """
+        try:
+            mode = self.mode
+            if mode is models.XMAMode.OPEN:
+                current_value = incoming_bar.open
+            elif mode is models.XMAMode.HIGH:
+                current_value = incoming_bar.high
+            elif mode is models.XMAMode.LOW:
+                current_value = incoming_bar.low
+            elif mode is models.XMAMode.CLOSE:
+                current_value = incoming_bar.close
+            elif mode is models.XMAMode.TYPICAL_PRICE:
+                current_value = (
+                    incoming_bar.high + incoming_bar.low + incoming_bar.close
+                ) / 3.0
+            elif mode is models.XMAMode.WEIGHTED_CLOSE:
+                current_value = (
+                    incoming_bar.high + incoming_bar.low + 2.0 * incoming_bar.close
+                ) / 4.0
+            else:
+                console.logger.warning(
+                    f"Unsupported XMAMode: {mode}; using close price"
+                )
+                current_value = incoming_bar.close
+
+            if not np.isfinite(current_value):
+                console.logger.warning(
+                    f"Invalid value extracted: {current_value} (mode={mode.name}); "
+                    f"using np.nan"
+                )
+                return np.nan
+
+            with self._lock:
+                self._window.append(current_value)
+                if len(self._window) < self.period:
+                    return np.nan
+                sma_value = sum(self._window) / self.period
+            return sma_value
+
+        except Exception as e:
+            console.logger.warning(f"SMA calculation failed: {e}; returning np.nan")
+            return np.nan

{onesecondtrader-0.12.1.dist-info → onesecondtrader-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: onesecondtrader
-Version: 0.12.1
+Version: 0.13.0
 Summary: The Trading Infrastructure Toolkit for Python. Research, simulate, and deploy algorithmic trading strategies — all in one place.
 License-File: LICENSE
 Author: Nils P. Kujath

{onesecondtrader-0.12.1.dist-info → onesecondtrader-0.13.0.dist-info}/RECORD

@@ -1,12 +1,13 @@
 onesecondtrader/__init__.py,sha256=TNqlT20sH46-J7F6giBxwWYG1-wFZZt7toDbZeQK6KQ,210
 onesecondtrader/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-onesecondtrader/core/models.py,sha256=I2NgWfZcvlyBPGUSsocrFrhP3KnLFJ-CFt8Cg4GOd0g,4185
+onesecondtrader/core/models.py,sha256=253_5DtMS4mQA1IAVrEbw-rpCcyyKtB3HaORFyF2jdU,4823
 onesecondtrader/core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 onesecondtrader/datafeeds/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 onesecondtrader/datafeeds/base_datafeed.py,sha256=QGXtkVUVN7PsDYeIH8h7Hi_kiDDFcqRyW8K8LzZkRTk,1394
 onesecondtrader/datafeeds/csv_datafeed.py,sha256=WMoZpoian_93CdAzo36hJoF15T0ywRADfuFQcfsPQNc,10957
 onesecondtrader/indicators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 onesecondtrader/indicators/base_indicator.py,sha256=eGv5_WYOSsuLXX8MbnyE3_Y8owH-2bpUT_GczOXDHVE,4359
+onesecondtrader/indicators/moving_averages.py,sha256=h6lKaIgpILF0zrvU17Ml4xo_WnhzoK2StFCw46YWKWU,4674
 onesecondtrader/messaging/__init__.py,sha256=9GBHlh6pXweknEacXVBvzpdoTJgVyb3ROLqe1Fhz2ww,179
 onesecondtrader/messaging/eventbus.py,sha256=R2K85INeYVwJ1tMOybC3WpRraK0ZKVe8WehCbAzzznU,19359
 onesecondtrader/messaging/events.py,sha256=eaWXQQIUnRNOR-9n5-6lyLbZ6bUtzjD4GI567U_vh4g,23625
@@ -14,7 +15,7 @@ onesecondtrader/monitoring/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJ
 onesecondtrader/monitoring/console.py,sha256=1mrojXkyL4ro7ebkvDMGNQiCL-93WEylRuwnfmEKzVs,299
 onesecondtrader/monitoring/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 onesecondtrader/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-onesecondtrader-0.12.1.dist-info/METADATA,sha256=saYuNOGorryGgxVFS3BArfldAK4uUtKWarPNjmKsa8Q,9638
-onesecondtrader-0.12.1.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
-onesecondtrader-0.12.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-onesecondtrader-0.12.1.dist-info/RECORD,,
+onesecondtrader-0.13.0.dist-info/METADATA,sha256=4dSKCGtQCOiEiG4y06SVtaYNY9epLoNPfv1QWtj9T2g,9638
+onesecondtrader-0.13.0.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
+onesecondtrader-0.13.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+onesecondtrader-0.13.0.dist-info/RECORD,,