crawlo 1.1.8__py3-none-any.whl → 1.2.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 (191) hide show
  1. crawlo/__init__.py +61 -61
  2. crawlo/__version__.py +1 -1
  3. crawlo/cleaners/__init__.py +60 -60
  4. crawlo/cleaners/data_formatter.py +225 -225
  5. crawlo/cleaners/encoding_converter.py +125 -125
  6. crawlo/cleaners/text_cleaner.py +232 -232
  7. crawlo/cli.py +65 -65
  8. crawlo/commands/__init__.py +14 -14
  9. crawlo/commands/check.py +594 -594
  10. crawlo/commands/genspider.py +151 -151
  11. crawlo/commands/help.py +132 -132
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +292 -292
  14. crawlo/commands/startproject.py +418 -418
  15. crawlo/commands/stats.py +188 -188
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +252 -252
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +354 -345
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +143 -136
  23. crawlo/crawler.py +1027 -1027
  24. crawlo/downloader/__init__.py +266 -266
  25. crawlo/downloader/aiohttp_downloader.py +220 -220
  26. crawlo/downloader/cffi_downloader.py +256 -256
  27. crawlo/downloader/httpx_downloader.py +259 -259
  28. crawlo/downloader/hybrid_downloader.py +213 -213
  29. crawlo/downloader/playwright_downloader.py +402 -402
  30. crawlo/downloader/selenium_downloader.py +472 -472
  31. crawlo/event.py +11 -11
  32. crawlo/exceptions.py +81 -81
  33. crawlo/extension/__init__.py +37 -37
  34. crawlo/extension/health_check.py +141 -141
  35. crawlo/extension/log_interval.py +57 -57
  36. crawlo/extension/log_stats.py +81 -81
  37. crawlo/extension/logging_extension.py +43 -43
  38. crawlo/extension/memory_monitor.py +104 -104
  39. crawlo/extension/performance_profiler.py +133 -133
  40. crawlo/extension/request_recorder.py +107 -107
  41. crawlo/filters/__init__.py +154 -154
  42. crawlo/filters/aioredis_filter.py +280 -280
  43. crawlo/filters/memory_filter.py +269 -269
  44. crawlo/items/__init__.py +23 -23
  45. crawlo/items/base.py +21 -21
  46. crawlo/items/fields.py +53 -53
  47. crawlo/items/items.py +104 -104
  48. crawlo/middleware/__init__.py +21 -21
  49. crawlo/middleware/default_header.py +32 -32
  50. crawlo/middleware/download_delay.py +28 -28
  51. crawlo/middleware/middleware_manager.py +135 -135
  52. crawlo/middleware/proxy.py +272 -272
  53. crawlo/middleware/request_ignore.py +30 -30
  54. crawlo/middleware/response_code.py +18 -18
  55. crawlo/middleware/response_filter.py +26 -26
  56. crawlo/middleware/retry.py +124 -124
  57. crawlo/mode_manager.py +211 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +338 -338
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +224 -224
  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 +316 -316
  70. crawlo/pipelines/pipeline_manager.py +61 -61
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +187 -187
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +337 -334
  75. crawlo/queue/redis_priority_queue.py +298 -298
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +219 -219
  78. crawlo/settings/setting_manager.py +122 -122
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +130 -130
  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 +109 -109
  87. crawlo/templates/project/pipelines.py.tmpl +96 -96
  88. crawlo/templates/project/run.py.tmpl +45 -45
  89. crawlo/templates/project/settings.py.tmpl +326 -326
  90. crawlo/templates/project/settings_distributed.py.tmpl +119 -119
  91. crawlo/templates/project/settings_gentle.py.tmpl +94 -94
  92. crawlo/templates/project/settings_high_performance.py.tmpl +151 -151
  93. crawlo/templates/project/settings_simple.py.tmpl +68 -68
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/spider/spider.py.tmpl +141 -141
  96. crawlo/tools/__init__.py +182 -182
  97. crawlo/tools/anti_crawler.py +268 -268
  98. crawlo/tools/authenticated_proxy.py +240 -240
  99. crawlo/tools/data_validator.py +180 -180
  100. crawlo/tools/date_tools.py +35 -35
  101. crawlo/tools/distributed_coordinator.py +386 -386
  102. crawlo/tools/retry_mechanism.py +220 -220
  103. crawlo/tools/scenario_adapter.py +262 -262
  104. crawlo/utils/__init__.py +35 -35
  105. crawlo/utils/batch_processor.py +260 -260
  106. crawlo/utils/controlled_spider_mixin.py +439 -439
  107. crawlo/utils/date_tools.py +290 -290
  108. crawlo/utils/db_helper.py +343 -343
  109. crawlo/utils/enhanced_error_handler.py +359 -359
  110. crawlo/utils/env_config.py +105 -105
  111. crawlo/utils/error_handler.py +125 -125
  112. crawlo/utils/func_tools.py +82 -82
  113. crawlo/utils/large_scale_config.py +286 -286
  114. crawlo/utils/large_scale_helper.py +343 -343
  115. crawlo/utils/log.py +128 -128
  116. crawlo/utils/performance_monitor.py +284 -284
  117. crawlo/utils/queue_helper.py +175 -175
  118. crawlo/utils/redis_connection_pool.py +334 -334
  119. crawlo/utils/redis_key_validator.py +199 -199
  120. crawlo/utils/request.py +267 -267
  121. crawlo/utils/request_serializer.py +219 -219
  122. crawlo/utils/spider_loader.py +62 -62
  123. crawlo/utils/system.py +11 -11
  124. crawlo/utils/tools.py +4 -4
  125. crawlo/utils/url.py +39 -39
  126. crawlo-1.2.0.dist-info/METADATA +697 -0
  127. crawlo-1.2.0.dist-info/RECORD +190 -0
  128. examples/__init__.py +7 -7
  129. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  130. tests/__init__.py +7 -7
  131. tests/advanced_tools_example.py +275 -275
  132. tests/authenticated_proxy_example.py +236 -236
  133. tests/cleaners_example.py +160 -160
  134. tests/config_validation_demo.py +102 -102
  135. tests/controlled_spider_example.py +205 -205
  136. tests/date_tools_example.py +180 -180
  137. tests/dynamic_loading_example.py +523 -523
  138. tests/dynamic_loading_test.py +104 -104
  139. tests/env_config_example.py +133 -133
  140. tests/error_handling_example.py +171 -171
  141. tests/redis_key_validation_demo.py +130 -130
  142. tests/response_improvements_example.py +144 -144
  143. tests/test_advanced_tools.py +148 -148
  144. tests/test_all_redis_key_configs.py +145 -145
  145. tests/test_authenticated_proxy.py +141 -141
  146. tests/test_cleaners.py +54 -54
  147. tests/test_comprehensive.py +146 -146
  148. tests/test_config_validator.py +193 -193
  149. tests/test_date_tools.py +123 -123
  150. tests/test_double_crawlo_fix.py +207 -207
  151. tests/test_double_crawlo_fix_simple.py +124 -124
  152. tests/test_dynamic_downloaders_proxy.py +124 -124
  153. tests/test_dynamic_proxy.py +92 -92
  154. tests/test_dynamic_proxy_config.py +146 -146
  155. tests/test_dynamic_proxy_real.py +109 -109
  156. tests/test_edge_cases.py +303 -303
  157. tests/test_enhanced_error_handler.py +270 -270
  158. tests/test_env_config.py +121 -121
  159. tests/test_error_handler_compatibility.py +112 -112
  160. tests/test_final_validation.py +153 -153
  161. tests/test_framework_env_usage.py +103 -103
  162. tests/test_integration.py +356 -356
  163. tests/test_item_dedup_redis_key.py +122 -122
  164. tests/test_parsel.py +29 -29
  165. tests/test_performance.py +327 -327
  166. tests/test_proxy_health_check.py +32 -32
  167. tests/test_proxy_middleware_integration.py +136 -136
  168. tests/test_proxy_providers.py +56 -56
  169. tests/test_proxy_stats.py +19 -19
  170. tests/test_proxy_strategies.py +59 -59
  171. tests/test_queue_manager_double_crawlo.py +174 -231
  172. tests/test_queue_manager_redis_key.py +176 -176
  173. tests/test_redis_config.py +28 -28
  174. tests/test_redis_connection_pool.py +294 -294
  175. tests/test_redis_key_naming.py +181 -181
  176. tests/test_redis_key_validator.py +123 -123
  177. tests/test_redis_queue.py +224 -224
  178. tests/test_request_serialization.py +70 -70
  179. tests/test_response_improvements.py +152 -152
  180. tests/test_scheduler.py +241 -241
  181. tests/test_simple_response.py +61 -61
  182. tests/test_telecom_spider_redis_key.py +205 -205
  183. tests/test_template_content.py +87 -87
  184. tests/test_template_redis_key.py +134 -134
  185. tests/test_tools.py +153 -153
  186. tests/tools_example.py +257 -257
  187. crawlo-1.1.8.dist-info/METADATA +0 -626
  188. crawlo-1.1.8.dist-info/RECORD +0 -190
  189. {crawlo-1.1.8.dist-info → crawlo-1.2.0.dist-info}/WHEEL +0 -0
  190. {crawlo-1.1.8.dist-info → crawlo-1.2.0.dist-info}/entry_points.txt +0 -0
  191. {crawlo-1.1.8.dist-info → crawlo-1.2.0.dist-info}/top_level.txt +0 -0
