mcli-framework 7.0.0__py3-none-any.whl → 7.0.2__py3-none-any.whl

mcli/__init__.py

@@ -0,0 +1,160 @@
+# logger.info("I am in mcli.__init__.py")
+import sys
+
+try:
+    from mcli.app import main
+
+    # from mcli.public import *
+    # from mcli.private import *
+    # Import the complete Click superset decorators
+    from mcli.lib.api.mcli_decorators import BOOL  # mcli.BOOL - Click BOOL type
+    from mcli.lib.api.mcli_decorators import FLOAT  # mcli.FLOAT - Click FLOAT type
+    from mcli.lib.api.mcli_decorators import INT  # mcli.INT - Click INT type
+    from mcli.lib.api.mcli_decorators import STRING  # mcli.STRING - Click STRING type
+    from mcli.lib.api.mcli_decorators import UNPROCESSED  # mcli.UNPROCESSED - Click UNPROCESSED
+    from mcli.lib.api.mcli_decorators import UUID  # mcli.UUID - Click UUID type
+    from mcli.lib.api.mcli_decorators import Abort  # mcli.Abort - Click Abort
+    from mcli.lib.api.mcli_decorators import BadParameter  # mcli.BadParameter - Click BadParameter
+    from mcli.lib.api.mcli_decorators import Choice  # mcli.Choice - Click Choice type
+    from mcli.lib.api.mcli_decorators import File  # mcli.File - Click File type
+    from mcli.lib.api.mcli_decorators import FloatRange  # mcli.FloatRange - Click FloatRange type
+    from mcli.lib.api.mcli_decorators import IntRange  # mcli.IntRange - Click IntRange type
+    from mcli.lib.api.mcli_decorators import ParamType  # mcli.ParamType - Click ParamType
+    from mcli.lib.api.mcli_decorators import Path  # mcli.Path - Click Path type
+    from mcli.lib.api.mcli_decorators import UsageError  # mcli.UsageError - Click UsageError
+    from mcli.lib.api.mcli_decorators import api  # @mcli.api - Legacy API decorator
+    from mcli.lib.api.mcli_decorators import (
+        api_command,  # @mcli.api_command - Convenience for API endpoints
+    )
+    from mcli.lib.api.mcli_decorators import argument  # @mcli.argument - Click argument decorator
+    from mcli.lib.api.mcli_decorators import (
+        background,  # @mcli.background - Legacy background decorator
+    )
+    from mcli.lib.api.mcli_decorators import (
+        background_command,  # @mcli.background_command - Convenience for background
+    )
+    from mcli.lib.api.mcli_decorators import clear  # mcli.clear - Click clear
+    from mcli.lib.api.mcli_decorators import (
+        cli_with_api,  # @mcli.cli_with_api - Legacy combined decorator
+    )
+    from mcli.lib.api.mcli_decorators import (
+        command,  # @mcli.command - Complete Click command with API/background
+    )
+    from mcli.lib.api.mcli_decorators import confirm  # mcli.confirm - Click confirmation
+    from mcli.lib.api.mcli_decorators import echo  # mcli.echo - Click echo function
+    from mcli.lib.api.mcli_decorators import edit  # mcli.edit - Click editor
+    from mcli.lib.api.mcli_decorators import (
+        format_filename,  # mcli.format_filename - Click filename
+    )
+    from mcli.lib.api.mcli_decorators import get_app  # mcli.get_app - Click app
+    from mcli.lib.api.mcli_decorators import get_app_dir  # mcli.get_app_dir - Click app directory
+    from mcli.lib.api.mcli_decorators import (
+        get_binary_stream,  # mcli.get_binary_stream - Click binary stream
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_current_context,  # mcli.get_current_context - Click context
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_network_credentials,  # mcli.get_network_credentials - Click network
+    )
+    from mcli.lib.api.mcli_decorators import get_os_args  # mcli.get_os_args - Click OS args
+    from mcli.lib.api.mcli_decorators import (
+        get_terminal_size,  # mcli.get_terminal_size - Click terminal size
+    )
+    from mcli.lib.api.mcli_decorators import (
+        get_text_stream,  # mcli.get_text_stream - Click text stream
+    )
+    from mcli.lib.api.mcli_decorators import getchar  # mcli.getchar - Click character input
+    from mcli.lib.api.mcli_decorators import (
+        group,  # @mcli.group - Complete Click group with API support
+    )
+    from mcli.lib.api.mcli_decorators import launch  # mcli.launch - Click launch
+    from mcli.lib.api.mcli_decorators import open_file  # mcli.open_file - Click file operations
+    from mcli.lib.api.mcli_decorators import option  # @mcli.option - Click option decorator
+    from mcli.lib.api.mcli_decorators import pause  # mcli.pause - Click pause
+    from mcli.lib.api.mcli_decorators import progressbar  # mcli.progressbar - Click progress bar
+    from mcli.lib.api.mcli_decorators import prompt  # mcli.prompt - Click prompt
+    from mcli.lib.api.mcli_decorators import secho  # mcli.secho - Click styled echo
+    from mcli.lib.api.mcli_decorators import style  # mcli.style - Click styling
+    from mcli.lib.api.mcli_decorators import unstyle  # mcli.unstyle - Click unstyle
+    from mcli.lib.api.mcli_decorators import (  # Core decorators (complete Click superset); Click re-exports (complete subsume); Click types (complete subsume); Convenience decorators; Legacy decorators (for backward compatibility); Server management; Configuration; Convenience functions
+        disable_api_server,
+        enable_api_server,
+        get_api_config,
+        health_check,
+        is_background_available,
+        is_server_running,
+        start_server,
+        status_check,
+        stop_server,
+    )
+
+    # Make everything available at the top level (complete Click subsume)
+    __all__ = [
+        "main",
+        # Core decorators (complete Click superset)
+        "command",
+        "group",
+        # Click re-exports (complete subsume)
+        "option",
+        "argument",
+        "echo",
+        "get_current_context",
+        "get_app",
+        "launch",
+        "open_file",
+        "get_os_args",
+        "get_binary_stream",
+        "get_text_stream",
+        "format_filename",
+        "getchar",
+        "pause",
+        "clear",
+        "style",
+        "unstyle",
+        "secho",
+        "edit",
+        "confirm",
+        "prompt",
+        "progressbar",
+        "get_terminal_size",
+        "get_app_dir",
+        "get_network_credentials",
+        # Click types (complete subsume)
+        "Path",
+        "Choice",
+        "IntRange",
+        "FloatRange",
+        "UNPROCESSED",
+        "STRING",
+        "INT",
+        "FLOAT",
+        "BOOL",
+        "UUID",
+        "File",
+        "ParamType",
+        "BadParameter",
+        "UsageError",
+        "Abort",
+        # Convenience decorators
+        "api_command",
+        "background_command",
+        # Legacy decorators (for backward compatibility)
+        "api",
+        "background",
+        "cli_with_api",
+        # Server management
+        "start_server",
+        "stop_server",
+        "is_server_running",
+        "is_background_available",
+        "get_api_config",
+        "enable_api_server",
+        "disable_api_server",
+        "health_check",
+        "status_check",
+    ]
+
+except ImportError:
+    # from .app import main
+    sys.exit(1)

