Qubx 0.6.91__tar.gz → 0.6.93__tar.gz

{qubx-0.6.91 → qubx-0.6.93}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Qubx
-Version: 0.6.91
+Version: 0.6.93
 Summary: Qubx - Quantitative Trading Framework
 License-File: LICENSE
 Author: Dmitry Marienko
@@ -24,6 +24,7 @@ Requires-Dist: ipywidgets (>=8.1.5,<9.0.0)
 Requires-Dist: jinja2 (>=3.1.0,<4.0.0)
 Requires-Dist: jupyter (>=1.1.1,<2.0.0)
 Requires-Dist: jupyter-console (>=6.6.3,<7.0.0)
+Requires-Dist: lighter-sdk (>=0.1.4,<0.2.0)
 Requires-Dist: loguru (>=0.7.2,<0.8.0)
 Requires-Dist: matplotlib (>=3.8.4,<4.0.0)
 Requires-Dist: msgspec (>=0.18.6,<0.19.0)
@@ -52,7 +53,9 @@ Requires-Dist: sortedcontainers (>=2.4.0,<3.0.0)
 Requires-Dist: stackprinter (>=0.2.10,<0.3.0)
 Requires-Dist: statsmodels (>=0.14.2,<0.15.0)
 Requires-Dist: tabulate (>=0.9.0,<0.10.0)
-Requires-Dist: textual (>=0.88.0,<0.89.0)
+Requires-Dist: textual-autocomplete (>=4.0.0,<5.0.0)
+Requires-Dist: textual-serve (>=1.0.0,<2.0.0)
+Requires-Dist: textual[syntax] (>=6.0.0,<7.0.0)
 Requires-Dist: toml (>=0.10.2,<0.11.0)
 Requires-Dist: tqdm
 Requires-Dist: websockets (==15.0.1)

{qubx-0.6.91 → qubx-0.6.93}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "Qubx"
-version = "0.6.91"
+version = "0.6.93"
 description = "Qubx - Quantitative Trading Framework"
 authors = [ "Dmitry Marienko <dmitry.marienko@xlydian.com>", "Yuriy Arabskyy <yuriy.arabskyy@xlydian.com>",]
 readme = "README.md"
@@ -74,9 +74,11 @@ orjson = "^3.10.15"
 aiohttp = "~3.10.11"
 websockets = "15.0.1"
 qubx-bitfinex-api = "^3.0.7"
-textual = "^0.88.0"
+textual-autocomplete = "^4.0.0"
+textual-serve = "^1.0.0"
 rich = "^13.9.4"
 jinja2 = "^3.1.0"
+lighter-sdk = "^0.1.4"
 
 [tool.ruff.lint]
 extend-select = [ "I",]
