crawlo 1.1.3__py3-none-any.whl → 1.1.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 (115) hide show
  1. crawlo/__init__.py +28 -1
  2. crawlo/__version__.py +1 -1
  3. crawlo/cleaners/__init__.py +61 -0
  4. crawlo/cleaners/data_formatter.py +226 -0
  5. crawlo/cleaners/encoding_converter.py +126 -0
  6. crawlo/cleaners/text_cleaner.py +233 -0
  7. crawlo/commands/startproject.py +117 -13
  8. crawlo/config.py +30 -0
  9. crawlo/config_validator.py +253 -0
  10. crawlo/core/engine.py +185 -11
  11. crawlo/core/scheduler.py +49 -78
  12. crawlo/crawler.py +6 -6
  13. crawlo/downloader/__init__.py +24 -0
  14. crawlo/downloader/aiohttp_downloader.py +8 -0
  15. crawlo/downloader/cffi_downloader.py +5 -0
  16. crawlo/downloader/hybrid_downloader.py +214 -0
  17. crawlo/downloader/playwright_downloader.py +403 -0
  18. crawlo/downloader/selenium_downloader.py +473 -0
  19. crawlo/extension/__init__.py +17 -10
  20. crawlo/extension/health_check.py +142 -0
  21. crawlo/extension/log_interval.py +27 -18
  22. crawlo/extension/log_stats.py +62 -24
  23. crawlo/extension/logging_extension.py +18 -9
  24. crawlo/extension/memory_monitor.py +105 -0
  25. crawlo/extension/performance_profiler.py +134 -0
  26. crawlo/extension/request_recorder.py +108 -0
  27. crawlo/filters/aioredis_filter.py +50 -12
  28. crawlo/middleware/proxy.py +26 -2
  29. crawlo/mode_manager.py +24 -19
  30. crawlo/network/request.py +30 -3
  31. crawlo/network/response.py +114 -25
  32. crawlo/pipelines/mongo_pipeline.py +81 -66
  33. crawlo/pipelines/mysql_pipeline.py +165 -43
  34. crawlo/pipelines/redis_dedup_pipeline.py +7 -3
  35. crawlo/queue/queue_manager.py +15 -2
  36. crawlo/queue/redis_priority_queue.py +144 -76
  37. crawlo/settings/default_settings.py +93 -121
  38. crawlo/subscriber.py +62 -37
  39. crawlo/templates/project/items.py.tmpl +1 -1
  40. crawlo/templates/project/middlewares.py.tmpl +73 -49
  41. crawlo/templates/project/pipelines.py.tmpl +51 -295
  42. crawlo/templates/project/settings.py.tmpl +93 -17
  43. crawlo/templates/project/settings_distributed.py.tmpl +120 -0
  44. crawlo/templates/project/settings_gentle.py.tmpl +95 -0
  45. crawlo/templates/project/settings_high_performance.py.tmpl +152 -0
  46. crawlo/templates/project/settings_simple.py.tmpl +69 -0
  47. crawlo/templates/spider/spider.py.tmpl +2 -38
  48. crawlo/tools/__init__.py +183 -0
  49. crawlo/tools/anti_crawler.py +269 -0
  50. crawlo/tools/authenticated_proxy.py +241 -0
  51. crawlo/tools/data_validator.py +181 -0
  52. crawlo/tools/date_tools.py +36 -0
  53. crawlo/tools/distributed_coordinator.py +387 -0
  54. crawlo/tools/retry_mechanism.py +221 -0
  55. crawlo/tools/scenario_adapter.py +263 -0
  56. crawlo/utils/__init__.py +29 -1
  57. crawlo/utils/batch_processor.py +261 -0
  58. crawlo/utils/date_tools.py +58 -1
  59. crawlo/utils/enhanced_error_handler.py +360 -0
  60. crawlo/utils/env_config.py +106 -0
  61. crawlo/utils/error_handler.py +126 -0
  62. crawlo/utils/performance_monitor.py +285 -0
  63. crawlo/utils/redis_connection_pool.py +335 -0
  64. crawlo/utils/redis_key_validator.py +200 -0
  65. crawlo-1.1.5.dist-info/METADATA +401 -0
  66. crawlo-1.1.5.dist-info/RECORD +185 -0
  67. tests/advanced_tools_example.py +276 -0
  68. tests/authenticated_proxy_example.py +237 -0
  69. tests/cleaners_example.py +161 -0
  70. tests/config_validation_demo.py +103 -0
  71. tests/date_tools_example.py +181 -0
  72. tests/dynamic_loading_example.py +524 -0
  73. tests/dynamic_loading_test.py +105 -0
  74. tests/env_config_example.py +134 -0
  75. tests/error_handling_example.py +172 -0
  76. tests/redis_key_validation_demo.py +131 -0
  77. tests/response_improvements_example.py +145 -0
  78. tests/test_advanced_tools.py +149 -0
  79. tests/test_all_redis_key_configs.py +146 -0
  80. tests/test_authenticated_proxy.py +142 -0
  81. tests/test_cleaners.py +55 -0
  82. tests/test_comprehensive.py +147 -0
  83. tests/test_config_validator.py +194 -0
  84. tests/test_date_tools.py +124 -0
  85. tests/test_dynamic_downloaders_proxy.py +125 -0
  86. tests/test_dynamic_proxy.py +93 -0
  87. tests/test_dynamic_proxy_config.py +147 -0
  88. tests/test_dynamic_proxy_real.py +110 -0
  89. tests/test_edge_cases.py +304 -0
  90. tests/test_enhanced_error_handler.py +271 -0
  91. tests/test_env_config.py +122 -0
  92. tests/test_error_handler_compatibility.py +113 -0
  93. tests/test_framework_env_usage.py +104 -0
  94. tests/test_integration.py +357 -0
  95. tests/test_item_dedup_redis_key.py +123 -0
  96. tests/test_parsel.py +30 -0
  97. tests/test_performance.py +328 -0
  98. tests/test_queue_manager_redis_key.py +177 -0
  99. tests/test_redis_connection_pool.py +295 -0
  100. tests/test_redis_key_naming.py +182 -0
  101. tests/test_redis_key_validator.py +124 -0
  102. tests/test_response_improvements.py +153 -0
  103. tests/test_simple_response.py +62 -0
  104. tests/test_telecom_spider_redis_key.py +206 -0
  105. tests/test_template_content.py +88 -0
  106. tests/test_template_redis_key.py +135 -0
  107. tests/test_tools.py +154 -0
  108. tests/tools_example.py +258 -0
  109. crawlo/core/enhanced_engine.py +0 -190
  110. crawlo-1.1.3.dist-info/METADATA +0 -635
  111. crawlo-1.1.3.dist-info/RECORD +0 -113
  112. {crawlo-1.1.3.dist-info → crawlo-1.1.5.dist-info}/WHEEL +0 -0
  113. {crawlo-1.1.3.dist-info → crawlo-1.1.5.dist-info}/entry_points.txt +0 -0
  114. {crawlo-1.1.3.dist-info → crawlo-1.1.5.dist-info}/top_level.txt +0 -0
  115. {examples → tests}/controlled_spider_example.py +0 -0
