crawlo 1.1.9__py3-none-any.whl → 1.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of crawlo might be problematic. Click here for more details.

Files changed (221) hide show
  1. crawlo/__init__.py +61 -61
  2. crawlo/__version__.py +1 -1
  3. crawlo/cleaners/__init__.py +60 -60
  4. crawlo/cleaners/data_formatter.py +225 -225
  5. crawlo/cleaners/encoding_converter.py +125 -125
  6. crawlo/cleaners/text_cleaner.py +232 -232
  7. crawlo/cli.py +65 -65
  8. crawlo/commands/__init__.py +14 -14
  9. crawlo/commands/check.py +594 -594
  10. crawlo/commands/genspider.py +151 -151
  11. crawlo/commands/help.py +142 -132
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +292 -292
  14. crawlo/commands/startproject.py +418 -418
  15. crawlo/commands/stats.py +188 -188
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +252 -252
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +354 -345
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +143 -136
  23. crawlo/crawler.py +1027 -1027
  24. crawlo/downloader/__init__.py +266 -266
  25. crawlo/downloader/aiohttp_downloader.py +220 -220
  26. crawlo/downloader/cffi_downloader.py +256 -256
  27. crawlo/downloader/httpx_downloader.py +259 -259
  28. crawlo/downloader/hybrid_downloader.py +213 -213
  29. crawlo/downloader/playwright_downloader.py +402 -402
  30. crawlo/downloader/selenium_downloader.py +472 -472
  31. crawlo/event.py +11 -11
  32. crawlo/exceptions.py +81 -81
  33. crawlo/extension/__init__.py +37 -37
  34. crawlo/extension/health_check.py +141 -141
  35. crawlo/extension/log_interval.py +57 -57
  36. crawlo/extension/log_stats.py +81 -81
  37. crawlo/extension/logging_extension.py +43 -43
  38. crawlo/extension/memory_monitor.py +104 -104
  39. crawlo/extension/performance_profiler.py +133 -133
  40. crawlo/extension/request_recorder.py +107 -107
  41. crawlo/filters/__init__.py +154 -154
  42. crawlo/filters/aioredis_filter.py +280 -280
  43. crawlo/filters/memory_filter.py +269 -269
  44. crawlo/items/__init__.py +23 -23
  45. crawlo/items/base.py +21 -21
  46. crawlo/items/fields.py +53 -53
  47. crawlo/items/items.py +104 -104
  48. crawlo/middleware/__init__.py +21 -21
  49. crawlo/middleware/default_header.py +132 -32
  50. crawlo/middleware/download_delay.py +105 -28
  51. crawlo/middleware/middleware_manager.py +135 -135
  52. crawlo/middleware/offsite.py +116 -0
  53. crawlo/middleware/proxy.py +366 -272
  54. crawlo/middleware/request_ignore.py +88 -30
  55. crawlo/middleware/response_code.py +164 -18
  56. crawlo/middleware/response_filter.py +138 -26
  57. crawlo/middleware/retry.py +124 -124
  58. crawlo/mode_manager.py +211 -211
  59. crawlo/network/__init__.py +21 -21
  60. crawlo/network/request.py +338 -338
  61. crawlo/network/response.py +359 -359
  62. crawlo/pipelines/__init__.py +21 -21
  63. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  64. crawlo/pipelines/console_pipeline.py +39 -39
  65. crawlo/pipelines/csv_pipeline.py +316 -316
  66. crawlo/pipelines/database_dedup_pipeline.py +224 -224
  67. crawlo/pipelines/json_pipeline.py +218 -218
  68. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  69. crawlo/pipelines/mongo_pipeline.py +131 -131
  70. crawlo/pipelines/mysql_pipeline.py +316 -316
  71. crawlo/pipelines/pipeline_manager.py +61 -61
  72. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  73. crawlo/project.py +187 -187
  74. crawlo/queue/pqueue.py +37 -37
  75. crawlo/queue/queue_manager.py +337 -334
  76. crawlo/queue/redis_priority_queue.py +298 -298
  77. crawlo/settings/__init__.py +7 -7
  78. crawlo/settings/default_settings.py +226 -219
  79. crawlo/settings/setting_manager.py +122 -122
  80. crawlo/spider/__init__.py +639 -639
  81. crawlo/stats_collector.py +59 -59
  82. crawlo/subscriber.py +130 -130
  83. crawlo/task_manager.py +30 -30
  84. crawlo/templates/crawlo.cfg.tmpl +10 -10
  85. crawlo/templates/project/__init__.py.tmpl +3 -3
  86. crawlo/templates/project/items.py.tmpl +17 -17
  87. crawlo/templates/project/middlewares.py.tmpl +118 -109
  88. crawlo/templates/project/pipelines.py.tmpl +96 -96
  89. crawlo/templates/project/run.py.tmpl +45 -45
  90. crawlo/templates/project/settings.py.tmpl +327 -326
  91. crawlo/templates/project/settings_distributed.py.tmpl +119 -119
  92. crawlo/templates/project/settings_gentle.py.tmpl +94 -94
  93. crawlo/templates/project/settings_high_performance.py.tmpl +151 -151
  94. crawlo/templates/project/settings_simple.py.tmpl +68 -68
  95. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  96. crawlo/templates/spider/spider.py.tmpl +143 -141
  97. crawlo/tools/__init__.py +182 -182
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/tools/data_validator.py +180 -180
  101. crawlo/tools/date_tools.py +35 -35
  102. crawlo/tools/distributed_coordinator.py +386 -386
  103. crawlo/tools/retry_mechanism.py +220 -220
  104. crawlo/tools/scenario_adapter.py +262 -262
  105. crawlo/utils/__init__.py +35 -35
  106. crawlo/utils/batch_processor.py +260 -260
  107. crawlo/utils/controlled_spider_mixin.py +439 -439
  108. crawlo/utils/date_tools.py +290 -290
  109. crawlo/utils/db_helper.py +343 -343
  110. crawlo/utils/enhanced_error_handler.py +359 -359
  111. crawlo/utils/env_config.py +105 -105
  112. crawlo/utils/error_handler.py +125 -125
  113. crawlo/utils/func_tools.py +82 -82
  114. crawlo/utils/large_scale_config.py +286 -286
  115. crawlo/utils/large_scale_helper.py +343 -343
  116. crawlo/utils/log.py +128 -128
  117. crawlo/utils/performance_monitor.py +284 -284
  118. crawlo/utils/queue_helper.py +175 -175
  119. crawlo/utils/redis_connection_pool.py +334 -334
  120. crawlo/utils/redis_key_validator.py +199 -199
  121. crawlo/utils/request.py +267 -267
  122. crawlo/utils/request_serializer.py +219 -219
  123. crawlo/utils/spider_loader.py +62 -62
  124. crawlo/utils/system.py +11 -11
  125. crawlo/utils/tools.py +4 -4
  126. crawlo/utils/url.py +39 -39
  127. crawlo-1.2.1.dist-info/METADATA +692 -0
  128. crawlo-1.2.1.dist-info/RECORD +220 -0
  129. examples/__init__.py +7 -7
  130. examples/aiohttp_settings.py +42 -0
  131. examples/curl_cffi_settings.py +41 -0
  132. examples/default_header_middleware_example.py +107 -0
  133. examples/default_header_spider_example.py +129 -0
  134. examples/download_delay_middleware_example.py +160 -0
  135. examples/httpx_settings.py +42 -0
  136. examples/multi_downloader_proxy_example.py +81 -0
  137. examples/offsite_middleware_example.py +55 -0
  138. examples/offsite_spider_example.py +107 -0
  139. examples/proxy_spider_example.py +166 -0
  140. examples/request_ignore_middleware_example.py +51 -0
  141. examples/request_ignore_spider_example.py +99 -0
  142. examples/response_code_middleware_example.py +52 -0
  143. examples/response_filter_middleware_example.py +67 -0
  144. examples/tong_hua_shun_settings.py +62 -0
  145. examples/tong_hua_shun_spider.py +170 -0
  146. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  147. tests/__init__.py +7 -7
  148. tests/advanced_tools_example.py +275 -275
  149. tests/authenticated_proxy_example.py +236 -236
  150. tests/cleaners_example.py +160 -160
  151. tests/config_validation_demo.py +102 -102
  152. tests/controlled_spider_example.py +205 -205
  153. tests/date_tools_example.py +180 -180
  154. tests/dynamic_loading_example.py +523 -523
  155. tests/dynamic_loading_test.py +104 -104
  156. tests/env_config_example.py +133 -133
  157. tests/error_handling_example.py +171 -171
  158. tests/redis_key_validation_demo.py +130 -130
  159. tests/response_improvements_example.py +144 -144
  160. tests/test_advanced_tools.py +148 -148
  161. tests/test_all_redis_key_configs.py +145 -145
  162. tests/test_authenticated_proxy.py +141 -141
  163. tests/test_cleaners.py +54 -54
  164. tests/test_comprehensive.py +146 -146
  165. tests/test_config_validator.py +193 -193
  166. tests/test_crawlo_proxy_integration.py +173 -0
  167. tests/test_date_tools.py +123 -123
  168. tests/test_default_header_middleware.py +159 -0
  169. tests/test_double_crawlo_fix.py +207 -207
  170. tests/test_double_crawlo_fix_simple.py +124 -124
  171. tests/test_download_delay_middleware.py +222 -0
  172. tests/test_downloader_proxy_compatibility.py +269 -0
  173. tests/test_dynamic_downloaders_proxy.py +124 -124
  174. tests/test_dynamic_proxy.py +92 -92
  175. tests/test_dynamic_proxy_config.py +146 -146
  176. tests/test_dynamic_proxy_real.py +109 -109
  177. tests/test_edge_cases.py +303 -303
  178. tests/test_enhanced_error_handler.py +270 -270
  179. tests/test_env_config.py +121 -121
  180. tests/test_error_handler_compatibility.py +112 -112
  181. tests/test_final_validation.py +153 -153
  182. tests/test_framework_env_usage.py +103 -103
  183. tests/test_integration.py +356 -356
  184. tests/test_item_dedup_redis_key.py +122 -122
  185. tests/test_offsite_middleware.py +222 -0
  186. tests/test_parsel.py +29 -29
  187. tests/test_performance.py +327 -327
  188. tests/test_proxy_api.py +265 -0
  189. tests/test_proxy_health_check.py +32 -32
  190. tests/test_proxy_middleware.py +122 -0
  191. tests/test_proxy_middleware_enhanced.py +217 -0
  192. tests/test_proxy_middleware_integration.py +136 -136
  193. tests/test_proxy_providers.py +56 -56
  194. tests/test_proxy_stats.py +19 -19
  195. tests/test_proxy_strategies.py +59 -59
  196. tests/test_queue_manager_double_crawlo.py +174 -231
  197. tests/test_queue_manager_redis_key.py +176 -176
  198. tests/test_real_scenario_proxy.py +196 -0
  199. tests/test_redis_config.py +28 -28
  200. tests/test_redis_connection_pool.py +294 -294
  201. tests/test_redis_key_naming.py +181 -181
  202. tests/test_redis_key_validator.py +123 -123
  203. tests/test_redis_queue.py +224 -224
  204. tests/test_request_ignore_middleware.py +183 -0
  205. tests/test_request_serialization.py +70 -70
  206. tests/test_response_code_middleware.py +350 -0
  207. tests/test_response_filter_middleware.py +428 -0
  208. tests/test_response_improvements.py +152 -152
  209. tests/test_retry_middleware.py +242 -0
  210. tests/test_scheduler.py +241 -241
  211. tests/test_simple_response.py +61 -61
  212. tests/test_telecom_spider_redis_key.py +205 -205
  213. tests/test_template_content.py +87 -87
  214. tests/test_template_redis_key.py +134 -134
  215. tests/test_tools.py +153 -153
  216. tests/tools_example.py +257 -257
  217. crawlo-1.1.9.dist-info/METADATA +0 -626
  218. crawlo-1.1.9.dist-info/RECORD +0 -190
  219. {crawlo-1.1.9.dist-info → crawlo-1.2.1.dist-info}/WHEEL +0 -0
  220. {crawlo-1.1.9.dist-info → crawlo-1.2.1.dist-info}/entry_points.txt +0 -0
  221. {crawlo-1.1.9.dist-info → crawlo-1.2.1.dist-info}/top_level.txt +0 -0
