crawlo 1.3.3__py3-none-any.whl → 1.3.5__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 (289) hide show
  1. crawlo/__init__.py +87 -63
  2. crawlo/__version__.py +1 -1
  3. crawlo/cli.py +75 -75
  4. crawlo/commands/__init__.py +14 -14
  5. crawlo/commands/check.py +594 -594
  6. crawlo/commands/genspider.py +151 -151
  7. crawlo/commands/help.py +138 -138
  8. crawlo/commands/list.py +155 -155
  9. crawlo/commands/run.py +341 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +196 -196
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -277
  15. crawlo/core/__init__.py +46 -2
  16. crawlo/core/engine.py +439 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +257 -256
  19. crawlo/crawler.py +639 -1167
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -194
  22. crawlo/downloader/__init__.py +273 -273
  23. crawlo/downloader/aiohttp_downloader.py +228 -226
  24. crawlo/downloader/cffi_downloader.py +245 -245
  25. crawlo/downloader/httpx_downloader.py +259 -259
  26. crawlo/downloader/hybrid_downloader.py +212 -212
  27. crawlo/downloader/playwright_downloader.py +402 -402
  28. crawlo/downloader/selenium_downloader.py +472 -472
  29. crawlo/event.py +11 -11
  30. crawlo/exceptions.py +81 -81
  31. crawlo/extension/__init__.py +39 -39
  32. crawlo/extension/health_check.py +141 -141
  33. crawlo/extension/log_interval.py +57 -57
  34. crawlo/extension/log_stats.py +81 -81
  35. crawlo/extension/logging_extension.py +61 -52
  36. crawlo/extension/memory_monitor.py +104 -104
  37. crawlo/extension/performance_profiler.py +133 -133
  38. crawlo/extension/request_recorder.py +107 -107
  39. crawlo/factories/__init__.py +28 -0
  40. crawlo/factories/base.py +69 -0
  41. crawlo/factories/crawler.py +104 -0
  42. crawlo/factories/registry.py +85 -0
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +257 -234
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/framework.py +292 -0
  47. crawlo/initialization/__init__.py +40 -0
  48. crawlo/initialization/built_in.py +426 -0
  49. crawlo/initialization/context.py +142 -0
  50. crawlo/initialization/core.py +194 -0
  51. crawlo/initialization/phases.py +149 -0
  52. crawlo/initialization/registry.py +146 -0
  53. crawlo/items/__init__.py +23 -23
  54. crawlo/items/base.py +23 -22
  55. crawlo/items/fields.py +52 -52
  56. crawlo/items/items.py +104 -104
  57. crawlo/logging/__init__.py +38 -0
  58. crawlo/logging/config.py +97 -0
  59. crawlo/logging/factory.py +129 -0
  60. crawlo/logging/manager.py +112 -0
  61. crawlo/middleware/__init__.py +21 -21
  62. crawlo/middleware/default_header.py +132 -132
  63. crawlo/middleware/download_delay.py +104 -104
  64. crawlo/middleware/middleware_manager.py +135 -135
  65. crawlo/middleware/offsite.py +123 -123
  66. crawlo/middleware/proxy.py +386 -386
  67. crawlo/middleware/request_ignore.py +86 -86
  68. crawlo/middleware/response_code.py +163 -163
  69. crawlo/middleware/response_filter.py +136 -136
  70. crawlo/middleware/retry.py +124 -124
  71. crawlo/middleware/simple_proxy.py +65 -65
  72. crawlo/mode_manager.py +212 -187
  73. crawlo/network/__init__.py +21 -21
  74. crawlo/network/request.py +379 -379
  75. crawlo/network/response.py +359 -359
  76. crawlo/pipelines/__init__.py +21 -21
  77. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  78. crawlo/pipelines/console_pipeline.py +39 -39
  79. crawlo/pipelines/csv_pipeline.py +316 -316
  80. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  81. crawlo/pipelines/json_pipeline.py +218 -218
  82. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  83. crawlo/pipelines/mongo_pipeline.py +131 -131
  84. crawlo/pipelines/mysql_pipeline.py +325 -318
  85. crawlo/pipelines/pipeline_manager.py +76 -75
  86. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  87. crawlo/project.py +327 -325
  88. crawlo/queue/pqueue.py +43 -37
  89. crawlo/queue/queue_manager.py +503 -379
  90. crawlo/queue/redis_priority_queue.py +326 -306
  91. crawlo/settings/__init__.py +7 -7
  92. crawlo/settings/default_settings.py +321 -225
  93. crawlo/settings/setting_manager.py +214 -198
  94. crawlo/spider/__init__.py +657 -639
  95. crawlo/stats_collector.py +73 -59
  96. crawlo/subscriber.py +129 -129
  97. crawlo/task_manager.py +139 -30
  98. crawlo/templates/crawlo.cfg.tmpl +10 -10
  99. crawlo/templates/project/__init__.py.tmpl +3 -3
  100. crawlo/templates/project/items.py.tmpl +17 -17
  101. crawlo/templates/project/middlewares.py.tmpl +118 -118
  102. crawlo/templates/project/pipelines.py.tmpl +96 -96
  103. crawlo/templates/project/settings.py.tmpl +168 -267
  104. crawlo/templates/project/settings_distributed.py.tmpl +167 -180
  105. crawlo/templates/project/settings_gentle.py.tmpl +167 -61
  106. crawlo/templates/project/settings_high_performance.py.tmpl +168 -131
  107. crawlo/templates/project/settings_minimal.py.tmpl +66 -35
  108. crawlo/templates/project/settings_simple.py.tmpl +165 -102
  109. crawlo/templates/project/spiders/__init__.py.tmpl +10 -6
  110. crawlo/templates/run.py.tmpl +34 -38
  111. crawlo/templates/spider/spider.py.tmpl +143 -143
  112. crawlo/templates/spiders_init.py.tmpl +10 -0
  113. crawlo/tools/__init__.py +200 -200
  114. crawlo/tools/anti_crawler.py +268 -268
  115. crawlo/tools/authenticated_proxy.py +240 -240
  116. crawlo/tools/data_formatter.py +225 -225
  117. crawlo/tools/data_validator.py +180 -180
  118. crawlo/tools/date_tools.py +289 -289
  119. crawlo/tools/distributed_coordinator.py +388 -388
  120. crawlo/tools/encoding_converter.py +127 -127
  121. crawlo/tools/network_diagnostic.py +365 -0
  122. crawlo/tools/request_tools.py +82 -82
  123. crawlo/tools/retry_mechanism.py +224 -224
  124. crawlo/tools/scenario_adapter.py +262 -262
  125. crawlo/tools/text_cleaner.py +232 -232
  126. crawlo/utils/__init__.py +34 -34
  127. crawlo/utils/batch_processor.py +259 -259
  128. crawlo/utils/class_loader.py +26 -0
  129. crawlo/utils/controlled_spider_mixin.py +439 -439
  130. crawlo/utils/db_helper.py +343 -343
  131. crawlo/utils/enhanced_error_handler.py +356 -356
  132. crawlo/utils/env_config.py +142 -142
  133. crawlo/utils/error_handler.py +165 -124
  134. crawlo/utils/func_tools.py +82 -82
  135. crawlo/utils/large_scale_config.py +286 -286
  136. crawlo/utils/large_scale_helper.py +344 -344
  137. crawlo/utils/log.py +80 -200
  138. crawlo/utils/performance_monitor.py +285 -285
  139. crawlo/utils/queue_helper.py +175 -175
  140. crawlo/utils/redis_connection_pool.py +388 -351
  141. crawlo/utils/redis_key_validator.py +198 -198
  142. crawlo/utils/request.py +267 -267
  143. crawlo/utils/request_serializer.py +225 -218
  144. crawlo/utils/spider_loader.py +61 -61
  145. crawlo/utils/system.py +11 -11
  146. crawlo/utils/tools.py +4 -4
  147. crawlo/utils/url.py +39 -39
  148. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/METADATA +1126 -1020
  149. crawlo-1.3.5.dist-info/RECORD +288 -0
  150. examples/__init__.py +7 -7
  151. tests/__init__.py +7 -7
  152. tests/advanced_tools_example.py +275 -275
  153. tests/authenticated_proxy_example.py +107 -107
  154. tests/baidu_performance_test.py +109 -0
  155. tests/baidu_test.py +60 -0
  156. tests/cleaners_example.py +160 -160
  157. tests/comprehensive_framework_test.py +213 -0
  158. tests/comprehensive_test.py +82 -0
  159. tests/comprehensive_testing_summary.md +187 -0
  160. tests/config_validation_demo.py +142 -142
  161. tests/controlled_spider_example.py +205 -205
  162. tests/date_tools_example.py +180 -180
  163. tests/debug_configure.py +70 -0
  164. tests/debug_framework_logger.py +85 -0
  165. tests/debug_log_config.py +127 -0
  166. tests/debug_log_levels.py +64 -0
  167. tests/debug_pipelines.py +66 -66
  168. tests/detailed_log_test.py +234 -0
  169. tests/distributed_test.py +67 -0
  170. tests/distributed_test_debug.py +77 -0
  171. tests/dynamic_loading_example.py +523 -523
  172. tests/dynamic_loading_test.py +104 -104
  173. tests/env_config_example.py +133 -133
  174. tests/error_handling_example.py +171 -171
  175. tests/final_command_test_report.md +0 -0
  176. tests/final_comprehensive_test.py +152 -0
  177. tests/final_log_test.py +261 -0
  178. tests/final_validation_test.py +183 -0
  179. tests/fix_log_test.py +143 -0
  180. tests/framework_performance_test.py +203 -0
  181. tests/log_buffering_test.py +112 -0
  182. tests/log_generation_timing_test.py +154 -0
  183. tests/optimized_performance_test.py +212 -0
  184. tests/performance_comparison.py +246 -0
  185. tests/queue_blocking_test.py +114 -0
  186. tests/queue_test.py +90 -0
  187. tests/redis_key_validation_demo.py +130 -130
  188. tests/request_params_example.py +150 -150
  189. tests/response_improvements_example.py +144 -144
  190. tests/scrapy_comparison/ofweek_scrapy.py +139 -0
  191. tests/scrapy_comparison/scrapy_test.py +134 -0
  192. tests/simple_command_test.py +120 -0
  193. tests/simple_crawlo_test.py +128 -0
  194. tests/simple_log_test.py +58 -0
  195. tests/simple_log_test2.py +138 -0
  196. tests/simple_optimization_test.py +129 -0
  197. tests/simple_spider_test.py +50 -0
  198. tests/simple_test.py +48 -0
  199. tests/spider_log_timing_test.py +178 -0
  200. tests/test_advanced_tools.py +148 -148
  201. tests/test_all_commands.py +231 -0
  202. tests/test_all_redis_key_configs.py +145 -145
  203. tests/test_authenticated_proxy.py +141 -141
  204. tests/test_batch_processor.py +179 -0
  205. tests/test_cleaners.py +54 -54
  206. tests/test_component_factory.py +175 -0
  207. tests/test_comprehensive.py +146 -146
  208. tests/test_config_consistency.py +80 -80
  209. tests/test_config_merge.py +152 -152
  210. tests/test_config_validator.py +182 -182
  211. tests/test_controlled_spider_mixin.py +80 -0
  212. tests/test_crawlo_proxy_integration.py +108 -108
  213. tests/test_date_tools.py +123 -123
  214. tests/test_default_header_middleware.py +158 -158
  215. tests/test_distributed.py +65 -65
  216. tests/test_double_crawlo_fix.py +207 -207
  217. tests/test_double_crawlo_fix_simple.py +124 -124
  218. tests/test_download_delay_middleware.py +221 -221
  219. tests/test_downloader_proxy_compatibility.py +268 -268
  220. tests/test_dynamic_downloaders_proxy.py +124 -124
  221. tests/test_dynamic_proxy.py +92 -92
  222. tests/test_dynamic_proxy_config.py +146 -146
  223. tests/test_dynamic_proxy_real.py +109 -109
  224. tests/test_edge_cases.py +303 -303
  225. tests/test_enhanced_error_handler.py +270 -270
  226. tests/test_enhanced_error_handler_comprehensive.py +246 -0
  227. tests/test_env_config.py +121 -121
  228. tests/test_error_handler_compatibility.py +112 -112
  229. tests/test_factories.py +253 -0
  230. tests/test_final_validation.py +153 -153
  231. tests/test_framework_env_usage.py +103 -103
  232. tests/test_framework_logger.py +67 -0
  233. tests/test_framework_startup.py +65 -0
  234. tests/test_get_component_logger.py +84 -0
  235. tests/test_integration.py +169 -169
  236. tests/test_item_dedup_redis_key.py +122 -122
  237. tests/test_large_scale_config.py +113 -0
  238. tests/test_large_scale_helper.py +236 -0
  239. tests/test_logging_system.py +283 -0
  240. tests/test_mode_change.py +73 -0
  241. tests/test_mode_consistency.py +51 -51
  242. tests/test_offsite_middleware.py +221 -221
  243. tests/test_parsel.py +29 -29
  244. tests/test_performance.py +327 -327
  245. tests/test_performance_monitor.py +116 -0
  246. tests/test_proxy_api.py +264 -264
  247. tests/test_proxy_health_check.py +32 -32
  248. tests/test_proxy_middleware.py +121 -121
  249. tests/test_proxy_middleware_enhanced.py +216 -216
  250. tests/test_proxy_middleware_integration.py +136 -136
  251. tests/test_proxy_middleware_refactored.py +184 -184
  252. tests/test_proxy_providers.py +56 -56
  253. tests/test_proxy_stats.py +19 -19
  254. tests/test_proxy_strategies.py +59 -59
  255. tests/test_queue_empty_check.py +42 -0
  256. tests/test_queue_manager_double_crawlo.py +173 -173
  257. tests/test_queue_manager_redis_key.py +176 -176
  258. tests/test_random_user_agent.py +72 -72
  259. tests/test_real_scenario_proxy.py +195 -195
  260. tests/test_redis_config.py +28 -28
  261. tests/test_redis_connection_pool.py +294 -294
  262. tests/test_redis_key_naming.py +181 -181
  263. tests/test_redis_key_validator.py +123 -123
  264. tests/test_redis_queue.py +224 -224
  265. tests/test_request_ignore_middleware.py +182 -182
  266. tests/test_request_params.py +111 -111
  267. tests/test_request_serialization.py +70 -70
  268. tests/test_response_code_middleware.py +349 -349
  269. tests/test_response_filter_middleware.py +427 -427
  270. tests/test_response_improvements.py +152 -152
  271. tests/test_retry_middleware.py +241 -241
  272. tests/test_scheduler.py +252 -252
  273. tests/test_scheduler_config_update.py +133 -133
  274. tests/test_simple_response.py +61 -61
  275. tests/test_telecom_spider_redis_key.py +205 -205
  276. tests/test_template_content.py +87 -87
  277. tests/test_template_redis_key.py +134 -134
  278. tests/test_tools.py +159 -159
  279. tests/test_user_agents.py +96 -96
  280. tests/tools_example.py +260 -260
  281. tests/untested_features_report.md +139 -0
  282. tests/verify_debug.py +52 -0
  283. tests/verify_distributed.py +117 -117
  284. tests/verify_log_fix.py +112 -0
  285. crawlo-1.3.3.dist-info/RECORD +0 -219
  286. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +0 -82
  287. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/WHEEL +0 -0
  288. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/entry_points.txt +0 -0
  289. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/top_level.txt +0 -0