@@ -1,273 +1,273 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- import asyncio
4
- import socket
5
- from typing import Optional, Dict, Any, Callable, Union, TYPE_CHECKING
6
- from urllib.parse import urlparse
7
-
8
- from crawlo import Request, Response
9
- from crawlo.exceptions import NotConfiguredError
10
- from crawlo.utils.log import get_logger
11
-
12
- if TYPE_CHECKING:
13
- import aiohttp
14
-
15
- try:
16
- import httpx
17
- HTTPX_EXCEPTIONS = (httpx.NetworkError, httpx.TimeoutException, httpx.ReadError, httpx.ConnectError)
18
- except ImportError:
19
- HTTPX_EXCEPTIONS = ()
20
- httpx = None
21
-
22
- try:
23
- import aiohttp
24
- AIOHTTP_EXCEPTIONS = (
25
- aiohttp.ClientError, aiohttp.ClientConnectorError, aiohttp.ClientResponseError, aiohttp.ServerTimeoutError,
26
- aiohttp.ServerDisconnectedError)
27
- except ImportError:
28
- AIOHTTP_EXCEPTIONS = ()
29
- aiohttp = None
30
-
31
- try:
32
- from curl_cffi import requests as cffi_requests
33
- CURL_CFFI_EXCEPTIONS = (cffi_requests.RequestsError,)
34
- except (ImportError, AttributeError):
35
- CURL_CFFI_EXCEPTIONS = ()
36
- cffi_requests = None
37
-
38
- NETWORK_EXCEPTIONS = (
39
- asyncio.TimeoutError,
40
- socket.gaierror,
41
- ConnectionError,
42
- TimeoutError,
43
- ) + HTTPX_EXCEPTIONS + AIOHTTP_EXCEPTIONS + CURL_CFFI_EXCEPTIONS
44
-
45
- ProxyExtractor = Callable[[Dict[str, Any]], Union[None, str, Dict[str, str]]]
46
-
47
-
48
- class ProxyMiddleware:
49
- def __init__(self, settings, log_level):
50
- self.logger = get_logger(self.__class__.__name__, log_level)
51
-
52
- self._session: Optional[Any] = None # aiohttp.ClientSession when aiohttp is available
53
- self._current_proxy: Optional[Union[str, Dict[str, str]]] = None
54
- self._last_fetch_time: float = 0
55
-
56
- self.proxy_extractor = settings.get("PROXY_EXTRACTOR", "proxy")
57
- self.refresh_interval = settings.get_float("PROXY_REFRESH_INTERVAL", 60)
58
- self.timeout = settings.get_float("PROXY_API_TIMEOUT", 10)
59
-
60
- self.enabled = settings.get_bool("PROXY_ENABLED", True)
61
-
62
- if not self.enabled:
63
- self.logger.info("ProxyMiddleware 已被禁用 (PROXY_ENABLED=False)")
64
- return
65
-
66
- self.api_url = settings.get("PROXY_API_URL")
67
- if not self.api_url:
68
- raise NotConfiguredError("PROXY_API_URL 未配置,ProxyMiddleware 已禁用")
69
-
70
- self.logger.info(f"代理中间件已启用 | API: {self.api_url} | 刷新间隔: {self.refresh_interval}s")
71
-
72
- @classmethod
73
- def create_instance(cls, crawler):
74
- return cls(settings=crawler.settings, log_level=crawler.settings.get("LOG_LEVEL"))
75
-
76
- def _compile_extractor(self) -> ProxyExtractor:
77
- if callable(self.proxy_extractor):
78
- return self.proxy_extractor
79
-
80
- if isinstance(self.proxy_extractor, str):
81
- keys = self.proxy_extractor.split(".")
82
-
83
- def extract(data: Dict[str, Any]) -> Union[None, str, Dict[str, str]]:
84
- for k in keys:
85
- if isinstance(data, dict):
86
- data = data.get(k)
87
- else:
88
- return None
89
- if data is None:
90
- break
91
- return data
92
-
93
- return extract
94
-
95
- raise ValueError(f"PROXY_EXTRACTOR 必须是 str 或 callable,当前类型: {type(self.proxy_extractor)}")
96
-
97
- async def _close_session(self):
98
- if self._session:
99
- try:
100
- await self._session.close()
101
- self.logger.debug("已关闭 aiohttp session.")
102
- except Exception as e:
103
- self.logger.warning(f"关闭 aiohttp session 时出错: {e}")
104
- finally:
105
- self._session = None
106
-
107
- async def _get_session(self) -> Any: # returns aiohttp.ClientSession when aiohttp is available
108
- if aiohttp is None:
109
- raise RuntimeError("aiohttp 未安装,无法使用 ProxyMiddleware")
110
-
111
- if self._session is None or self._session.closed:
112
- if self._session and self._session.closed:
113
- self.logger.debug("现有 session 已关闭,正在创建新 session...")
114
- timeout = aiohttp.ClientTimeout(total=self.timeout)
115
- self._session = aiohttp.ClientSession(timeout=timeout)
116
- self.logger.debug("已创建新的 aiohttp session.")
117
- return self._session
118
-
119
- async def _fetch_raw_data(self) -> Optional[Dict[str, Any]]:
120
- max_retries = 2
121
- retry_count = 0
122
-
123
- while retry_count <= max_retries:
124
- session = await self._get_session()
125
- try:
126
- async with session.get(self.api_url) as resp:
127
- content_type = resp.content_type.lower()
128
- if 'application/json' not in content_type:
129
- self.logger.warning(f"代理 API 返回非 JSON 内容类型: {content_type} (URL: {self.api_url})")
130
- try:
131
- text = await resp.text()
132
- return {"__raw_text__": text.strip(), "__content_type__": content_type}
133
- except Exception as e:
134
- self.logger.error(f"读取非 JSON 响应体失败: {repr(e)}")
135
- return None
136
-
137
- if resp.status != 200:
138
- try:
139
- error_text = await resp.text()
140
- except:
141
- error_text = "<无法读取响应体>"
142
- self.logger.error(f"代理 API 状态码异常: {resp.status}, 响应体: {error_text}")
143
- if 400 <= resp.status < 500:
144
- return None
145
- return None
146
-
147
- return await resp.json()
148
-
149
- except NETWORK_EXCEPTIONS as e:
150
- retry_count += 1
151
- self.logger.warning(f"请求代理 API 失败 (尝试 {retry_count}/{max_retries + 1}): {repr(e)}")
152
- if retry_count <= max_retries:
153
- self.logger.info("正在关闭并重建 session 以进行重试...")
154
- await self._close_session()
155
- else:
156
- self.logger.error(f"请求代理 API 失败,已达到最大重试次数 ({max_retries + 1}): {repr(e)}")
157
- return None
158
-
159
- except aiohttp.ContentTypeError as e:
160
- self.logger.error(f"代理 API 响应内容类型错误: {repr(e)}")
161
- return None
162
-
163
- except Exception as e:
164
- self.logger.critical(f"请求代理 API 时发生未预期错误: {repr(e)}", exc_info=True)
165
- return None
166
-
167
- return None
168
-
169
- async def _extract_proxy(self, data: Dict[str, Any]) -> Optional[Union[str, Dict[str, str]]]:
170
- extractor = self._compile_extractor()
171
- try:
172
- result = extractor(data)
173
- if isinstance(result, str) and result.strip():
174
- return result.strip()
175
- elif isinstance(result, dict):
176
- cleaned = {k: v.strip() if isinstance(v, str) else v for k, v in result.items()}
177
- return cleaned if cleaned else None
178
- return None
179
- except Exception as e:
180
- self.logger.error(f"执行 PROXY_EXTRACTOR 时出错: {repr(e)}")
181
- return None
182
-
183
- async def _get_proxy_from_api(self) -> Optional[Union[str, Dict[str, str]]]:
184
- raw_data = await self._fetch_raw_data()
185
- if not raw_data:
186
- return None
187
-
188
- if "__raw_text__" in raw_data:
189
- text = raw_data["__raw_text__"]
190
- if text.startswith("http://") or text.startswith("https://"):
191
- return text
192
-
193
- return await self._extract_proxy(raw_data)
194
-
195
- async def _get_cached_proxy(self) -> Optional[str]:
196
- if not self.enabled:
197
- self.logger.debug("ProxyMiddleware 已禁用,跳过代理获取。")
198
- return None
199
-
200
- now = asyncio.get_event_loop().time()
201
- if self._current_proxy and (now - self._last_fetch_time) < self.refresh_interval:
202
- pass
203
- else:
204
- proxy = await self._get_proxy_from_api()
205
- if proxy:
206
- self._current_proxy = proxy
207
- self._last_fetch_time = now
208
- self.logger.debug(f"更新代理缓存: {proxy}")
209
- else:
210
- self.logger.warning("无法获取新代理,请求将直连。")
211
-
212
- return self._current_proxy
213
-
214
- @staticmethod
215
- def _is_https(request: Request) -> bool:
216
- return urlparse(request.url).scheme == "https"
217
-
218
- async def process_request(self, request: Request, spider) -> Optional[Request]:
219
- if not self.enabled:
220
- self.logger.debug(f"ProxyMiddleware 已禁用,请求将直连: {request.url}")
221
- return None
222
-
223
- if request.proxy:
224
- return None
225
-
226
- proxy = await self._get_cached_proxy()
227
- if proxy:
228
- # 处理带认证的代理URL
229
- if isinstance(proxy, str) and "@" in proxy and "://" in proxy:
230
- # 解析带认证的代理URL
231
- parsed = urlparse(proxy)
232
- if parsed.username and parsed.password:
233
- # 对于AioHttp下载器,需要特殊处理认证信息
234
- downloader_type = spider.crawler.settings.get("DOWNLOADER_TYPE", "aiohttp")
235
- if downloader_type == "aiohttp":
236
- # 将认证信息存储在meta中,由下载器处理
237
- request.meta["proxy_auth"] = {
238
- "username": parsed.username,
239
- "password": parsed.password
240
- }
241
- # 清理URL中的认证信息
242
- clean_proxy = f"{parsed.scheme}://{parsed.hostname}"
243
- if parsed.port:
244
- clean_proxy += f":{parsed.port}"
245
- request.proxy = clean_proxy
246
- else:
247
- # 其他下载器可以直接使用带认证的URL
248
- request.proxy = proxy
249
- else:
250
- request.proxy = proxy
251
- else:
252
- request.proxy = proxy
253
- self.logger.info(f"分配代理 → {proxy} | {request.url}")
254
- else:
255
- self.logger.warning(f"未获取到代理,请求直连: {request.url}")
256
-
257
- return None
258
-
259
- def process_response(self, request: Request, response: Response, spider) -> Response:
260
- proxy = request.proxy
261
- if proxy:
262
- status_code = getattr(response, 'status_code', 'N/A')
263
- self.logger.debug(f"代理成功: {proxy} | {request.url} | Status: {status_code}")
264
- return response
265
-
266
- def process_exception(self, request: Request, exception: Exception, spider) -> Optional[Request]:
267
- proxy = request.proxy
268
- if proxy:
269
- self.logger.warning(f"代理请求失败: {proxy} | {request.url} | {repr(exception)}")
270
- return None
271
-
272
- async def close(self):
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ import asyncio
4
+ import socket
5
+ from typing import Optional, Dict, Any, Callable, Union, TYPE_CHECKING
6
+ from urllib.parse import urlparse
7
+
8
+ from crawlo import Request, Response
9
+ from crawlo.exceptions import NotConfiguredError
10
+ from crawlo.utils.log import get_logger
11
+
12
+ if TYPE_CHECKING:
13
+ import aiohttp
14
+
15
+ try:
16
+ import httpx
17
+ HTTPX_EXCEPTIONS = (httpx.NetworkError, httpx.TimeoutException, httpx.ReadError, httpx.ConnectError)
18
+ except ImportError:
19
+ HTTPX_EXCEPTIONS = ()
20
+ httpx = None
21
+
22
+ try:
23
+ import aiohttp
24
+ AIOHTTP_EXCEPTIONS = (
25
+ aiohttp.ClientError, aiohttp.ClientConnectorError, aiohttp.ClientResponseError, aiohttp.ServerTimeoutError,
26
+ aiohttp.ServerDisconnectedError)
27
+ except ImportError:
28
+ AIOHTTP_EXCEPTIONS = ()
29
+ aiohttp = None
30
+
31
+ try:
32
+ from curl_cffi import requests as cffi_requests
33
+ CURL_CFFI_EXCEPTIONS = (cffi_requests.RequestsError,)
34
+ except (ImportError, AttributeError):
35
+ CURL_CFFI_EXCEPTIONS = ()
36
+ cffi_requests = None
37
+
38
+ NETWORK_EXCEPTIONS = (
39
+ asyncio.TimeoutError,
40
+ socket.gaierror,
41
+ ConnectionError,
42
+ TimeoutError,
43
+ ) + HTTPX_EXCEPTIONS + AIOHTTP_EXCEPTIONS + CURL_CFFI_EXCEPTIONS
44
+
45
+ ProxyExtractor = Callable[[Dict[str, Any]], Union[None, str, Dict[str, str]]]
46
+
47
+
48
+ class ProxyMiddleware:
49
+ def __init__(self, settings, log_level):
50
+ self.logger = get_logger(self.__class__.__name__, log_level)
51
+
52
+ self._session: Optional[Any] = None # aiohttp.ClientSession when aiohttp is available
53
+ self._current_proxy: Optional[Union[str, Dict[str, str]]] = None
54
+ self._last_fetch_time: float = 0
55
+
56
+ self.proxy_extractor = settings.get("PROXY_EXTRACTOR", "proxy")
57
+ self.refresh_interval = settings.get_float("PROXY_REFRESH_INTERVAL", 60)
58
+ self.timeout = settings.get_float("PROXY_API_TIMEOUT", 10)
59
+
60
+ self.enabled = settings.get_bool("PROXY_ENABLED", True)
61
+
62
+ if not self.enabled:
63
+ self.logger.info("ProxyMiddleware 已被禁用 (PROXY_ENABLED=False)")
64
+ return
65
+
66
+ self.api_url = settings.get("PROXY_API_URL")
67
+ if not self.api_url:
68
+ raise NotConfiguredError("PROXY_API_URL 未配置,ProxyMiddleware 已禁用")
69
+
70
+ self.logger.info(f"代理中间件已启用 | API: {self.api_url} | 刷新间隔: {self.refresh_interval}s")
71
+
72
+ @classmethod
73
+ def create_instance(cls, crawler):
74
+ return cls(settings=crawler.settings, log_level=crawler.settings.get("LOG_LEVEL"))
75
+
76
+ def _compile_extractor(self) -> ProxyExtractor:
77
+ if callable(self.proxy_extractor):
78
+ return self.proxy_extractor
79
+
80
+ if isinstance(self.proxy_extractor, str):
81
+ keys = self.proxy_extractor.split(".")
82
+
83
+ def extract(data: Dict[str, Any]) -> Union[None, str, Dict[str, str]]:
84
+ for k in keys:
85
+ if isinstance(data, dict):
86
+ data = data.get(k)
87
+ else:
88
+ return None
89
+ if data is None:
90
+ break
91
+ return data
92
+
93
+ return extract
94
+
95
+ raise ValueError(f"PROXY_EXTRACTOR 必须是 str 或 callable,当前类型: {type(self.proxy_extractor)}")
96
+
97
+ async def _close_session(self):
98
+ if self._session:
99
+ try:
100
+ await self._session.close()
101
+ self.logger.debug("已关闭 aiohttp session.")
102
+ except Exception as e:
103
+ self.logger.warning(f"关闭 aiohttp session 时出错: {e}")
104
+ finally:
105
+ self._session = None
106
+
107
+ async def _get_session(self) -> Any: # returns aiohttp.ClientSession when aiohttp is available
108
+ if aiohttp is None:
109
+ raise RuntimeError("aiohttp 未安装,无法使用 ProxyMiddleware")
110
+
111
+ if self._session is None or self._session.closed:
112
+ if self._session and self._session.closed:
113
+ self.logger.debug("现有 session 已关闭,正在创建新 session...")
114
+ timeout = aiohttp.ClientTimeout(total=self.timeout)
115
+ self._session = aiohttp.ClientSession(timeout=timeout)
116
+ self.logger.debug("已创建新的 aiohttp session.")
117
+ return self._session
118
+
119
+ async def _fetch_raw_data(self) -> Optional[Dict[str, Any]]:
120
+ max_retries = 2
121
+ retry_count = 0
122
+
123
+ while retry_count <= max_retries:
124
+ session = await self._get_session()
125
+ try:
126
+ async with session.get(self.api_url) as resp:
127
+ content_type = resp.content_type.lower()
128
+ if 'application/json' not in content_type:
129
+ self.logger.warning(f"代理 API 返回非 JSON 内容类型: {content_type} (URL: {self.api_url})")
130
+ try:
131
+ text = await resp.text()
132
+ return {"__raw_text__": text.strip(), "__content_type__": content_type}
133
+ except Exception as e:
134
+ self.logger.error(f"读取非 JSON 响应体失败: {repr(e)}")
135
+ return None
136
+
137
+ if resp.status != 200:
138
+ try:
139
+ error_text = await resp.text()
140
+ except:
141
+ error_text = "<无法读取响应体>"
142
+ self.logger.error(f"代理 API 状态码异常: {resp.status}, 响应体: {error_text}")
143
+ if 400 <= resp.status < 500:
144
+ return None
145
+ return None
146
+
147
+ return await resp.json()
148
+
149
+ except NETWORK_EXCEPTIONS as e:
150
+ retry_count += 1
151
+ self.logger.warning(f"请求代理 API 失败 (尝试 {retry_count}/{max_retries + 1}): {repr(e)}")
152
+ if retry_count <= max_retries:
153
+ self.logger.info("正在关闭并重建 session 以进行重试...")
154
+ await self._close_session()
155
+ else:
156
+ self.logger.error(f"请求代理 API 失败,已达到最大重试次数 ({max_retries + 1}): {repr(e)}")
157
+ return None
158
+
159
+ except aiohttp.ContentTypeError as e:
160
+ self.logger.error(f"代理 API 响应内容类型错误: {repr(e)}")
161
+ return None
162
+
163
+ except Exception as e:
164
+ self.logger.critical(f"请求代理 API 时发生未预期错误: {repr(e)}", exc_info=True)
165
+ return None
166
+
167
+ return None
168
+
169
+ async def _extract_proxy(self, data: Dict[str, Any]) -> Optional[Union[str, Dict[str, str]]]:
170
+ extractor = self._compile_extractor()
171
+ try:
172
+ result = extractor(data)
173
+ if isinstance(result, str) and result.strip():
174
+ return result.strip()
175
+ elif isinstance(result, dict):
176
+ cleaned = {k: v.strip() if isinstance(v, str) else v for k, v in result.items()}
177
+ return cleaned if cleaned else None
178
+ return None
179
+ except Exception as e:
180
+ self.logger.error(f"执行 PROXY_EXTRACTOR 时出错: {repr(e)}")
181
+ return None
182
+
183
+ async def _get_proxy_from_api(self) -> Optional[Union[str, Dict[str, str]]]:
184
+ raw_data = await self._fetch_raw_data()
185
+ if not raw_data:
186
+ return None
187
+
188
+ if "__raw_text__" in raw_data:
189
+ text = raw_data["__raw_text__"]
190
+ if text.startswith("http://") or text.startswith("https://"):
191
+ return text
192
+
193
+ return await self._extract_proxy(raw_data)
194
+
195
+ async def _get_cached_proxy(self) -> Optional[str]:
196
+ if not self.enabled:
197
+ self.logger.debug("ProxyMiddleware 已禁用,跳过代理获取。")
198
+ return None
199
+
200
+ now = asyncio.get_event_loop().time()
201
+ if self._current_proxy and (now - self._last_fetch_time) < self.refresh_interval:
202
+ pass
203
+ else:
204
+ proxy = await self._get_proxy_from_api()
205
+ if proxy:
206
+ self._current_proxy = proxy
207
+ self._last_fetch_time = now
208
+ self.logger.debug(f"更新代理缓存: {proxy}")
209
+ else:
210
+ self.logger.warning("无法获取新代理,请求将直连。")
211
+
212
+ return self._current_proxy
213
+
214
+ @staticmethod
215
+ def _is_https(request: Request) -> bool:
216
+ return urlparse(request.url).scheme == "https"
217
+
218
+ async def process_request(self, request: Request, spider) -> Optional[Request]:
219
+ if not self.enabled:
220
+ self.logger.debug(f"ProxyMiddleware 已禁用,请求将直连: {request.url}")
221
+ return None
222
+
223
+ if request.proxy:
224
+ return None
225
+
226
+ proxy = await self._get_cached_proxy()
227
+ if proxy:
228
+ # 处理带认证的代理URL
229
+ if isinstance(proxy, str) and "@" in proxy and "://" in proxy:
230
+ # 解析带认证的代理URL
231
+ parsed = urlparse(proxy)
232
+ if parsed.username and parsed.password:
233
+ # 对于AioHttp下载器,需要特殊处理认证信息
234
+ downloader_type = spider.crawler.settings.get("DOWNLOADER_TYPE", "aiohttp")
235
+ if downloader_type == "aiohttp":
236
+ # 将认证信息存储在meta中,由下载器处理
237
+ request.meta["proxy_auth"] = {
238
+ "username": parsed.username,
239
+ "password": parsed.password
240
+ }
241
+ # 清理URL中的认证信息
242
+ clean_proxy = f"{parsed.scheme}://{parsed.hostname}"
243
+ if parsed.port:
244
+ clean_proxy += f":{parsed.port}"
245
+ request.proxy = clean_proxy
246
+ else:
247
+ # 其他下载器可以直接使用带认证的URL
248
+ request.proxy = proxy
249
+ else:
250
+ request.proxy = proxy
251
+ else:
252
+ request.proxy = proxy
253
+ self.logger.info(f"分配代理 → {proxy} | {request.url}")
254
+ else:
255
+ self.logger.warning(f"未获取到代理,请求直连: {request.url}")
256
+
257
+ return None
258
+
259
+ def process_response(self, request: Request, response: Response, spider) -> Response:
260
+ proxy = request.proxy
261
+ if proxy:
262
+ status_code = getattr(response, 'status_code', 'N/A')
263
+ self.logger.debug(f"代理成功: {proxy} | {request.url} | Status: {status_code}")
264
+ return response
265
+
266
+ def process_exception(self, request: Request, exception: Exception, spider) -> Optional[Request]:
267
+ proxy = request.proxy
268
+ if proxy:
269
+ self.logger.warning(f"代理请求失败: {proxy} | {request.url} | {repr(exception)}")
270
+ return None
271
+
272
+ async def close(self):
273
273
  await self._close_session()
