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

vnai/scope/promo.py

@@ -1,6 +1,4 @@
-# vnai/scope/promo.py
-# Content display mechanism for various environments
-
+import logging
 import requests
 from datetime import datetime
 import random
@@ -8,139 +6,120 @@ import threading
 import time
 import urllib.parse
 
+logger = logging.getLogger(__name__)
+if not logger.hasHandlers():
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter('%(message)s'))
+    logger.addHandler(handler)
+    logger.setLevel(logging.INFO)
+
 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.display_interval = 24 * 3600
+
+        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"
+        )
+
         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"
-            }
+            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
+            logger.debug(f"Non-200 response fetching content: {response.status_code}")
             return None
-        except:
+        except Exception as e:
+            logger.debug(f"Failed to fetch remote content: {e}")
             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 = (
+                    inspector.examine().get("environment", "unknown")
+                )
+            except Exception:
                 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)
+            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
+            remote_content = self.fetch_remote_content(
+                context=context, html=False
+            )
+
         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
+                    except Exception:
                         display(HTML(fallback_content["html"]))
-            except:
-                # If IPython display fails, do nothing
-                pass
-        
+            except Exception as e:
+                logger.debug(f"Jupyter display failed: {e}")
+
         elif environment == "terminal":
             if remote_content:
-                print(remote_content)
+                logger.info(remote_content)
             else:
-                print(fallback_content["terminal"])
-        
+                logger.info(fallback_content["terminal"])
+
         else:
-            # Simple text version for other environments
-            print(fallback_content["simple"])
-    
+            logger.info(fallback_content["simple"])
+
     def _generate_fallback_content(self, context):
-        """Generate appropriate fallback content based on context"""
-        fallback = {
-            "html": "",
-            "markdown": "",
-            "terminal": "",
-            "simple": ""
-        }
-        
+        fallback = {"html": "", "markdown": "", "terminal": "", "simple": ""}
+
         if context == "loop":
-            
-                        # Content for rate limit exceeded scenario
-            fallback["html"] = f"""
+            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>
@@ -151,8 +130,9 @@ class ContentManager:
                 </ul>
             </div>
             """
-            
-            fallback["markdown"] = """
+            )
+            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:
@@ -160,8 +140,9 @@ class ContentManager:
 * 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"] = """
+            )
+            fallback["terminal"] = (
+                """
 ╔═════════════════════════════════════════════════════════════════╗
 ║                                                                 ║
 ║   🚫 ĐANG BỊ CHẶN BỞI GIỚI HẠN API? GIẢI PHÁP Ở ĐÂY!            ║
@@ -173,13 +154,15 @@ class ContentManager:
 ║     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"""
+                """
+            )
+            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>
@@ -190,19 +173,21 @@ class ContentManager:
                 <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"] = """
+            )
+            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)
+* 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"] = """
+                """
+            )
+            fallback["terminal"] = (
+                """
 ╔══════════════════════════════════════════════════════════╗
 ║                                                          ║
 ║  👋 Chào mừng bạn đến với Vnstock!                       ║
@@ -210,27 +195,24 @@ Khám phá các tính năng mới nhất và tham gia cộng đồng để nhậ
 ║  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             ║
