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
@@ -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.")