@@ -1,82 +1,82 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- from typing import Any
4
-
5
- from crawlo import event
6
- from crawlo.utils.date_tools import now, time_diff
7
-
8
-
9
- class LogStats(object):
10
-
11
- def __init__(self, stats: Any):
12
- self._stats = stats
13
-
14
- @classmethod
15
- def create_instance(cls, crawler: Any) -> 'LogStats':
16
- o = cls(crawler.stats)
17
- # 订阅所有需要的事件
18
- event_subscriptions = [
19
- (o.spider_opened, event.spider_opened),
20
- (o.spider_closed, event.spider_closed),
21
- (o.item_successful, event.item_successful),
22
- (o.item_discard, event.item_discard),
23
- (o.response_received, event.response_received),
24
- (o.request_scheduled, event.request_scheduled),
25
- ]
26
-
27
- for handler, evt in event_subscriptions:
28
- try:
29
- crawler.subscriber.subscribe(handler, event=evt)
30
- except Exception as e:
31
- # 获取日志记录器并记录错误
32
- from crawlo.utils.log import get_logger
33
- logger = get_logger(cls.__name__)
34
- logger.error(f"Failed to subscribe to event {evt}: {e}")
35
-
36
- return o
37
-
38
- async def spider_opened(self) -> None:
39
- try:
40
- self._stats['start_time'] = now(fmt='%Y-%m-%d %H:%M:%S')
41
- except Exception as e:
42
- # 静默处理,避免影响爬虫运行
43
- pass
44
-
45
- async def spider_closed(self) -> None:
46
- try:
47
- self._stats['end_time'] = now(fmt='%Y-%m-%d %H:%M:%S')
48
- self._stats['cost_time(s)'] = time_diff(start=self._stats['start_time'], end=self._stats['end_time'])
49
- except Exception as e:
50
- # 静默处理,避免影响爬虫运行
51
- pass
52
-
53
- async def item_successful(self, _item: Any, _spider: Any) -> None:
54
- try:
55
- self._stats.inc_value('item_successful_count')
56
- except Exception as e:
57
- # 静默处理,避免影响爬虫运行
58
- pass
59
-
60
- async def item_discard(self, _item: Any, exc: Any, _spider: Any) -> None:
61
- try:
62
- self._stats.inc_value('item_discard_count')
63
- reason = getattr(exc, 'msg', None) # 更安全地获取属性
64
- if reason:
65
- self._stats.inc_value(f"item_discard/{reason}")
66
- except Exception as e:
67
- # 静默处理,避免影响爬虫运行
68
- pass
69
-
70
- async def response_received(self, _response: Any, _spider: Any) -> None:
71
- try:
72
- self._stats.inc_value('response_received_count')
73
- except Exception as e:
74
- # 静默处理,避免影响爬虫运行
75
- pass
76
-
77
- async def request_scheduled(self, _request: Any, _spider: Any) -> None:
78
- try:
79
- self._stats.inc_value('request_scheduler_count')
80
- except Exception as e:
81
- # 静默处理,避免影响爬虫运行
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ from typing import Any
4
+
5
+ from crawlo import event
6
+ from crawlo.utils.date_tools import now, time_diff
7
+
8
+
9
+ class LogStats(object):
10
+
11
+ def __init__(self, stats: Any):
12
+ self._stats = stats
13
+
14
+ @classmethod
15
+ def create_instance(cls, crawler: Any) -> 'LogStats':
16
+ o = cls(crawler.stats)
17
+ # 订阅所有需要的事件
18
+ event_subscriptions = [
19
+ (o.spider_opened, event.spider_opened),
20
+ (o.spider_closed, event.spider_closed),
21
+ (o.item_successful, event.item_successful),
22
+ (o.item_discard, event.item_discard),
23
+ (o.response_received, event.response_received),
24
+ (o.request_scheduled, event.request_scheduled),
25
+ ]
26
+
27
+ for handler, evt in event_subscriptions:
28
+ try:
29
+ crawler.subscriber.subscribe(handler, event=evt)
30
+ except Exception as e:
31
+ # 获取日志记录器并记录错误
32
+ from crawlo.utils.log import get_logger
33
+ logger = get_logger(cls.__name__)
34
+ logger.error(f"Failed to subscribe to event {evt}: {e}")
35
+
36
+ return o
37
+
38
+ async def spider_opened(self) -> None:
39
+ try:
40
+ self._stats['start_time'] = now(fmt='%Y-%m-%d %H:%M:%S')
41
+ except Exception as e:
42
+ # 静默处理,避免影响爬虫运行
43
+ pass
44
+
45
+ async def spider_closed(self) -> None:
46
+ try:
47
+ self._stats['end_time'] = now(fmt='%Y-%m-%d %H:%M:%S')
48
+ self._stats['cost_time(s)'] = time_diff(start=self._stats['start_time'], end=self._stats['end_time'])
49
+ except Exception as e:
50
+ # 静默处理,避免影响爬虫运行
51
+ pass
52
+
53
+ async def item_successful(self, _item: Any, _spider: Any) -> None:
54
+ try:
55
+ self._stats.inc_value('item_successful_count')
56
+ except Exception as e:
57
+ # 静默处理,避免影响爬虫运行
58
+ pass
59
+
60
+ async def item_discard(self, _item: Any, exc: Any, _spider: Any) -> None:
61
+ try:
62
+ self._stats.inc_value('item_discard_count')
63
+ reason = getattr(exc, 'msg', None) # 更安全地获取属性
64
+ if reason:
65
+ self._stats.inc_value(f"item_discard/{reason}")
66
+ except Exception as e:
67
+ # 静默处理,避免影响爬虫运行
68
+ pass
69
+
70
+ async def response_received(self, _response: Any, _spider: Any) -> None:
71
+ try:
72
+ self._stats.inc_value('response_received_count')
73
+ except Exception as e:
74
+ # 静默处理,避免影响爬虫运行
75
+ pass
76
+
77
+ async def request_scheduled(self, _request: Any, _spider: Any) -> None:
78
+ try:
79
+ self._stats.inc_value('request_scheduler_count')
80
+ except Exception as e:
81
+ # 静默处理,避免影响爬虫运行
82
82
  pass
