crawlo 1.3.2__py3-none-any.whl → 1.3.3__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 (219) hide show
  1. crawlo/__init__.py +63 -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 +322 -314
  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 +2 -2
  16. crawlo/core/engine.py +365 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +256 -256
  19. crawlo/crawler.py +1166 -1168
  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 +226 -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 +52 -45
  36. crawlo/extension/memory_monitor.py +104 -104
  37. crawlo/extension/performance_profiler.py +133 -133
  38. crawlo/extension/request_recorder.py +107 -107
  39. crawlo/filters/__init__.py +154 -154
  40. crawlo/filters/aioredis_filter.py +234 -234
  41. crawlo/filters/memory_filter.py +269 -269
  42. crawlo/items/__init__.py +23 -23
  43. crawlo/items/base.py +21 -21
  44. crawlo/items/fields.py +52 -52
  45. crawlo/items/items.py +104 -104
  46. crawlo/middleware/__init__.py +21 -21
  47. crawlo/middleware/default_header.py +132 -132
  48. crawlo/middleware/download_delay.py +104 -104
  49. crawlo/middleware/middleware_manager.py +135 -135
  50. crawlo/middleware/offsite.py +123 -123
  51. crawlo/middleware/proxy.py +386 -386
  52. crawlo/middleware/request_ignore.py +86 -86
  53. crawlo/middleware/response_code.py +163 -163
  54. crawlo/middleware/response_filter.py +136 -136
  55. crawlo/middleware/retry.py +124 -124
  56. crawlo/middleware/simple_proxy.py +65 -65
  57. crawlo/mode_manager.py +187 -187
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +379 -379
  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 +222 -222
  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 +318 -318
  70. crawlo/pipelines/pipeline_manager.py +75 -75
  71. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  72. crawlo/project.py +325 -297
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +379 -379
  75. crawlo/queue/redis_priority_queue.py +306 -306
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +225 -225
  78. crawlo/settings/setting_manager.py +198 -198
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +129 -129
  82. crawlo/task_manager.py +30 -30
  83. crawlo/templates/crawlo.cfg.tmpl +10 -10
  84. crawlo/templates/project/__init__.py.tmpl +3 -3
  85. crawlo/templates/project/items.py.tmpl +17 -17
  86. crawlo/templates/project/middlewares.py.tmpl +118 -118
  87. crawlo/templates/project/pipelines.py.tmpl +96 -96
  88. crawlo/templates/project/settings.py.tmpl +266 -266
  89. crawlo/templates/project/settings_distributed.py.tmpl +179 -179
  90. crawlo/templates/project/settings_gentle.py.tmpl +60 -60
  91. crawlo/templates/project/settings_high_performance.py.tmpl +130 -130
  92. crawlo/templates/project/settings_minimal.py.tmpl +34 -34
  93. crawlo/templates/project/settings_simple.py.tmpl +101 -101
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +38 -38
  96. crawlo/templates/spider/spider.py.tmpl +143 -143
  97. crawlo/tools/__init__.py +200 -200
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/tools/data_formatter.py +225 -225
  101. crawlo/tools/data_validator.py +180 -180
  102. crawlo/tools/date_tools.py +289 -289
  103. crawlo/tools/distributed_coordinator.py +388 -388
  104. crawlo/tools/encoding_converter.py +127 -127
  105. crawlo/tools/request_tools.py +82 -82
  106. crawlo/tools/retry_mechanism.py +224 -224
  107. crawlo/tools/scenario_adapter.py +262 -262
  108. crawlo/tools/text_cleaner.py +232 -232
  109. crawlo/utils/__init__.py +34 -34
  110. crawlo/utils/batch_processor.py +259 -259
  111. crawlo/utils/controlled_spider_mixin.py +439 -439
  112. crawlo/utils/db_helper.py +343 -343
  113. crawlo/utils/enhanced_error_handler.py +356 -356
  114. crawlo/utils/env_config.py +142 -142
  115. crawlo/utils/error_handler.py +123 -123
  116. crawlo/utils/func_tools.py +82 -82
  117. crawlo/utils/large_scale_config.py +286 -286
  118. crawlo/utils/large_scale_helper.py +344 -344
  119. crawlo/utils/log.py +199 -146
  120. crawlo/utils/performance_monitor.py +285 -285
  121. crawlo/utils/queue_helper.py +175 -175
  122. crawlo/utils/redis_connection_pool.py +351 -351
  123. crawlo/utils/redis_key_validator.py +198 -198
  124. crawlo/utils/request.py +267 -267
  125. crawlo/utils/request_serializer.py +218 -218
  126. crawlo/utils/spider_loader.py +61 -61
  127. crawlo/utils/system.py +11 -11
  128. crawlo/utils/tools.py +4 -4
  129. crawlo/utils/url.py +39 -39
  130. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/METADATA +1020 -1020
  131. crawlo-1.3.3.dist-info/RECORD +219 -0
  132. examples/__init__.py +7 -7
  133. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  134. tests/__init__.py +7 -7
  135. tests/advanced_tools_example.py +275 -275
  136. tests/authenticated_proxy_example.py +107 -107
  137. tests/cleaners_example.py +160 -160
  138. tests/config_validation_demo.py +142 -142
  139. tests/controlled_spider_example.py +205 -205
  140. tests/date_tools_example.py +180 -180
  141. tests/debug_pipelines.py +66 -66
  142. tests/dynamic_loading_example.py +523 -523
  143. tests/dynamic_loading_test.py +104 -104
  144. tests/env_config_example.py +133 -133
  145. tests/error_handling_example.py +171 -171
  146. tests/redis_key_validation_demo.py +130 -130
  147. tests/request_params_example.py +150 -150
  148. tests/response_improvements_example.py +144 -144
  149. tests/test_advanced_tools.py +148 -148
  150. tests/test_all_redis_key_configs.py +145 -145
  151. tests/test_authenticated_proxy.py +141 -141
  152. tests/test_cleaners.py +54 -54
  153. tests/test_comprehensive.py +146 -146
  154. tests/test_config_consistency.py +80 -80
  155. tests/test_config_merge.py +152 -152
  156. tests/test_config_validator.py +182 -182
  157. tests/test_crawlo_proxy_integration.py +108 -108
  158. tests/test_date_tools.py +123 -123
  159. tests/test_default_header_middleware.py +158 -158
  160. tests/test_distributed.py +65 -65
  161. tests/test_double_crawlo_fix.py +207 -207
  162. tests/test_double_crawlo_fix_simple.py +124 -124
  163. tests/test_download_delay_middleware.py +221 -221
  164. tests/test_downloader_proxy_compatibility.py +268 -268
  165. tests/test_dynamic_downloaders_proxy.py +124 -124
  166. tests/test_dynamic_proxy.py +92 -92
  167. tests/test_dynamic_proxy_config.py +146 -146
  168. tests/test_dynamic_proxy_real.py +109 -109
  169. tests/test_edge_cases.py +303 -303
  170. tests/test_enhanced_error_handler.py +270 -270
  171. tests/test_env_config.py +121 -121
  172. tests/test_error_handler_compatibility.py +112 -112
  173. tests/test_final_validation.py +153 -153
  174. tests/test_framework_env_usage.py +103 -103
  175. tests/test_integration.py +169 -169
  176. tests/test_item_dedup_redis_key.py +122 -122
  177. tests/test_mode_consistency.py +51 -51
  178. tests/test_offsite_middleware.py +221 -221
  179. tests/test_parsel.py +29 -29
  180. tests/test_performance.py +327 -327
  181. tests/test_proxy_api.py +264 -264
  182. tests/test_proxy_health_check.py +32 -32
  183. tests/test_proxy_middleware.py +121 -121
  184. tests/test_proxy_middleware_enhanced.py +216 -216
  185. tests/test_proxy_middleware_integration.py +136 -136
  186. tests/test_proxy_middleware_refactored.py +184 -184
  187. tests/test_proxy_providers.py +56 -56
  188. tests/test_proxy_stats.py +19 -19
  189. tests/test_proxy_strategies.py +59 -59
  190. tests/test_queue_manager_double_crawlo.py +173 -173
  191. tests/test_queue_manager_redis_key.py +176 -176
  192. tests/test_random_user_agent.py +72 -72
  193. tests/test_real_scenario_proxy.py +195 -195
  194. tests/test_redis_config.py +28 -28
  195. tests/test_redis_connection_pool.py +294 -294
  196. tests/test_redis_key_naming.py +181 -181
  197. tests/test_redis_key_validator.py +123 -123
  198. tests/test_redis_queue.py +224 -224
  199. tests/test_request_ignore_middleware.py +182 -182
  200. tests/test_request_params.py +111 -111
  201. tests/test_request_serialization.py +70 -70
  202. tests/test_response_code_middleware.py +349 -349
  203. tests/test_response_filter_middleware.py +427 -427
  204. tests/test_response_improvements.py +152 -152
  205. tests/test_retry_middleware.py +241 -241
  206. tests/test_scheduler.py +252 -252
  207. tests/test_scheduler_config_update.py +133 -133
  208. tests/test_simple_response.py +61 -61
  209. tests/test_telecom_spider_redis_key.py +205 -205
  210. tests/test_template_content.py +87 -87
  211. tests/test_template_redis_key.py +134 -134
  212. tests/test_tools.py +159 -159
  213. tests/test_user_agents.py +96 -96
  214. tests/tools_example.py +260 -260
  215. tests/verify_distributed.py +117 -117
  216. crawlo-1.3.2.dist-info/RECORD +0 -219
  217. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/WHEEL +0 -0
  218. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/entry_points.txt +0 -0
  219. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/top_level.txt +0 -0
