vnai 0.1.4__py3-none-any.whl → 2.0.1__py3-none-any.whl

vnai/scope/promo.py

@@ -0,0 +1,236 @@
+# vnai/scope/promo.py
+# Content display mechanism for various environments
+
+import requests
+from datetime import datetime
+import random
+import threading
+import time
+import urllib.parse
+
+class ContentManager:
+    """Manages content display across different environments"""
+    
+    _instance = None
+    _lock = threading.Lock()
+    
+    def __new__(cls):
+        with cls._lock:
+            if cls._instance is None:
+                cls._instance = super(ContentManager, cls).__new__(cls)
+                cls._instance._initialize()
+            return cls._instance
+    
+    def _initialize(self):
+        """Initialize content manager"""
+        self.last_display = 0
+        self.display_interval = 24 * 3600  # Once per day by default
+        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"
+        
+        # Start periodic display thread
+        self._start_periodic_display()
+    
+    def _start_periodic_display(self):
+        """Start thread for occasional content display"""
+        def periodic_display():
+            while True:
+                # Sleep for a random time between 2-6 hours
+                sleep_time = random.randint(2 * 3600, 6 * 3600)
+                time.sleep(sleep_time)
+                
+                # Only show 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")
+        
+        # Start thread as daemon so it doesn't prevent program exit
+        thread = threading.Thread(target=periodic_display, daemon=True)
+        thread.start()
+    
+    def fetch_remote_content(self, context="init", html=True):
+        """
+        Fetch content from remote source
+        
+        Args:
+            context (str): Context of the content request (init, loop, periodic, etc.)
+            html (bool): Whether to request HTML content (True) or plain text (False)
+        """
+        try:
+            # Build the URL with query parameters
+            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
+            return None
+        except:
+            return None
+    
+    def present_content(self, environment=None, context="init"):
+        """
+        Present content appropriate for the environment and context
+        
+        Args:
+            environment (str): The display environment (jupyter, terminal, etc.)
+            context (str): The context for content (init, loop, periodic)
+        """
+        # Update last display time
+        self.last_display = time.time()
+        
+        # Get environment if not provided
+        if environment is None:
+            try:
+                from vnai.scope.profile import inspector
+                environment = inspector.examine().get("environment", "unknown")
+            except:
+                environment = "unknown"
+        
+        # Try to fetch remote content based on context and environment
+        if environment == "jupyter":
+            remote_content = self.fetch_remote_content(context=context, html=True)
+        else:
+            remote_content = self.fetch_remote_content(context=context, html=False)
+        
+        # Generate fallback content based on context
+        fallback_content = self._generate_fallback_content(context)
+        
+        # Display based on environment
+        if environment == "jupyter":
+            try:
+                from IPython.display import display, HTML, Markdown
+                if remote_content:
+                    # Use remote content if available
+                    display(HTML(remote_content))
+                else:
+                    # Try markdown version first
+                    try:
+                        display(Markdown(fallback_content["markdown"]))
+                    except:
+                        # Fall back to HTML if markdown fails
+                        display(HTML(fallback_content["html"]))
+            except:
+                # If IPython display fails, do nothing
+                pass
+        
+        elif environment == "terminal":
+            if remote_content:
+                print(remote_content)
+            else:
+                print(fallback_content["terminal"])
+        
+        else:
+            # Simple text version for other environments
+            print(fallback_content["simple"])
+    
+    def _generate_fallback_content(self, context):
+        """Generate appropriate fallback content based on context"""
+        fallback = {
+            "html": "",
+            "markdown": "",
+            "terminal": "",
+            "simple": ""
+        }
+        
+        if context == "loop":
+            
+                        # Content for rate limit exceeded scenario
+            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>
+                <ul>
+                    <li>Thêm thời gian chờ giữa các lần gọi API</li>
+                    <li>Sử dụng xử lý theo batch thay vì lặp liên tục</li>
+                    <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>
+            """
+            
+            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:  # init or periodic or default
+            # General welcome content
+            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>
+                <ul>
+                    <li>Tài liệu: <a href="https://vnstocks.com/docs/category/s%E1%BB%95-tay-h%C6%B0%E1%BB%9Bng-d%E1%BA%ABn" style="color: #3498db;">vnstocks.com/docs</a></li>
+                    <li>Cộng đồng: <a href="https://www.facebook.com/groups/vnstock.official" style="color: #3498db;">vnstocks.com/community</a></li>
+                </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>
+            """
+            
+            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: [vnstocks.com/docs](https://vnstocks.com/docs)
+* Cộng đồng: [vnstocks.com/community](https://vnstocks.com/community)
+
+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                   ║
+║  ✓ Cộng đồng: https://vnstocks.com/community             ║
+║                                                          ║
+║  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 | Cộng đồng: https://vnstocks.com/community"
+            
+        return fallback
+
+# Create singleton instance
+manager = ContentManager()
+
+def present(context="init"):
+    """
+    Public API to present content
+    
+    Args:
+        context (str): Context for content presentation (init, loop, periodic)
+    """
+    return manager.present_content(context=context)

vnai/scope/state.py

@@ -0,0 +1,223 @@
+# 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:
+    """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.1.dist-info/METADATA

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: vnai
+Version: 2.0.1
+Summary: System optimization and resource management toolkit
+Home-page: https://github.com/yourusername/vnai
+Author: Your Name
+Author-email: your.email@example.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+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
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+System resource management and performance optimization toolkit

vnai-2.0.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+vnai/__init__.py,sha256=iqCNvUVrP6JVFk5jBnCLpVyZdBSZkcfkzu64JNEijis,8895
+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=I2rUC3z5s5ni9yTU8Vj7mpMA2uPGMT64s9PwbJUsr7s,20798
+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=xKEqDAaeZvRZMn1YK8qS6ILz7DRYxRkd_IJxLm7O-cs,30738
+vnai/scope/promo.py,sha256=bIVok3eW3GXGGu-OdDeMggrvC_JfpT6blYVJuj35k7s,11031
+vnai/scope/state.py,sha256=LlcZNKBy2mcAnD765BO2Tlv3Zzbak2TOEz4RUPMCFZ8,7490
+vnai-2.0.1.dist-info/METADATA,sha256=9gyeWPMPAoIUmQPeeyow2USwrGO3Ir8Q3ivMNalh40o,1038
+vnai-2.0.1.dist-info/WHEEL,sha256=tTnHoFhvKQHCh4jz3yCn0WPTYIy7wXx3CJtJ7SJGV7c,91
+vnai-2.0.1.dist-info/top_level.txt,sha256=4zI0qZHePCwvgSqXl4420sBcd0VzZn4MEcRsAIFae3k,5
+vnai-2.0.1.dist-info/RECORD,,

{vnai-0.1.4.dist-info → vnai-2.0.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.6.0)
+Generator: setuptools (77.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

vnai-0.1.4.dist-info/METADATA

@@ -1,19 +0,0 @@
-Metadata-Version: 2.1
-Name: vnai
-Version: 0.1.4
-Summary: :))
-Author: Vnstock HQ
-Author-email: support@vnstock.site
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Requires-Dist: requests
-Requires-Dist: cryptography
-Requires-Dist: psutil
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"

vnai-0.1.4.dist-info/RECORD

@@ -1,5 +0,0 @@
-vnai/__init__.py,sha256=k6Qn1-1DeiTMHs0TZk4tLwLzAb35qxcjhjg4fJQ046A,12245
-vnai-0.1.4.dist-info/METADATA,sha256=tosZBcT5xYtgGkkKCyPf77H9LsqA0ja04vg-zByIcrQ,631
-vnai-0.1.4.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-vnai-0.1.4.dist-info/top_level.txt,sha256=4zI0qZHePCwvgSqXl4420sBcd0VzZn4MEcRsAIFae3k,5
-vnai-0.1.4.dist-info/RECORD,,