investing-algorithm-framework 8.4.0__tar.gz → 8.6.0__tar.gz

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: investing-algorithm-framework
-Version: 8.4.0
+Version: 8.6.0
 Summary: A framework for creating trading bots
 Author: MDUYN
 Requires-Python: >=3.10,<4.0
@@ -49,23 +49,13 @@ Description-Content-Type: text/markdown
 
 <h4 align="center">
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=linux%20(main)&style=flat-square&logo=linux&logoColor=white" alt="linux main" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=linux&style=flat-square&logo=linux&logoColor=white" alt="linux main" style="height: 20px;">
   </a>
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=macos%20(main)&style=flat-square&logo=apple&logoColor=white" alt="macos main" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=macos&style=flat-square&logo=apple&logoColor=white" alt="macos main" style="height: 20px;">
   </a>
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=windows%20(main)&style=flat-square&logo=windows&logoColor=white" alt="windows main" style="height: 20px;">
-  </a>
-  <br>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=linux%20(dev)&style=flat-square&logo=linux&logoColor=white" alt="linux dev" style="height: 20px;">
-  </a>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=macos%20(dev)&style=flat-square&logo=apple&logoColor=white" alt="macos dev" style="height: 20px;">
-  </a>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=windows%20(dev)&style=flat-square&logo=windows&logoColor=white" alt="windows dev" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=windows&style=flat-square&logo=windows&logoColor=white" alt="windows main" style="height: 20px;">
   </a>
   <a href="https://pypi.org/project/investing-algorithm-framework/">
     <img src="https://img.shields.io/pypi/v/investing-algorithm-framework.svg?style=flat-square" alt="pypi" style="height: 20px;">

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/README.md

@@ -8,23 +8,13 @@
 
 <h4 align="center">
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=linux%20(main)&style=flat-square&logo=linux&logoColor=white" alt="linux main" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=linux&style=flat-square&logo=linux&logoColor=white" alt="linux main" style="height: 20px;">
   </a>
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=macos%20(main)&style=flat-square&logo=apple&logoColor=white" alt="macos main" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=macos&style=flat-square&logo=apple&logoColor=white" alt="macos main" style="height: 20px;">
   </a>
   <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Amain">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=windows%20(main)&style=flat-square&logo=windows&logoColor=white" alt="windows main" style="height: 20px;">
-  </a>
-  <br>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=linux%20(dev)&style=flat-square&logo=linux&logoColor=white" alt="linux dev" style="height: 20px;">
-  </a>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=macos%20(dev)&style=flat-square&logo=apple&logoColor=white" alt="macos dev" style="height: 20px;">
-  </a>
-  <a href="https://github.com/coding-kitties/investing-algorithm-framework/actions/workflows/test.yml?query=branch%3Adev">
-    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=dev&label=windows%20(dev)&style=flat-square&logo=windows&logoColor=white" alt="windows dev" style="height: 20px;">
+    <img src="https://img.shields.io/github/actions/workflow/status/coding-kitties/investing-algorithm-framework/test.yml?branch=main&label=windows&style=flat-square&logo=windows&logoColor=white" alt="windows main" style="height: 20px;">
   </a>
   <a href="https://pypi.org/project/investing-algorithm-framework/">
     <img src="https://img.shields.io/pypi/v/investing-algorithm-framework.svg?style=flat-square" alt="pypi" style="height: 20px;">

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/investing_algorithm_framework/__init__.py

@@ -67,7 +67,9 @@ from .services import get_annual_volatility, get_sortino_ratio, \
     get_current_average_trade_loss, get_negative_trades, \
     get_positive_trades, get_number_of_trades, get_current_win_rate, \
     get_current_win_loss_ratio, create_backtest_metrics_for_backtest, \
