vnai 2.0.2__py3-none-any.whl → 2.0.4__py3-none-any.whl

vnai/scope/promo.py

@@ -1,55 +1,170 @@
-_G='init'
-_F='simple'
-_E='markdown'
-_D=True
-_C=None
-_B='terminal'
-_A='html'
+"""
+Promo module for vnai: fetches and presents promotional content periodically or on demand,
+using logging instead of printing to avoid polluting stdout for AI tools.
+"""
+import logging
 import requests
 from datetime import datetime
-import random,threading,time,urllib.parse
+import random
+import threading
+import time
+import urllib.parse
+
+# Module-level logger setup
+logger = logging.getLogger(__name__)
+if not logger.hasHandlers():
+    # Add a simple stream handler that only outputs the message text
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter('%(message)s'))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 class ContentManager:
-	_instance=_C;_lock=threading.Lock()
-	def __new__(A):
-		with A._lock:
-			if A._instance is _C:A._instance=super(ContentManager,A).__new__(A);A._instance._initialize()
-			return A._instance
-	def _initialize(A):A.last_display=0;A.display_interval=86400;A.content_base_url='https://vnstock-beam.hf.space/content-delivery';A.target_url='https://vnstocks.com/lp-khoa-hoc-python-chung-khoan';A.image_url='https://vnstocks.com/img/trang-chu-vnstock-python-api-phan-tich-giao-dich-chung-khoan.jpg';A._start_periodic_display()
-	def _start_periodic_display(A):
-		def B():
-			while _D:
-				B=random.randint(7200,21600);time.sleep(B);C=time.time()
-				if C-A.last_display>=A.display_interval:A.present_content(context='periodic')
-		C=threading.Thread(target=B,daemon=_D);C.start()
-	def fetch_remote_content(B,context=_G,html=_D):
-		try:
-			C={'context':context,_A:'true'if html else'false'};D=f"{B.content_base_url}?{urllib.parse.urlencode(C)}";A=requests.get(D,timeout=3)
-			if A.status_code==200:return A.text
-			return
-		except:return
-	def present_content(C,environment=_C,context=_G):
-		I='jupyter';H='unknown';E=context;A=environment;C.last_display=time.time()
-		if A is _C:
-			try:from vnai.scope.profile import inspector as J;A=J.examine().get('environment',H)
-			except:A=H
-		if A==I:B=C.fetch_remote_content(context=E,html=_D)
-		else:B=C.fetch_remote_content(context=E,html=False)
-		D=C._generate_fallback_content(E)
-		if A==I:
-			try:
-				from IPython.display import display as F,HTML as G,Markdown as K
-				if B:F(G(B))
-				else:
-					try:F(K(D[_E]))
-					except:F(G(D[_A]))
-			except:pass
-		elif A==_B:
-			if B:print(B)
-			else:print(D[_B])
-		else:print(D[_F])
-	def _generate_fallback_content(B,context):
-		A={_A:'',_E:'',_B:'',_F:''}
-		if context=='loop':A[_A]=f'''
+    """
+    Singleton manager to fetch remote or fallback promotional content and
+    present it in different environments (Jupyter, terminal, other).
+
+    Displays content automatically at randomized intervals via a background thread.
+    """
+    _instance = None
+    _lock = threading.Lock()
+
+    def __new__(cls):
+        """
+        Ensure only one instance of ContentManager is created (thread-safe).
+        """
+        with cls._lock:
+            if cls._instance is None:
+                cls._instance = super(ContentManager, cls).__new__(cls)
+                cls._instance._initialize()
+            return cls._instance
+
+    def _initialize(self):
+        """
+        Internal initializer: sets up display timing, URLs, and starts the periodic display thread.
+        """
+        # Timestamp of last content display (epoch seconds)
+        self.last_display = 0
+        # Minimum interval between displays (24 hours)
+        self.display_interval = 24 * 3600
+
+        # Base endpoints for fetching remote content and linking
+        self.content_base_url = "https://vnstock-beam.hf.space/content-delivery"
+        self.target_url = "https://vnstocks.com/lp-khoa-hoc-python-chung-khoan"
+        self.image_url = (
+            "https://vnstocks.com/img/trang-chu-vnstock-python-api-phan-tich-giao-dich-chung-khoan.jpg"
+        )
+
+        # Launch the background thread to periodically present content
+        self._start_periodic_display()
+
+    def _start_periodic_display(self):
+        """
+        Launch a daemon thread that sleeps a random duration between 2–6 hours,
+        then checks if the display interval has elapsed and calls present_content.
+        """
+        def periodic_display():
+            while True:
+                # Randomize sleep to avoid synchronized requests across instances
+                sleep_time = random.randint(2 * 3600, 6 * 3600)
+                time.sleep(sleep_time)
+
+                # Present content if enough time has passed since last_display
+                current_time = time.time()
+                if current_time - self.last_display >= self.display_interval:
+                    self.present_content(context="periodic")
+
+        thread = threading.Thread(target=periodic_display, daemon=True)
+        thread.start()
+
+    def fetch_remote_content(self, context: str = "init", html: bool = True) -> str:
+        """
+        Fetch promotional content from remote service with context and format flag.
+
+        Args:
+            context: usage context (e.g., "init", "periodic", "loop").
+            html: if True, request HTML; otherwise plain text.
+
+        Returns:
+            The content string on HTTP 200, or None on failure.
+        """
+        try:
+            # Build query params and URL
+            params = {"context": context, "html": "true" if html else "false"}
+            url = f"{self.content_base_url}?{urllib.parse.urlencode(params)}"
+
+            response = requests.get(url, timeout=3)
+            if response.status_code == 200:
+                return response.text
+            # Log non-200 responses at debug level
+            logger.debug(f"Non-200 response fetching content: {response.status_code}")
+            return None
+        except Exception as e:
+            # Log exceptions without interrupting user code
+            logger.debug(f"Failed to fetch remote content: {e}")
+            return None
+
+    def present_content(self, environment: str = None, context: str = "init") -> None:
+        """
+        Present content according to the detected environment:
+        - In Jupyter: use display(HTML or Markdown).
+        - In terminal or other: log via logger.info().
+
+        Args:
+            environment: override detected environment ("jupyter", "terminal", else).
+            context: same context flag passed to fetch_remote_content and fallback logic.
+        """
+        # Update last display timestamp
+        self.last_display = time.time()
+
+        # Auto-detect environment if not provided
+        if environment is None:
+            try:
+                from vnai.scope.profile import inspector
+                environment = inspector.examine().get("environment", "unknown")
+            except Exception:
+                environment = "unknown"
+
+        # Retrieve remote or HTML/text content based on environment
+        remote_content = self.fetch_remote_content(
+            context=context, html=(environment == "jupyter")
+        )
+        # Generate fallback messages if remote fetch fails
+        fallback = self._generate_fallback_content(context)
+
+        if environment == "jupyter":
+            # Rich display in Jupyter notebooks
+            try:
+                from IPython.display import display, HTML, Markdown
+
+                if remote_content:
+                    display(HTML(remote_content))
+                else:
+                    # Try Markdown, fallback to HTML
+                    try:
+                        display(Markdown(fallback["markdown"]))
+                    except Exception:
+                        display(HTML(fallback["html"]))
+            except Exception as e:
+                logger.debug(f"Jupyter display failed: {e}")
+
+        elif environment == "terminal":
+            # Log terminal-friendly or raw content via logger
+            if remote_content:
+                logger.info(remote_content)
+            else:
+                logger.info(fallback["terminal"])
+
+        else:
+            # Generic simple message for other environments
+            logger.info(fallback["simple"])
+
+    def _generate_fallback_content(self, context):
+        fallback = {"html": "", "markdown": "", "terminal": "", "simple": ""}
+
+        if context == "loop":
+            fallback["html"] = (
+                f"""
             <div style="border: 1px solid #e74c3c; padding: 15px; border-radius: 5px; margin: 10px 0;">
                 <h3 style="color: #e74c3c;">⚠️ Bạn đang sử dụng vòng lặp với quá nhiều requests</h3>
                 <p>Để tránh bị giới hạn tốc độ và tối ưu hiệu suất:</p>
@@ -59,8 +174,40 @@ class ContentManager:
                     <li>Tham gia gói tài trợ <a href="https://vnstocks.com/insiders-program" style="color: #3498db;">Vnstock Insider</a> để tăng 5X giới hạn API</li>
                 </ul>
             </div>
-            ''';A[_E]='\n## ⚠️ Bạn đang sử dụng vòng lặp với quá nhiều requests\n\nĐể tránh bị giới hạn tốc độ và tối ưu hiệu suất:\n* Thêm thời gian chờ giữa các lần gọi API\n* Sử dụng xử lý theo batch thay vì lặp liên tục\n* Tham gia gói tài trợ [Vnstock Insider](https://vnstocks.com/insiders-program) để tăng 5X giới hạn API\n            ';A[_B]='\n╔═════════════════════════════════════════════════════════════════╗\n║                                                                 ║\n║   🚫 ĐANG BỊ CHẶN BỞI GIỚI HẠN API? GIẢI PHÁP Ở ĐÂY!            ║\n║                                                                 ║\n║   ✓ Tăng ngay 500% tốc độ gọi API - Không còn lỗi RateLimit     ║\n║   ✓ Tiết kiệm 85% thời gian chờ đợi giữa các request            ║\n║                                                                 ║\n║   ➤ NÂNG CẤP NGAY VỚI GÓI TÀI TRỢ VNSTOCK:                      ║\n║     https://vnstocks.com/insiders-program                       ║\n║                                                                 ║\n╚═════════════════════════════════════════════════════════════════╝\n            ';A[_F]='🚫 Đang bị giới hạn API? Tăng tốc độ gọi API lên 500% với gói Vnstock Insider: https://vnstocks.com/insiders-program'
-		else:A[_A]=f'''
+            """
+            )
+            fallback["markdown"] = (
+                """
+## ⚠️ Bạn đang sử dụng vòng lặp với quá nhiều requests
+
+Để tránh bị giới hạn tốc độ và tối ưu hiệu suất:
+* Thêm thời gian chờ giữa các lần gọi API
+* Sử dụng xử lý theo batch thay vì lặp liên tục
+* Tham gia gói tài trợ [Vnstock Insider](https://vnstocks.com/insiders-program) để tăng 5X giới hạn API
+            """
+            )
+            fallback["terminal"] = (
+                """
+╔═════════════════════════════════════════════════════════════════╗
+║                                                                 ║
+║   🚫 ĐANG BỊ CHẶN BỞI GIỚI HẠN API? GIẢI PHÁP Ở ĐÂY!            ║
+║                                                                 ║
+║   ✓ Tăng ngay 500% tốc độ gọi API - Không còn lỗi RateLimit     ║
+║   ✓ Tiết kiệm 85% thời gian chờ đợi giữa các request            ║
+║                                                                 ║
+║   ➤ NÂNG CẤP NGAY VỚI GÓI TÀI TRỢ VNSTOCK:                      ║
+║     https://vnstocks.com/insiders-program                       ║
+║                                                                 ║
+╚═════════════════════════════════════════════════════════════════╝
+                """
+            )
+            fallback["simple"] = (
+                "🚫 Đang bị giới hạn API? Tăng tốc độ gọi API lên 500% với gói "
+                "Vnstock Insider: https://vnstocks.com/insiders-program"
+            )
+        else:
+            fallback["html"] = (
+                f"""
             <div style="border: 1px solid #3498db; padding: 15px; border-radius: 5px; margin: 10px 0;">
                 <h3 style="color: #3498db;">👋 Chào mừng bạn đến với Vnstock!</h3>
                 <p>Cảm ơn bạn đã sử dụng thư viện phân tích chứng khoán #1 tại Việt Nam cho Python</p>
@@ -70,7 +217,54 @@ class ContentManager:
                 </ul>
                 <p>Khám phá các tính năng mới nhất và tham gia cộng đồng để nhận hỗ trợ.</p>
             </div>
-            ''';A[_E]='\n## 👋 Chào mừng bạn đến với Vnstock!\n\nCảm ơn bạn đã sử dụng package phân tích chứng khoán #1 tại Việt Nam\n\n* Tài liệu: [vnstocks.com/docs](https://vnstocks.com/docs)\n* Cộng đồng: [vnstocks.com/community](https://vnstocks.com/community)\n\nKhám phá các tính năng mới nhất và tham gia cộng đồng để nhận hỗ trợ.\n            ';A[_B]='\n╔══════════════════════════════════════════════════════════╗\n║                                                          ║\n║  👋 Chào mừng bạn đến với Vnstock!                       ║\n║                                                          ║\n║  Cảm ơn bạn đã sử dụng package phân tích                 ║\n║  chứng khoán #1 tại Việt Nam                             ║\n║                                                          ║\n║  ✓ Tài liệu: https://vnstocks.com/docs                   ║\n║  ✓ Cộng đồng: https://vnstocks.com/community             ║\n║                                                          ║\n║  Khám phá các tính năng mới nhất và tham gia             ║\n║  cộng đồng để nhận hỗ trợ.                               ║\n║                                                          ║\n╚══════════════════════════════════════════════════════════╝\n            ';A[_F]='👋 Chào mừng bạn đến với Vnstock! Tài liệu: https://vnstocks.com/docs | Cộng đồng: https://vnstocks.com/community'
-		return A
-manager=ContentManager()
-def present(context=_G):return manager.present_content(context=context)
+            """
+            )
+            fallback["markdown"] = (
+                """
+## 👋 Chào mừng bạn đến với Vnstock!
+
+Cảm ơn bạn đã sử dụng package phân tích chứng khoán #1 tại Việt Nam
+
+* Tài liệu: [Sổ tay hướng dẫn](https://vnstocks.com/docs/category/s%E1%BB%95-tay-h%C6%B0%E1%BB%9Bng-d%E1%BA%ABn)
+* Cộng đồng: [Nhóm Facebook](https://www.facebook.com/groups/vnstock.official)
+
+Khám phá các tính năng mới nhất và tham gia cộng đồng để nhận hỗ trợ.
+                """
+            )
+            fallback["terminal"] = (
+                """
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║  👋 Chào mừng bạn đến với Vnstock!                       ║
+║                                                          ║
+║  Cảm ơn bạn đã sử dụng package phân tích                 ║
+║  chứng khoán #1 tại Việt Nam                             ║
+║                                                          ║
+║  ✓ Tài liệu: https://vnstocks.com/docs/category/s%E1%BB%95-tay-h%C6%B0%E1%BB%9Bng-d%E1%BA%ABn             ║
+║  ✓ Cộng đồng: https://www.facebook.com/groups/vnstock.official             ║
+║                                                          ║
+║  Khám phá các tính năng mới nhất và tham gia             ║
+║  cộng đồng để nhận hỗ trợ.                               ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+                """
+            )
+            fallback["simple"] = (
+                "👋 Chào mừng bạn đến với Vnstock! "
+                "Tài liệu: https://vnstocks.com/docs/tai-lieu/huong-dan-nhanh | "
+                "Cộng đồng: https://www.facebook.com/groups/vnstock.official"
+            )
+        return fallback
+
+# Singleton instance for module-level use
+manager = ContentManager()
+
+
+def present(context: str = "init") -> None:
+    """
+    Shortcut to ContentManager.present_content for external callers.
+
+    Args:
+        context: propagate context string to ContentManager.
+    """
+    return manager.present_content(context=context)

vnai/scope/state.py

@@ -1,74 +1,223 @@
-_L='minimal'
-_K='warnings'
-_J='api_requests'
-_I='last_error_time'
-_H='startup_time'
-_G='standard'
-_F='function_calls'
-_E='peak_memory'
-_D='errors'
-_C=True
-_B=None
-_A='execution_times'
-import time,threading,json,os
+# vnai/scope/state.py
+# System state tracking
+
+import time
+import threading
+import json
+import os
 from datetime import datetime
 from pathlib import Path
+
 class Tracker:
-	_instance=_B;_lock=threading.Lock()
-	def __new__(A):
-		with A._lock:
-			if A._instance is _B:A._instance=super(Tracker,A).__new__(A);A._instance._initialize()
-			return A._instance
-	def _initialize(A):A.metrics={_H:datetime.now().isoformat(),_F:0,_J:0,_D:0,_K:0};A.performance_metrics={_A:[],_I:_B,_E:0};A.privacy_level=_G;A.home_dir=Path.home();A.project_dir=A.home_dir/'.vnstock';A.project_dir.mkdir(exist_ok=_C);A.data_dir=A.project_dir/'data';A.data_dir.mkdir(exist_ok=_C);A.metrics_path=A.data_dir/'usage_metrics.json';A.privacy_config_path=A.project_dir/'config'/'privacy.json';os.makedirs(os.path.dirname(A.privacy_config_path),exist_ok=_C);A._load_metrics();A._load_privacy_settings();A._start_background_collector()
-	def _load_metrics(A):
-		if A.metrics_path.exists():
-			try:
-				with open(A.metrics_path,'r')as C:D=json.load(C)
-				for(B,E)in D.items():
-					if B in A.metrics:A.metrics[B]=E
-			except:pass
-	def _save_metrics(A):
-		try:
-			with open(A.metrics_path,'w')as B:json.dump(A.metrics,B)
-		except:pass
-	def _load_privacy_settings(A):
-		if A.privacy_config_path.exists():
-			try:
-				with open(A.privacy_config_path,'r')as B:C=json.load(B);A.privacy_level=C.get('level',_G)
-			except:pass
-	def setup_privacy(B,level=_B):
-		A=level;C={_L:'Essential system data only',_G:'Performance metrics and errors','enhanced':'Detailed operation analytics'}
-		if A is _B:A=_G
-		if A not in C:raise ValueError(f"Invalid privacy level: {A}. Choose from {', '.join(C.keys())}")
-		B.privacy_level=A
-		with open(B.privacy_config_path,'w')as D:json.dump({'level':A},D)
-		return A
-	def get_privacy_level(A):return A.privacy_level
-	def _start_background_collector(A):
-		def B():
-			while _C:
-				try:
-					import psutil as C;D=C.Process();E=D.memory_info();B=E.rss/1048576
-					if B>A.performance_metrics[_E]:A.performance_metrics[_E]=B
-					A._save_metrics()
-				except:pass
-				time.sleep(300)
-		C=threading.Thread(target=B,daemon=_C);C.start()
-	def record(A,event_type,data=_B):
-		D='execution_time';C=data;B=event_type
-		if A.privacy_level==_L and B!=_D:return _C
-		if B in A.metrics:A.metrics[B]+=1
-		else:A.metrics[B]=1
-		if B==_D:A.performance_metrics[_I]=datetime.now().isoformat()
-		if B==_F and C and D in C:
-			A.performance_metrics[_A].append(C[D])
-			if len(A.performance_metrics[_A])>100:A.performance_metrics[_A]=A.performance_metrics[_A][-100:]
-		if A.metrics[_F]%100==0 or B==_D:A._save_metrics()
-		return _C
-	def get_metrics(A):
-		B=0
-		if A.performance_metrics[_A]:B=sum(A.performance_metrics[_A])/len(A.performance_metrics[_A])
-		C=A.metrics.copy();C.update({'avg_execution_time':B,'peak_memory_mb':A.performance_metrics[_E],'uptime':(datetime.now()-datetime.fromisoformat(A.metrics[_H])).total_seconds(),'privacy_level':A.privacy_level});return C
-	def reset(A):A.metrics={_H:datetime.now().isoformat(),_F:0,_J:0,_D:0,_K:0};A.performance_metrics={_A:[],_I:_B,_E:0};A._save_metrics();return _C
-tracker=Tracker()
-def record(event_type,data=_B):return tracker.record(event_type,data)
+    """Tracks system state and performance metrics"""
+    
+    _instance = None
+    _lock = threading.Lock()
+    
+    def __new__(cls):
+        with cls._lock:
+            if cls._instance is None:
+                cls._instance = super(Tracker, cls).__new__(cls)
+                cls._instance._initialize()
+            return cls._instance
+    
+    def _initialize(self):
+        """Initialize tracker"""
+        self.metrics = {
+            "startup_time": datetime.now().isoformat(),
+            "function_calls": 0,
+            "api_requests": 0,
+            "errors": 0,
+            "warnings": 0
+        }
+        
+        self.performance_metrics = {
+            "execution_times": [],
+            "last_error_time": None,
+            "peak_memory": 0
+        }
+        
+        self.privacy_level = "standard"
+        
+        # Setup data directory
+        self.home_dir = Path.home()
+        self.project_dir = self.home_dir / ".vnstock"
+        self.project_dir.mkdir(exist_ok=True)
+        self.data_dir = self.project_dir / 'data'
+        self.data_dir.mkdir(exist_ok=True)
+        self.metrics_path = self.data_dir / "usage_metrics.json"
+        self.privacy_config_path = self.project_dir / 'config' / "privacy.json"
+        
+        # Create config directory if it doesn't exist
+        os.makedirs(os.path.dirname(self.privacy_config_path), exist_ok=True)
+        
+        # Load existing metrics
+        self._load_metrics()
+        
+        # Load privacy settings
+        self._load_privacy_settings()
+        
+        # Start background metrics collector
+        self._start_background_collector()
+    
+    def _load_metrics(self):
+        """Load metrics from file"""
+        if self.metrics_path.exists():
+            try:
+                with open(self.metrics_path, 'r') as f:
+                    stored_metrics = json.load(f)
+                    
+                # Update metrics with stored values
+                for key, value in stored_metrics.items():
+                    if key in self.metrics:
+                        self.metrics[key] = value
+            except:
+                pass
+    
+    def _save_metrics(self):
+        """Save metrics to file"""
+        try:
+            with open(self.metrics_path, 'w') as f:
+                json.dump(self.metrics, f)
+        except:
+            pass
+    
+    def _load_privacy_settings(self):
+        """Load privacy settings"""
+        if self.privacy_config_path.exists():
+            try:
+                with open(self.privacy_config_path, 'r') as f:
+                    settings = json.load(f)
+                    self.privacy_level = settings.get("level", "standard")
+            except:
+                pass
+    
+    def setup_privacy(self, level=None):
+        """Configure privacy level for data collection"""
+        privacy_levels = {
+            "minimal": "Essential system data only",
+            "standard": "Performance metrics and errors",
+            "enhanced": "Detailed operation analytics" 
+        }
+        
+        if level is None:
+            # Default level
+            level = "standard"
+        
+        if level not in privacy_levels:
+            raise ValueError(f"Invalid privacy level: {level}. Choose from {', '.join(privacy_levels.keys())}")
+        
+        # Store preference
+        self.privacy_level = level
+        
+        # Store in configuration file
+        with open(self.privacy_config_path, "w") as f:
+            json.dump({"level": level}, f)
+        
+        return level
+    
+    def get_privacy_level(self):
+        """Get current privacy level"""
+        return self.privacy_level
+    
+    def _start_background_collector(self):
+        """Start background metrics collection"""
+        def collect_metrics():
+            while True:
+                try:
+                    import psutil
+                    
+                    # Update peak memory
+                    current_process = psutil.Process()
+                    memory_info = current_process.memory_info()
+                    memory_usage = memory_info.rss / (1024 * 1024)  # MB
+                    
+                    if memory_usage > self.performance_metrics["peak_memory"]:
+                        self.performance_metrics["peak_memory"] = memory_usage
+                        
+                    # Save metrics periodically
+                    self._save_metrics()
+                    
+                except:
+                    pass
+                    
+                time.sleep(300)  # Run every 5 minutes
+        
+        # Start thread
+        thread = threading.Thread(target=collect_metrics, daemon=True)
+        thread.start()
+    
+    def record(self, event_type, data=None):
+        """Record an event"""
+        # Check privacy level
+        if self.privacy_level == "minimal" and event_type != "errors":
+            # In minimal mode, only track errors
+            return True
+            
+        # Update counts
+        if event_type in self.metrics:
+            self.metrics[event_type] += 1
+        else:
+            self.metrics[event_type] = 1
+            
+        # Special handling for errors
+        if event_type == "errors":
+            self.performance_metrics["last_error_time"] = datetime.now().isoformat()
+            
+        # Special handling for function calls with timing data
+        if event_type == "function_calls" and data and "execution_time" in data:
+            # Keep up to 100 latest execution times
+            self.performance_metrics["execution_times"].append(data["execution_time"])
+            if len(self.performance_metrics["execution_times"]) > 100:
+                self.performance_metrics["execution_times"] = self.performance_metrics["execution_times"][-100:]
+                
+        # Save if metrics change significantly
+        if self.metrics["function_calls"] % 100 == 0 or event_type == "errors":
+            self._save_metrics()
+            
+        return True
+    
+    def get_metrics(self):
+        """Get current metrics"""
+        # Calculate derived metrics
+        avg_execution_time = 0
+        if self.performance_metrics["execution_times"]:
+            avg_execution_time = sum(self.performance_metrics["execution_times"]) / len(self.performance_metrics["execution_times"])
+            
+        # Add derived metrics to output
+        output = self.metrics.copy()
+        output.update({
+            "avg_execution_time": avg_execution_time,
+            "peak_memory_mb": self.performance_metrics["peak_memory"],
+            "uptime": (datetime.now() - datetime.fromisoformat(self.metrics["startup_time"])).total_seconds(),
+            "privacy_level": self.privacy_level
+        })
+        
+        return output
+    
+    def reset(self):
+        """Reset metrics"""
+        self.metrics = {
+            "startup_time": datetime.now().isoformat(),
+            "function_calls": 0,
+            "api_requests": 0,
+            "errors": 0,
+            "warnings": 0
+        }
+        
+        self.performance_metrics = {
+            "execution_times": [],
+            "last_error_time": None,
+            "peak_memory": 0
+        }
+        
+        self._save_metrics()
+        return True
+
+# Create singleton instance
+tracker = Tracker()
+
+
+def record(event_type, data=None):
+    """Record an event"""
+    return tracker.record(event_type, data)

{vnai-2.0.2.dist-info → vnai-2.0.4.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: vnai
-Version: 2.0.2
+Version: 2.0.4
 Summary: System optimization and resource management toolkit
-Home-page: https://github.com/yourusername/vnai
-Author: Your Name
-Author-email: your.email@example.com
+Home-page: https://github.com/vnstock-hq/initialization/new/main
+Author: Vnstock HQ
+Author-email: support@vnstocks.com
 License: MIT
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -17,7 +17,6 @@ Requires-Dist: requests>=2.25.0
 Requires-Dist: psutil>=5.8.0
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0.0; extra == "dev"
-Requires-Dist: black>=21.5b2; extra == "dev"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

vnai-2.0.4.dist-info/RECORD

@@ -0,0 +1,16 @@
+vnai/__init__.py,sha256=ClnS_1T23BjbzejrIW4KTsAVBhXuq9bjDUcRP5AIcPo,9082
+vnai/beam/__init__.py,sha256=xKb_iu9aAPXCulI7dENrvqVIhelSD1mIqKE9Go3GAHw,200
+vnai/beam/metrics.py,sha256=xVmVw93yhKeWzRZJurmrD9mWur16HyLJl_p1XqMwW_w,7187
+vnai/beam/pulse.py,sha256=jp1YwjLaMhne2nYhM5PofveDsdrSp2YtewQ2jjE78Is,3470
+vnai/beam/quota.py,sha256=yP5_Z62QJwOoCEgqqWuNkzm1Dar70UiJsu6W27LNqiw,21218
+vnai/flow/__init__.py,sha256=K3OeabzAWGrdPgTAOlDqrJh2y9aQW2pgLZg8tblN3ho,147
+vnai/flow/queue.py,sha256=b9YKUbiXDZRC3fVgEnA77EO0EMXAi8eCoBkHnAUI5Sc,4162
+vnai/flow/relay.py,sha256=RtIPRZ3BlQd-XgTbisJg0iC1HqikAjHGyyo8aTj_fUw,15766
+vnai/scope/__init__.py,sha256=overJZ_UiEfBRNcSieE1GPU_9X3oS4C5l6JeBaFFVxk,267
+vnai/scope/profile.py,sha256=6LL7Djke9F1HVA9eEExud2jZ5yGUfy9_NYt68nIj2-8,30737
+vnai/scope/promo.py,sha256=N4aWZdh92rVNovjCwuUjv-QdhoRwloPAn4Hydx4IcRs,12515
+vnai/scope/state.py,sha256=LlcZNKBy2mcAnD765BO2Tlv3Zzbak2TOEz4RUPMCFZ8,7490
+vnai-2.0.4.dist-info/METADATA,sha256=rgGwwXBeevv4rjzJ-hLADRkGnPcuTaC3rMnSgd_WMRw,988
+vnai-2.0.4.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+vnai-2.0.4.dist-info/top_level.txt,sha256=4zI0qZHePCwvgSqXl4420sBcd0VzZn4MEcRsAIFae3k,5
+vnai-2.0.4.dist-info/RECORD,,