mcli/__main__.py

@@ -0,0 +1,14 @@
+# logger.info("I am in mcli.__init__.py")
+
+try:
+    from mcli.app.main import main as main_func
+
+    # from mcli.public import *
+    # from mcli.private import *
+except ImportError:
+    from .app.main import main as main_func
+
+__all__ = ["main_func"]
+
+if __name__ == "__main__":
+    main_func()

mcli/app/__init__.py

@@ -0,0 +1,32 @@
+# src/mcli/app/__init__.py
+import importlib
+from pathlib import Path
+
+from mcli.lib.logger.logger import get_logger
+
+logger = get_logger(__name__)
+
+logger.info("Initializing mcli.app package")
+
+# Import main function
+try:
+    from .main import main
+
+    logger.info("Successfully imported main from .main")
+except ImportError as e:
+    logger.error(f"Failed to import main: {e}")
+    import traceback
+
+    logger.error(f"Traceback: {traceback.format_exc()}")
+    raise
+
+# Try importing readiness submodule
+try:
+    from .readiness import readiness
+
+    logger.info(f"Successfully imported readiness module directly: {readiness}")
+    # Make it available at the app level
+    __all__ = ["main", "readiness"]
+except ImportError as e:
+    logger.info(f"Could not import readiness directly: {e}")
+    __all__ = ["main"]

mcli/app/logs_cmd.py