@@ -0,0 +1,473 @@
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ Selenium 下载器
5
+ ==============
6
+ 支持动态加载内容的下载器,基于 Selenium WebDriver 实现。
7
+
8
+ 功能特性:
9
+ - 支持 Chrome/Firefox/Edge 等主流浏览器
10
+ - 智能等待页面加载完成
11
+ - 支持自定义浏览器选项和插件
12
+ - 内存安全的资源管理
13
+ - 自动处理 Cookie 和本地存储
14
+ - 支持翻页操作(鼠标滑动、点击翻页)
15
+ - 单浏览器多标签页模式
16
+ """
17
+ import asyncio
18
+ import os
19
+ import time
20
+ from typing import Optional, Dict, List
21
+
22
+ from selenium import webdriver
23
+ from selenium.common.exceptions import TimeoutException, WebDriverException
24
+ from selenium.webdriver.chrome.options import Options as ChromeOptions
25
+ from selenium.webdriver.common.action_chains import ActionChains
26
+ from selenium.webdriver.common.by import By
27
+ from selenium.webdriver.edge.options import Options as EdgeOptions
28
+ from selenium.webdriver.firefox.options import Options as FirefoxOptions
29
+ from selenium.webdriver.support import expected_conditions as EC
30
+ from selenium.webdriver.support.ui import WebDriverWait
31
+
32
+ from crawlo.downloader import DownloaderBase
33
+ from crawlo.network.response import Response
34
+ from crawlo.utils.log import get_logger
35
+
36
+
37
+ class SeleniumDownloader(DownloaderBase):
38
+ """
39
+ 基于 Selenium 的动态内容下载器
40
+ 支持处理 JavaScript 渲染的网页内容
41
+ """
42
+
43
+ def __init__(self, crawler):
44
+ super().__init__(crawler)
45
+ self.driver: Optional[webdriver.Chrome] = None
46
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get("LOG_LEVEL"))
47
+ self.default_timeout = crawler.settings.get_int("SELENIUM_TIMEOUT", 30)
48
+ self.load_timeout = crawler.settings.get_int("SELENIUM_LOAD_TIMEOUT", 10)
49
+ self.window_width = crawler.settings.get_int("SELENIUM_WINDOW_WIDTH", 1920)
50
+ self.window_height = crawler.settings.get_int("SELENIUM_WINDOW_HEIGHT", 1080)
51
+ self.browser_type = crawler.settings.get("SELENIUM_BROWSER_TYPE", "chrome").lower()
52
+ self.headless = crawler.settings.get_bool("SELENIUM_HEADLESS", True)
53
+ self.wait_for_element = crawler.settings.get("SELENIUM_WAIT_FOR_ELEMENT", None)
54
+
55
+ # 单浏览器多标签页模式
56
+ self.single_browser_mode = crawler.settings.get_bool("SELENIUM_SINGLE_BROWSER_MODE", True)
57
+ self.max_tabs_per_browser = crawler.settings.get_int("SELENIUM_MAX_TABS_PER_BROWSER", 10)
58
+ self._window_handles: List[str] = []
59
+ self._current_handle_index = 0
60
+
61
+ def open(self):
62
+ super().open()
63
+ self.logger.info("Opening SeleniumDownloader")
64
+
65
+ try:
66
+ if self.browser_type == "chrome":
67
+ self.driver = self._create_chrome_driver()
68
+ elif self.browser_type == "firefox":
69
+ self.driver = self._create_firefox_driver()
70
+ elif self.browser_type == "edge":
71
+ self.driver = self._create_edge_driver()
72
+ else:
73
+ raise ValueError(f"Unsupported browser type: {self.browser_type}")
74
+
75
+ # 设置窗口大小
76
+ self.driver.set_window_size(self.window_width, self.window_height)
77
+ self.logger.debug(f"SeleniumDownloader initialized with {self.browser_type}")
78
+
79
+ except Exception as e:
80
+ self.logger.error(f"Failed to initialize SeleniumDownloader: {e}")
81
+ raise
82
+
83
+ def _create_chrome_driver(self):
84
+ """创建 Chrome WebDriver"""
85
+ options = ChromeOptions()
86
+
87
+ if self.headless:
88
+ options.add_argument("--headless")
89
+
90
+ # 基本配置
91
+ options.add_argument("--no-sandbox")
92
+ options.add_argument("--disable-dev-shm-usage")
93
+ options.add_argument("--disable-gpu")
94
+ options.add_argument("--disable-extensions")
95
+ options.add_argument("--disable-plugins")
96
+ options.add_argument("--disable-images")
97
+ options.add_argument("--disable-javascript") if not self.crawler.settings.get_bool("SELENIUM_ENABLE_JS", True) else None
98
+
99
+ # 用户代理
100
+ user_agent = self.crawler.settings.get("USER_AGENT")
101
+ if user_agent:
102
+ options.add_argument(f"--user-agent={user_agent}")
103
+
104
+ # 代理设置
105
+ proxy = self.crawler.settings.get("SELENIUM_PROXY")
106
+ if proxy:
107
+ # 处理带认证的代理
108
+ if isinstance(proxy, str) and "@" in proxy and "://" in proxy:
109
+ # 解析带认证的代理URL
110
+ from urllib.parse import urlparse
111
+ parsed = urlparse(proxy)
112
+ if parsed.username and parsed.password:
113
+ # 对于带认证的代理,需要特殊处理
114
+ # 这里我们使用一个扩展来处理认证
115
+ # 创建一个临时的代理配置文件
116
+ import tempfile
117
+ import json
118
+
119
+ proxy_config = {
120
+ "mode": "fixed_servers",
121
+ "rules": {
122
+ "proxyForHttp": {
123
+ "scheme": parsed.scheme,
124
+ "host": parsed.hostname,
125
+ "port": parsed.port or (80 if parsed.scheme == "http" else 443)
126
+ },
127
+ "proxyForHttps": {
128
+ "scheme": parsed.scheme,
129
+ "host": parsed.hostname,
130
+ "port": parsed.port or (80 if parsed.scheme == "http" else 443)
131
+ },
132
+ "bypassList": []
133
+ }
134
+ }
135
+
136
+ # 创建临时目录和文件
137
+ temp_dir = tempfile.mkdtemp()
138
+ proxy_file = os.path.join(temp_dir, "proxy.json")
139
+ with open(proxy_file, 'w') as f:
140
+ json.dump(proxy_config, f)
141
+
142
+ # 设置代理配置文件
143
+ options.add_argument(f"--proxy-server={parsed.scheme}://{parsed.hostname}:{parsed.port or (80 if parsed.scheme == 'http' else 443)}")
144
+
145
+ # 设置认证信息(需要通过其他方式处理)
146
+ # 这里我们简单地清理URL中的认证信息
147
+ clean_proxy = f"{parsed.scheme}://{parsed.hostname}:{parsed.port or (80 if parsed.scheme == 'http' else 443)}"
148
+ options.add_argument(f"--proxy-server={clean_proxy}")
149
+ else:
150
+ options.add_argument(f"--proxy-server={proxy}")
151
+ else:
152
+ options.add_argument(f"--proxy-server={proxy}")
153
+
154
+ # 创建驱动
155
+ return webdriver.Chrome(options=options)
156
+
157
+ def _create_firefox_driver(self):
158
+ """创建 Firefox WebDriver"""
159
+ options = FirefoxOptions()
160
+
161
+ if self.headless:
162
+ options.add_argument("--headless")
163
+
164
+ # 基本配置
165
+ options.set_preference("network.http.use-cache", False)
166
+ options.set_preference("browser.cache.disk.enable", False)
167
+ options.set_preference("browser.cache.memory.enable", False)
168
+
169
+ # 用户代理
170
+ user_agent = self.crawler.settings.get("USER_AGENT")
171
+ if user_agent:
172
+ options.set_preference("general.useragent.override", user_agent)
173
+
174
+ # 代理设置
175
+ proxy = self.crawler.settings.get("SELENIUM_PROXY")
176
+ if proxy:
177
+ # 处理带认证的代理
178
+ if isinstance(proxy, str) and "@" in proxy and "://" in proxy:
179
+ # 解析带认证的代理URL
180
+ from urllib.parse import urlparse
181
+ parsed = urlparse(proxy)
182
+ if parsed.username and parsed.password:
183
+ # 设置代理服务器
184
+ options.set_preference("network.proxy.type", 1) # 手动配置
185
+ options.set_preference("network.proxy.http", parsed.hostname)
186
+ options.set_preference("network.proxy.http_port", parsed.port or 80)
187
+ options.set_preference("network.proxy.ssl", parsed.hostname)
188
+ options.set_preference("network.proxy.ssl_port", parsed.port or 443)
189
+ options.set_preference("network.proxy.ftp", parsed.hostname)
190
+ options.set_preference("network.proxy.ftp_port", parsed.port or 21)
191
+ options.set_preference("network.proxy.socks", parsed.hostname)
192
+ options.set_preference("network.proxy.socks_port", parsed.port or 1080)
193
+
194
+ # 认证信息需要通过其他方式处理(例如使用扩展)
195
+ # 这里我们简单地清理URL中的认证信息
196
+ clean_proxy = f"{parsed.scheme}://{parsed.hostname}:{parsed.port or (80 if parsed.scheme == 'http' else 443)}"
197
+ else:
198
+ options.add_argument(f"--proxy-server={proxy}")
199
+ else:
200
+ # 简单的代理配置
201
+ options.set_preference("network.proxy.type", 1)
202
+ # 这里需要根据代理URL的具体格式来解析
203
+ from urllib.parse import urlparse
204
+ parsed = urlparse(proxy)
205
+ if parsed.scheme in ["http", "https"]:
206
+ options.set_preference("network.proxy.http", parsed.hostname)
207
+ options.set_preference("network.proxy.http_port", parsed.port or 80)
208
+ options.set_preference("network.proxy.ssl", parsed.hostname)
209
+ options.set_preference("network.proxy.ssl_port", parsed.port or 443)
210
+ elif parsed.scheme == "socks5":
211
+ options.set_preference("network.proxy.socks", parsed.hostname)
212
+ options.set_preference("network.proxy.socks_port", parsed.port or 1080)
213
+ options.set_preference("network.proxy.socks_version", 5)
214
+ elif parsed.scheme == "socks4":
215
+ options.set_preference("network.proxy.socks", parsed.hostname)
216
+ options.set_preference("network.proxy.socks_port", parsed.port or 1080)
217
+ options.set_preference("network.proxy.socks_version", 4)
218
+
219
+ return webdriver.Firefox(options=options)
220
+
221
+ def _create_edge_driver(self):
222
+ """创建 Edge WebDriver"""
223
+ options = EdgeOptions()
224
+
225
+ if self.headless:
226
+ options.add_argument("--headless")
227
+
228
+ # 基本配置
229
+ options.add_argument("--no-sandbox")
230
+ options.add_argument("--disable-dev-shm-usage")
231
+ options.add_argument("--disable-gpu")
232
+
233
+ # 用户代理
234
+ user_agent = self.crawler.settings.get("USER_AGENT")
235
+ if user_agent:
236
+ options.add_argument(f"--user-agent={user_agent}")
237
+
238
+ # 代理设置
239
+ proxy = self.crawler.settings.get("SELENIUM_PROXY")
240
+ if proxy:
241
+ # 处理带认证的代理
242
+ if isinstance(proxy, str) and "@" in proxy and "://" in proxy:
243
+ # 解析带认证的代理URL
244
+ from urllib.parse import urlparse
245
+ parsed = urlparse(proxy)
246
+ if parsed.username and parsed.password:
247
+ # 清理URL中的认证信息
248
+ clean_proxy = f"{parsed.scheme}://{parsed.hostname}:{parsed.port or (80 if parsed.scheme == 'http' else 443)}"
249
+ options.add_argument(f"--proxy-server={clean_proxy}")
250
+ else:
251
+ options.add_argument(f"--proxy-server={proxy}")
252
+ else:
253
+ options.add_argument(f"--proxy-server={proxy}")
254
+
255
+ return webdriver.Edge(options=options)
256
+
257
+ async def download(self, request) -> Optional[Response]:
258
+ """下载动态内容"""
259
+ if not self.driver:
260
+ raise RuntimeError("SeleniumDownloader driver is not available")
261
+
262
+ start_time = None
263
+ if self.crawler.settings.get_bool("DOWNLOAD_STATS", True):
264
+ start_time = time.time()
265
+
266
+ try:
267
+ # 切换到合适的标签页或创建新标签页
268
+ await self._switch_or_create_tab()
269
+
270
+ # 访问页面
271
+ self.driver.get(request.url)
272
+
273
+ # 等待页面加载完成
274
+ await self._wait_for_page_load()
275
+
276
+ # 执行自定义脚本(如果有)
277
+ await self._execute_custom_scripts(request)
278
+
279
+ # 执行翻页操作(如果有)
280
+ await self._execute_pagination_actions(request)
281
+
282
+ # 获取页面内容
283
+ page_source = self.driver.page_source
284
+ page_url = self.driver.current_url
285
+
286
+ # 获取响应头信息(Selenium 无法直接获取,需要模拟)
287
+ headers = self._get_response_headers()
288
+
289
+ # 获取状态码(Selenium 无法直接获取,需要通过执行脚本)
290
+ status_code = await self._get_status_code()
291
+
292
+ # 获取 Cookies
293
+ cookies = self._get_cookies()
294
+
295
+ # 构造响应对象
296
+ response = Response(
297
+ url=page_url,
298
+ headers=headers,
299
+ status_code=status_code,
300
+ body=page_source.encode('utf-8'),
301
+ request=request
302
+ )
303
+
304
+ # 添加 Cookies 到响应
305
+ response.cookies = cookies
306
+
307
+ # 记录下载统计
308
+ if start_time:
309
+ download_time = time.time() - start_time
310
+ self.logger.debug(f"Downloaded {request.url} in {download_time:.3f}s")
311
+
312
+ return response
313
+
314
+ except TimeoutException as e:
315
+ self.logger.error(f"Timeout error for {request.url}: {e}")
316
+ raise
317
+ except WebDriverException as e:
318
+ self.logger.error(f"WebDriver error for {request.url}: {e}")
319
+ raise
320
+ except Exception as e:
321
+ self.logger.critical(f"Unexpected error for {request.url}: {e}", exc_info=True)
322
+ raise
323
+
324
+ async def _switch_or_create_tab(self):
325
+ """切换到合适的标签页或创建新标签页"""
326
+ if not self.single_browser_mode:
327
+ return
328
+
329
+ # 如果还没有窗口句柄,保存当前窗口
330
+ if not self._window_handles:
331
+ self._window_handles.append(self.driver.current_window_handle)
332
+ return
333
+
334
+ # 检查是否需要创建新标签页
335
+ if len(self._window_handles) < self.max_tabs_per_browser:
336
+ # 创建新标签页
337
+ self.driver.execute_script("window.open('');")
338
+ # 切换到新标签页
339
+ self.driver.switch_to.window(self.driver.window_handles[-1])
340
+ # 保存新标签页句柄
341
+ self._window_handles.append(self.driver.current_window_handle)
342
+ return
343
+
344
+ # 循环使用现有的标签页
345
+ self._current_handle_index = (self._current_handle_index + 1) % len(self._window_handles)
346
+ self.driver.switch_to.window(self._window_handles[self._current_handle_index])
347
+
348
+ # 清空当前页面内容
349
+ self.driver.execute_script("document.body.innerHTML = '';")
350
+
351
+ async def _wait_for_page_load(self):
352
+ """等待页面加载完成"""
353
+ try:
354
+ # 等待 document.readyState 为 complete
355
+ WebDriverWait(self.driver, self.load_timeout).until(
356
+ lambda d: d.execute_script("return document.readyState") == "complete"
357
+ )
358
+
359
+ # 如果配置了等待特定元素,则等待该元素出现
360
+ if self.wait_for_element:
361
+ WebDriverWait(self.driver, self.load_timeout).until(
362
+ EC.presence_of_element_located((By.CSS_SELECTOR, self.wait_for_element))
363
+ )
364
+
365
+ except TimeoutException:
366
+ self.logger.warning("Page load timeout, continuing with current content")
367
+
368
+ async def _execute_custom_scripts(self, request):
369
+ """执行自定义脚本"""
370
+ # 从请求的 meta 中获取自定义脚本
371
+ custom_scripts = request.meta.get("selenium_scripts", [])
372
+
373
+ for script in custom_scripts:
374
+ try:
375
+ if isinstance(script, str):
376
+ self.driver.execute_script(script)
377
+ elif isinstance(script, dict):
378
+ script_type = script.get("type", "js")
379
+ script_content = script.get("content", "")
380
+
381
+ if script_type == "js":
382
+ self.driver.execute_script(script_content)
383
+ elif script_type == "wait":
384
+ # 等待特定时间
385
+ await asyncio.sleep(script_content)
386
+
387
+ except Exception as e:
388
+ self.logger.warning(f"Failed to execute custom script: {e}")
389
+
390
+ async def _execute_pagination_actions(self, request):
391
+ """执行翻页操作"""
392
+ # 从请求的 meta 中获取翻页操作
393
+ pagination_actions = request.meta.get("pagination_actions", [])
394
+
395
+ for action in pagination_actions:
396
+ try:
397
+ if isinstance(action, dict):
398
+ action_type = action.get("type")
399
+ action_params = action.get("params", {})
400
+
401
+ if action_type == "scroll":
402
+ # 鼠标滑动翻页
403
+ scroll_count = action_params.get("count", 1)
404
+ scroll_delay = action_params.get("delay", 1)
405
+ scroll_distance = action_params.get("distance", 500)
406
+
407
+ action_chains = ActionChains(self.driver)
408
+ for _ in range(scroll_count):
409
+ action_chains.scroll_by_amount(0, scroll_distance).perform()
410
+ time.sleep(scroll_delay)
411
+
412
+ elif action_type == "click":
413
+ # 鼠标点击翻页
414
+ selector = action_params.get("selector")
415
+ click_count = action_params.get("count", 1)
416
+ click_delay = action_params.get("delay", 1)
417
+
418
+ if selector:
419
+ element = WebDriverWait(self.driver, self.load_timeout).until(
420
+ EC.element_to_be_clickable((By.CSS_SELECTOR, selector))
421
+ )
422
+ for _ in range(click_count):
423
+ element.click()
424
+ time.sleep(click_delay)
425
+
426
+ elif action_type == "evaluate":
427
+ # 执行自定义脚本翻页
428
+ script = action_params.get("script")
429
+ if script:
430
+ self.driver.execute_script(script)
431
+
432
+ except Exception as e:
433
+ self.logger.warning(f"Failed to execute pagination action: {e}")
434
+
435
+ def _get_response_headers(self) -> Dict[str, str]:
436
+ """获取响应头信息"""
437
+ # Selenium 无法直接获取响应头,这里返回一些基本的模拟信息
438
+ return {
439
+ "Content-Type": "text/html; charset=utf-8",
440
+ "Server": "Selenium WebDriver"
441
+ }
442
+
443
+ async def _get_status_code(self) -> int:
444
+ """获取状态码"""
445
+ try:
446
+ # 通过执行脚本获取状态码
447
+ status_code = self.driver.execute_script(
448
+ "return window.performance.getEntriesByType('navigation')[0].responseStart > 0 ? 200 : 404;"
449
+ )
450
+ return status_code if isinstance(status_code, int) else 200
451
+ except Exception:
452
+ return 200 # 默认成功
453
+
454
+ def _get_cookies(self) -> Dict[str, str]:
455
+ """获取 Cookies"""
456
+ try:
457
+ selenium_cookies = self.driver.get_cookies()
458
+ return {cookie['name']: cookie['value'] for cookie in selenium_cookies}
459
+ except Exception as e:
460
+ self.logger.warning(f"Failed to get cookies: {e}")
461
+ return {}
462
+
463
+ async def close(self) -> None:
464
+ """关闭浏览器资源"""
465
+ if self.driver:
466
+ self.logger.info("Closing SeleniumDownloader driver...")
467
+ try:
468
+ self.driver.quit()
469
+ except Exception as e:
470
+ self.logger.warning(f"Error closing Selenium driver: {e}")
471
+ finally:
472
+ self.driver = None
473
+ self.logger.debug("SeleniumDownloader closed.")
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/python
2
2
  # -*- coding:UTF-8 -*-
3
- from typing import List
3
+ from typing import List, Any
4
4
  from pprint import pformat
5
5
 
6
6
  from crawlo.utils.log import get_logger
@@ -10,7 +10,7 @@ from crawlo.exceptions import ExtensionInitError
10
10
 
11
11
  class ExtensionManager(object):
12
12
 
13
- def __init__(self, crawler):
13
+ def __init__(self, crawler: Any):
14
14
  self.crawler = crawler
15
15
  self.extensions: List = []
16
16
  extensions = self.crawler.settings.get_list('EXTENSIONS')
@@ -18,14 +18,21 @@ class ExtensionManager(object):
18
18
  self._add_extensions(extensions)
19
19
 
20
20
  @classmethod
21
- def create_instance(cls, *args, **kwargs):
21
+ def create_instance(cls, *args: Any, **kwargs: Any) -> 'ExtensionManager':
22
22
  return cls(*args, **kwargs)
23
23
 
24
- def _add_extensions(self, extensions):
25
- for extension in extensions:
26
- extension_cls = load_class(extension)
27
- if not hasattr(extension_cls, 'create_instance'):
28
- raise ExtensionInitError(f"extension init failed, Must have method 'create_instance()")
29
- self.extensions.append(extension_cls.create_instance(self.crawler))
24
+ def _add_extensions(self, extensions: List[str]) -> None:
25
+ for extension_path in extensions:
26
+ try:
27
+ extension_cls = load_class(extension_path)
28
+ if not hasattr(extension_cls, 'create_instance'):
29
+ raise ExtensionInitError(
30
+ f"Extension '{extension_path}' init failed: Must have method 'create_instance()'"
31
+ )
32
+ self.extensions.append(extension_cls.create_instance(self.crawler))
33
+ except Exception as e:
34
+ self.logger.error(f"Failed to load extension '{extension_path}': {e}")
35
+ raise ExtensionInitError(f"Failed to load extension '{extension_path}': {e}")
36
+
30
37
  if extensions:
31
- self.logger.info(f"enabled extensions: \n {pformat(extensions)}")
38
+ self.logger.info(f"Enabled extensions: \n{pformat(extensions)}")
@@ -0,0 +1,142 @@
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ from typing import Any, Optional, Dict
5
+ from datetime import datetime, timedelta
6
+
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.event import spider_opened, spider_closed, response_received, request_scheduled
9
+
10
+
11
+ class HealthCheckExtension:
12
+ """
13
+ 健康检查扩展
14
+ 监控爬虫的健康状态,包括响应时间、错误率等指标
15
+ """
16
+
17
+ def __init__(self, crawler: Any):
18
+ self.settings = crawler.settings
19
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
20
+
21
+ # 获取配置参数
22
+ self.enabled = self.settings.get_bool('HEALTH_CHECK_ENABLED', True)
23
+ self.check_interval = self.settings.get_int('HEALTH_CHECK_INTERVAL', 60) # 默认60秒
24
+
25
+ # 健康状态统计
26
+ self.stats: Dict[str, Any] = {
27
+ 'start_time': None,
28
+ 'total_requests': 0,
29
+ 'total_responses': 0,
30
+ 'error_responses': 0,
31
+ 'last_check_time': None,
32
+ 'response_times': [], # 存储最近的响应时间
33
+ }
34
+
35
+ self.task: Optional[asyncio.Task] = None
36
+
37
+ @classmethod
38
+ def create_instance(cls, crawler: Any) -> 'HealthCheckExtension':
39
+ # 只有当配置启用时才创建实例
40
+ if not crawler.settings.get_bool('HEALTH_CHECK_ENABLED', True):
41
+ from crawlo.exceptions import NotConfigured
42
+ raise NotConfigured("HealthCheckExtension: HEALTH_CHECK_ENABLED is False")
43
+
44
+ o = cls(crawler)
45
+ if o.enabled:
46
+ crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
47
+ crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
48
+ crawler.subscriber.subscribe(o.response_received, event=response_received)
49
+ crawler.subscriber.subscribe(o.request_scheduled, event=request_scheduled)
50
+ return o
51
+
52
+ async def spider_opened(self) -> None:
53
+ """爬虫启动时初始化健康检查"""
54
+ if not self.enabled:
55
+ return
56
+
57
+ self.stats['start_time'] = datetime.now()
58
+ self.task = asyncio.create_task(self._health_check_loop())
59
+ self.logger.info("Health check extension started.")
60
+
61
+ async def spider_closed(self) -> None:
62
+ """爬虫关闭时停止健康检查"""
63
+ if not self.enabled:
64
+ return
65
+
66
+ if self.task:
67
+ self.task.cancel()
68
+ try:
69
+ await self.task
70
+ except asyncio.CancelledError:
71
+ pass
72
+
73
+ # 输出最终健康状态
74
+ await self._check_health()
75
+ self.logger.info("Health check extension stopped.")
76
+
77
+ async def request_scheduled(self, request: Any, spider: Any) -> None:
78
+ """记录调度的请求"""
79
+ if not self.enabled:
80
+ return
81
+ self.stats['total_requests'] += 1
82
+
83
+ async def response_received(self, response: Any, spider: Any) -> None:
84
+ """记录接收到的响应"""
85
+ if not self.enabled:
86
+ return
87
+
88
+ self.stats['total_responses'] += 1
89
+
90
+ # 记录错误响应
91
+ if hasattr(response, 'status_code') and response.status_code >= 400:
92
+ self.stats['error_responses'] += 1
93
+
94
+ async def _health_check_loop(self) -> None:
95
+ """健康检查循环"""
96
+ while True:
97
+ try:
98
+ await asyncio.sleep(self.check_interval)
99
+ await self._check_health()
100
+ except asyncio.CancelledError:
101
+ break
102
+ except Exception as e:
103
+ self.logger.error(f"Error in health check loop: {e}")
104
+
105
+ async def _check_health(self) -> None:
106
+ """执行健康检查并输出报告"""
107
+ try:
108
+ now_time = datetime.now()
109
+ self.stats['last_check_time'] = now_time
110
+
111
+ # 计算基本统计信息
112
+ runtime = (now_time - self.stats['start_time']).total_seconds() if self.stats['start_time'] else 0
113
+ requests_per_second = self.stats['total_requests'] / runtime if runtime > 0 else 0
114
+ responses_per_second = self.stats['total_responses'] / runtime if runtime > 0 else 0
115
+
116
+ # 计算错误率
117
+ error_rate = (
118
+ self.stats['error_responses'] / self.stats['total_responses']
119
+ if self.stats['total_responses'] > 0 else 0
120
+ )
121
+
122
+ # 输出健康报告
123
+ health_report = {
124
+ 'runtime_seconds': round(runtime, 2),
125
+ 'total_requests': self.stats['total_requests'],
126
+ 'total_responses': self.stats['total_responses'],
127
+ 'requests_per_second': round(requests_per_second, 2),
128
+ 'responses_per_second': round(responses_per_second, 2),
129
+ 'error_responses': self.stats['error_responses'],
130
+ 'error_rate': f"{error_rate:.2%}",
131
+ }
132
+
133
+ # 根据错误率判断健康状态
134
+ if error_rate > 0.1: # 错误率超过10%
135
+ self.logger.warning(f"Health check report: {health_report}")
136
+ elif error_rate > 0.05: # 错误率超过5%
137
+ self.logger.info(f"Health check report: {health_report}")
138
+ else:
139
+ self.logger.debug(f"Health check report: {health_report}")
140
+
141
+ except Exception as e:
142
+ self.logger.error(f"Error in health check: {e}")