crawlo 1.1.4__py3-none-any.whl → 1.1.5__py3-none-any.whl

crawlo/extension/logging_extension.py

@@ -1,44 +1,44 @@
-from typing import Any
-from crawlo.exceptions import NotConfigured
-from crawlo.utils.log import get_logger
-from crawlo.utils.log import LoggerManager
-
-
-class CustomLoggerExtension:
-    """
-    日志系统初始化扩展
-    遵循与 ExtensionManager 一致的接口规范：使用 create_instance
-    """
-
-    def __init__(self, settings: Any):
-        self.settings = settings
-        # 初始化全局日志配置
-        LoggerManager.configure(settings)
-
-    @classmethod
-    def create_instance(cls, crawler: Any, *args: Any, **kwargs: Any) -> 'CustomLoggerExtension':
-        """
-        工厂方法：兼容 ExtensionManager 的创建方式
-        被 ExtensionManager 调用
-        """
-        # 可以通过 settings 控制是否启用
-        log_file = crawler.settings.get('LOG_FILE')
-        log_enable_custom = crawler.settings.get('LOG_ENABLE_CUSTOM', False)
-        
-        # 只有当没有配置日志文件且未启用自定义日志时才禁用
-        if not log_file and not log_enable_custom:
-            raise NotConfigured("CustomLoggerExtension: LOG_FILE not set and LOG_ENABLE_CUSTOM=False")
-
-        return cls(crawler.settings)
-
-    def spider_opened(self, spider: Any) -> None:
-        logger = get_logger(__name__)
-        try:
-            logger.info(
-                f"CustomLoggerExtension: Logging initialized. "
-                f"LOG_FILE={self.settings.get('LOG_FILE')}, "
-                f"LOG_LEVEL={self.settings.get('LOG_LEVEL')}"
-            )
-        except Exception as e:
-            # 即使日志初始化信息无法打印，也不应该影响程序运行
+from typing import Any
+from crawlo.exceptions import NotConfigured
+from crawlo.utils.log import get_logger
+from crawlo.utils.log import LoggerManager
+
+
+class CustomLoggerExtension:
+    """
+    日志系统初始化扩展
+    遵循与 ExtensionManager 一致的接口规范：使用 create_instance
+    """
+
+    def __init__(self, settings: Any):
+        self.settings = settings
+        # 初始化全局日志配置
+        LoggerManager.configure(settings)
+
+    @classmethod
+    def create_instance(cls, crawler: Any, *args: Any, **kwargs: Any) -> 'CustomLoggerExtension':
+        """
+        工厂方法：兼容 ExtensionManager 的创建方式
+        被 ExtensionManager 调用
+        """
+        # 可以通过 settings 控制是否启用
+        log_file = crawler.settings.get('LOG_FILE')
+        log_enable_custom = crawler.settings.get('LOG_ENABLE_CUSTOM', False)
+        
+        # 只有当没有配置日志文件且未启用自定义日志时才禁用
+        if not log_file and not log_enable_custom:
+            raise NotConfigured("CustomLoggerExtension: LOG_FILE not set and LOG_ENABLE_CUSTOM=False")
+
+        return cls(crawler.settings)
+
+    def spider_opened(self, spider: Any) -> None:
+        logger = get_logger(__name__)
+        try:
+            logger.info(
+                f"CustomLoggerExtension: Logging initialized. "
+                f"LOG_FILE={self.settings.get('LOG_FILE')}, "
+                f"LOG_LEVEL={self.settings.get('LOG_LEVEL')}"
+            )
+        except Exception as e:
+            # 即使日志初始化信息无法打印，也不应该影响程序运行
             pass

crawlo/extension/memory_monitor.py