crawlo/commands/run.py CHANGED
@@ -1,315 +1,323 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- # @Time : 2025-08-31 22:36
5
- # @Author : crawl-coder
6
- # @Desc : 命令行入口:crawlo run <spider_name>|all,用于运行指定爬虫。
7
- """
8
- import os
9
- import sys
10
- import asyncio
11
- import configparser
12
- from importlib import import_module
13
-
14
- from rich import box
15
- from rich.console import Console
16
- from rich.panel import Panel
17
- from rich.progress import Progress, SpinnerColumn, TextColumn
18
- from rich.table import Table
19
- from rich.text import Text
20
-
21
- from crawlo.commands.stats import record_stats
22
- from crawlo.crawler import CrawlerProcess
23
- from crawlo.project import get_settings, _find_project_root
24
- # 使用自定义日志系统
25
- from crawlo.utils.log import get_logger
26
-
27
- logger = get_logger(__name__)
28
-
29
- console = Console()
30
-
31
-
32
- def check_redis_connection(settings):
33
- """检查Redis连接(分布式模式下)"""
34
- try:
35
- # 检查是否为分布式模式
36
- run_mode = settings.get('RUN_MODE', 'standalone')
37
- queue_type = settings.get('QUEUE_TYPE', 'memory')
38
-
39
- if run_mode == 'distributed' or queue_type == 'redis':
40
- import redis.asyncio as redis
41
- redis_url = settings.get('REDIS_URL', 'redis://127.0.0.1:6379/0')
42
- redis_host = settings.get('REDIS_HOST', '127.0.0.1')
43
- redis_port = settings.get('REDIS_PORT', 6379)
44
-
45
- console.print(f"检查 Redis 连接: {redis_host}:{redis_port}")
46
-
47
- # 创建Redis连接进行测试
48
- async def _test_redis():
49
- try:
50
- r = redis.from_url(redis_url, encoding="utf-8", decode_responses=True)
51
- await r.ping()
52
- await r.close()
53
- return True
54
- except Exception as e:
55
- console.print(f"Redis 连接失败: {e}")
56
- return False
57
-
58
- # 运行异步测试
59
- if not asyncio.run(_test_redis()):
60
- raise ConnectionError(f"无法连接到 Redis 服务器 {redis_host}:{redis_port}")
61
-
62
- console.print("Redis 连接正常")
63
- return True
64
- else:
65
- # 非分布式模式,跳过Redis检查
66
- return True
67
- except ImportError:
68
- console.print("Redis 客户端未安装,跳过连接检查")
69
- return True
70
- except Exception as e:
71
- console.print(f"Redis 连接检查失败: {e}")
72
- return False
73
-
74
-
75
- def main(args):
76
- """
77
- 主函数:运行指定爬虫
78
- 用法:
79
- crawlo run <spider_name>|all [--json] [--no-stats]
80
- """
81
- # 添加调试信息
82
- logger.debug("DEBUG: 进入main函数")
83
-
84
- if len(args) < 1:
85
- console.print("[bold red]用法:[/bold red] [blue]crawlo run[/blue] <爬虫名称>|all [bold yellow][--json] [--no-stats][/bold yellow]")
86
- console.print("示例:")
87
- console.print(" [blue]crawlo run baidu[/blue]")
88
- console.print(" [blue]crawlo run all[/blue]")
89
- console.print(" [blue]crawlo run all --json --no-stats[/blue]")
90
- return 1
91
-
92
- # 解析参数
93
- spider_arg = args[0]
94
- show_json = "--json" in args
95
- no_stats = "--no-stats" in args
96
-
97
- try:
98
- # 1. 查找项目根目录
99
- project_root = _find_project_root()
100
- if not project_root:
101
- msg = "[bold red]找不到 'crawlo.cfg'[/bold red]\n请在项目目录中运行此命令。"
102
- if show_json:
103
- console.print_json(data={"success": False, "error": "未找到项目根目录"})
104
- return 1
105
- else:
106
- console.print(Panel(
107
- Text.from_markup(msg),
108
- title="非Crawlo项目",
109
- border_style="red",
110
- padding=(1, 2)
111
- ))
112
- return 1
113
-
114
- project_root_str = str(project_root)
115
- if project_root_str not in sys.path:
116
- sys.path.insert(0, project_root_str)
117
-
118
- # 2. 读取 crawlo.cfg 获取 settings 模块
119
- cfg_file = os.path.join(project_root, "crawlo.cfg")
120
- if not os.path.exists(cfg_file):
121
- msg = f"在 {project_root} 中未找到 crawlo.cfg"
122
- if show_json:
123
- console.print_json(data={"success": False, "error": msg})
124
- return 1
125
- else:
126
- console.print(Panel(msg, title="缺少配置文件", border_style="red"))
127
- return 1
128
-
129
- config = configparser.ConfigParser()
130
- config.read(cfg_file, encoding="utf-8")
131
-
132
- if not config.has_section("settings") or not config.has_option("settings", "default"):
133
- msg = "crawlo.cfg 中缺少 [settings] 部分或 'default' 选项"
134
- if show_json:
135
- console.print_json(data={"success": False, "error": msg})
136
- return 1
137
- else:
138
- console.print(Panel(msg, title="无效配置", border_style="red"))
139
- return 1
140
-
141
- settings_module = config.get("settings", "default")
142
- project_package = settings_module.split(".")[0]
143
-
144
- # 3. 确保项目包可导入
145
- try:
146
- import_module(project_package)
147
- except ImportError as e:
148
- msg = f"导入项目包 '{project_package}' 失败: {e}"
149
- if show_json:
150
- console.print_json(data={"success": False, "error": msg})
151
- return 1
152
- else:
153
- console.print(Panel(msg, title="导入错误", border_style="red"))
154
- return 1
155
-
156
- # 4. 加载 settings 和爬虫模块
157
- settings = get_settings()
158
-
159
- # 检查Redis连接(如果是分布式模式)
160
- if not check_redis_connection(settings):
161
- if show_json:
162
- console.print_json(data={"success": False, "error": "Redis连接检查失败"})
163
- return 1
164
- else:
165
- return 1
166
-
167
- spider_modules = [f"{project_package}.spiders"]
168
- process = CrawlerProcess(settings=settings, spider_modules=spider_modules)
169
-
170
- # === 情况1:运行所有爬虫 ===
171
- if spider_arg.lower() == "all":
172
- spider_names = process.get_spider_names()
173
- if not spider_names:
174
- msg = "未找到爬虫。"
175
- if show_json:
176
- console.print_json(data={"success": False, "error": msg})
177
- return 1
178
- else:
179
- console.print(Panel(
180
- Text.from_markup(
181
- "[bold red]未找到爬虫。[/bold red]\n\n"
182
- "[bold]确保:[/bold]\n"
183
- " • 爬虫定义于 '[cyan]spiders/[/cyan]' 目录\n"
184
- " 具有 [green]`name`[/green] 属性\n"
185
- " • 模块已导入 (例如通过 [cyan]__init__.py[/cyan])"
186
- ),
187
- title="未找到爬虫",
188
- border_style="red",
189
- padding=(1, 2)
190
- ))
191
- return 1
192
-
193
- # 显示即将运行的爬虫列表
194
- # 根据用户要求,不再显示详细的爬虫列表信息
195
-
196
- # 注册 stats 记录(除非 --no-stats)
197
- if not no_stats:
198
- for crawler in process.crawlers:
199
- crawler.signals.connect(record_stats, signal="spider_closed")
200
-
201
- # 并行运行所有爬虫
202
- with Progress(
203
- SpinnerColumn(),
204
- TextColumn("[progress.description]{task.description}"),
205
- transient=True,
206
- ) as progress:
207
- task = progress.add_task("正在运行所有爬虫...", total=None)
208
- asyncio.run(process.crawl(spider_names))
209
-
210
- if show_json:
211
- console.print_json(data={"success": True, "spiders": spider_names})
212
- else:
213
- console.print(Panel(
214
- "[bold green]所有爬虫运行完成![/bold green]",
215
- title="全部完成",
216
- border_style="green"
217
- ))
218
- return 0
219
-
220
- # === 情况2:运行单个爬虫 ===
221
- spider_name = spider_arg
222
- if not process.is_spider_registered(spider_name):
223
- available = process.get_spider_names()
224
- msg = f"爬虫 '[cyan]{spider_name}[/cyan]' 未找到。"
225
- if show_json:
226
- console.print_json(data={
227
- "success": False,
228
- "error": msg,
229
- "available": available
230
- })
231
- return 1
232
- else:
233
- panel_content = Text.from_markup(msg + "\n")
234
- if available:
235
- panel_content.append("\n可用爬虫:\n")
236
- for name in sorted(available):
237
- cls = process.get_spider_class(name)
238
- panel_content.append(f" • [cyan]{name}[/cyan] ([green]{cls.__name__}[/green])\n")
239
- else:
240
- panel_content.append("\n未找到爬虫。请检查爬虫模块。")
241
-
242
- console.print(Panel(
243
- panel_content,
244
- title="爬虫未找到",
245
- border_style="red",
246
- padding=(1, 2)
247
- ))
248
- return 1
249
-
250
- spider_class = process.get_spider_class(spider_name)
251
-
252
- # 显示启动信息
253
- # 根据用户要求,不再显示项目启动信息
254
- # if not show_json:
255
- # info_table = Table(
256
- # title=f"启动爬虫: [bold cyan]{spider_name}[/bold cyan]",
257
- # box=box.SIMPLE,
258
- # show_header=False,
259
- # title_style="bold green"
260
- # )
261
- # info_table.add_column("Key", style="yellow")
262
- # info_table.add_column("Value", style="cyan")
263
- # info_table.add_row("Project", project_package)
264
- # info_table.add_row("Class", spider_class.__name__)
265
- # info_table.add_row("Module", spider_class.__module__)
266
- # console.print(info_table)
267
- # console.print()
268
-
269
- # 注册 stats 记录
270
- if not no_stats:
271
- for crawler in process.crawlers:
272
- crawler.signals.connect(record_stats, signal="spider_closed")
273
-
274
- # 运行爬虫
275
- with Progress(
276
- SpinnerColumn(),
277
- TextColumn("[progress.description]{task.description}"),
278
- transient=True,
279
- ) as progress:
280
- task = progress.add_task(f"正在运行 {spider_name}...", total=None)
281
- asyncio.run(process.crawl(spider_name))
282
-
283
- if show_json:
284
- console.print_json(data={"success": True, "spider": spider_name})
285
- else:
286
- console.print(Panel(
287
- f"[bold green]爬虫 '[cyan]{spider_name}[/cyan]' 运行完成![/bold green]",
288
- title="完成",
289
- border_style="green"
290
- ))
291
- return 0
292
-
293
- except KeyboardInterrupt:
294
- msg = "爬虫被用户中断。"
295
- if show_json:
296
- console.print_json(data={"success": False, "error": msg})
297
- else:
298
- console.print(f"[bold yellow]{msg}[/bold yellow]")
299
- return 1
300
- except Exception as e:
301
- logger.exception("Exception during 'crawlo run'")
302
- msg = f"意外错误: {e}"
303
- if show_json:
304
- console.print_json(data={"success": False, "error": msg})
305
- else:
306
- console.print(f"[bold red]{msg}[/bold red]")
307
- return 1
308
-
309
-
310
- if __name__ == "__main__":
311
- """
312
- 支持直接运行:
313
- python -m crawlo.commands.run spider_name
314
- """
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ # @Time : 2025-08-31 22:36
5
+ # @Author : crawl-coder
6
+ # @Desc : 命令行入口:crawlo run <spider_name>|all,用于运行指定爬虫。
7
+ """
8
+ import os
9
+ import sys
10
+ import asyncio
11
+ import configparser
12
+ from importlib import import_module
13
+
14
+ from rich import box
15
+ from rich.console import Console
16
+ from rich.panel import Panel
17
+ from rich.progress import Progress, SpinnerColumn, TextColumn
18
+ from rich.table import Table
19
+ from rich.text import Text
20
+
21
+ from crawlo.commands.stats import record_stats
22
+ from crawlo.crawler import CrawlerProcess
23
+ from crawlo.project import get_settings, _find_project_root
24
+ # 使用自定义日志系统
25
+ from crawlo.utils.log import get_logger
26
+
27
+ # 延迟获取logger,确保在日志系统配置之后获取
28
+ _logger = None
29
+
30
+ def logger():
31
+ """延迟获取logger实例,确保在日志系统配置之后获取"""
32
+ global _logger
33
+ if _logger is None:
34
+ _logger = get_logger(__name__)
35
+ return _logger
36
+
37
+ console = Console()
38
+
39
+
40
+ def check_redis_connection(settings):
41
+ """检查Redis连接(分布式模式下)"""
42
+ try:
43
+ # 检查是否为分布式模式
44
+ run_mode = settings.get('RUN_MODE', 'standalone')
45
+ queue_type = settings.get('QUEUE_TYPE', 'memory')
46
+
47
+ if run_mode == 'distributed' or queue_type == 'redis':
48
+ import redis.asyncio as redis
49
+ redis_url = settings.get('REDIS_URL', 'redis://127.0.0.1:6379/0')
50
+ redis_host = settings.get('REDIS_HOST', '127.0.0.1')
51
+ redis_port = settings.get('REDIS_PORT', 6379)
52
+
53
+ console.print(f"检查 Redis 连接: {redis_host}:{redis_port}")
54
+
55
+ # 创建Redis连接进行测试
56
+ async def _test_redis():
57
+ try:
58
+ r = redis.from_url(redis_url, encoding="utf-8", decode_responses=True)
59
+ await r.ping()
60
+ await r.close()
61
+ return True
62
+ except Exception as e:
63
+ console.print(f"Redis 连接失败: {e}")
64
+ return False
65
+
66
+ # 运行异步测试
67
+ if not asyncio.run(_test_redis()):
68
+ raise ConnectionError(f"无法连接到 Redis 服务器 {redis_host}:{redis_port}")
69
+
70
+ console.print("Redis 连接正常")
71
+ return True
72
+ else:
73
+ # 非分布式模式,跳过Redis检查
74
+ return True
75
+ except ImportError:
76
+ console.print("Redis 客户端未安装,跳过连接检查")
77
+ return True
78
+ except Exception as e:
79
+ console.print(f"Redis 连接检查失败: {e}")
80
+ return False
81
+
82
+
83
+ def main(args):
84
+ """
85
+ 主函数:运行指定爬虫
86
+ 用法:
87
+ crawlo run <spider_name>|all [--json] [--no-stats]
88
+ """
89
+ # 添加调试信息
90
+ logger().debug("DEBUG: 进入main函数")
91
+
92
+ if len(args) < 1:
93
+ console.print("[bold red]用法:[/bold red] [blue]crawlo run[/blue] <爬虫名称>|all [bold yellow][--json] [--no-stats][/bold yellow]")
94
+ console.print("示例:")
95
+ console.print(" [blue]crawlo run baidu[/blue]")
96
+ console.print(" [blue]crawlo run all[/blue]")
97
+ console.print(" [blue]crawlo run all --json --no-stats[/blue]")
98
+ return 1
99
+
100
+ # 解析参数
101
+ spider_arg = args[0]
102
+ show_json = "--json" in args
103
+ no_stats = "--no-stats" in args
104
+
105
+ try:
106
+ # 1. 查找项目根目录
107
+ project_root = _find_project_root()
108
+ if not project_root:
109
+ msg = "[bold red]找不到 'crawlo.cfg'[/bold red]\n请在项目目录中运行此命令。"
110
+ if show_json:
111
+ console.print_json(data={"success": False, "error": "未找到项目根目录"})
112
+ return 1
113
+ else:
114
+ console.print(Panel(
115
+ Text.from_markup(msg),
116
+ title="非Crawlo项目",
117
+ border_style="red",
118
+ padding=(1, 2)
119
+ ))
120
+ return 1
121
+
122
+ project_root_str = str(project_root)
123
+ if project_root_str not in sys.path:
124
+ sys.path.insert(0, project_root_str)
125
+
126
+ # 2. 读取 crawlo.cfg 获取 settings 模块
127
+ cfg_file = os.path.join(project_root, "crawlo.cfg")
128
+ if not os.path.exists(cfg_file):
129
+ msg = f"在 {project_root} 中未找到 crawlo.cfg"
130
+ if show_json:
131
+ console.print_json(data={"success": False, "error": msg})
132
+ return 1
133
+ else:
134
+ console.print(Panel(msg, title="缺少配置文件", border_style="red"))
135
+ return 1
136
+
137
+ config = configparser.ConfigParser()
138
+ config.read(cfg_file, encoding="utf-8")
139
+
140
+ if not config.has_section("settings") or not config.has_option("settings", "default"):
141
+ msg = "crawlo.cfg 中缺少 [settings] 部分或 'default' 选项"
142
+ if show_json:
143
+ console.print_json(data={"success": False, "error": msg})
144
+ return 1
145
+ else:
146
+ console.print(Panel(msg, title="无效配置", border_style="red"))
147
+ return 1
148
+
149
+ settings_module = config.get("settings", "default")
150
+ project_package = settings_module.split(".")[0]
151
+
152
+ # 3. 确保项目包可导入
153
+ try:
154
+ import_module(project_package)
155
+ except ImportError as e:
156
+ msg = f"导入项目包 '{project_package}' 失败: {e}"
157
+ if show_json:
158
+ console.print_json(data={"success": False, "error": msg})
159
+ return 1
160
+ else:
161
+ console.print(Panel(msg, title="导入错误", border_style="red"))
162
+ return 1
163
+
164
+ # 4. 加载 settings 和爬虫模块
165
+ settings = get_settings()
166
+
167
+ # 检查Redis连接(如果是分布式模式)
168
+ if not check_redis_connection(settings):
169
+ if show_json:
170
+ console.print_json(data={"success": False, "error": "Redis连接检查失败"})
171
+ return 1
172
+ else:
173
+ return 1
174
+
175
+ spider_modules = [f"{project_package}.spiders"]
176
+ process = CrawlerProcess(settings=settings, spider_modules=spider_modules)
177
+
178
+ # === 情况1:运行所有爬虫 ===
179
+ if spider_arg.lower() == "all":
180
+ spider_names = process.get_spider_names()
181
+ if not spider_names:
182
+ msg = "未找到爬虫。"
183
+ if show_json:
184
+ console.print_json(data={"success": False, "error": msg})
185
+ return 1
186
+ else:
187
+ console.print(Panel(
188
+ Text.from_markup(
189
+ "[bold red]未找到爬虫。[/bold red]\n\n"
190
+ "[bold]确保:[/bold]\n"
191
+ " • 爬虫定义于 '[cyan]spiders/[/cyan]' 目录\n"
192
+ " • 具有 [green]`name`[/green] 属性\n"
193
+ " • 模块已导入 (例如通过 [cyan]__init__.py[/cyan])"
194
+ ),
195
+ title="未找到爬虫",
196
+ border_style="red",
197
+ padding=(1, 2)
198
+ ))
199
+ return 1
200
+
201
+ # 显示即将运行的爬虫列表
202
+ # 根据用户要求,不再显示详细的爬虫列表信息
203
+
204
+ # 注册 stats 记录(除非 --no-stats)
205
+ if not no_stats:
206
+ for crawler in process.crawlers:
207
+ crawler.signals.connect(record_stats, signal="spider_closed")
208
+
209
+ # 并行运行所有爬虫
210
+ with Progress(
211
+ SpinnerColumn(),
212
+ TextColumn("[progress.description]{task.description}"),
213
+ transient=True,
214
+ ) as progress:
215
+ task = progress.add_task("正在运行所有爬虫...", total=None)
216
+ asyncio.run(process.crawl(spider_names))
217
+
218
+ if show_json:
219
+ console.print_json(data={"success": True, "spiders": spider_names})
220
+ else:
221
+ console.print(Panel(
222
+ "[bold green]所有爬虫运行完成![/bold green]",
223
+ title="全部完成",
224
+ border_style="green"
225
+ ))
226
+ return 0
227
+
228
+ # === 情况2:运行单个爬虫 ===
229
+ spider_name = spider_arg
230
+ if not process.is_spider_registered(spider_name):
231
+ available = process.get_spider_names()
232
+ msg = f"爬虫 '[cyan]{spider_name}[/cyan]' 未找到。"
233
+ if show_json:
234
+ console.print_json(data={
235
+ "success": False,
236
+ "error": msg,
237
+ "available": available
238
+ })
239
+ return 1
240
+ else:
241
+ panel_content = Text.from_markup(msg + "\n")
242
+ if available:
243
+ panel_content.append("\n可用爬虫:\n")
244
+ for name in sorted(available):
245
+ cls = process.get_spider_class(name)
246
+ panel_content.append(f" • [cyan]{name}[/cyan] ([green]{cls.__name__}[/green])\n")
247
+ else:
248
+ panel_content.append("\n未找到爬虫。请检查爬虫模块。")
249
+
250
+ console.print(Panel(
251
+ panel_content,
252
+ title="爬虫未找到",
253
+ border_style="red",
254
+ padding=(1, 2)
255
+ ))
256
+ return 1
257
+
258
+ spider_class = process.get_spider_class(spider_name)
259
+
260
+ # 显示启动信息
261
+ # 根据用户要求,不再显示项目启动信息
262
+ # if not show_json:
263
+ # info_table = Table(
264
+ # title=f"启动爬虫: [bold cyan]{spider_name}[/bold cyan]",
265
+ # box=box.SIMPLE,
266
+ # show_header=False,
267
+ # title_style="bold green"
268
+ # )
269
+ # info_table.add_column("Key", style="yellow")
270
+ # info_table.add_column("Value", style="cyan")
271
+ # info_table.add_row("Project", project_package)
272
+ # info_table.add_row("Class", spider_class.__name__)
273
+ # info_table.add_row("Module", spider_class.__module__)
274
+ # console.print(info_table)
275
+ # console.print()
276
+
277
+ # 注册 stats 记录
278
+ if not no_stats:
279
+ for crawler in process.crawlers:
280
+ crawler.signals.connect(record_stats, signal="spider_closed")
281
+
282
+ # 运行爬虫
283
+ with Progress(
284
+ SpinnerColumn(),
285
+ TextColumn("[progress.description]{task.description}"),
286
+ transient=True,
287
+ ) as progress:
288
+ task = progress.add_task(f"正在运行 {spider_name}...", total=None)
289
+ asyncio.run(process.crawl(spider_name))
290
+
291
+ if show_json:
292
+ console.print_json(data={"success": True, "spider": spider_name})
293
+ else:
294
+ console.print(Panel(
295
+ f"[bold green]爬虫 '[cyan]{spider_name}[/cyan]' 运行完成![/bold green]",
296
+ title="完成",
297
+ border_style="green"
298
+ ))
299
+ return 0
300
+
301
+ except KeyboardInterrupt:
302
+ msg = "爬虫被用户中断。"
303
+ if show_json:
304
+ console.print_json(data={"success": False, "error": msg})
305
+ else:
306
+ console.print(f"[bold yellow]{msg}[/bold yellow]")
307
+ return 1
308
+ except Exception as e:
309
+ logger().exception("Exception during 'crawlo run'")
310
+ msg = f"意外错误: {e}"
311
+ if show_json:
312
+ console.print_json(data={"success": False, "error": msg})
313
+ else:
314
+ console.print(f"[bold red]{msg}[/bold red]")
315
+ return 1
316
+
317
+
318
+ if __name__ == "__main__":
319
+ """
320
+ 支持直接运行:
321
+ python -m crawlo.commands.run spider_name
322
+ """
315
323
  sys.exit(main(sys.argv[1:]))