+║  ✓ 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 | Cộng đồng: https://vnstocks.com/community"
-            
+                """
+            )
+            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
 
-# Create singleton instance
+# Singleton instance
 manager = ContentManager()
 
-def present(context="init"):
-    """
-    Public API to present content
-    
-    Args:
-        context (str): Context for content presentation (init, loop, periodic)
-    """
+def present(context="init"):  # module-level shortcut
     return manager.present_content(context=context)

vnai/scope/state.py

@@ -1,5 +1,7 @@
-# vnai/scope/state.py
-# System state tracking
+##
+
+##
+
 
 import time
 import threading
@@ -9,7 +11,7 @@ from datetime import datetime
 from pathlib import Path
 
 class Tracker:
-    """Tracks system state and performance metrics"""
+    #--
     
     _instance = None
     _lock = threading.Lock()
@@ -22,7 +24,7 @@ class Tracker:
             return cls._instance
     
     def _initialize(self):
-        """Initialize tracker"""
+        #--
         self.metrics = {
             "startup_time": datetime.now().isoformat(),
             "function_calls": 0,
@@ -39,7 +41,8 @@ class Tracker:
         
         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)
@@ -48,26 +51,31 @@ class Tracker:
         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
@@ -75,7 +83,7 @@ class Tracker:
                 pass
     
     def _save_metrics(self):
-        """Save metrics to file"""
+        #--
         try:
             with open(self.metrics_path, 'w') as f:
                 json.dump(self.metrics, f)
@@ -83,7 +91,7 @@ class Tracker:
             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:
@@ -93,7 +101,7 @@ class Tracker:
                 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",
@@ -101,90 +109,107 @@ class Tracker:
         }
         
         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
+                    memory_usage = memory_info.rss / (1024 * 1024)  ##
+
                     
                     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
+                time.sleep(300)  ##
+
         
-        # 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,
@@ -196,7 +221,7 @@ class Tracker:
         return output
     
     def reset(self):
-        """Reset metrics"""
+        #--
         self.metrics = {
             "startup_time": datetime.now().isoformat(),
             "function_calls": 0,
@@ -214,10 +239,11 @@ class Tracker:
         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 → vnai-2.0.3.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: vnai
-Version: 2.0.1
+Version: 2.0.3
 Summary: System optimization and resource management toolkit
 Home-page: https://github.com/yourusername/vnai
 Author: Your Name
 Author-email: your.email@example.com
+License: MIT
 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
@@ -24,6 +24,7 @@ Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
 Dynamic: home-page
+Dynamic: license
 Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: requires-python

vnai-2.0.3.dist-info/RECORD

@@ -0,0 +1,16 @@
+vnai/__init__.py,sha256=SF3HcEadrvSmtotBCy8a6637UwTFiSAaAN0Azi0X4qg,7219
+vnai/beam/__init__.py,sha256=h19ZEQFnWTvqed0mpTcuQf-sT9XifWhfVbaobTEs91Q,131
+vnai/beam/metrics.py,sha256=lNYEeav5kMm8SGnlsxwz6aD3fRzOytopHhUPkUx9Avs,5950
+vnai/beam/pulse.py,sha256=-rN4tbcgNKmA74P2ThVkQqxabG0-UlhfRbFCyYPvKFw,2920
+vnai/beam/quota.py,sha256=DRlqZpztppdFDJymuJS6VCKLHZrkI_PX8cUtStHDSFM,16934
+vnai/flow/__init__.py,sha256=VW6R7c30M4q8PhOUqXyHwWlmk1BwPrYvcxtLFI0fWJo,91
+vnai/flow/queue.py,sha256=0R6LjF6PSUz37JV2SnsOQMBHps3bG5c0BGfEOUIPhcA,3650
+vnai/flow/relay.py,sha256=wIRojuZKQ5Jk1N-p2PkA9fkx-F7kwgVu0JIc0Iya5aw,13783
+vnai/scope/__init__.py,sha256=yB0qWMlKd2ix5tFlBcRPX6SYR1O8Di0mwgQC15u8l2o,207
+vnai/scope/profile.py,sha256=tIy39_FpcNKZCg3Dy5mgy0jdLQCH2FK2nfvUlTM72wM,26781
+vnai/scope/promo.py,sha256=NlKcyadl6BlOr2TMlKkdri4dkm8xIoI_3Z05ErcVnGo,9930
+vnai/scope/state.py,sha256=XUhuXNx1W6pce5vRY3IkSrR__MGetRo8lQt1bQIAOLM,6550
+vnai-2.0.3.dist-info/METADATA,sha256=IlnWkYA8m9Rxjyfu7JCgpwJw0C7ldherJqhQnAdRrug,1017
+vnai-2.0.3.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+vnai-2.0.3.dist-info/top_level.txt,sha256=4zI0qZHePCwvgSqXl4420sBcd0VzZn4MEcRsAIFae3k,5
+vnai-2.0.3.dist-info/RECORD,,

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

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

vnai-2.0.1.dist-info/RECORD

@@ -1,16 +0,0 @@
-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,,