-    recalculate_backtests, TradeTakeProfitService, TradeStopLossService
+    recalculate_backtests, TradeTakeProfitService, TradeStopLossService, \
+    get_cv_consistency, get_normalized_stability, \
+    get_consistency_score, get_stability_score
 
 
 __all__ = [
@@ -254,4 +256,17 @@ __all__ = [
     "VolumeBasedFill",
     "FXRateProvider",
     "StaticFXRateProvider",
+    "load_ipython_extension",
+    "get_cv_consistency",
+    "get_normalized_stability",
+    "get_consistency_score",
+    "get_stability_score",
 ]
+
+
+def load_ipython_extension(ipython):
+    """Allow ``%load_ext investing_algorithm_framework`` to register
+    the ``%backtest`` / ``%%backtest`` magic commands."""
+    from investing_algorithm_framework.notebook import load_ipython_extension \
+        as _load
+    _load(ipython)

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/investing_algorithm_framework/app/app.py

@@ -279,10 +279,11 @@ class App:
 
         if SQLALCHEMY_DATABASE_URI not in config \
                 or config[SQLALCHEMY_DATABASE_URI] is None:
-            path = "sqlite:///" + os.path.join(
+            db_path = os.path.join(
                 configuration_service.config[DATABASE_DIRECTORY_PATH],
                 configuration_service.config[DATABASE_NAME]
             )
+            path = "sqlite:///" + db_path.replace("\\", "/")
             configuration_service.add_value(SQLALCHEMY_DATABASE_URI, path)
 
     def initialize_backtest_config(
@@ -394,7 +395,7 @@ class App:
                 os.remove(database_path)
 
         # Create the sqlalchemy database uri
-        path = f"sqlite:///{database_path}"
+        path = "sqlite:///" + database_path.replace("\\", "/")
         self.set_config(SQLALCHEMY_DATABASE_URI, path)
 
         # Setup sql if needed

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/investing_algorithm_framework/app/reporting/backtest_report.py

@@ -1,9 +1,11 @@
 import os
 import csv
 import base64
+import tempfile
 import webbrowser
 import logging
 from dataclasses import dataclass, field
+from pathlib import Path
 from typing import List, Union
 from datetime import datetime, timedelta
 
@@ -185,12 +187,14 @@ class BacktestReport:
         if not self.html_report:
             self.html_report = self._build_html()
 
-        path = "/tmp/backtest_report.html"
+        path = os.path.join(tempfile.gettempdir(), "backtest_report.html")
         with open(path, "w", encoding="utf-8") as f:
             f.write(self.html_report)
 
+        file_uri = Path(path).as_uri()
+
         if browser:
-            webbrowser.open(f"file://{path}")
+            webbrowser.open(file_uri)
             return
 
         try:
@@ -203,7 +207,7 @@ class BacktestReport:
         except (NameError, ImportError):
             pass
 
-        webbrowser.open(f"file://{path}")
+        webbrowser.open(file_uri)
 
     def save(self, path):
         if not self.html_report:

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/investing_algorithm_framework/app/reporting/backtest_report_old.py

@@ -1,5 +1,6 @@
 import logging
 import os
+import tempfile
 from pathlib import Path
 import webbrowser
 from dataclasses import dataclass
@@ -117,12 +118,14 @@ class BacktestReport:
             self._create_html_report(backtest_date_range)
 
         # Save the html report to a tmp location
-        path = "/tmp/backtest_report.html"
+        path = os.path.join(tempfile.gettempdir(), "backtest_report.html")
         with open(path, "w") as html_file:
             html_file.write(self.html_report)
 
+        file_uri = Path(path).as_uri()
+
         if browser:
-            webbrowser.open(f"file://{path}")
+            webbrowser.open(file_uri)
 
         def in_jupyter_notebook():
             try:
@@ -134,7 +137,7 @@ class BacktestReport:
         if in_jupyter_notebook():
             display(HTML(self.html_report))
         else:
-            webbrowser.open(f"file://{path}")
+            webbrowser.open(file_uri)
 
     def _create_html_report(self, backtest_date_range: BacktestDateRange):
         """

{investing_algorithm_framework-8.4.0 → investing_algorithm_framework-8.6.0}/investing_algorithm_framework/domain/backtesting/combine_backtests.py

@@ -2,6 +2,10 @@ import logging
 import math
 from typing import List
 
+from .consistency import (
+    get_cv_consistency, get_normalized_stability,
+    get_consistency_score, get_stability_score,
+)
 from .backtest_metrics import BacktestMetrics
 from .backtest_summary_metrics import BacktestSummaryMetrics
 
@@ -441,45 +445,14 @@ def generate_backtest_summary_metrics(
     ) if consecutive_losses else None
 
     # === CONSISTENCY METRICS ===
-    # Two complementary approaches to measure cross-window stability.
-    #
-    # 1) CV-based consistency: 1 - CV  (CV = std / |mean|), capped [0, 1].
-    #    Standard statistical measure; scale-invariant.
-    #    Drawback: undefined when mean ≈ 0.
-    #
-    # 2) Normalized-std stability: 1 - std/max_std, capped [0, 1].
-    #    Uses a domain-specific max_std for normalization.
-    #    More intuitive for bounded metrics (win rate 0-100,
-    #    Sharpe typically -2 to +4).
-
     return_consistency = None
     win_rate_consistency = None
     sharpe_consistency = None
-    consistency_score = None
+    consistency_score_val = None
     return_stability = None
     win_rate_stability = None
     sharpe_stability = None
-    stability_score = None
-
-    def _cv_consistency(values):
-        """1 - CV capped to [0, 1], or None if insufficient data."""
-        if len(values) < 2:
-            return None
-        mean = sum(values) / len(values)
-        if abs(mean) < 1e-9:
-            return 0.0  # mean ≈ 0 → unstable
-        var = sum((x - mean) ** 2 for x in values) / (len(values) - 1)
-        cv = math.sqrt(var) / abs(mean)
-        return max(0.0, min(1.0, 1.0 - cv))
-
-    def _norm_stability(values, max_std):
-        """1 - std/max_std capped to [0, 1], or None if insufficient."""
-        if len(values) < 2:
-            return None
-        mean = sum(values) / len(values)
-        var = sum((x - mean) ** 2 for x in values) / (len(values) - 1)
-        std = math.sqrt(var)
-        return max(0.0, min(1.0, 1.0 - std / max_std))
+    stability_score_val = None
 
     if len(valid_metrics) >= 2:
         # --- Per-window returns ---
@@ -487,9 +460,10 @@ def generate_backtest_summary_metrics(
             b.total_net_gain_percentage for b in valid_metrics
             if b.total_net_gain_percentage is not None
         ]
-        return_consistency = _cv_consistency(per_window_returns)
-        # max_std = 100: a std of 100% of initial capital → score 0
-        return_stability = _norm_stability(per_window_returns, 100.0)
+        return_consistency = get_cv_consistency(per_window_returns)
+        return_stability = get_normalized_stability(
+            per_window_returns, 100.0
+        )
 
         # --- Per-window win rates ---
         per_window_win_rates = [
@@ -498,10 +472,10 @@ def generate_backtest_summary_metrics(
             and b.number_of_trades_closed is not None
             and b.number_of_trades_closed > 0
         ]
-        return_consistency = _cv_consistency(per_window_returns)
-        win_rate_consistency = _cv_consistency(per_window_win_rates)
-        # max_std = 50: theoretical max std for a [0, 100] range
-        win_rate_stability = _norm_stability(per_window_win_rates, 50.0)
+        win_rate_consistency = get_cv_consistency(per_window_win_rates)
+        win_rate_stability = get_normalized_stability(
+            per_window_win_rates, 50.0
+        )
 
         # --- Per-window Sharpe ratios ---
         per_window_sharpe = [
@@ -510,45 +484,19 @@ def generate_backtest_summary_metrics(
             and not math.isnan(b.sharpe_ratio)
             and not math.isinf(b.sharpe_ratio)
         ]
-        sharpe_consistency = _cv_consistency(per_window_sharpe)
-        # max_std = 2: Sharpe ratios typically range -2 to +4;
-        # a std of 2 means wildly inconsistent
-        sharpe_stability = _norm_stability(per_window_sharpe, 2.0)
+        sharpe_consistency = get_cv_consistency(per_window_sharpe)
+        sharpe_stability = get_normalized_stability(
+            per_window_sharpe, 2.0
+        )
 
         # --- Composite scores ---
-        # Both use the same weighting scheme:
-        # 35% returns, 25% win rate, 20% Sharpe, 20% profitable
-        # window ratio.
-        def _composite(ret_c, wr_c, sh_c):
-            components = []
-            weights_c = []
-            if ret_c is not None:
-                components.append(ret_c)
-                weights_c.append(0.35)
-            if wr_c is not None:
-                components.append(wr_c)
-                weights_c.append(0.25)
-            if sh_c is not None:
-                components.append(sh_c)
-                weights_c.append(0.20)
-            if number_of_windows and number_of_windows > 0:
-                pw_ratio = (
-                    number_of_profitable_windows / number_of_windows
-                )
-                components.append(pw_ratio)
-                weights_c.append(0.20)
-            if not components:
-                return None
-            total_w = sum(weights_c)
-            return sum(
-                c * w for c, w in zip(components, weights_c)
-            ) / total_w
-
-        consistency_score = _composite(
-            return_consistency, win_rate_consistency, sharpe_consistency
+        consistency_score_val = get_consistency_score(
+            return_consistency, win_rate_consistency, sharpe_consistency,
+            number_of_profitable_windows, number_of_windows,
         )
-        stability_score = _composite(
-            return_stability, win_rate_stability, sharpe_stability
+        stability_score_val = get_stability_score(
+            return_stability, win_rate_stability, sharpe_stability,
+            number_of_profitable_windows, number_of_windows,
         )
 
     return BacktestSummaryMetrics(
@@ -602,9 +550,9 @@ def generate_backtest_summary_metrics(
         return_consistency=return_consistency,
         win_rate_consistency=win_rate_consistency,
         sharpe_consistency=sharpe_consistency,
-        consistency_score=consistency_score,
+        consistency_score=consistency_score_val,
         return_stability=return_stability,
         win_rate_stability=win_rate_stability,
         sharpe_stability=sharpe_stability,
-        stability_score=stability_score,
+        stability_score=stability_score_val,
     )

investing_algorithm_framework-8.6.0/investing_algorithm_framework/domain/backtesting/consistency.py

@@ -0,0 +1,137 @@
+import math
+
+
+def get_cv_consistency(values):
+    """
+    CV-based consistency: 1 - CV (CV = std / |mean|), capped [0, 1].
+
+    Standard statistical measure; scale-invariant.
+    Returns None if fewer than 2 values.
+    Returns 0.0 when mean ≈ 0 (unstable).
+
+    Args:
+        values: list of numeric values (e.g. per-window returns)
+
+    Returns:
+        float in [0, 1] or None
+    """
+    if len(values) < 2:
+        return None
+    mean = sum(values) / len(values)
+    if abs(mean) < 1e-9:
+        return 0.0
+    var = sum((x - mean) ** 2 for x in values) / (len(values) - 1)
+    cv = math.sqrt(var) / abs(mean)
+    return max(0.0, min(1.0, 1.0 - cv))
+
+
+def get_normalized_stability(values, max_std):
+    """
+    Normalized-std stability: 1 - std/max_std, capped [0, 1].
+
+    Uses a domain-specific max_std for normalization.
+    More intuitive for bounded metrics (win rate 0-100,
+    Sharpe typically -2 to +4).
+    Returns None if fewer than 2 values.
+
+    Args:
+        values: list of numeric values (e.g. per-window win rates)
+        max_std: domain-specific maximum standard deviation for
+                 normalization
+
+    Returns:
+        float in [0, 1] or None
+    """
+    if len(values) < 2:
+        return None
+    mean = sum(values) / len(values)
+    var = sum((x - mean) ** 2 for x in values) / (len(values) - 1)
+    std = math.sqrt(var)
+    return max(0.0, min(1.0, 1.0 - std / max_std))
+
+
+def get_consistency_score(
+    return_consistency,
+    win_rate_consistency,
+    sharpe_consistency,
+    number_of_profitable_windows=None,
+    number_of_windows=None,
+):
+    """
+    Composite consistency score using weighted components:
+    35% returns, 25% win rate, 20% Sharpe, 20% profitable window ratio.
+
+    Args:
+        return_consistency: CV consistency of per-window returns
+        win_rate_consistency: CV consistency of per-window win rates
+        sharpe_consistency: CV consistency of per-window Sharpe ratios
+        number_of_profitable_windows: count of profitable windows
+        number_of_windows: total number of windows
+
+    Returns:
+        float in [0, 1] or None
+    """
+    return _composite(
+        return_consistency,
+        win_rate_consistency,
+        sharpe_consistency,
+        number_of_profitable_windows,
+        number_of_windows,
+    )
+
+
+def get_stability_score(
+    return_stability,
+    win_rate_stability,
+    sharpe_stability,
+    number_of_profitable_windows=None,
+    number_of_windows=None,
+):
+    """
+    Composite stability score using weighted components:
+    35% returns, 25% win rate, 20% Sharpe, 20% profitable window ratio.
+
+    Args:
+        return_stability: normalized stability of per-window returns
+        win_rate_stability: normalized stability of per-window win rates
+        sharpe_stability: normalized stability of per-window Sharpe ratios
+        number_of_profitable_windows: count of profitable windows
+        number_of_windows: total number of windows
+
+    Returns:
+        float in [0, 1] or None
+    """
+    return _composite(
+        return_stability,
+        win_rate_stability,
+        sharpe_stability,
+        number_of_profitable_windows,
+        number_of_windows,
+    )
+
+
+def _composite(
+    ret_c, wr_c, sh_c,
+    number_of_profitable_windows=None,
+    number_of_windows=None,
+):
+    components = []
+    weights_c = []
+    if ret_c is not None:
+        components.append(ret_c)
+        weights_c.append(0.35)
+    if wr_c is not None:
+        components.append(wr_c)
+        weights_c.append(0.25)
+    if sh_c is not None:
+        components.append(sh_c)
+        weights_c.append(0.20)
+    if number_of_windows and number_of_windows > 0 \
+            and number_of_profitable_windows is not None:
+        pw_ratio = number_of_profitable_windows / number_of_windows
+        components.append(pw_ratio)
+        weights_c.append(0.20)
+    if not components:
+        return None
+    total_w = sum(weights_c)
+    return sum(c * w for c, w in zip(components, weights_c)) / total_w