@@ -1,30 +1,30 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- from crawlo.utils.log import get_logger
4
- from crawlo.exceptions import IgnoreRequestError
5
- from crawlo.event import ignore_request
6
-
7
-
8
- class RequestIgnoreMiddleware(object):
9
-
10
- def __init__(self, stats, log_level):
11
- self.logger = get_logger(self.__class__.__name__, log_level)
12
- self.stats = stats
13
-
14
- @classmethod
15
- def create_instance(cls, crawler):
16
- o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
17
- crawler.subscriber.subscribe(o.request_ignore, event=ignore_request)
18
- return o
19
-
20
- async def request_ignore(self, exc, request, _spider):
21
- self.logger.info(f'{request} ignored.')
22
- self.stats.inc_value('request_ignore_count')
23
- reason = exc.msg
24
- if reason:
25
- self.stats.inc_value(f'request_ignore_count/{reason}')
26
-
27
- @staticmethod
28
- def process_exception(_request, exc, _spider):
29
- if isinstance(exc, IgnoreRequestError):
30
- return True
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ from crawlo.utils.log import get_logger
4
+ from crawlo.exceptions import IgnoreRequestError
5
+ from crawlo.event import ignore_request
6
+
7
+
8
+ class RequestIgnoreMiddleware(object):
9
+
10
+ def __init__(self, stats, log_level):
11
+ self.logger = get_logger(self.__class__.__name__, log_level)
12
+ self.stats = stats
13
+
14
+ @classmethod
15
+ def create_instance(cls, crawler):
16
+ o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
17
+ crawler.subscriber.subscribe(o.request_ignore, event=ignore_request)
18
+ return o
19
+
20
+ async def request_ignore(self, exc, request, _spider):
21
+ self.logger.info(f'{request} ignored.')
22
+ self.stats.inc_value('request_ignore_count')
23
+ reason = exc.msg
24
+ if reason:
25
+ self.stats.inc_value(f'request_ignore_count/{reason}')
26
+
27
+ @staticmethod
28
+ def process_exception(_request, exc, _spider):
29
+ if isinstance(exc, IgnoreRequestError):
30
+ return True
@@ -1,19 +1,19 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- from crawlo.utils.log import get_logger
4
-
5
-
6
- class ResponseCodeMiddleware(object):
7
- def __init__(self, stats, log_level):
8
- self.logger = get_logger(self.__class__.__name__, log_level)
9
- self.stats = stats
10
-
11
- @classmethod
12
- def create_instance(cls, crawler):
13
- o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
14
- return o
15
-
16
- def process_response(self, request, response, spider):
17
- self.stats.inc_value(f'stats_code/count/{response.status_code}')
18
- self.logger.debug(f'Got response from <{response.status_code} {response.url}>')
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ from crawlo.utils.log import get_logger
4
+
5
+
6
+ class ResponseCodeMiddleware(object):
7
+ def __init__(self, stats, log_level):
8
+ self.logger = get_logger(self.__class__.__name__, log_level)
9
+ self.stats = stats
10
+
11
+ @classmethod
12
+ def create_instance(cls, crawler):
13
+ o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
14
+ return o
15
+
16
+ def process_response(self, request, response, spider):
17
+ self.stats.inc_value(f'stats_code/count/{response.status_code}')
18
+ self.logger.debug(f'Got response from <{response.status_code} {response.url}>')
19
19
  return response