@@ -1,44 +1,44 @@
1
- from typing import Any
2
- from crawlo.exceptions import NotConfigured
3
- from crawlo.utils.log import get_logger
4
- from crawlo.utils.log import LoggerManager
5
-
6
-
7
- class CustomLoggerExtension:
8
- """
9
- 日志系统初始化扩展
10
- 遵循与 ExtensionManager 一致的接口规范:使用 create_instance
11
- """
12
-
13
- def __init__(self, settings: Any):
14
- self.settings = settings
15
- # 初始化全局日志配置
16
- LoggerManager.configure(settings)
17
-
18
- @classmethod
19
- def create_instance(cls, crawler: Any, *args: Any, **kwargs: Any) -> 'CustomLoggerExtension':
20
- """
21
- 工厂方法:兼容 ExtensionManager 的创建方式
22
- 被 ExtensionManager 调用
23
- """
24
- # 可以通过 settings 控制是否启用
25
- log_file = crawler.settings.get('LOG_FILE')
26
- log_enable_custom = crawler.settings.get('LOG_ENABLE_CUSTOM', False)
27
-
28
- # 只有当没有配置日志文件且未启用自定义日志时才禁用
29
- if not log_file and not log_enable_custom:
30
- raise NotConfigured("CustomLoggerExtension: LOG_FILE not set and LOG_ENABLE_CUSTOM=False")
31
-
32
- return cls(crawler.settings)
33
-
34
- def spider_opened(self, spider: Any) -> None:
35
- logger = get_logger(__name__)
36
- try:
37
- logger.info(
38
- f"CustomLoggerExtension: Logging initialized. "
39
- f"LOG_FILE={self.settings.get('LOG_FILE')}, "
40
- f"LOG_LEVEL={self.settings.get('LOG_LEVEL')}"
41
- )
42
- except Exception as e:
43
- # 即使日志初始化信息无法打印,也不应该影响程序运行
1
+ from typing import Any
2
+ from crawlo.exceptions import NotConfigured
3
+ from crawlo.utils.log import get_logger
4
+ from crawlo.utils.log import LoggerManager
5
+
6
+
7
+ class CustomLoggerExtension:
8
+ """
9
+ 日志系统初始化扩展
10
+ 遵循与 ExtensionManager 一致的接口规范:使用 create_instance
11
+ """
12
+
13
+ def __init__(self, settings: Any):
14
+ self.settings = settings
15
+ # 初始化全局日志配置
16
+ LoggerManager.configure(settings)
17
+
18
+ @classmethod
19
+ def create_instance(cls, crawler: Any, *args: Any, **kwargs: Any) -> 'CustomLoggerExtension':
20
+ """
21
+ 工厂方法:兼容 ExtensionManager 的创建方式
22
+ 被 ExtensionManager 调用
23
+ """
24
+ # 可以通过 settings 控制是否启用
25
+ log_file = crawler.settings.get('LOG_FILE')
26
+ log_enable_custom = crawler.settings.get('LOG_ENABLE_CUSTOM', False)
27
+
28
+ # 只有当没有配置日志文件且未启用自定义日志时才禁用
29
+ if not log_file and not log_enable_custom:
30
+ raise NotConfigured("CustomLoggerExtension: LOG_FILE not set and LOG_ENABLE_CUSTOM=False")
31
+
32
+ return cls(crawler.settings)
33
+
34
+ def spider_opened(self, spider: Any) -> None:
35
+ logger = get_logger(__name__)
36
+ try:
37
+ logger.info(
38
+ f"CustomLoggerExtension: Logging initialized. "
39
+ f"LOG_FILE={self.settings.get('LOG_FILE')}, "
40
+ f"LOG_LEVEL={self.settings.get('LOG_LEVEL')}"
41
+ )
42
+ except Exception as e:
43
+ # 即使日志初始化信息无法打印,也不应该影响程序运行
44
44
  pass
