crawlo 1.2.8__py3-none-any.whl → 1.3.0__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 +63 -61
  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 +314 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +186 -186
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -251
  15. crawlo/core/__init__.py +2 -2
  16. crawlo/core/engine.py +365 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +256 -251
  19. crawlo/crawler.py +1097 -1099
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -107
  22. crawlo/downloader/__init__.py +273 -266
  23. crawlo/downloader/aiohttp_downloader.py +226 -228
  24. crawlo/downloader/cffi_downloader.py +245 -256
  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 +45 -43
  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/filters/__init__.py +154 -154
  40. crawlo/filters/aioredis_filter.py +234 -234
  41. crawlo/filters/memory_filter.py +269 -269
  42. crawlo/items/__init__.py +23 -23
  43. crawlo/items/base.py +21 -21
  44. crawlo/items/fields.py +52 -52
  45. crawlo/items/items.py +104 -104
  46. crawlo/middleware/__init__.py +21 -21
  47. crawlo/middleware/default_header.py +132 -132
  48. crawlo/middleware/download_delay.py +104 -104
  49. crawlo/middleware/middleware_manager.py +136 -136
  50. crawlo/middleware/offsite.py +114 -114
  51. crawlo/middleware/proxy.py +386 -368
  52. crawlo/middleware/request_ignore.py +86 -86
  53. crawlo/middleware/response_code.py +163 -163
  54. crawlo/middleware/response_filter.py +136 -136
  55. crawlo/middleware/retry.py +124 -124
  56. crawlo/middleware/simple_proxy.py +65 -0
  57. crawlo/mode_manager.py +212 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +379 -338
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +157 -157
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +223 -223
  66. crawlo/pipelines/json_pipeline.py +218 -218
  67. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  68. crawlo/pipelines/mongo_pipeline.py +131 -131
  69. crawlo/pipelines/mysql_pipeline.py +317 -317
  70. crawlo/pipelines/pipeline_manager.py +74 -62
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +284 -315
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +379 -378
  75. crawlo/queue/redis_priority_queue.py +306 -306
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +216 -220
  78. crawlo/settings/setting_manager.py +175 -122
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +129 -129
  82. crawlo/task_manager.py +30 -30
  83. crawlo/templates/crawlo.cfg.tmpl +10 -10
  84. crawlo/templates/project/__init__.py.tmpl +3 -3
  85. crawlo/templates/project/items.py.tmpl +17 -17
  86. crawlo/templates/project/middlewares.py.tmpl +118 -118
  87. crawlo/templates/project/pipelines.py.tmpl +96 -96
  88. crawlo/templates/project/settings.py.tmpl +261 -288
  89. crawlo/templates/project/settings_distributed.py.tmpl +174 -157
  90. crawlo/templates/project/settings_gentle.py.tmpl +95 -100
  91. crawlo/templates/project/settings_high_performance.py.tmpl +125 -134
  92. crawlo/templates/project/settings_minimal.py.tmpl +30 -0
  93. crawlo/templates/project/settings_simple.py.tmpl +96 -98
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +47 -47
  96. crawlo/templates/spider/spider.py.tmpl +143 -143
  97. crawlo/tools/__init__.py +200 -182
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/{cleaners → tools}/data_formatter.py +225 -225
  101. crawlo/tools/data_validator.py +180 -180
  102. crawlo/tools/date_tools.py +290 -36
  103. crawlo/tools/distributed_coordinator.py +388 -387
  104. crawlo/{cleaners → tools}/encoding_converter.py +127 -126
  105. crawlo/tools/request_tools.py +83 -0
  106. crawlo/tools/retry_mechanism.py +224 -221
  107. crawlo/tools/scenario_adapter.py +262 -262
  108. crawlo/{cleaners → tools}/text_cleaner.py +232 -232
  109. crawlo/utils/__init__.py +35 -35
  110. crawlo/utils/batch_processor.py +259 -259
  111. crawlo/utils/controlled_spider_mixin.py +439 -439
  112. crawlo/utils/db_helper.py +343 -343
  113. crawlo/utils/enhanced_error_handler.py +356 -356
  114. crawlo/utils/env_config.py +142 -142
  115. crawlo/utils/error_handler.py +123 -123
  116. crawlo/utils/func_tools.py +82 -82
  117. crawlo/utils/large_scale_config.py +286 -286
  118. crawlo/utils/large_scale_helper.py +344 -344
  119. crawlo/utils/log.py +146 -128
  120. crawlo/utils/performance_monitor.py +285 -285
  121. crawlo/utils/queue_helper.py +175 -175
  122. crawlo/utils/redis_connection_pool.py +351 -351
  123. crawlo/utils/redis_key_validator.py +198 -198
  124. crawlo/utils/request.py +267 -267
  125. crawlo/utils/request_serializer.py +218 -218
  126. crawlo/utils/spider_loader.py +61 -61
  127. crawlo/utils/system.py +11 -11
  128. crawlo/utils/tools.py +4 -4
  129. crawlo/utils/url.py +39 -39
  130. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/METADATA +1011 -764
  131. crawlo-1.3.0.dist-info/RECORD +219 -0
  132. examples/__init__.py +7 -7
  133. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  134. tests/__init__.py +7 -7
  135. tests/advanced_tools_example.py +275 -275
  136. tests/authenticated_proxy_example.py +107 -237
  137. tests/cleaners_example.py +160 -160
  138. tests/config_validation_demo.py +143 -103
  139. tests/controlled_spider_example.py +205 -205
  140. tests/date_tools_example.py +180 -180
  141. tests/debug_pipelines.py +67 -0
  142. tests/dynamic_loading_example.py +523 -523
  143. tests/dynamic_loading_test.py +104 -104
  144. tests/env_config_example.py +133 -133
  145. tests/error_handling_example.py +171 -171
  146. tests/redis_key_validation_demo.py +130 -130
  147. tests/request_params_example.py +151 -0
  148. tests/response_improvements_example.py +144 -144
  149. tests/test_advanced_tools.py +148 -148
  150. tests/test_all_redis_key_configs.py +145 -145
  151. tests/test_authenticated_proxy.py +141 -141
  152. tests/test_cleaners.py +54 -54
  153. tests/test_comprehensive.py +146 -146
  154. tests/test_config_consistency.py +80 -80
  155. tests/test_config_merge.py +153 -0
  156. tests/test_config_validator.py +182 -193
  157. tests/test_crawlo_proxy_integration.py +109 -173
  158. tests/test_date_tools.py +123 -123
  159. tests/test_default_header_middleware.py +158 -158
  160. tests/test_distributed.py +65 -0
  161. tests/test_double_crawlo_fix.py +207 -207
  162. tests/test_double_crawlo_fix_simple.py +124 -124
  163. tests/test_download_delay_middleware.py +221 -221
  164. tests/test_downloader_proxy_compatibility.py +268 -268
  165. tests/test_dynamic_downloaders_proxy.py +124 -124
  166. tests/test_dynamic_proxy.py +92 -92
  167. tests/test_dynamic_proxy_config.py +146 -146
  168. tests/test_dynamic_proxy_real.py +109 -109
  169. tests/test_edge_cases.py +303 -303
  170. tests/test_enhanced_error_handler.py +270 -270
  171. tests/test_env_config.py +121 -121
  172. tests/test_error_handler_compatibility.py +112 -112
  173. tests/test_final_validation.py +153 -153
  174. tests/test_framework_env_usage.py +103 -103
  175. tests/test_integration.py +169 -357
  176. tests/test_item_dedup_redis_key.py +122 -122
  177. tests/test_mode_consistency.py +51 -51
  178. tests/test_offsite_middleware.py +221 -221
  179. tests/test_parsel.py +29 -29
  180. tests/test_performance.py +327 -327
  181. tests/test_proxy_api.py +264 -264
  182. tests/test_proxy_health_check.py +32 -32
  183. tests/test_proxy_middleware.py +121 -121
  184. tests/test_proxy_middleware_enhanced.py +216 -216
  185. tests/test_proxy_middleware_integration.py +136 -136
  186. tests/test_proxy_middleware_refactored.py +185 -0
  187. tests/test_proxy_providers.py +56 -56
  188. tests/test_proxy_stats.py +19 -19
  189. tests/test_proxy_strategies.py +59 -59
  190. tests/test_queue_manager_double_crawlo.py +173 -173
  191. tests/test_queue_manager_redis_key.py +176 -176
  192. tests/test_random_user_agent.py +73 -0
  193. tests/test_real_scenario_proxy.py +195 -195
  194. tests/test_redis_config.py +28 -28
  195. tests/test_redis_connection_pool.py +294 -294
  196. tests/test_redis_key_naming.py +181 -181
  197. tests/test_redis_key_validator.py +123 -123
  198. tests/test_redis_queue.py +224 -224
  199. tests/test_request_ignore_middleware.py +182 -182
  200. tests/test_request_params.py +112 -0
  201. tests/test_request_serialization.py +70 -70
  202. tests/test_response_code_middleware.py +349 -349
  203. tests/test_response_filter_middleware.py +427 -427
  204. tests/test_response_improvements.py +152 -152
  205. tests/test_retry_middleware.py +241 -241
  206. tests/test_scheduler.py +252 -252
  207. tests/test_scheduler_config_update.py +133 -133
  208. tests/test_simple_response.py +61 -61
  209. tests/test_telecom_spider_redis_key.py +205 -205
  210. tests/test_template_content.py +87 -87
  211. tests/test_template_redis_key.py +134 -134
  212. tests/test_tools.py +159 -153
  213. tests/test_user_agents.py +97 -0
  214. tests/tools_example.py +260 -257
  215. tests/verify_distributed.py +117 -0
  216. crawlo/cleaners/__init__.py +0 -61
  217. crawlo/utils/date_tools.py +0 -290
  218. crawlo-1.2.8.dist-info/RECORD +0 -209
  219. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/WHEEL +0 -0
  220. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/entry_points.txt +0 -0
  221. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/top_level.txt +0 -0