crawlo/core/engine.py CHANGED
@@ -1,366 +1,440 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- import asyncio
4
- import time
5
- from inspect import iscoroutine
6
- from typing import Optional, Generator, Callable
7
-
8
- from crawlo import Request, Item
9
- from crawlo.spider import Spider
10
- from crawlo.utils.log import get_logger
11
- from crawlo.exceptions import OutputError
12
- from crawlo.core.scheduler import Scheduler
13
- from crawlo.core.processor import Processor
14
- from crawlo.task_manager import TaskManager
15
- from crawlo.project import load_class
16
- from crawlo.downloader import DownloaderBase
17
- from crawlo.utils.func_tools import transform
18
- from crawlo.event import spider_opened, spider_error, request_scheduled
19
-
20
-
21
- class Engine(object):
22
-
23
- def __init__(self, crawler):
24
- self.running = False
25
- self.normal = True
26
- self.crawler = crawler
27
- self.settings = crawler.settings
28
- self.spider: Optional[Spider] = None
29
- self.downloader: Optional[DownloaderBase] = None
30
- self.scheduler: Optional[Scheduler] = None
31
- self.processor: Optional[Processor] = None
32
- self.start_requests: Optional[Generator] = None
33
- self.task_manager: Optional[TaskManager] = TaskManager(self.settings.get_int('CONCURRENCY'))
34
-
35
- # Enhanced control parameters
36
- self.max_queue_size = self.settings.get_int('SCHEDULER_MAX_QUEUE_SIZE', 200)
37
- self.generation_batch_size = self.settings.get_int('REQUEST_GENERATION_BATCH_SIZE', 10)
38
- self.generation_interval = self.settings.get_float('REQUEST_GENERATION_INTERVAL', 0.05)
39
- self.backpressure_ratio = self.settings.get_float('BACKPRESSURE_RATIO', 0.8) # Start backpressure when queue reaches 80%
40
-
41
- # State tracking
42
- self._generation_paused = False
43
- self._last_generation_time = 0
44
- self._generation_stats = {
45
- 'total_generated': 0,
46
- 'backpressure_events': 0
47
- }
48
-
49
- self.logger = get_logger(name=self.__class__.__name__)
50
-
51
- def _get_downloader_cls(self):
52
- """Get downloader class, supports multiple configuration methods"""
53
- # 方式1: 使用 DOWNLOADER_TYPE 简化名称(推荐)
54
- downloader_type = self.settings.get('DOWNLOADER_TYPE')
55
- if downloader_type:
56
- try:
57
- from crawlo.downloader import get_downloader_class
58
- downloader_cls = get_downloader_class(downloader_type)
59
- self.logger.debug(f"Using downloader type: {downloader_type} -> {downloader_cls.__name__}")
60
- return downloader_cls
61
- except (ImportError, ValueError) as e:
62
- self.logger.warning(f"Unable to use downloader type '{downloader_type}': {e}, falling back to default configuration")
63
-
64
- # 方式2: 使用 DOWNLOADER 完整类路径(兼容旧版本)
65
- downloader_cls = load_class(self.settings.get('DOWNLOADER'))
66
- if not issubclass(downloader_cls, DownloaderBase):
67
- raise TypeError(f'Downloader {downloader_cls.__name__} is not subclass of DownloaderBase.')
68
- return downloader_cls
69
-
70
- def engine_start(self):
71
- self.running = True
72
- # Get version number, use default value if failed to get
73
- version = self.settings.get('VERSION', '1.0.0')
74
- if not version or version == 'None':
75
- version = '1.0.0'
76
- # Change INFO level log to DEBUG level to avoid duplication with CrawlerProcess startup log
77
- self.logger.debug(
78
- f"Crawlo Started version {version}"
79
- )
80
-
81
- async def start_spider(self, spider):
82
- self.spider = spider
83
-
84
- self.scheduler = Scheduler.create_instance(self.crawler)
85
- if hasattr(self.scheduler, 'open'):
86
- if asyncio.iscoroutinefunction(self.scheduler.open):
87
- await self.scheduler.open()
88
- else:
89
- self.scheduler.open()
90
-
91
- downloader_cls = self._get_downloader_cls()
92
- self.downloader = downloader_cls(self.crawler)
93
- if hasattr(self.downloader, 'open'):
94
- if asyncio.iscoroutinefunction(self.downloader.open):
95
- self.downloader.open()
96
- else:
97
- # DownloaderBase.open() 是同步方法,直接调用而不是await
98
- self.downloader.open()
99
-
100
- self.processor = Processor(self.crawler)
101
- if hasattr(self.processor, 'open'):
102
- if asyncio.iscoroutinefunction(self.processor.open):
103
- await self.processor.open()
104
- else:
105
- # Processor.open() 是同步方法
106
- self.processor.open()
107
-
108
- # 在处理器初始化之后初始化扩展管理器,确保日志输出顺序正确
109
- # 中间件 -> 管道 -> 扩展
110
- if not hasattr(self.crawler, 'extension') or not self.crawler.extension:
111
- self.crawler.extension = self.crawler._create_extension()
112
-
113
- self.start_requests = iter(spider.start_requests())
114
- await self._open_spider()
115
-
116
- async def crawl(self):
117
- """
118
- Crawl the spider
119
- Enhanced version supports intelligent request generation and backpressure control
120
- """
121
- generation_task = None
122
-
123
- try:
124
- # 启动请求生成任务(如果启用了受控生成)
125
- if (self.start_requests and
126
- self.settings.get_bool('ENABLE_CONTROLLED_REQUEST_GENERATION', False)):
127
- generation_task = asyncio.create_task(
128
- self._controlled_request_generation()
129
- )
130
- else:
131
- # 传统方式处理启动请求
132
- generation_task = asyncio.create_task(
133
- self._traditional_request_generation()
134
- )
135
-
136
- # 主爬取循环
137
- while self.running:
138
- # 获取并处理请求
139
- if request := await self._get_next_request():
140
- await self._crawl(request)
141
-
142
- # 检查退出条件
143
- if await self._should_exit():
144
- break
145
-
146
- # 短暂休息避免忙等
147
- await asyncio.sleep(0.001)
148
-
149
- finally:
150
- # 清理生成任务
151
- if generation_task and not generation_task.done():
152
- generation_task.cancel()
153
- try:
154
- await generation_task
155
- except asyncio.CancelledError:
156
- pass
157
-
158
- await self.close_spider()
159
-
160
- async def _traditional_request_generation(self):
161
- """Traditional request generation method (compatible with older versions)"""
162
- while self.running:
163
- try:
164
- start_request = next(self.start_requests)
165
- # 请求入队
166
- await self.enqueue_request(start_request)
167
- except StopIteration:
168
- self.start_requests = None
169
- break
170
- except Exception as exp:
171
- # 1. All requests have been processed
172
- # 2. Is scheduler idle
173
- # 3. Is downloader idle
174
- if not await self._exit():
175
- continue
176
- self.running = False
177
- if self.start_requests is not None:
178
- self.logger.error(f"Error occurred while starting request: {str(exp)}")
179
- await asyncio.sleep(0.001)
180
-
181
- async def _controlled_request_generation(self):
182
- """Controlled request generation (enhanced features)"""
183
- self.logger.info("Starting controlled request generation")
184
-
185
- batch = []
186
- total_generated = 0
187
-
188
- try:
189
- for request in self.start_requests:
190
- batch.append(request)
191
-
192
- # 批量处理
193
- if len(batch) >= self.generation_batch_size:
194
- generated = await self._process_generation_batch(batch)
195
- total_generated += generated
196
- batch = []
197
-
198
- # 背压检查
199
- if await self._should_pause_generation():
200
- await self._wait_for_capacity()
201
-
202
- # 处理剩余请求
203
- if batch:
204
- generated = await self._process_generation_batch(batch)
205
- total_generated += generated
206
-
207
- except Exception as e:
208
- self.logger.error(f"Request generation failed: {e}")
209
-
210
- finally:
211
- self.start_requests = None
212
- self.logger.info(f"Request generation completed, total: {total_generated}")
213
-
214
- async def _process_generation_batch(self, batch) -> int:
215
- """Process a batch of requests"""
216
- generated = 0
217
-
218
- for request in batch:
219
- if not self.running:
220
- break
221
-
222
- # 等待队列有空间
223
- while await self._is_queue_full() and self.running:
224
- await asyncio.sleep(0.1)
225
-
226
- if self.running:
227
- await self.enqueue_request(request)
228
- generated += 1
229
- self._generation_stats['total_generated'] += 1
230
-
231
- # 控制生成速度
232
- if self.generation_interval > 0:
233
- await asyncio.sleep(self.generation_interval)
234
-
235
- return generated
236
-
237
- async def _should_pause_generation(self) -> bool:
238
- """Determine whether generation should be paused"""
239
- # 检查队列大小
240
- if await self._is_queue_full():
241
- return True
242
-
243
- # 检查任务管理器负载
244
- if self.task_manager:
245
- current_tasks = len(self.task_manager.current_task)
246
- if hasattr(self.task_manager, 'semaphore'):
247
- max_concurrency = getattr(self.task_manager.semaphore, '_initial_value', 8)
248
- if current_tasks >= max_concurrency * self.backpressure_ratio:
249
- return True
250
-
251
- return False
252
-
253
- async def _is_queue_full(self) -> bool:
254
- """Check if queue is full"""
255
- if not self.scheduler:
256
- return False
257
-
258
- queue_size = len(self.scheduler)
259
- return queue_size >= self.max_queue_size * self.backpressure_ratio
260
-
261
- async def _wait_for_capacity(self):
262
- """Wait for system to have sufficient capacity"""
263
- self._generation_stats['backpressure_events'] += 1
264
- self.logger.debug("Backpressure triggered, pausing request generation")
265
-
266
- wait_time = 0.1
267
- max_wait = 2.0
268
-
269
- while await self._should_pause_generation() and self.running:
270
- await asyncio.sleep(wait_time)
271
- wait_time = min(wait_time * 1.1, max_wait)
272
-
273
- async def _open_spider(self):
274
- asyncio.create_task(self.crawler.subscriber.notify(spider_opened))
275
- crawling = asyncio.create_task(self.crawl())
276
- await crawling
277
-
278
- async def _crawl(self, request):
279
- # TODO 实现并发
280
- async def crawl_task():
281
- outputs = await self._fetch(request)
282
- # TODO 处理output
283
- if outputs:
284
- await self._handle_spider_output(outputs)
285
-
286
- # 使用异步任务创建,遵守并发限制
287
- await self.task_manager.create_task(crawl_task())
288
-
289
- async def _fetch(self, request):
290
- async def _successful(_response):
291
- callback: Callable = request.callback or self.spider.parse
292
- if _outputs := callback(_response):
293
- if iscoroutine(_outputs):
294
- await _outputs
295
- else:
296
- return transform(_outputs, _response)
297
-
298
- _response = await self.downloader.fetch(request)
299
- if _response is None:
300
- return None
301
- output = await _successful(_response)
302
- return output
303
-
304
- async def enqueue_request(self, start_request):
305
- await self._schedule_request(start_request)
306
-
307
- async def _schedule_request(self, request):
308
- # TODO 去重
309
- if await self.scheduler.enqueue_request(request):
310
- asyncio.create_task(self.crawler.subscriber.notify(request_scheduled, request, self.crawler.spider))
311
-
312
- async def _get_next_request(self):
313
- return await self.scheduler.next_request()
314
-
315
- async def _handle_spider_output(self, outputs):
316
- async for spider_output in outputs:
317
- if isinstance(spider_output, (Request, Item)):
318
- await self.processor.enqueue(spider_output)
319
- elif isinstance(spider_output, Exception):
320
- asyncio.create_task(
321
- self.crawler.subscriber.notify(spider_error, spider_output, self.spider)
322
- )
323
- raise spider_output
324
- else:
325
- raise OutputError(f'{type(self.spider)} must return `Request` or `Item`.')
326
-
327
- async def _exit(self):
328
- if self.scheduler.idle() and self.downloader.idle() and self.task_manager.all_done() and self.processor.idle():
329
- return True
330
- return False
331
-
332
- async def _should_exit(self) -> bool:
333
- """检查是否应该退出"""
334
- # 没有启动请求,且所有队列都空闲
335
- if self.start_requests is None:
336
- # 使用异步的idle检查方法以获得更精确的结果
337
- scheduler_idle = await self.scheduler.async_idle() if hasattr(self.scheduler, 'async_idle') else self.scheduler.idle()
338
-
339
- if (scheduler_idle and
340
- self.downloader.idle() and
341
- self.task_manager.all_done() and
342
- self.processor.idle()):
343
- # 增加额外检查确保所有任务都完成
344
- await asyncio.sleep(0.1) # 短暂等待确保没有新的任务加入
345
- if (await self.scheduler.async_idle() and
346
- self.downloader.idle() and
347
- self.task_manager.all_done() and
348
- self.processor.idle()):
349
- return True
350
-
351
- return False
352
-
353
- async def close_spider(self):
354
- await asyncio.gather(*self.task_manager.current_task)
355
- await self.scheduler.close()
356
- await self.downloader.close()
357
- if self.normal:
358
- await self.crawler.close()
359
-
360
- def get_generation_stats(self) -> dict:
361
- """获取生成统计"""
362
- return {
363
- **self._generation_stats,
364
- 'queue_size': len(self.scheduler) if self.scheduler else 0,
365
- 'active_tasks': len(self.task_manager.current_task) if self.task_manager else 0
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ import time
5
+ from inspect import iscoroutine
6
+ from typing import Optional, Generator, Callable
7
+
8
+ from crawlo import Request, Item
9
+ from crawlo.core.processor import Processor
10
+ from crawlo.core.scheduler import Scheduler
11
+ from crawlo.downloader import DownloaderBase
12
+ from crawlo.event import spider_opened, spider_error, request_scheduled
13
+ from crawlo.exceptions import OutputError
14
+ from crawlo.utils.class_loader import load_class
15
+ from crawlo.spider import Spider
16
+ from crawlo.task_manager import TaskManager
17
+ from crawlo.utils.func_tools import transform
18
+ from crawlo.utils.log import get_logger
19
+
20
+
21
+ class Engine(object):
22
+
23
+ def __init__(self, crawler):
24
+ self.running = False
25
+ self.normal = True
26
+ self.crawler = crawler
27
+ self.settings = crawler.settings
28
+ self.spider: Optional[Spider] = None
29
+ self.downloader: Optional[DownloaderBase] = None
30
+ self.scheduler: Optional[Scheduler] = None
31
+ self.processor: Optional[Processor] = None
32
+ self.start_requests: Optional[Generator] = None
33
+ self.task_manager: Optional[TaskManager] = TaskManager(self.settings.get_int('CONCURRENCY'))
34
+
35
+ # Enhanced control parameters
36
+ self.max_queue_size = self.settings.get_int('SCHEDULER_MAX_QUEUE_SIZE', 200)
37
+ self.generation_batch_size = self.settings.get_int('REQUEST_GENERATION_BATCH_SIZE', 10)
38
+ self.generation_interval = self.settings.get_float('REQUEST_GENERATION_INTERVAL', 0.01) # 优化默认值
39
+ self.backpressure_ratio = self.settings.get_float('BACKPRESSURE_RATIO', 0.9) # 优化默认值
40
+
41
+ # State tracking
42
+ self._generation_paused = False
43
+ self._last_generation_time = 0
44
+ self._generation_stats = {
45
+ 'total_generated': 0,
46
+ 'backpressure_events': 0
47
+ }
48
+
49
+ self.logger = get_logger(name=self.__class__.__name__)
50
+
51
+ def _get_downloader_cls(self):
52
+ """Get downloader class, supports multiple configuration methods"""
53
+ # 方式1: 使用 DOWNLOADER_TYPE 简化名称(推荐)
54
+ downloader_type = self.settings.get('DOWNLOADER_TYPE')
55
+ if downloader_type:
56
+ try:
57
+ from crawlo.downloader import get_downloader_class
58
+ downloader_cls = get_downloader_class(downloader_type)
59
+ self.logger.debug(f"Using downloader type: {downloader_type} -> {downloader_cls.__name__}")
60
+ return downloader_cls
61
+ except (ImportError, ValueError) as e:
62
+ self.logger.warning(f"Unable to use downloader type '{downloader_type}': {e}, falling back to default configuration")
63
+
64
+ # 方式2: 使用 DOWNLOADER 完整类路径(兼容旧版本)
65
+ downloader_cls = load_class(self.settings.get('DOWNLOADER'))
66
+ if not issubclass(downloader_cls, DownloaderBase):
67
+ raise TypeError(f'Downloader {downloader_cls.__name__} is not subclass of DownloaderBase.')
68
+ return downloader_cls
69
+
70
+ def engine_start(self):
71
+ self.running = True
72
+ # Get version number, use default value if failed to get
73
+ version = self.settings.get('VERSION', '1.0.0')
74
+ if not version or version == 'None':
75
+ version = '1.0.0'
76
+ # Change INFO level log to DEBUG level to avoid duplication with CrawlerProcess startup log
77
+ self.logger.debug(f"Crawlo Framework Started {version}")
78
+
79
+ async def start_spider(self, spider):
80
+ self.spider = spider
81
+
82
+ self.scheduler = Scheduler.create_instance(self.crawler)
83
+ if hasattr(self.scheduler, 'open'):
84
+ if asyncio.iscoroutinefunction(self.scheduler.open):
85
+ await self.scheduler.open()
86
+ else:
87
+ self.scheduler.open()
88
+
89
+ downloader_cls = self._get_downloader_cls()
90
+ self.downloader = downloader_cls(self.crawler)
91
+ if hasattr(self.downloader, 'open'):
92
+ if asyncio.iscoroutinefunction(self.downloader.open):
93
+ self.downloader.open()
94
+ else:
95
+ # DownloaderBase.open() 是同步方法,直接调用而不是await
96
+ self.downloader.open()
97
+
98
+ self.processor = Processor(self.crawler)
99
+ if hasattr(self.processor, 'open'):
100
+ if asyncio.iscoroutinefunction(self.processor.open):
101
+ await self.processor.open()
102
+ else:
103
+ # Processor.open() 是同步方法
104
+ self.processor.open()
105
+
106
+ # 在处理器初始化之后初始化扩展管理器,确保日志输出顺序正确
107
+ # 中间件 -> 管道 -> 扩展
108
+ if not hasattr(self.crawler, 'extension') or not self.crawler.extension:
109
+ self.crawler.extension = self.crawler._create_extension()
110
+
111
+ # 启动引擎
112
+ self.engine_start()
113
+
114
+ self.logger.debug("开始创建start_requests迭代器")
115
+ try:
116
+ # 先收集所有请求到列表中,避免在检查时消耗迭代器
117
+ requests_list = list(spider.start_requests())
118
+ self.logger.debug(f"收集到 {len(requests_list)} 个请求")
119
+ self.start_requests = iter(requests_list)
120
+ self.logger.debug("start_requests迭代器创建成功")
121
+ except Exception as e:
122
+ self.logger.error(f"创建start_requests迭代器失败: {e}")
123
+ import traceback
124
+ self.logger.error(traceback.format_exc())
125
+ await self._open_spider()
126
+
127
+ async def crawl(self):
128
+ """
129
+ Crawl the spider
130
+ Enhanced version supports intelligent request generation and backpressure control
131
+ """
132
+ generation_task = None
133
+
134
+ try:
135
+ # 启动请求生成任务(如果启用了受控生成)
136
+ if (self.start_requests and
137
+ self.settings.get_bool('ENABLE_CONTROLLED_REQUEST_GENERATION', False)):
138
+ self.logger.debug("创建受控请求生成任务")
139
+ generation_task = asyncio.create_task(
140
+ self._controlled_request_generation()
141
+ )
142
+ else:
143
+ # 传统方式处理启动请求
144
+ self.logger.debug("创建传统请求生成任务")
145
+ generation_task = asyncio.create_task(
146
+ self._traditional_request_generation()
147
+ )
148
+
149
+ self.logger.debug("请求生成任务创建完成")
150
+
151
+ # 主爬取循环
152
+ loop_count = 0
153
+ last_exit_check = 0 # 记录上次检查退出条件的时间
154
+ exit_check_interval = 1 # 每1次循环检查一次退出条件,进一步提高检查频率
155
+
156
+ while self.running:
157
+ loop_count += 1
158
+ # 获取并处理请求
159
+ if request := await self._get_next_request():
160
+ await self._crawl(request)
161
+
162
+ # 优化退出条件检查频率
163
+ if loop_count - last_exit_check >= exit_check_interval:
164
+ should_exit = await self._should_exit()
165
+ if should_exit:
166
+ self.logger.debug("满足退出条件,准备退出循环")
167
+ break
168
+ last_exit_check = loop_count
169
+
170
+ # 短暂休息避免忙等,但减少休息时间以提高效率
171
+ await asyncio.sleep(0.000001) # 从0.00001减少到0.000001
172
+
173
+ self.logger.debug(f"主爬取循环结束,总共执行了 {loop_count} 次")
174
+
175
+ finally:
176
+ # 确保请求生成任务完成
177
+ if generation_task and not generation_task.done():
178
+ try:
179
+ await generation_task
180
+ except asyncio.CancelledError:
181
+ pass
182
+
183
+ await self.close_spider()
184
+
185
+ async def _traditional_request_generation(self):
186
+ """Traditional request generation method (compatible with older versions)"""
187
+ self.logger.debug("开始处理传统请求生成")
188
+ processed_count = 0
189
+ while self.running:
190
+ try:
191
+ start_request = next(self.start_requests)
192
+ self.logger.debug(f"获取到请求: {getattr(start_request, 'url', 'Unknown URL')}")
193
+ # 请求入队
194
+ await self.enqueue_request(start_request)
195
+ processed_count += 1
196
+ self.logger.debug(f"已处理请求数量: {processed_count}")
197
+ except StopIteration:
198
+ self.logger.debug("所有起始请求处理完成")
199
+ self.start_requests = None
200
+ break
201
+ except Exception as exp:
202
+ self.logger.error(f"处理请求时发生异常: {exp}")
203
+ import traceback
204
+ self.logger.error(traceback.format_exc())
205
+ # 1. All requests have been processed
206
+ # 2. Is scheduler idle
207
+ # 3. Is downloader idle
208
+ if not await self._exit():
209
+ continue
210
+ self.running = False
211
+ if self.start_requests is not None:
212
+ self.logger.error(f"Error occurred while starting request: {str(exp)}")
213
+ # 减少等待时间以提高效率
214
+ await asyncio.sleep(0.00001) # 从0.0001减少到0.00001
215
+ self.logger.debug(f"传统请求生成完成,总共处理了 {processed_count} 个请求")
216
+
217
+ async def _controlled_request_generation(self):
218
+ """Controlled request generation (enhanced features)"""
219
+ self.logger.debug("Starting controlled request generation")
220
+
221
+ batch = []
222
+ total_generated = 0
223
+
224
+ try:
225
+ for request in self.start_requests:
226
+ batch.append(request)
227
+
228
+ # 批量处理
229
+ if len(batch) >= self.generation_batch_size:
230
+ generated = await self._process_generation_batch(batch)
231
+ total_generated += generated
232
+ batch = []
233
+
234
+ # 背压检查
235
+ if await self._should_pause_generation():
236
+ await self._wait_for_capacity()
237
+
238
+ # 处理剩余请求
239
+ if batch:
240
+ generated = await self._process_generation_batch(batch)
241
+ total_generated += generated
242
+
243
+ except Exception as e:
244
+ self.logger.error(f"Request generation failed: {e}")
245
+
246
+ finally:
247
+ self.start_requests = None
248
+ self.logger.debug(f"Request generation completed, total: {total_generated}")
249
+
250
+ async def _process_generation_batch(self, batch) -> int:
251
+ """Process a batch of requests"""
252
+ generated = 0
253
+
254
+ for request in batch:
255
+ if not self.running:
256
+ break
257
+
258
+ # 等待队列有空间
259
+ while await self._is_queue_full() and self.running:
260
+ await asyncio.sleep(0.01) # 减少等待时间
261
+
262
+ if self.running:
263
+ await self.enqueue_request(request)
264
+ generated += 1
265
+ self._generation_stats['total_generated'] += 1
266
+
267
+ # 控制生成速度,但使用更小的间隔
268
+ if self.generation_interval > 0:
269
+ await asyncio.sleep(self.generation_interval)
270
+
271
+ return generated
272
+
273
+ async def _should_pause_generation(self) -> bool:
274
+ """Determine whether generation should be paused"""
275
+ # 检查队列大小
276
+ if await self._is_queue_full():
277
+ return True
278
+
279
+ # 检查任务管理器负载
280
+ if self.task_manager:
281
+ current_tasks = len(self.task_manager.current_task)
282
+ if hasattr(self.task_manager, 'semaphore'):
283
+ max_concurrency = getattr(self.task_manager.semaphore, '_initial_value', 8)
284
+ if current_tasks >= max_concurrency * self.backpressure_ratio:
285
+ return True
286
+
287
+ return False
288
+
289
+ async def _is_queue_full(self) -> bool:
290
+ """Check if queue is full"""
291
+ if not self.scheduler:
292
+ return False
293
+
294
+ queue_size = len(self.scheduler)
295
+ return queue_size >= self.max_queue_size * self.backpressure_ratio
296
+
297
+ async def _wait_for_capacity(self):
298
+ """Wait for system to have sufficient capacity"""
299
+ self._generation_stats['backpressure_events'] += 1
300
+ self.logger.debug("Backpressure triggered, pausing request generation")
301
+
302
+ wait_time = 0.01 # 减少初始等待时间
303
+ max_wait = 1.0 # 减少最大等待时间
304
+
305
+ while await self._should_pause_generation() and self.running:
306
+ await asyncio.sleep(wait_time)
307
+ wait_time = min(wait_time * 1.1, max_wait)
308
+
309
+ async def _open_spider(self):
310
+ asyncio.create_task(self.crawler.subscriber.notify(spider_opened))
311
+ # 直接调用crawl方法而不是创建任务,确保等待完成
312
+ await self.crawl()
313
+
314
+ async def _crawl(self, request):
315
+ async def crawl_task():
316
+ start_time = time.time()
317
+ try:
318
+ outputs = await self._fetch(request)
319
+ # 记录响应时间
320
+ response_time = time.time() - start_time
321
+ if self.task_manager:
322
+ self.task_manager.record_response_time(response_time)
323
+
324
+ # TODO 处理output
325
+ if outputs:
326
+ await self._handle_spider_output(outputs)
327
+ except Exception as e:
328
+ # 记录详细的异常信息
329
+ self.logger.error(
330
+ f"处理请求失败: {getattr(request, 'url', 'Unknown URL')} - {type(e).__name__}: {e}"
331
+ )
332
+ self.logger.debug(f"详细异常信息", exc_info=True)
333
+
334
+ # 发送统计事件
335
+ if hasattr(self.crawler, 'stats'):
336
+ self.crawler.stats.inc_value('downloader/exception_count')
337
+ self.crawler.stats.inc_value(f'downloader/exception_type_count/{type(e).__name__}')
338
+ if hasattr(request, 'url'):
339
+ self.crawler.stats.inc_value(f'downloader/failed_urls_count')
340
+
341
+ # 不再重新抛出异常,避免未处理的Task异常
342
+ return None
343
+
344
+ # 使用异步任务创建,遵守并发限制
345
+ await self.task_manager.create_task(crawl_task())
346
+
347
+ async def _fetch(self, request):
348
+ async def _successful(_response):
349
+ callback: Callable = request.callback or self.spider.parse
350
+ if _outputs := callback(_response):
351
+ if iscoroutine(_outputs):
352
+ await _outputs
353
+ else:
354
+ return transform(_outputs, _response)
355
+
356
+ _response = await self.downloader.fetch(request)
357
+ if _response is None:
358
+ return None
359
+ output = await _successful(_response)
360
+ return output
361
+
362
+ async def enqueue_request(self, start_request):
363
+ await self._schedule_request(start_request)
364
+
365
+ async def _schedule_request(self, request):
366
+ # TODO 去重
367
+ if await self.scheduler.enqueue_request(request):
368
+ asyncio.create_task(self.crawler.subscriber.notify(request_scheduled, request, self.crawler.spider))
369
+
370
+ async def _get_next_request(self):
371
+ return await self.scheduler.next_request()
372
+
373
+ async def _handle_spider_output(self, outputs):
374
+ async for spider_output in outputs:
375
+ if isinstance(spider_output, (Request, Item)):
376
+ await self.processor.enqueue(spider_output)
377
+ elif isinstance(spider_output, Exception):
378
+ asyncio.create_task(
379
+ self.crawler.subscriber.notify(spider_error, spider_output, self.spider)
380
+ )
381
+ raise spider_output
382
+ else:
383
+ raise OutputError(f'{type(self.spider)} must return `Request` or `Item`.')
384
+
385
+ async def _exit(self):
386
+ if self.scheduler.idle() and self.downloader.idle() and self.task_manager.all_done() and self.processor.idle():
387
+ return True
388
+ return False
389
+
390
+ async def _should_exit(self) -> bool:
391
+ """检查是否应该退出"""
392
+ self.logger.debug(f"检查退出条件: start_requests={self.start_requests is not None}")
393
+ # 没有启动请求,且所有队列都空闲
394
+ if self.start_requests is None:
395
+ self.logger.debug("start_requests 为 None,检查其他组件状态")
396
+ # 使用异步的idle检查方法以获得更精确的结果
397
+ scheduler_idle = await self.scheduler.async_idle() if hasattr(self.scheduler, 'async_idle') else self.scheduler.idle()
398
+ downloader_idle = self.downloader.idle()
399
+ task_manager_done = self.task_manager.all_done()
400
+ processor_idle = self.processor.idle()
401
+
402
+ self.logger.debug(f"组件状态 - Scheduler: {scheduler_idle}, Downloader: {downloader_idle}, TaskManager: {task_manager_done}, Processor: {processor_idle}")
403
+
404
+ if (scheduler_idle and
405
+ downloader_idle and
406
+ task_manager_done and
407
+ processor_idle):
408
+ # 立即进行二次检查,不等待
409
+ scheduler_idle = await self.scheduler.async_idle() if hasattr(self.scheduler, 'async_idle') else self.scheduler.idle()
410
+ downloader_idle = self.downloader.idle()
411
+ task_manager_done = self.task_manager.all_done()
412
+ processor_idle = self.processor.idle()
413
+
414
+ self.logger.debug(f"二次检查组件状态 - Scheduler: {scheduler_idle}, Downloader: {downloader_idle}, TaskManager: {task_manager_done}, Processor: {processor_idle}")
415
+
416
+ if (scheduler_idle and
417
+ downloader_idle and
418
+ task_manager_done and
419
+ processor_idle):
420
+ self.logger.info("所有组件都空闲,准备退出")
421
+ return True
422
+ else:
423
+ self.logger.debug("start_requests 不为 None,不退出")
424
+
425
+ return False
426
+
427
+ async def close_spider(self):
428
+ # 不再调用crawler.close(),避免重复清理
429
+ # 清理工作应该由crawler的_lifecycle_manager上下文管理器来处理
430
+ await asyncio.gather(*self.task_manager.current_task)
431
+ await self.scheduler.close()
432
+ await self.downloader.close()
433
+
434
+ def get_generation_stats(self) -> dict:
435
+ """获取生成统计"""
436
+ return {
437
+ **self._generation_stats,
438
+ 'queue_size': len(self.scheduler) if self.scheduler else 0,
439
+ 'active_tasks': len(self.task_manager.current_task) if self.task_manager else 0
366
440
  }