@@ -1,105 +1,105 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- import asyncio
4
- import psutil
5
- from typing import Any, Optional
6
-
7
- from crawlo.utils.log import get_logger
8
- from crawlo.utils.error_handler import ErrorHandler
9
- from crawlo.event import spider_opened, spider_closed
10
-
11
-
12
- class MemoryMonitorExtension:
13
- """
14
- 内存监控扩展
15
- 定期监控爬虫进程的内存使用情况,并在超出阈值时发出警告
16
- """
17
-
18
- def __init__(self, crawler: Any):
19
- self.task: Optional[asyncio.Task] = None
20
- self.process = psutil.Process()
21
- self.settings = crawler.settings
22
- self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
23
- self.error_handler = ErrorHandler(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
24
-
25
- # 获取配置参数
26
- self.interval = self.settings.get_int('MEMORY_MONITOR_INTERVAL', 60) # 默认60秒检查一次
27
- self.warning_threshold = self.settings.get_float('MEMORY_WARNING_THRESHOLD', 80.0) # 默认80%警告阈值
28
- self.critical_threshold = self.settings.get_float('MEMORY_CRITICAL_THRESHOLD', 90.0) # 默认90%严重阈值
29
-
30
- @classmethod
31
- def create_instance(cls, crawler: Any) -> 'MemoryMonitorExtension':
32
- # 只有当配置启用时才创建实例
33
- if not crawler.settings.get_bool('MEMORY_MONITOR_ENABLED', False):
34
- from crawlo.exceptions import NotConfigured
35
- raise NotConfigured("MemoryMonitorExtension: MEMORY_MONITOR_ENABLED is False")
36
-
37
- o = cls(crawler)
38
- crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
39
- crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
40
- return o
41
-
42
- async def spider_opened(self) -> None:
43
- """爬虫启动时开始监控"""
44
- try:
45
- self.task = asyncio.create_task(self._monitor_loop())
46
- self.logger.info(
47
- f"Memory monitor started. Interval: {self.interval}s, "
48
- f"Warning threshold: {self.warning_threshold}%, Critical threshold: {self.critical_threshold}%"
49
- )
50
- except Exception as e:
51
- self.error_handler.handle_error(
52
- e,
53
- context="启动内存监控失败",
54
- raise_error=False
55
- )
56
-
57
- async def spider_closed(self) -> None:
58
- """爬虫关闭时停止监控"""
59
- try:
60
- if self.task:
61
- self.task.cancel()
62
- try:
63
- await self.task
64
- except asyncio.CancelledError:
65
- pass
66
- self.task = None
67
- self.logger.info("Memory monitor stopped.")
68
- except Exception as e:
69
- self.error_handler.handle_error(
70
- e,
71
- context="停止内存监控失败",
72
- raise_error=False
73
- )
74
-
75
- async def _monitor_loop(self) -> None:
76
- """内存监控循环"""
77
- while True:
78
- try:
79
- # 获取内存使用信息
80
- memory_info = self.process.memory_info()
81
- memory_percent = self.process.memory_percent()
82
-
83
- # 记录内存使用情况
84
- self.logger.debug(
85
- f"Memory usage: {memory_percent:.2f}% "
86
- f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB, "
87
- f"VMS: {memory_info.vms / 1024 / 1024:.2f} MB)"
88
- )
89
-
90
- # 检查是否超过阈值
91
- if memory_percent >= self.critical_threshold:
92
- self.logger.critical(
93
- f"Memory usage critical: {memory_percent:.2f}% "
94
- f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
95
- )
96
- elif memory_percent >= self.warning_threshold:
97
- self.logger.warning(
98
- f"Memory usage high: {memory_percent:.2f}% "
99
- f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
100
- )
101
-
102
- await asyncio.sleep(self.interval)
103
- except Exception as e:
104
- self.logger.error(f"Error in memory monitoring: {e}")
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ import psutil
5
+ from typing import Any, Optional
6
+
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.utils.error_handler import ErrorHandler
9
+ from crawlo.event import spider_opened, spider_closed
10
+
11
+
12
+ class MemoryMonitorExtension:
13
+ """
14
+ 内存监控扩展
15
+ 定期监控爬虫进程的内存使用情况,并在超出阈值时发出警告
16
+ """
17
+
18
+ def __init__(self, crawler: Any):
19
+ self.task: Optional[asyncio.Task] = None
20
+ self.process = psutil.Process()
21
+ self.settings = crawler.settings
22
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
23
+ self.error_handler = ErrorHandler(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
24
+
25
+ # 获取配置参数
26
+ self.interval = self.settings.get_int('MEMORY_MONITOR_INTERVAL', 60) # 默认60秒检查一次
27
+ self.warning_threshold = self.settings.get_float('MEMORY_WARNING_THRESHOLD', 80.0) # 默认80%警告阈值
28
+ self.critical_threshold = self.settings.get_float('MEMORY_CRITICAL_THRESHOLD', 90.0) # 默认90%严重阈值
29
+
30
+ @classmethod
31
+ def create_instance(cls, crawler: Any) -> 'MemoryMonitorExtension':
32
+ # 只有当配置启用时才创建实例
33
+ if not crawler.settings.get_bool('MEMORY_MONITOR_ENABLED', False):
34
+ from crawlo.exceptions import NotConfigured
35
+ raise NotConfigured("MemoryMonitorExtension: MEMORY_MONITOR_ENABLED is False")
36
+
37
+ o = cls(crawler)
38
+ crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
39
+ crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
40
+ return o
41
+
42
+ async def spider_opened(self) -> None:
43
+ """爬虫启动时开始监控"""
44
+ try:
45
+ self.task = asyncio.create_task(self._monitor_loop())
46
+ self.logger.info(
47
+ f"Memory monitor started. Interval: {self.interval}s, "
48
+ f"Warning threshold: {self.warning_threshold}%, Critical threshold: {self.critical_threshold}%"
49
+ )
50
+ except Exception as e:
51
+ self.error_handler.handle_error(
52
+ e,
53
+ context="启动内存监控失败",
54
+ raise_error=False
55
+ )
56
+
57
+ async def spider_closed(self) -> None:
58
+ """爬虫关闭时停止监控"""
59
+ try:
60
+ if self.task:
61
+ self.task.cancel()
62
+ try:
63
+ await self.task
64
+ except asyncio.CancelledError:
65
+ pass
66
+ self.task = None
67
+ self.logger.info("Memory monitor stopped.")
68
+ except Exception as e:
69
+ self.error_handler.handle_error(
70
+ e,
71
+ context="停止内存监控失败",
72
+ raise_error=False
73
+ )
74
+
75
+ async def _monitor_loop(self) -> None:
76
+ """内存监控循环"""
77
+ while True:
78
+ try:
79
+ # 获取内存使用信息
80
+ memory_info = self.process.memory_info()
81
+ memory_percent = self.process.memory_percent()
82
+
83
+ # 记录内存使用情况
84
+ self.logger.debug(
85
+ f"Memory usage: {memory_percent:.2f}% "
86
+ f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB, "
87
+ f"VMS: {memory_info.vms / 1024 / 1024:.2f} MB)"
88
+ )
89
+
90
+ # 检查是否超过阈值
91
+ if memory_percent >= self.critical_threshold:
92
+ self.logger.critical(
93
+ f"Memory usage critical: {memory_percent:.2f}% "
94
+ f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
95
+ )
96
+ elif memory_percent >= self.warning_threshold:
97
+ self.logger.warning(
98
+ f"Memory usage high: {memory_percent:.2f}% "
99
+ f"(RSS: {memory_info.rss / 1024 / 1024:.2f} MB)"
100
+ )
101
+
102
+ await asyncio.sleep(self.interval)
103
+ except Exception as e:
104
+ self.logger.error(f"Error in memory monitoring: {e}")
105
105
  await asyncio.sleep(self.interval)