@@ -16,6 +16,8 @@ from rich.live import Live
 from rich.panel import Panel
 from rich.text import Text
 
+from mcli.lib.paths import get_logs_dir
+
 console = Console()
 
 
@@ -25,6 +27,24 @@ def logs_group():
     pass
 
 
+@logs_group.command(name="location")
+def show_location():
+    """Show the location of the logs directory"""
+    logs_dir = get_logs_dir()
+    console.print(f"📁 [cyan]Logs directory:[/cyan] {logs_dir}")
+    console.print(f"   [dim]Set MCLI_HOME environment variable to change location[/dim]")
+
+    # Show if directory exists and has files
+    if logs_dir.exists():
+        log_files = list(logs_dir.glob("mcli*.log"))
+        if log_files:
+            console.print(f"   [green]✓ {len(log_files)} log file(s) found[/green]")
+        else:
+            console.print(f"   [yellow]⚠ Directory exists but no log files yet[/yellow]")
+    else:
+        console.print(f"   [yellow]⚠ Directory will be created on first use[/yellow]")
+
+
 @logs_group.command(name="stream")
 @click.option(
     "--type",
@@ -49,13 +69,7 @@ def stream_logs(type: str, lines: int, follow: bool):
     Shows log output with syntax highlighting and real-time updates.
     Similar to 'tail -f' but with enhanced formatting for MCLI logs.
     """
-    logs_dir = Path("logs")
-
-    if not logs_dir.exists():
-        console.print(
-            "❌ No logs directory found. Run some MCLI commands to generate logs.", style="red"
-        )
-        return
+    logs_dir = get_logs_dir()
 
     # Get today's log files
     today = datetime.now().strftime("%Y%m%d")
@@ -98,12 +112,7 @@ def stream_logs(type: str, lines: int, follow: bool):
 @click.option("--date", "-d", help="Show logs for specific date (YYYYMMDD format)")
 def list_logs(date: Optional[str]):
     """List available log files"""
-    logs_dir = Path("logs")
-
-    if not logs_dir.exists():
-        console.print("❌ No logs directory found", style="red")
-        return
-
+    logs_dir = get_logs_dir()
     _list_available_logs(logs_dir, date)
 
 
@@ -113,11 +122,9 @@ def list_logs(date: Optional[str]):
 @click.option("--date", "-d", help="Date for log file (YYYYMMDD format, default: today)")
 def tail_logs(log_type: str, lines: int, date: Optional[str]):
     """Show the last N lines of a specific log file"""
-    logs_dir = Path("logs")
+    logs_dir = get_logs_dir()
 
-    if not logs_dir.exists():
-        console.print("❌ No logs directory found", style="red")
-        return
+    # Note: get_logs_dir() creates the directory automatically
 
     # Use provided date or default to today
     log_date = date or datetime.now().strftime("%Y%m%d")
@@ -168,11 +175,7 @@ def tail_logs(log_type: str, lines: int, date: Optional[str]):
 )
 def grep_logs(pattern: str, type: str, date: Optional[str], context: int):
     """Search for patterns in log files"""
-    logs_dir = Path("logs")
-
-    if not logs_dir.exists():
-        console.print("❌ No logs directory found", style="red")
-        return
+    logs_dir = get_logs_dir()
 
     # Use provided date or default to today
     log_date = date or datetime.now().strftime("%Y%m%d")
@@ -216,11 +219,7 @@ def grep_logs(pattern: str, type: str, date: Optional[str], context: int):
 @click.option("--confirm", "-y", is_flag=True, help="Skip confirmation prompt")
 def clear_logs(older_than: Optional[int], confirm: bool):
     """Clear old log files"""
-    logs_dir = Path("logs")
-
-    if not logs_dir.exists():
-        console.print("❌ No logs directory found", style="red")
-        return
+    logs_dir = get_logs_dir()
 
     # Find log files
     log_files = list(logs_dir.glob("mcli*.log"))

mcli/app/video/__init__.py

@@ -0,0 +1,5 @@
+"""
+Video processing commands for mcli.
+"""
+
+from .video import *

mcli/chat/__init__.py

@@ -0,0 +1,34 @@
+"""
+MCLI Chat System
+Real-time system control and interaction capabilities for MCLI chat
+"""
+
+from .system_controller import (
+    SystemController,
+    control_app,
+    execute_system_command,
+    open_file_or_url,
+    open_textedit_and_write,
+    system_controller,
+    take_screenshot,
+)
+from .system_integration import (
+    ChatSystemIntegration,
+    chat_system_integration,
+    get_system_capabilities,
+    handle_system_request,
+)
+
+__all__ = [
+    "SystemController",
+    "system_controller",
+    "ChatSystemIntegration",
+    "chat_system_integration",
+    "handle_system_request",
+    "get_system_capabilities",
+    "open_textedit_and_write",
+    "control_app",
+    "execute_system_command",
+    "take_screenshot",
+    "open_file_or_url",
+]

mcli/lib/auth/__init__.py

@@ -0,0 +1 @@
+from .auth import *

mcli/lib/config/__init__.py

@@ -0,0 +1 @@
+from .config import *

mcli/lib/erd/__init__.py

@@ -0,0 +1,25 @@
+"""
+Entity Relationship Diagram (ERD) package.
+
+This package provides utilities for generating Entity Relationship Diagrams from MCLI type metadata.
+"""
+
+# Import and export all public functions from erd.py
+from .erd import (
+    analyze_graph_for_hierarchical_exports,
+    create_merged_erd,
+    do_erd,
+    find_top_nodes_in_graph,
+    generate_erd_for_top_nodes,
+    generate_merged_erd_for_types,
+)
+
+# Define __all__ to control exports
+__all__ = [
+    "do_erd",
+    "create_merged_erd",
+    "generate_merged_erd_for_types",
+    "find_top_nodes_in_graph",
+    "generate_erd_for_top_nodes",
+    "analyze_graph_for_hierarchical_exports",
+]

mcli/lib/fs/__init__.py

@@ -0,0 +1 @@
+from .fs import *

mcli/lib/logger/__init__.py

@@ -0,0 +1,3 @@
+from .logger import get_logger
+
+__all__ = ["get_logger"]

mcli/lib/logger/logger.py

@@ -208,13 +208,11 @@ class McliLogger:
 
         # Set up file handler with path resolution
         try:
-            # Find the project root directory (where logs dir should be)
-            # Start with the current file and navigate up the directory structure
-            current_file = Path(__file__)
-            # Go up 5 levels: file -> logger -> lib -> mcli -> src -> repo_root
-            project_root = current_file.parents[4]
-            log_dir = project_root / "logs"
-            log_dir.mkdir(exist_ok=True)
+            # Import paths utility for consistent path resolution
+            from mcli.lib.paths import get_logs_dir
+
+            # Get logs directory (e.g., ~/.mcli/logs)
+            log_dir = get_logs_dir()
 
             # Create daily log file
             timestamp = datetime.now().strftime("%Y%m%d")

mcli/lib/paths.py

@@ -0,0 +1,82 @@
+"""
+Path resolution utilities for mcli
+
+Provides consistent path resolution for logs, config, and data directories
+that work both when running from source and when installed as a package.
+"""
+
+import os
+from pathlib import Path
+from typing import Optional
+
+
+def get_mcli_home() -> Path:
+    """
+    Get the mcli home directory for storing logs, config, and data.
+
+    Returns:
+        Path to ~/.mcli directory, created if it doesn't exist
+    """
+    # Check for MCLI_HOME environment variable first
+    mcli_home = os.getenv("MCLI_HOME")
+    if mcli_home:
+        path = Path(mcli_home)
+    else:
+        # Use XDG_DATA_HOME if set, otherwise default to ~/.mcli
+        xdg_data_home = os.getenv("XDG_DATA_HOME")
+        if xdg_data_home:
+            path = Path(xdg_data_home) / "mcli"
+        else:
+            path = Path.home() / ".mcli"
+
+    # Create directory if it doesn't exist
+    path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def get_logs_dir() -> Path:
+    """
+    Get the logs directory for mcli.
+
+    Returns:
+        Path to logs directory (e.g., ~/.mcli/logs), created if it doesn't exist
+    """
+    logs_dir = get_mcli_home() / "logs"
+    logs_dir.mkdir(parents=True, exist_ok=True)
+    return logs_dir
+
+
+def get_config_dir() -> Path:
+    """
+    Get the config directory for mcli.
+
+    Returns:
+        Path to config directory (e.g., ~/.mcli/config), created if it doesn't exist
+    """
+    config_dir = get_mcli_home() / "config"
+    config_dir.mkdir(parents=True, exist_ok=True)
+    return config_dir
+
+
+def get_data_dir() -> Path:
+    """
+    Get the data directory for mcli.
+
+    Returns:
+        Path to data directory (e.g., ~/.mcli/data), created if it doesn't exist
+    """
+    data_dir = get_mcli_home() / "data"
+    data_dir.mkdir(parents=True, exist_ok=True)
+    return data_dir
+
+
+def get_cache_dir() -> Path:
+    """
+    Get the cache directory for mcli.
+
+    Returns:
+        Path to cache directory (e.g., ~/.mcli/cache), created if it doesn't exist
+    """
+    cache_dir = get_mcli_home() / "cache"
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    return cache_dir

mcli/lib/performance/__init__.py

@@ -0,0 +1,17 @@
+"""
+Performance optimization utilities for mcli
+"""
+
+from .uvloop_config import (
+    configure_event_loop_for_performance,
+    get_event_loop_info,
+    install_uvloop,
+    should_use_uvloop,
+)
+
+__all__ = [
+    "install_uvloop",
+    "should_use_uvloop",
+    "get_event_loop_info",
+    "configure_event_loop_for_performance",
+]

mcli/lib/pickles/__init__.py

@@ -0,0 +1 @@
+from .pickles import ObjectCache

mcli/lib/toml/__init__.py

@@ -0,0 +1 @@
+from .toml import read_from_toml

mcli/ml/__init__.py

@@ -0,0 +1,16 @@
+"""MCLI Machine Learning Module for Stock Recommendation System"""
+
+from .configs.dvc_config import get_dvc_config, setup_dvc
+from .configs.mlflow_config import get_mlflow_config, setup_mlflow
+from .configs.mlops_manager import MLOpsManager, get_mlops_manager
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "get_mlops_manager",
+    "MLOpsManager",
+    "get_mlflow_config",
+    "setup_mlflow",
+    "get_dvc_config",
+    "setup_dvc",
+]

mcli/ml/api/__init__.py

@@ -0,0 +1,31 @@
+"""API routes and endpoints for ML system"""
+
+from .routers import (
+    auth_router,
+    model_router,
+    prediction_router,
+    portfolio_router,
+    data_router,
+    trade_router,
+    backtest_router,
+    monitoring_router,
+    admin_router,
+    websocket_router,
+)
+
+from .app import create_app, get_application
+
+__all__ = [
+    "auth_router",
+    "model_router",
+    "prediction_router",
+    "portfolio_router",
+    "data_router",
+    "trade_router",
+    "backtest_router",
+    "monitoring_router",
+    "admin_router",
+    "websocket_router",
+    "create_app",
+    "get_application",
+]

mcli/ml/api/routers/__init__.py

@@ -0,0 +1,27 @@
+"""API routers"""
+
+from . import (
+    auth_router,
+    model_router,
+    prediction_router,
+    portfolio_router,
+    data_router,
+    trade_router,
+    backtest_router,
+    monitoring_router,
+    admin_router,
+    websocket_router,
+)
+
+__all__ = [
+    "auth_router",
+    "model_router",
+    "prediction_router",
+    "portfolio_router",
+    "data_router",
+    "trade_router",
+    "backtest_router",
+    "monitoring_router",
+    "admin_router",
+    "websocket_router",
+]

mcli/ml/auth/__init__.py

@@ -0,0 +1,45 @@
+"""Authentication and authorization system"""
+
+from .auth_manager import (
+    AuthManager,
+    create_access_token,
+    verify_access_token,
+    get_current_user,
+    get_current_active_user,
+    require_role,
+    hash_password,
+    verify_password,
+)
+from .models import (
+    UserCreate,
+    UserLogin,
+    UserResponse,
+    TokenResponse,
+    PasswordReset,
+    PasswordChange,
+)
+from .permissions import (
+    Permission,
+    check_permission,
+    has_permission,
+)
+
+__all__ = [
+    "AuthManager",
+    "create_access_token",
+    "verify_access_token",
+    "get_current_user",
+    "get_current_active_user",
+    "require_role",
+    "hash_password",
+    "verify_password",
+    "UserCreate",
+    "UserLogin",
+    "UserResponse",
+    "TokenResponse",
+    "PasswordReset",
+    "PasswordChange",
+    "Permission",
+    "check_permission",
+    "has_permission",
+]