@@ -1,89 +1,105 @@
-#!/usr/bin/python
-# -*- coding:UTF-8 -*-
-import asyncio
-import psutil
-from typing import Any, Optional
-
-from crawlo.utils.log import get_logger
-from crawlo.event import spider_opened, spider_closed
-
-
-class MemoryMonitorExtension:
-    """
-    内存监控扩展
-    定期监控爬虫进程的内存使用情况，并在超出阈值时发出警告
-    """
-
-    def __init__(self, crawler: Any):
-        self.task: Optional[asyncio.Task] = None
-        self.process = psutil.Process()
-        self.settings = crawler.settings
-        self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
-        
-        # 获取配置参数
-        self.interval = self.settings.get_int('MEMORY_MONITOR_INTERVAL', 60)  # 默认60秒检查一次
-        self.warning_threshold = self.settings.get_float('MEMORY_WARNING_THRESHOLD', 80.0)  # 默认80%警告阈值
-        self.critical_threshold = self.settings.get_float('MEMORY_CRITICAL_THRESHOLD', 90.0)  # 默认90%严重阈值
-
-    @classmethod
-    def create_instance(cls, crawler: Any) -> 'MemoryMonitorExtension':
-        # 只有当配置启用时才创建实例
-        if not crawler.settings.get_bool('MEMORY_MONITOR_ENABLED', False):
-            from crawlo.exceptions import NotConfigured
-            raise NotConfigured("MemoryMonitorExtension: MEMORY_MONITOR_ENABLED is False")
-        
-        o = cls(crawler)
-        crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
-        crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
-        return o
-
-    async def spider_opened(self) -> None:
-        """爬虫启动时开始监控"""
-        self.task = asyncio.create_task(self._monitor_loop())
-        self.logger.info(
-            f"Memory monitor started. Interval: {self.interval}s, "
-            f"Warning threshold: {self.warning_threshold}%, Critical threshold: {self.critical_threshold}%"
-        )
-
-    async def spider_closed(self) -> None:
-        """爬虫关闭时停止监控"""
-        if self.task:
-            self.task.cancel()
-            try:
-                await self.task
-            except asyncio.CancelledError:
-                pass
-            self.task = None
-            self.logger.info("Memory monitor stopped.")
-
-    async def _monitor_loop(self) -> None:
-        """内存监控循环"""
-        while True:
-            try:
-                # 获取内存使用信息
-                memory_info = self.process.memory_info()
-                memory_percent = self.process.memory_percent()
-                
-                # 记录内存使用情况
-                self.logger.debug(
-                    f"Memory usage: {memory_percent:.2f}% "
-                    f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB, "
-                    f"VMS: {memory_info.vms / 1024 / 1024:.2f} MB)"
-                )
-                
-                # 检查是否超过阈值
-                if memory_percent >= self.critical_threshold:
-                    self.logger.critical(
-                        f"Memory usage critical: {memory_percent:.2f}% "
-                        f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
-                    )
-                elif memory_percent >= self.warning_threshold:
-                    self.logger.warning(
-                        f"Memory usage high: {memory_percent:.2f}% "
-                        f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
-                    )
-                
-                await asyncio.sleep(self.interval)
-            except Exception as e:
-                self.logger.error(f"Error in memory monitoring: {e}")
+#!/usr/bin/python
+# -*- coding:UTF-8 -*-
+import asyncio
+import psutil
+from typing import Any, Optional
+
+from crawlo.utils.log import get_logger
+from crawlo.utils.error_handler import ErrorHandler
+from crawlo.event import spider_opened, spider_closed
+
+
+class MemoryMonitorExtension:
+    """
+    内存监控扩展
+    定期监控爬虫进程的内存使用情况，并在超出阈值时发出警告
+    """
+
+    def __init__(self, crawler: Any):
+        self.task: Optional[asyncio.Task] = None
+        self.process = psutil.Process()
+        self.settings = crawler.settings
+        self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
+        self.error_handler = ErrorHandler(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
+        
+        # 获取配置参数
+        self.interval = self.settings.get_int('MEMORY_MONITOR_INTERVAL', 60)  # 默认60秒检查一次
+        self.warning_threshold = self.settings.get_float('MEMORY_WARNING_THRESHOLD', 80.0)  # 默认80%警告阈值
+        self.critical_threshold = self.settings.get_float('MEMORY_CRITICAL_THRESHOLD', 90.0)  # 默认90%严重阈值
+
+    @classmethod
+    def create_instance(cls, crawler: Any) -> 'MemoryMonitorExtension':
+        # 只有当配置启用时才创建实例
+        if not crawler.settings.get_bool('MEMORY_MONITOR_ENABLED', False):
+            from crawlo.exceptions import NotConfigured
+            raise NotConfigured("MemoryMonitorExtension: MEMORY_MONITOR_ENABLED is False")
+        
+        o = cls(crawler)
+        crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
+        crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
+        return o
+
+    async def spider_opened(self) -> None:
+        """爬虫启动时开始监控"""
+        try:
+            self.task = asyncio.create_task(self._monitor_loop())
+            self.logger.info(
+                f"Memory monitor started. Interval: {self.interval}s, "
+                f"Warning threshold: {self.warning_threshold}%, Critical threshold: {self.critical_threshold}%"
+            )
+        except Exception as e:
+            self.error_handler.handle_error(
+                e, 
+                context="启动内存监控失败", 
+                raise_error=False
+            )
+
+    async def spider_closed(self) -> None:
+        """爬虫关闭时停止监控"""
+        try:
+            if self.task:
+                self.task.cancel()
+                try:
+                    await self.task
+                except asyncio.CancelledError:
+                    pass
+                self.task = None
+                self.logger.info("Memory monitor stopped.")
+        except Exception as e:
+            self.error_handler.handle_error(
+                e, 
+                context="停止内存监控失败", 
+                raise_error=False
+            )
+
+    async def _monitor_loop(self) -> None:
+        """内存监控循环"""
+        while True:
+            try:
+                # 获取内存使用信息
+                memory_info = self.process.memory_info()
+                memory_percent = self.process.memory_percent()
+                
+                # 记录内存使用情况
+                self.logger.debug(
+                    f"Memory usage: {memory_percent:.2f}% "
+                    f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB, "
+                    f"VMS: {memory_info.vms / 1024 / 1024:.2f} MB)"
+                )
+                
+                # 检查是否超过阈值
+                if memory_percent >= self.critical_threshold:
+                    self.logger.critical(
+                        f"Memory usage critical: {memory_percent:.2f}% "
+                        f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
+                    )
+                elif memory_percent >= self.warning_threshold:
+                    self.logger.warning(
+                        f"Memory usage high: {memory_percent:.2f}% "
+                        f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
+                    )
+                
+                await asyncio.sleep(self.interval)
+            except Exception as e:
+                self.logger.error(f"Error in memory monitoring: {e}")
                 await asyncio.sleep(self.interval)

crawlo/extension/performance_profiler.py

@@ -1,118 +1,134 @@
-#!/usr/bin/python
-# -*- coding:UTF-8 -*-
-import io
-import os
-import pstats
-import asyncio
-import cProfile
-from typing import Any, Optional
-
-from crawlo.utils.log import get_logger
-from crawlo.event import spider_opened, spider_closed
-
-
-class PerformanceProfilerExtension:
-    """
-    性能分析扩展
-    在爬虫运行期间进行性能分析，帮助优化爬虫性能
-    """
-
-    def __init__(self, crawler: Any):
-        self.settings = crawler.settings
-        self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
-        
-        # 获取配置参数
-        self.enabled = self.settings.get_bool('PERFORMANCE_PROFILER_ENABLED', False)
-        self.output_dir = self.settings.get('PERFORMANCE_PROFILER_OUTPUT_DIR', 'profiling')
-        self.interval = self.settings.get_int('PERFORMANCE_PROFILER_INTERVAL', 300)  # 默认5分钟
-        
-        self.profiler: Optional[cProfile.Profile] = None
-        self.task: Optional[asyncio.Task] = None
-        
-        # 创建输出目录
-        if self.enabled:
-            os.makedirs(self.output_dir, exist_ok=True)
-
-    @classmethod
-    def create_instance(cls, crawler: Any) -> 'PerformanceProfilerExtension':
-        # 只有当配置启用时才创建实例
-        if not crawler.settings.get_bool('PERFORMANCE_PROFILER_ENABLED', False):
-            from crawlo.exceptions import NotConfigured
-            raise NotConfigured("PerformanceProfilerExtension: PERFORMANCE_PROFILER_ENABLED is False")
-        
-        o = cls(crawler)
-        if o.enabled:
-            crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
-            crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
-        return o
-
-    async def spider_opened(self) -> None:
-        """爬虫启动时开始性能分析"""
-        if not self.enabled:
-            return
-            
-        self.profiler = cProfile.Profile()
-        self.profiler.enable()
-        
-        # 启动定期保存分析结果的任务
-        self.task = asyncio.create_task(self._periodic_save())
-        
-        self.logger.info("Performance profiler started.")
-
-    async def spider_closed(self) -> None:
-        """爬虫关闭时停止性能分析并保存结果"""
-        if not self.enabled or not self.profiler:
-            return
-            
-        # 停止定期保存任务
-        if self.task:
-            self.task.cancel()
-            try:
-                await self.task
-            except asyncio.CancelledError:
-                pass
-        
-        # 停止分析器并保存最终结果
-        self.profiler.disable()
-        
-        # 保存分析结果
-        await self._save_profile("final")
-        self.logger.info("Performance profiler stopped and results saved.")
-
-    async def _periodic_save(self) -> None:
-        """定期保存分析结果"""
-        counter = 1
-        while True:
-            try:
-                await asyncio.sleep(self.interval)
-                if self.profiler:
-                    # 临时禁用分析器以保存结果
-                    self.profiler.disable()
-                    await self._save_profile(f"periodic_{counter}")
-                    counter += 1
-                    # 重新启用分析器
-                    self.profiler.enable()
-            except asyncio.CancelledError:
-                break
-            except Exception as e:
-                self.logger.error(f"Error in periodic profiling save: {e}")
-
-    async def _save_profile(self, name: str) -> None:
-        """保存分析结果到文件"""
-        try:
-            # 创建内存中的字符串流
-            s = io.StringIO()
-            ps = pstats.Stats(self.profiler, stream=s)
-            
-            # 排序并打印统计信息
-            ps.sort_stats('cumulative')
-            ps.print_stats()
-            
-            # 保存到文件
-            filename = os.path.join(self.output_dir, f'profile_{name}.txt')
-            with open(filename, 'w', encoding='utf-8') as f:
-                f.write(s.getvalue())
-            
-            self.logger.info(f"Performance profile saved to {filename}")
-        except Exception as e:
+#!/usr/bin/python
+# -*- coding:UTF-8 -*-
+import io
+import os
+import pstats
+import asyncio
+import cProfile
+from typing import Any, Optional
+
+from crawlo.utils.log import get_logger
+from crawlo.utils.error_handler import ErrorHandler
+from crawlo.event import spider_opened, spider_closed
+
+
+class PerformanceProfilerExtension:
+    """
+    性能分析扩展
+    在爬虫运行期间进行性能分析，帮助优化爬虫性能
+    """
+
+    def __init__(self, crawler: Any):
+        self.settings = crawler.settings
+        self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
+        self.error_handler = ErrorHandler(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
+        
+        # 获取配置参数
+        self.enabled = self.settings.get_bool('PERFORMANCE_PROFILER_ENABLED', False)
+        self.output_dir = self.settings.get('PERFORMANCE_PROFILER_OUTPUT_DIR', 'profiling')
+        self.interval = self.settings.get_int('PERFORMANCE_PROFILER_INTERVAL', 300)  # 默认5分钟
+        
+        self.profiler: Optional[cProfile.Profile] = None
+        self.task: Optional[asyncio.Task] = None
+        
+        # 创建输出目录
+        if self.enabled:
+            os.makedirs(self.output_dir, exist_ok=True)
+
+    @classmethod
+    def create_instance(cls, crawler: Any) -> 'PerformanceProfilerExtension':
+        # 只有当配置启用时才创建实例
+        if not crawler.settings.get_bool('PERFORMANCE_PROFILER_ENABLED', False):
+            from crawlo.exceptions import NotConfigured
+            raise NotConfigured("PerformanceProfilerExtension: PERFORMANCE_PROFILER_ENABLED is False")
+        
+        o = cls(crawler)
+        if o.enabled:
+            crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
+            crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
+        return o
+
+    async def spider_opened(self) -> None:
+        """爬虫启动时开始性能分析"""
+        if not self.enabled:
+            return
+            
+        try:
+            self.profiler = cProfile.Profile()
+            self.profiler.enable()
+            
+            # 启动定期保存分析结果的任务
+            self.task = asyncio.create_task(self._periodic_save())
+            
+            self.logger.info("Performance profiler started.")
+        except Exception as e:
+            self.error_handler.handle_error(
+                e, 
+                context="启动性能分析器失败", 
+                raise_error=False
+            )
+
+    async def spider_closed(self) -> None:
+        """爬虫关闭时停止性能分析并保存结果"""
+        if not self.enabled or not self.profiler:
+            return
+            
+        try:
+            # 停止定期保存任务
+            if self.task:
+                self.task.cancel()
+                try:
+                    await self.task
+                except asyncio.CancelledError:
+                    pass
+            
+            # 停止分析器并保存最终结果
+            self.profiler.disable()
+            
+            # 保存分析结果
+            await self._save_profile("final")
+            self.logger.info("Performance profiler stopped and results saved.")
+        except Exception as e:
+            self.error_handler.handle_error(
+                e, 
+                context="停止性能分析器失败", 
+                raise_error=False
+            )
+
+    async def _periodic_save(self) -> None:
+        """定期保存分析结果"""
+        counter = 1
+        while True:
+            try:
+                await asyncio.sleep(self.interval)
+                if self.profiler:
+                    # 临时禁用分析器以保存结果
+                    self.profiler.disable()
+                    await self._save_profile(f"periodic_{counter}")
+                    counter += 1
+                    # 重新启用分析器
+                    self.profiler.enable()
+            except asyncio.CancelledError:
+                break
+            except Exception as e:
+                self.logger.error(f"Error in periodic profiling save: {e}")
+
+    async def _save_profile(self, name: str) -> None:
+        """保存分析结果到文件"""
+        try:
+            # 创建内存中的字符串流
+            s = io.StringIO()
+            ps = pstats.Stats(self.profiler, stream=s)
+            
+            # 排序并打印统计信息
+            ps.sort_stats('cumulative')
+            ps.print_stats()
+            
+            # 保存到文件
+            filename = os.path.join(self.output_dir, f'profile_{name}.txt')
+            with open(filename, 'w', encoding='utf-8') as f:
+                f.write(s.getvalue())
+            
+            self.logger.info(f"Performance profile saved to {filename}")
+        except Exception as e:
             self.logger.error(f"Error saving performance profile: {e}")