crawlo 1.3.3__py3-none-any.whl → 1.3.4__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 (279) 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 +318 -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 +44 -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.4.dist-info}/METADATA +1126 -1020
  149. crawlo-1.3.4.dist-info/RECORD +278 -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_levels.py +64 -0
  166. tests/debug_pipelines.py +66 -66
  167. tests/distributed_test.py +67 -0
  168. tests/distributed_test_debug.py +77 -0
  169. tests/dynamic_loading_example.py +523 -523
  170. tests/dynamic_loading_test.py +104 -104
  171. tests/env_config_example.py +133 -133
  172. tests/error_handling_example.py +171 -171
  173. tests/final_command_test_report.md +0 -0
  174. tests/final_comprehensive_test.py +152 -0
  175. tests/final_validation_test.py +183 -0
  176. tests/framework_performance_test.py +203 -0
  177. tests/optimized_performance_test.py +212 -0
  178. tests/performance_comparison.py +246 -0
  179. tests/queue_blocking_test.py +114 -0
  180. tests/queue_test.py +90 -0
  181. tests/redis_key_validation_demo.py +130 -130
  182. tests/request_params_example.py +150 -150
  183. tests/response_improvements_example.py +144 -144
  184. tests/scrapy_comparison/ofweek_scrapy.py +139 -0
  185. tests/scrapy_comparison/scrapy_test.py +134 -0
  186. tests/simple_command_test.py +120 -0
  187. tests/simple_crawlo_test.py +128 -0
  188. tests/simple_log_test.py +58 -0
  189. tests/simple_optimization_test.py +129 -0
  190. tests/simple_spider_test.py +50 -0
  191. tests/simple_test.py +48 -0
  192. tests/test_advanced_tools.py +148 -148
  193. tests/test_all_commands.py +231 -0
  194. tests/test_all_redis_key_configs.py +145 -145
  195. tests/test_authenticated_proxy.py +141 -141
  196. tests/test_batch_processor.py +179 -0
  197. tests/test_cleaners.py +54 -54
  198. tests/test_component_factory.py +175 -0
  199. tests/test_comprehensive.py +146 -146
  200. tests/test_config_consistency.py +80 -80
  201. tests/test_config_merge.py +152 -152
  202. tests/test_config_validator.py +182 -182
  203. tests/test_controlled_spider_mixin.py +80 -0
  204. tests/test_crawlo_proxy_integration.py +108 -108
  205. tests/test_date_tools.py +123 -123
  206. tests/test_default_header_middleware.py +158 -158
  207. tests/test_distributed.py +65 -65
  208. tests/test_double_crawlo_fix.py +207 -207
  209. tests/test_double_crawlo_fix_simple.py +124 -124
  210. tests/test_download_delay_middleware.py +221 -221
  211. tests/test_downloader_proxy_compatibility.py +268 -268
  212. tests/test_dynamic_downloaders_proxy.py +124 -124
  213. tests/test_dynamic_proxy.py +92 -92
  214. tests/test_dynamic_proxy_config.py +146 -146
  215. tests/test_dynamic_proxy_real.py +109 -109
  216. tests/test_edge_cases.py +303 -303
  217. tests/test_enhanced_error_handler.py +270 -270
  218. tests/test_enhanced_error_handler_comprehensive.py +246 -0
  219. tests/test_env_config.py +121 -121
  220. tests/test_error_handler_compatibility.py +112 -112
  221. tests/test_factories.py +253 -0
  222. tests/test_final_validation.py +153 -153
  223. tests/test_framework_env_usage.py +103 -103
  224. tests/test_framework_logger.py +67 -0
  225. tests/test_framework_startup.py +65 -0
  226. tests/test_integration.py +169 -169
  227. tests/test_item_dedup_redis_key.py +122 -122
  228. tests/test_large_scale_config.py +113 -0
  229. tests/test_large_scale_helper.py +236 -0
  230. tests/test_mode_change.py +73 -0
  231. tests/test_mode_consistency.py +51 -51
  232. tests/test_offsite_middleware.py +221 -221
  233. tests/test_parsel.py +29 -29
  234. tests/test_performance.py +327 -327
  235. tests/test_performance_monitor.py +116 -0
  236. tests/test_proxy_api.py +264 -264
  237. tests/test_proxy_health_check.py +32 -32
  238. tests/test_proxy_middleware.py +121 -121
  239. tests/test_proxy_middleware_enhanced.py +216 -216
  240. tests/test_proxy_middleware_integration.py +136 -136
  241. tests/test_proxy_middleware_refactored.py +184 -184
  242. tests/test_proxy_providers.py +56 -56
  243. tests/test_proxy_stats.py +19 -19
  244. tests/test_proxy_strategies.py +59 -59
  245. tests/test_queue_empty_check.py +42 -0
  246. tests/test_queue_manager_double_crawlo.py +173 -173
  247. tests/test_queue_manager_redis_key.py +176 -176
  248. tests/test_random_user_agent.py +72 -72
  249. tests/test_real_scenario_proxy.py +195 -195
  250. tests/test_redis_config.py +28 -28
  251. tests/test_redis_connection_pool.py +294 -294
  252. tests/test_redis_key_naming.py +181 -181
  253. tests/test_redis_key_validator.py +123 -123
  254. tests/test_redis_queue.py +224 -224
  255. tests/test_request_ignore_middleware.py +182 -182
  256. tests/test_request_params.py +111 -111
  257. tests/test_request_serialization.py +70 -70
  258. tests/test_response_code_middleware.py +349 -349
  259. tests/test_response_filter_middleware.py +427 -427
  260. tests/test_response_improvements.py +152 -152
  261. tests/test_retry_middleware.py +241 -241
  262. tests/test_scheduler.py +252 -252
  263. tests/test_scheduler_config_update.py +133 -133
  264. tests/test_simple_response.py +61 -61
  265. tests/test_telecom_spider_redis_key.py +205 -205
  266. tests/test_template_content.py +87 -87
  267. tests/test_template_redis_key.py +134 -134
  268. tests/test_tools.py +159 -159
  269. tests/test_user_agents.py +96 -96
  270. tests/tools_example.py +260 -260
  271. tests/untested_features_report.md +139 -0
  272. tests/verify_debug.py +52 -0
  273. tests/verify_distributed.py +117 -117
  274. tests/verify_log_fix.py +112 -0
  275. crawlo-1.3.3.dist-info/RECORD +0 -219
  276. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +0 -82
  277. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/WHEEL +0 -0
  278. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/entry_points.txt +0 -0
  279. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/top_level.txt +0 -0