crawlo/core/engine.py CHANGED
@@ -1,366 +1,366 @@
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
- # 增强控制参数
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) # 队列达到80%时启动背压
40
-
41
- # 状态跟踪
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
- """获取下载器类,支持多种配置方式"""
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"使用下载器类型: {downloader_type} -> {downloader_cls.__name__}")
60
- return downloader_cls
61
- except (ImportError, ValueError) as e:
62
- self.logger.warning(f"无法使用下载器类型 '{downloader_type}': {e},回退到默认配置")
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
- # 获取版本号,如果获取失败则使用默认值
73
- version = self.settings.get('VERSION', '1.0.0')
74
- if not version or version == 'None':
75
- version = '1.0.0'
76
- self.logger.info(
77
- f"Crawlo Started version {version} . "
78
- # f"(project name : {self.settings.get('PROJECT_NAME')})"
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
- 增强版本支持智能请求生成和背压控制
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
- """传统的请求生成方式(兼容旧版本)"""
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、发去请求的request全部运行完毕
172
- # 2、调度器是否空闲
173
- # 3、下载器是否空闲
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"启动请求时发生错误: {str(exp)}")
179
- await asyncio.sleep(0.001)
180
-
181
- async def _controlled_request_generation(self):
182
- """受控的请求生成(增强功能)"""
183
- self.logger.info("🎛️ 启动受控请求生成")
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" 请求生成失败: {e}")
209
-
210
- finally:
211
- self.start_requests = None
212
- self.logger.info(f"🎉 请求生成完成,总计: {total_generated}")
213
-
214
- async def _process_generation_batch(self, batch) -> int:
215
- """处理一批请求"""
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
- """判断是否应该暂停生成"""
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
- """检查队列是否已满"""
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
- """等待系统有足够容量"""
263
- self._generation_stats['backpressure_events'] += 1
264
- self.logger.debug("⏸️ 触发背压,暂停请求生成")
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.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
366
366
  }