@@ -90,6 +92,10 @@ markers = [ "integration: mark test as requiring external services like Redis",
 addopts = "--disable-warnings"
 filterwarnings = [ "ignore:.*Jupyter is migrating.*:DeprecationWarning", "ignore:coroutine.*AsyncMockMixin._execute_mock_call.*was never awaited:RuntimeWarning",]
 
+[tool.poetry.dependencies.textual]
+extras = [ "syntax",]
+version = "^6.0.0"
+
 [tool.ruff.lint.extend-per-file-ignores]
 "*.ipynb" = [ "F405", "F401", "E701", "E402", "F403", "E401", "E702", "I001",]
 
@@ -120,6 +126,7 @@ pytest-mock = "^3.12.0"
 pytest-lazy-fixture = "^0.6.3"
 pytest-cov = "^4.1.0"
 mongomock = "^4.3.0"
+pytest-textual-snapshot = "^1.1.0"
 
 [tool.poetry.group.k8.dependencies]
 prometheus-client = "^0.21.1"

{qubx-0.6.91 → qubx-0.6.93}/src/qubx/backtester/management.py

@@ -1,6 +1,7 @@
 import re
 import zipfile
 from collections import defaultdict
+from os.path import expanduser
 from pathlib import Path
 
 import numpy as np
@@ -39,7 +40,7 @@ class BacktestsResultsManager:
     """
 
     def __init__(self, path: str):
-        self.path = path
+        self.path = expanduser(path)
         self.reload()
 
     def reload(self) -> "BacktestsResultsManager":

{qubx-0.6.91 → qubx-0.6.93}/src/qubx/cli/commands.py

@@ -72,11 +72,29 @@ def main(debug: bool, debug_port: int, log_level: str):
 @click.option(
     "--textual", "-t", is_flag=True, default=False, help="Run strategy in textual TUI.", show_default=True
 )
+@click.option(
+    "--textual-dev", is_flag=True, default=False, help="Enable Textual dev mode (use with 'textual console').", show_default=True
+)
+@click.option(
+    "--textual-web", is_flag=True, default=False, help="Serve Textual app in web browser.", show_default=True
+)
+@click.option(
+    "--textual-port", type=int, default=None, help="Port for Textual (web server: 8000, devtools: 8081).", show_default=False
+)
+@click.option(
+    "--textual-host", type=str, default="0.0.0.0", help="Host for Textual web server.", show_default=True
+)
+@click.option(
+    "--kernel-only", is_flag=True, default=False, help="Start kernel without UI (returns connection file).", show_default=True
+)
+@click.option(
+    "--connect", type=Path, default=None, help="Connect to existing kernel via connection file.", show_default=False
+)
 @click.option(
     "--restore", "-r", is_flag=True, default=False, help="Restore strategy state from previous run.", show_default=True
 )
 @click.option("--no-color", is_flag=True, default=False, help="Disable colored logging output.", show_default=True)
-def run(config_file: Path, account_file: Path | None, paper: bool, jupyter: bool, textual: bool, restore: bool, no_color: bool):
+def run(config_file: Path, account_file: Path | None, paper: bool, jupyter: bool, textual: bool, textual_dev: bool, textual_web: bool, textual_port: int | None, textual_host: str, kernel_only: bool, connect: Path | None, restore: bool, no_color: bool):
     """
     Starts the strategy with the given configuration file. If paper mode is enabled, account is not required.
 
@@ -94,6 +112,39 @@ def run(config_file: Path, account_file: Path | None, paper: bool, jupyter: bool
         click.echo("Error: --jupyter and --textual cannot be used together.", err=True)
         raise click.Abort()
 
+    # Handle --kernel-only mode
+    if kernel_only:
+        import asyncio
+
+        from qubx.utils.runner.kernel_service import KernelService
+
+        add_project_to_system_path()
+        add_project_to_system_path(str(config_file.parent.parent))
+        add_project_to_system_path(str(config_file.parent))
+
+        click.echo("Starting persistent kernel...")
+        connection_file = asyncio.run(KernelService.start(config_file, account_file, paper, restore))
+        click.echo(click.style("✓ Kernel started successfully!", fg="green", bold=True))
+        click.echo(click.style(f"Connection file: {connection_file}", fg="cyan"))
+        click.echo()
+        click.echo("To connect a UI to this kernel:")
+        click.echo(f"  qubx run --textual --connect {connection_file}")
+        click.echo()
+        click.echo("To stop this kernel:")
+        click.echo(f"  qubx kernel stop {connection_file}")
+        click.echo()
+        click.echo("Press Ctrl+C to stop the kernel and exit...")
+
+        # Keep the process alive until interrupted
+        try:
+            import signal
+            signal.pause()
+        except KeyboardInterrupt:
+            click.echo("\nShutting down kernel...")
+            asyncio.run(KernelService.stop(connection_file))
+            click.echo("Kernel stopped.")
+        return
+
     add_project_to_system_path()
     add_project_to_system_path(str(config_file.parent.parent))
     add_project_to_system_path(str(config_file.parent))
@@ -101,7 +152,7 @@ def run(config_file: Path, account_file: Path | None, paper: bool, jupyter: bool
     if jupyter:
         run_strategy_yaml_in_jupyter(config_file, account_file, paper, restore)
     elif textual:
-        run_strategy_yaml_in_textual(config_file, account_file, paper, restore)
+        run_strategy_yaml_in_textual(config_file, account_file, paper, restore, textual_dev, textual_web, textual_port, textual_host, connect)
     else:
         logo()
         run_strategy_yaml(config_file, account_file, paper=paper, restore=restore, blocking=True, no_color=no_color)
@@ -461,5 +512,69 @@ def init(
         raise click.Abort()
 
 
+@main.group()
+def kernel():
+    """
+    Manage persistent Jupyter kernels for strategy execution.
+
+    Kernels can be started independently of the UI, allowing multiple
+    UI instances to connect to the same running strategy.
+    """
+    pass
+
+
+@kernel.command("list")
+def kernel_list():
+    """
+    List all active kernel sessions.
+
+    Shows connection files and associated strategy configurations
+    for all currently running kernels.
+    """
+    from qubx.utils.runner.kernel_service import KernelService
+
+    active = KernelService.list_active()
+
+    if not active:
+        click.echo("No active kernels found.")
+        return
+
+    import datetime
+
+    click.echo(click.style("Active Kernels:", fg="cyan", bold=True))
+    click.echo()
+    for i, kernel_info in enumerate(active, 1):
+        # Format timestamp
+        ts = datetime.datetime.fromtimestamp(kernel_info["timestamp"])
+        time_str = ts.strftime("%Y-%m-%d %H:%M:%S")
+
+        click.echo(f"{i}. {click.style('Strategy:', fg='yellow')} {kernel_info['strategy_name']}")
+        click.echo(f"   {click.style('Started:', fg='yellow')} {time_str}")
+        click.echo(f"   {click.style('Connection:', fg='yellow')} {kernel_info['connection_file']}")
+        click.echo()
+
+
+@kernel.command("stop")
+@click.argument("connection-file", type=Path, required=True)
+def kernel_stop(connection_file: Path):
+    """
+    Stop a running kernel by its connection file.
+
+    This will gracefully shutdown the kernel and clean up
+    the connection file.
+    """
+    import asyncio
+
+    from qubx.utils.runner.kernel_service import KernelService
+
+    if not connection_file.exists():
+        click.echo(click.style(f"✗ Connection file not found: {connection_file}", fg="red"))
+        raise click.Abort()
+
+    click.echo(f"Stopping kernel: {connection_file}")
+    asyncio.run(KernelService.stop(str(connection_file)))
+    click.echo(click.style("✓ Kernel stopped successfully", fg="green"))
+
+
 if __name__ == "__main__":
     main()

{qubx-0.6.91 → qubx-0.6.93}/src/qubx/connectors/ccxt/factory.py

@@ -8,8 +8,8 @@ from qubx.core.basics import CtrlChannel
 from qubx.core.interfaces import IAccountProcessor, IBroker, IDataProvider, ITimeProvider
 
 from .account import CcxtAccountProcessor
-from .exchanges import CUSTOM_ACCOUNTS, CUSTOM_BROKERS, EXCHANGE_ALIASES
 from .exchange_manager import ExchangeManager
+from .exchanges import CUSTOM_ACCOUNTS, CUSTOM_BROKERS, EXCHANGE_ALIASES
 
 
 def get_ccxt_exchange(
@@ -22,10 +22,10 @@ def get_ccxt_exchange(
 ) -> cxp.Exchange:
     """
     Get a raw CCXT exchange object.
-    
+
     Creates and configures a CCXT exchange instance without any stability wrapper.
     Use get_ccxt_exchange_manager() if you need automatic stability management.
-    
+
     Parameters:
         exchange (str): The exchange name.
         api_key (str, optional): The API key. Default is None.
@@ -33,7 +33,7 @@ def get_ccxt_exchange(
         loop (asyncio.AbstractEventLoop, optional): Event loop. Default is None.
         use_testnet (bool): Use testnet/sandbox mode. Default is False.
         **kwargs: Additional parameters for exchange configuration.
-        
+
     Returns:
         Raw CCXT Exchange instance
     """
@@ -90,10 +90,10 @@ def get_ccxt_exchange_manager(
 ) -> ExchangeManager:
     """
     Get a CCXT exchange with automatic stability management.
-    
+
     Returns ExchangeManager wrapper that handles exchange recreation
     during data stall scenarios via self-monitoring.
-    
+
     Parameters:
         exchange (str): The exchange name.
         api_key (str, optional): The API key. Default is None.
@@ -102,28 +102,23 @@ def get_ccxt_exchange_manager(
         use_testnet (bool): Use testnet/sandbox mode. Default is False.
         check_interval_seconds (float): How often to check for stalls. Default is 30.0.
         **kwargs: Additional parameters for exchange configuration.
-        
+
     Returns:
         ExchangeManager wrapping the CCXT Exchange
     """
     # Prepare factory parameters for ExchangeManager recreation
     factory_params = {
-        'exchange': exchange,
-        'api_key': api_key,  
-        'secret': secret,
-        'loop': loop,
-        'use_testnet': use_testnet,
-        **{k: v for k, v in kwargs.items() if k != 'check_interval_seconds'}
+        "exchange": exchange,
+        "api_key": api_key,
+        "secret": secret,
+        "loop": loop,
+        "use_testnet": use_testnet,
+        **{k: v for k, v in kwargs.items() if k != "check_interval_seconds"},
     }
-    
+
     # Create raw CCXT exchange using public factory method
     ccxt_exchange = get_ccxt_exchange(
-        exchange=exchange,
-        api_key=api_key,
-        secret=secret,
-        loop=loop,
-        use_testnet=use_testnet,
-        **kwargs
+        exchange=exchange, api_key=api_key, secret=secret, loop=loop, use_testnet=use_testnet, **kwargs
     )
 
     # Wrap in ExchangeManager for stability management

qubx-0.6.93/src/qubx/connectors/xlighter/__init__.py

@@ -0,0 +1,83 @@
+"""XLighter exchange connector for Qubx"""
+
+from .account import LighterAccountProcessor
+from .broker import LighterBroker
+from .client import LighterClient
+from .constants import (
+    DEDICATED_CHANNELS,
+    MULTIPLEX_CHANNELS,
+    WS_CHANNEL_ACCOUNT_ALL,
+    WS_CHANNEL_EXECUTED_TX,
+    WS_CHANNEL_MARKET_STATS,
+    WS_CHANNEL_ORDER_BOOK,
+    WS_CHANNEL_TRADE,
+    WS_CHANNEL_USER_STATS,
+    LighterMarginMode,
+    LighterOrderSide,
+    LighterOrderType,
+    LighterTimeInForce,
+)
+from .data import LighterDataProvider
+from .factory import (
+    get_xlighter_account,
+    get_xlighter_broker,
+    get_xlighter_client,
+    get_xlighter_data_provider,
+)
+from .instruments import LighterInstrumentLoader, load_lighter_instruments
+from .parsers import PositionState
+from .reader import XLighterDataReader
+from .utils import (
+    convert_lighter_order,
+    convert_lighter_orderbook,
+    convert_lighter_quote,
+    convert_lighter_trade,
+    lighter_order_side_to_qubx,
+    lighter_symbol_to_qubx,
+    qubx_order_side_to_lighter,
+    qubx_symbol_to_lighter,
+)
+from .websocket import LighterWebSocketManager
+
+__all__ = [
+    # Core Components
+    "LighterClient",
+    "LighterDataProvider",
+    "LighterBroker",
+    "LighterAccountProcessor",
+    "LighterWebSocketManager",
+    # Factory Functions
+    "get_xlighter_client",
+    "get_xlighter_data_provider",
+    "get_xlighter_account",
+    "get_xlighter_broker",
+    # Data Reader
+    "XLighterDataReader",
+    # Instruments
+    "LighterInstrumentLoader",
+    "load_lighter_instruments",
+    # Parsers
+    "PositionState",
+    # Constants
+    "LighterOrderType",
+    "LighterTimeInForce",
+    "LighterOrderSide",
+    "LighterMarginMode",
+    "WS_CHANNEL_ORDER_BOOK",
+    "WS_CHANNEL_TRADE",
+    "WS_CHANNEL_MARKET_STATS",
+    "WS_CHANNEL_ACCOUNT_ALL",
+    "WS_CHANNEL_USER_STATS",
+    "WS_CHANNEL_EXECUTED_TX",
+    "MULTIPLEX_CHANNELS",
+    "DEDICATED_CHANNELS",
+    # Utils
+    "lighter_symbol_to_qubx",
+    "qubx_symbol_to_lighter",
+    "lighter_order_side_to_qubx",
+    "qubx_order_side_to_lighter",
+    "convert_lighter_orderbook",
+    "convert_lighter_trade",
+    "convert_lighter_quote",
+    "convert_lighter_order",
+]