@@ -1,226 +1,228 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- from yarl import URL
4
- from typing import Optional
5
- from aiohttp import (
6
- ClientSession,
7
- TCPConnector,
8
- ClientTimeout,
9
- TraceConfig,
10
- ClientResponse,
11
- ClientError,
12
- BasicAuth,
13
- )
14
-
15
- from crawlo.network.response import Response
16
- from crawlo.utils.log import get_logger
17
- from crawlo.downloader import DownloaderBase
18
-
19
-
20
- class AioHttpDownloader(DownloaderBase):
21
- """
22
- 高性能异步下载器
23
- - 基于持久化 ClientSession
24
- - 智能识别 Request 的高层语义(json_body/form_data)
25
- - 支持 GET/POST/PUT/DELETE 等方法
26
- - 支持中间件设置的 IP 代理(HTTP/HTTPS)
27
- - 内存安全防护
28
- """
29
-
30
- def __init__(self, crawler):
31
- super().__init__(crawler)
32
- self.session: Optional[ClientSession] = None
33
- self.max_download_size: int = 0
34
- self.logger = get_logger(self.__class__.__name__, crawler.settings.get("LOG_LEVEL"))
35
-
36
- def open(self):
37
- super().open()
38
- # 恢复关键的下载器启动信息为INFO级别
39
- # 读取配置
40
- timeout_secs = self.crawler.settings.get_int("DOWNLOAD_TIMEOUT", 30)
41
- verify_ssl = self.crawler.settings.get_bool("VERIFY_SSL", True)
42
- pool_limit = self.crawler.settings.get_int("CONNECTION_POOL_LIMIT", 100)
43
- pool_per_host = self.crawler.settings.get_int("CONNECTION_POOL_LIMIT_PER_HOST", 20)
44
- self.max_download_size = self.crawler.settings.get_int("DOWNLOAD_MAXSIZE", 10 * 1024 * 1024) # 10MB
45
-
46
- # 创建连接器
47
- connector = TCPConnector(
48
- verify_ssl=verify_ssl,
49
- limit=pool_limit,
50
- limit_per_host=pool_per_host,
51
- ttl_dns_cache=300,
52
- keepalive_timeout=15,
53
- force_close=False,
54
- )
55
-
56
- # 超时控制
57
- timeout = ClientTimeout(total=timeout_secs)
58
-
59
- # 请求追踪
60
- trace_config = TraceConfig()
61
- trace_config.on_request_start.append(self._on_request_start)
62
- trace_config.on_request_end.append(self._on_request_end)
63
- trace_config.on_request_exception.append(self._on_request_exception)
64
-
65
- # 创建全局 session
66
- self.session = ClientSession(
67
- connector=connector,
68
- timeout=timeout,
69
- trace_configs=[trace_config],
70
- auto_decompress=True,
71
- )
72
-
73
- # 输出下载器配置摘要
74
- spider_name = getattr(self.crawler.spider, 'name', 'Unknown')
75
- concurrency = self.crawler.settings.get('CONCURRENCY', 4)
76
- # self.logger.debug(f"下载器初始化完成 [爬虫: {spider_name}, 类型: {self.__class__.__name__}, 并发数: {concurrency}]") # 注释掉重复的日志
77
-
78
- # self.logger.debug("AioHttpDownloader initialized.") # 注释掉重复的日志
79
-
80
- async def download(self, request) -> Optional[Response]:
81
- """下载请求并返回响应"""
82
- if not self.session or self.session.closed:
83
- raise RuntimeError("AioHttpDownloader session is not open.")
84
-
85
- start_time = None
86
- if self.crawler.settings.get_bool("DOWNLOAD_STATS", True):
87
- import time
88
- start_time = time.time()
89
-
90
- try:
91
- # 使用通用发送逻辑(支持所有 HTTP 方法)
92
- async with await self._send_request(self.session, request) as resp:
93
- # 安全检查:防止大响应体导致 OOM
94
- content_length = resp.headers.get("Content-Length")
95
- if content_length and int(content_length) > self.max_download_size:
96
- raise OverflowError(f"Response too large: {content_length} > {self.max_download_size}")
97
-
98
- body = await resp.read()
99
- response = self._structure_response(request, resp, body)
100
-
101
- # 记录下载统计
102
- if start_time:
103
- download_time = time.time() - start_time
104
- self.logger.debug(f"Downloaded {request.url} in {download_time:.3f}s, size: {len(body)} bytes")
105
-
106
- return response
107
-
108
- except ClientError as e:
109
- self.logger.error(f"Client error for {request.url}: {e}")
110
- raise
111
- except Exception as e:
112
- self.logger.critical(f"Unexpected error for {request.url}: {e}", exc_info=True)
113
- raise
114
-
115
- @staticmethod
116
- async def _send_request(session: ClientSession, request) -> ClientResponse:
117
- """
118
- 根据请求方法和高层语义智能发送请求。
119
- 支持中间件设置的 proxy,兼容以下格式:
120
- - str: "http://user:pass@host:port"
121
- - dict: {"http": "...", "https": "..."} (自动取 http 或 https 字段)
122
- """
123
- method = request.method.lower()
124
- if not hasattr(session, method):
125
- raise ValueError(f"Unsupported HTTP method: {request.method}")
126
-
127
- method_func = getattr(session, method)
128
-
129
- # 构造参数
130
- kwargs = {
131
- "headers": request.headers,
132
- "cookies": request.cookies,
133
- "allow_redirects": request.allow_redirects,
134
- }
135
-
136
- # === 处理代理(proxy)===
137
- proxy = getattr(request, "proxy", None)
138
- proxy_auth = None
139
-
140
- if proxy:
141
- # 兼容字典格式:{"http": "http://...", "https": "http://..."}
142
- if isinstance(proxy, dict):
143
- # 优先使用 https,否则用 http
144
- proxy = proxy.get("https") or proxy.get("http")
145
-
146
- if not isinstance(proxy, (str, URL)):
147
- raise ValueError(f"proxy must be str or URL, got {type(proxy)}")
148
-
149
- try:
150
- proxy_url = URL(proxy)
151
- if proxy_url.scheme not in ("http", "https"):
152
- raise ValueError(f"Unsupported proxy scheme: {proxy_url.scheme}, only HTTP/HTTPS supported.")
153
-
154
- # 提取认证信息
155
- if proxy_url.user and proxy_url.password:
156
- proxy_auth = BasicAuth(proxy_url.user, proxy_url.password)
157
- # 去掉用户密码的 URL
158
- proxy = str(proxy_url.with_user(None))
159
- else:
160
- proxy = str(proxy_url)
161
-
162
- kwargs["proxy"] = proxy
163
- if proxy_auth:
164
- kwargs["proxy_auth"] = proxy_auth
165
-
166
- except Exception as e:
167
- raise ValueError(f"Invalid proxy URL: {proxy}") from e
168
-
169
- # 处理通过meta传递的代理认证信息
170
- meta_proxy_auth = request.meta.get("proxy_auth")
171
- if meta_proxy_auth and isinstance(meta_proxy_auth, dict):
172
- username = meta_proxy_auth.get("username")
173
- password = meta_proxy_auth.get("password")
174
- if username and password:
175
- kwargs["proxy_auth"] = BasicAuth(username, password)
176
-
177
- # === 处理请求体 ===
178
- if hasattr(request, "_json_body") and request._json_body is not None:
179
- kwargs["json"] = request._json_body
180
- elif isinstance(request.body, (dict, list)):
181
- kwargs["json"] = request.body
182
- else:
183
- if request.body is not None:
184
- kwargs["data"] = request.body
185
-
186
- return await method_func(request.url, **kwargs)
187
-
188
- @staticmethod
189
- def _structure_response(request, resp: ClientResponse, body: bytes) -> Response:
190
- """构造框架所需的 Response 对象"""
191
- return Response(
192
- url=str(resp.url),
193
- headers=dict(resp.headers),
194
- status_code=resp.status,
195
- body=body,
196
- request=request,
197
- )
198
-
199
- # --- 请求追踪日志 ---
200
- async def _on_request_start(self, session, trace_config_ctx, params):
201
- """请求开始时的回调。"""
202
- # proxy = getattr(params, "proxy", None)
203
- # proxy_info = f" via {proxy}" if proxy else ""
204
- # self.logger.debug(f"Requesting: {params.method} {params.url}{proxy_info}") # 注释掉过于详细的日志
205
-
206
- async def _on_request_end(self, session, trace_config_ctx, params):
207
- """请求成功结束时的回调。"""
208
- # response = params.response
209
- # self.logger.debug(
210
- # f"Finished: {params.method} {params.url} with status {response.status}"
211
- # ) # 注释掉过于详细的日志
212
-
213
- async def _on_request_exception(self, session, trace_config_ctx, params):
214
- """请求发生异常时的回调。"""
215
- # exc = params.exception
216
- # self.logger.warning(
217
- # f"Failed: {params.method} {params.url} with exception {type(exc).__name__}: {exc}"
218
- # ) # 注释掉过于详细的日志
219
-
220
- async def close(self) -> None:
221
- """关闭会话资源"""
222
- if self.session and not self.session.closed:
223
- # 恢复关键的下载器关闭信息为INFO级别
224
- self.logger.info("Closing AioHttpDownloader session...")
225
- await self.session.close()
226
- self.logger.debug("AioHttpDownloader closed.")
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ from yarl import URL
4
+ from typing import Optional
5
+ from aiohttp import (
6
+ ClientSession,
7
+ TCPConnector,
8
+ ClientTimeout,
9
+ TraceConfig,
10
+ ClientResponse,
11
+ ClientError,
12
+ BasicAuth,
13
+ )
14
+
15
+ from crawlo.network.response import Response
16
+ from crawlo.utils.log import get_logger
17
+ from crawlo.downloader import DownloaderBase
18
+
19
+
20
+ class AioHttpDownloader(DownloaderBase):
21
+ """
22
+ 高性能异步下载器
23
+ - 基于持久化 ClientSession
24
+ - 智能识别 Request 的高层语义(json_body/form_data)
25
+ - 支持 GET/POST/PUT/DELETE 等方法
26
+ - 支持中间件设置的 IP 代理(HTTP/HTTPS)
27
+ - 内存安全防护
28
+ """
29
+
30
+ def __init__(self, crawler):
31
+ super().__init__(crawler)
32
+ self.session: Optional[ClientSession] = None
33
+ self.max_download_size: int = 0
34
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get("LOG_LEVEL"))
35
+
36
+ def open(self):
37
+ super().open()
38
+ # 恢复关键的下载器启动信息为INFO级别
39
+ # 读取配置
40
+ timeout_secs = self.crawler.settings.get_int("DOWNLOAD_TIMEOUT", 30)
41
+ verify_ssl = self.crawler.settings.get_bool("VERIFY_SSL", True)
42
+ pool_limit = self.crawler.settings.get_int("CONNECTION_POOL_LIMIT", 300) # 从200增加到300
43
+ pool_per_host = self.crawler.settings.get_int("CONNECTION_POOL_LIMIT_PER_HOST", 100) # 从50增加到100
44
+ self.max_download_size = self.crawler.settings.get_int("DOWNLOAD_MAXSIZE", 10 * 1024 * 1024) # 10MB
45
+
46
+ # 创建连接器
47
+ connector = TCPConnector(
48
+ verify_ssl=verify_ssl,
49
+ limit=pool_limit,
50
+ limit_per_host=pool_per_host,
51
+ ttl_dns_cache=300,
52
+ keepalive_timeout=15,
53
+ force_close=False,
54
+ use_dns_cache=True, # 启用DNS缓存
55
+ family=0, # 允许IPv4和IPv6
56
+ )
57
+
58
+ # 超时控制
59
+ timeout = ClientTimeout(total=timeout_secs)
60
+
61
+ # 请求追踪
62
+ trace_config = TraceConfig()
63
+ trace_config.on_request_start.append(self._on_request_start)
64
+ trace_config.on_request_end.append(self._on_request_end)
65
+ trace_config.on_request_exception.append(self._on_request_exception)
66
+
67
+ # 创建全局 session
68
+ self.session = ClientSession(
69
+ connector=connector,
70
+ timeout=timeout,
71
+ trace_configs=[trace_config],
72
+ auto_decompress=True,
73
+ )
74
+
75
+ # 输出下载器配置摘要
76
+ spider_name = getattr(self.crawler.spider, 'name', 'Unknown')
77
+ concurrency = self.crawler.settings.get('CONCURRENCY', 4)
78
+ # self.logger.debug(f"下载器初始化完成 [爬虫: {spider_name}, 类型: {self.__class__.__name__}, 并发数: {concurrency}]") # 注释掉重复的日志
79
+
80
+ # self.logger.debug("AioHttpDownloader initialized.") # 注释掉重复的日志
81
+
82
+ async def download(self, request) -> Optional[Response]:
83
+ """下载请求并返回响应"""
84
+ if not self.session or self.session.closed:
85
+ raise RuntimeError("AioHttpDownloader session is not open.")
86
+
87
+ start_time = None
88
+ if self.crawler.settings.get_bool("DOWNLOAD_STATS", True):
89
+ import time
90
+ start_time = time.time()
91
+
92
+ try:
93
+ # 使用通用发送逻辑(支持所有 HTTP 方法)
94
+ async with await self._send_request(self.session, request) as resp:
95
+ # 安全检查:防止大响应体导致 OOM
96
+ content_length = resp.headers.get("Content-Length")
97
+ if content_length and int(content_length) > self.max_download_size:
98
+ raise OverflowError(f"Response too large: {content_length} > {self.max_download_size}")
99
+
100
+ body = await resp.read()
101
+ response = self._structure_response(request, resp, body)
102
+
103
+ # 记录下载统计
104
+ if start_time:
105
+ download_time = time.time() - start_time
106
+ self.logger.debug(f"Downloaded {request.url} in {download_time:.3f}s, size: {len(body)} bytes")
107
+
108
+ return response
109
+
110
+ except ClientError as e:
111
+ self.logger.error(f"Client error for {request.url}: {e}")
112
+ raise
113
+ except Exception as e:
114
+ self.logger.critical(f"Unexpected error for {request.url}: {e}", exc_info=True)
115
+ raise
116
+
117
+ @staticmethod
118
+ async def _send_request(session: ClientSession, request) -> ClientResponse:
119
+ """
120
+ 根据请求方法和高层语义智能发送请求。
121
+ 支持中间件设置的 proxy,兼容以下格式:
122
+ - str: "http://user:pass@host:port"
123
+ - dict: {"http": "...", "https": "..."} (自动取 http 或 https 字段)
124
+ """
125
+ method = request.method.lower()
126
+ if not hasattr(session, method):
127
+ raise ValueError(f"Unsupported HTTP method: {request.method}")
128
+
129
+ method_func = getattr(session, method)
130
+
131
+ # 构造参数
132
+ kwargs = {
133
+ "headers": request.headers,
134
+ "cookies": request.cookies,
135
+ "allow_redirects": request.allow_redirects,
136
+ }
137
+
138
+ # === 处理代理(proxy)===
139
+ proxy = getattr(request, "proxy", None)
140
+ proxy_auth = None
141
+
142
+ if proxy:
143
+ # 兼容字典格式:{"http": "http://...", "https": "http://..."}
144
+ if isinstance(proxy, dict):
145
+ # 优先使用 https,否则用 http
146
+ proxy = proxy.get("https") or proxy.get("http")
147
+
148
+ if not isinstance(proxy, (str, URL)):
149
+ raise ValueError(f"proxy must be str or URL, got {type(proxy)}")
150
+
151
+ try:
152
+ proxy_url = URL(proxy)
153
+ if proxy_url.scheme not in ("http", "https"):
154
+ raise ValueError(f"Unsupported proxy scheme: {proxy_url.scheme}, only HTTP/HTTPS supported.")
155
+
156
+ # 提取认证信息
157
+ if proxy_url.user and proxy_url.password:
158
+ proxy_auth = BasicAuth(proxy_url.user, proxy_url.password)
159
+ # 去掉用户密码的 URL
160
+ proxy = str(proxy_url.with_user(None))
161
+ else:
162
+ proxy = str(proxy_url)
163
+
164
+ kwargs["proxy"] = proxy
165
+ if proxy_auth:
166
+ kwargs["proxy_auth"] = proxy_auth
167
+
168
+ except Exception as e:
169
+ raise ValueError(f"Invalid proxy URL: {proxy}") from e
170
+
171
+ # 处理通过meta传递的代理认证信息
172
+ meta_proxy_auth = request.meta.get("proxy_auth")
173
+ if meta_proxy_auth and isinstance(meta_proxy_auth, dict):
174
+ username = meta_proxy_auth.get("username")
175
+ password = meta_proxy_auth.get("password")
176
+ if username and password:
177
+ kwargs["proxy_auth"] = BasicAuth(username, password)
178
+
179
+ # === 处理请求体 ===
180
+ if hasattr(request, "_json_body") and request._json_body is not None:
181
+ kwargs["json"] = request._json_body
182
+ elif isinstance(request.body, (dict, list)):
183
+ kwargs["json"] = request.body
184
+ else:
185
+ if request.body is not None:
186
+ kwargs["data"] = request.body
187
+
188
+ return await method_func(request.url, **kwargs)
189
+
190
+ @staticmethod
191
+ def _structure_response(request, resp: ClientResponse, body: bytes) -> Response:
192
+ """构造框架所需的 Response 对象"""
193
+ return Response(
194
+ url=str(resp.url),
195
+ headers=dict(resp.headers),
196
+ status_code=resp.status,
197
+ body=body,
198
+ request=request,
199
+ )
200
+
201
+ # --- 请求追踪日志 ---
202
+ async def _on_request_start(self, session, trace_config_ctx, params):
203
+ """请求开始时的回调。"""
204
+ # proxy = getattr(params, "proxy", None)
205
+ # proxy_info = f" via {proxy}" if proxy else ""
206
+ # self.logger.debug(f"Requesting: {params.method} {params.url}{proxy_info}") # 注释掉过于详细的日志
207
+
208
+ async def _on_request_end(self, session, trace_config_ctx, params):
209
+ """请求成功结束时的回调。"""
210
+ # response = params.response
211
+ # self.logger.debug(
212
+ # f"Finished: {params.method} {params.url} with status {response.status}"
213
+ # ) # 注释掉过于详细的日志
214
+
215
+ async def _on_request_exception(self, session, trace_config_ctx, params):
216
+ """请求发生异常时的回调。"""
217
+ # exc = params.exception
218
+ # self.logger.warning(
219
+ # f"Failed: {params.method} {params.url} with exception {type(exc).__name__}: {exc}"
220
+ # ) # 注释掉过于详细的日志
221
+
222
+ async def close(self) -> None:
223
+ """关闭会话资源"""
224
+ if self.session and not self.session.closed:
225
+ # 恢复关键的下载器关闭信息为INFO级别
226
+ self.logger.info("Closing AioHttpDownloader session...")
227
+ await self.session.close()
228
+ self.logger.debug("AioHttpDownloader closed.")