crawlo 1.2.8__py3-none-any.whl → 1.3.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 (221) hide show
  1. crawlo/__init__.py +63 -61
  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 +314 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +186 -186
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -251
  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 -251
  19. crawlo/crawler.py +1097 -1099
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -107
  22. crawlo/downloader/__init__.py +273 -266
  23. crawlo/downloader/aiohttp_downloader.py +226 -228
  24. crawlo/downloader/cffi_downloader.py +245 -256
  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 +45 -43
  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 +136 -136
  50. crawlo/middleware/offsite.py +114 -114
  51. crawlo/middleware/proxy.py +386 -368
  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 -0
  57. crawlo/mode_manager.py +212 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +379 -338
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +157 -157
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +223 -223
  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 +317 -317
  70. crawlo/pipelines/pipeline_manager.py +74 -62
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +284 -315
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +379 -378
  75. crawlo/queue/redis_priority_queue.py +306 -306
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +216 -220
  78. crawlo/settings/setting_manager.py +175 -122
  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 +261 -288
  89. crawlo/templates/project/settings_distributed.py.tmpl +174 -157
  90. crawlo/templates/project/settings_gentle.py.tmpl +95 -100
  91. crawlo/templates/project/settings_high_performance.py.tmpl +125 -134
  92. crawlo/templates/project/settings_minimal.py.tmpl +30 -0
  93. crawlo/templates/project/settings_simple.py.tmpl +96 -98
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +47 -47
  96. crawlo/templates/spider/spider.py.tmpl +143 -143
  97. crawlo/tools/__init__.py +200 -182
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/{cleaners → tools}/data_formatter.py +225 -225
  101. crawlo/tools/data_validator.py +180 -180
  102. crawlo/tools/date_tools.py +290 -36
  103. crawlo/tools/distributed_coordinator.py +388 -387
  104. crawlo/{cleaners → tools}/encoding_converter.py +127 -126
  105. crawlo/tools/request_tools.py +83 -0
  106. crawlo/tools/retry_mechanism.py +224 -221
  107. crawlo/tools/scenario_adapter.py +262 -262
  108. crawlo/{cleaners → tools}/text_cleaner.py +232 -232
  109. crawlo/utils/__init__.py +35 -35
  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 +146 -128
  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.2.8.dist-info → crawlo-1.3.0.dist-info}/METADATA +1011 -764
  131. crawlo-1.3.0.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 -237
  137. tests/cleaners_example.py +160 -160
  138. tests/config_validation_demo.py +143 -103
  139. tests/controlled_spider_example.py +205 -205
  140. tests/date_tools_example.py +180 -180
  141. tests/debug_pipelines.py +67 -0
  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 +151 -0
  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 +153 -0
  156. tests/test_config_validator.py +182 -193
  157. tests/test_crawlo_proxy_integration.py +109 -173
  158. tests/test_date_tools.py +123 -123
  159. tests/test_default_header_middleware.py +158 -158
  160. tests/test_distributed.py +65 -0
  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 -357
  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 +185 -0
  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 +73 -0
  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 +112 -0
  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 -153
  213. tests/test_user_agents.py +97 -0
  214. tests/tools_example.py +260 -257
  215. tests/verify_distributed.py +117 -0
  216. crawlo/cleaners/__init__.py +0 -61
  217. crawlo/utils/date_tools.py +0 -290
  218. crawlo-1.2.8.dist-info/RECORD +0 -209
  219. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/WHEEL +0 -0
  220. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/entry_points.txt +0 -0
  221. {crawlo-1.2.8.dist-info → crawlo-1.3.0.dist-info}/top_level.txt +0 -0
crawlo/commands/run.py CHANGED
@@ -1,324 +1,315 @@
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 sys
9
- import asyncio
10
- import configparser
11
- import os
12
- from pathlib import Path
13
- from importlib import import_module
14
-
15
- from rich.console import Console
16
- from rich.panel import Panel
17
- from rich.table import Table
18
- from rich.text import Text
19
- from rich import box
20
- from rich.progress import Progress, SpinnerColumn, TextColumn
21
-
22
- from crawlo.crawler import CrawlerProcess
23
- from crawlo.utils.log import get_logger
24
- from crawlo.project import get_settings, _find_project_root
25
- from crawlo.commands.stats import record_stats
26
-
27
- logger = get_logger(__name__)
28
- console = Console()
29
-
30
-
31
- def check_redis_connection(settings):
32
- """检查Redis连接(分布式模式下)"""
33
- try:
34
- # 检查是否为分布式模式
35
- run_mode = settings.get('RUN_MODE', 'standalone')
36
- queue_type = settings.get('QUEUE_TYPE', 'memory')
37
-
38
- if run_mode == 'distributed' or queue_type == 'redis':
39
- import redis.asyncio as redis
40
- redis_url = settings.get('REDIS_URL', 'redis://127.0.0.1:6379/0')
41
- redis_host = settings.get('REDIS_HOST', '127.0.0.1')
42
- redis_port = settings.get('REDIS_PORT', 6379)
43
-
44
- console.print(f"🔍 检查 Redis 连接: {redis_host}:{redis_port}")
45
-
46
- # 创建Redis连接进行测试
47
- async def _test_redis():
48
- try:
49
- r = redis.from_url(redis_url, encoding="utf-8", decode_responses=True)
50
- await r.ping()
51
- await r.close()
52
- return True
53
- except Exception as e:
54
- console.print(f"❌ Redis 连接失败: {e}")
55
- return False
56
-
57
- # 运行异步测试
58
- if not asyncio.run(_test_redis()):
59
- raise ConnectionError(f"无法连接到 Redis 服务器 {redis_host}:{redis_port}")
60
-
61
- console.print("✅ Redis 连接正常")
62
- return True
63
- else:
64
- # 非分布式模式,跳过Redis检查
65
- return True
66
- except ImportError:
67
- console.print("⚠️ Redis 客户端未安装,跳过连接检查")
68
- return True
69
- except Exception as e:
70
- console.print(f"❌ Redis 连接检查失败: {e}")
71
- return False
72
-
73
-
74
- def main(args):
75
- """
76
- 主函数:运行指定爬虫
77
- 用法:
78
- crawlo run <spider_name>|all [--json] [--no-stats]
79
- """
80
- if len(args) < 1:
81
- console.print("[bold red]❌ 用法:[/bold red] [blue]crawlo run[/blue] <爬虫名称>|all [bold yellow][--json] [--no-stats][/bold yellow]")
82
- console.print("💡 示例:")
83
- console.print(" [blue]crawlo run baidu[/blue]")
84
- console.print(" [blue]crawlo run all[/blue]")
85
- console.print(" [blue]crawlo run all --json --no-stats[/blue]")
86
- return 1
87
-
88
- # 解析参数
89
- spider_arg = args[0]
90
- show_json = "--json" in args
91
- no_stats = "--no-stats" in args
92
-
93
- try:
94
- # 1. 查找项目根目录
95
- project_root = _find_project_root()
96
- if not project_root:
97
- msg = ":cross_mark: [bold red]找不到 'crawlo.cfg'[/bold red]\n💡 请在项目目录中运行此命令。"
98
- if show_json:
99
- console.print_json(data={"success": False, "error": "未找到项目根目录"})
100
- return 1
101
- else:
102
- console.print(Panel(
103
- Text.from_markup(msg),
104
- title="❌ 非Crawlo项目",
105
- border_style="red",
106
- padding=(1, 2)
107
- ))
108
- return 1
109
-
110
- project_root_str = str(project_root)
111
- if project_root_str not in sys.path:
112
- sys.path.insert(0, project_root_str)
113
-
114
- # 2. 读取 crawlo.cfg 获取 settings 模块
115
- cfg_file = os.path.join(project_root, "crawlo.cfg")
116
- if not os.path.exists(cfg_file):
117
- msg = f"在 {project_root} 中未找到 crawlo.cfg"
118
- if show_json:
119
- console.print_json(data={"success": False, "error": msg})
120
- return 1
121
- else:
122
- console.print(Panel(msg, title="❌ 缺少配置文件", border_style="red"))
123
- return 1
124
-
125
- config = configparser.ConfigParser()
126
- config.read(cfg_file, encoding="utf-8")
127
-
128
- if not config.has_section("settings") or not config.has_option("settings", "default"):
129
- msg = "crawlo.cfg 中缺少 [settings] 部分或 'default' 选项"
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
- settings_module = config.get("settings", "default")
138
- project_package = settings_module.split(".")[0]
139
-
140
- # 3. 确保项目包可导入
141
- try:
142
- import_module(project_package)
143
- except ImportError as e:
144
- msg = f"导入项目包 '{project_package}' 失败: {e}"
145
- if show_json:
146
- console.print_json(data={"success": False, "error": msg})
147
- return 1
148
- else:
149
- console.print(Panel(msg, title="❌ 导入错误", border_style="red"))
150
- return 1
151
-
152
- # 4. 加载 settings 和爬虫模块
153
- settings = get_settings()
154
-
155
- # 检查Redis连接(如果是分布式模式)
156
- if not check_redis_connection(settings):
157
- if show_json:
158
- console.print_json(data={"success": False, "error": "Redis连接检查失败"})
159
- return 1
160
- else:
161
- return 1
162
-
163
- spider_modules = [f"{project_package}.spiders"]
164
- process = CrawlerProcess(settings=settings, spider_modules=spider_modules)
165
-
166
- # === 情况1:运行所有爬虫 ===
167
- if spider_arg.lower() == "all":
168
- spider_names = process.get_spider_names()
169
- if not spider_names:
170
- msg = "未找到爬虫。"
171
- if show_json:
172
- console.print_json(data={"success": False, "error": msg})
173
- return 1
174
- else:
175
- console.print(Panel(
176
- Text.from_markup(
177
- ":cross_mark: [bold red]未找到爬虫。[/bold red]\n\n"
178
- "[bold]💡 确保:[/bold]\n"
179
- " • 爬虫定义于 '[cyan]spiders/[/cyan]' 目录\n"
180
- " • 具有 [green]`name`[/green] 属性\n"
181
- " 模块已导入 (例如通过 [cyan]__init__.py[/cyan])"
182
- ),
183
- title=" 未找到爬虫",
184
- border_style="red",
185
- padding=(1, 2)
186
- ))
187
- return 1
188
-
189
- # 显示即将运行的爬虫列表
190
- table = Table(
191
- title=f"🚀 启动全部 {len(spider_names)} 个爬虫",
192
- box=box.ROUNDED,
193
- show_header=True,
194
- header_style="bold magenta"
195
- )
196
- table.add_column("名称", style="cyan")
197
- table.add_column("类名", style="green")
198
-
199
- for name in sorted(spider_names):
200
- cls = process.get_spider_class(name)
201
- table.add_row(name, cls.__name__)
202
-
203
- console.print(table)
204
- console.print()
205
-
206
- # 注册 stats 记录(除非 --no-stats)
207
- if not no_stats:
208
- for crawler in process.crawlers:
209
- crawler.signals.connect(record_stats, signal="spider_closed")
210
-
211
- # 并行运行所有爬虫
212
- with Progress(
213
- SpinnerColumn(),
214
- TextColumn("[progress.description]{task.description}"),
215
- transient=True,
216
- ) as progress:
217
- task = progress.add_task("正在运行所有爬虫...", total=None)
218
- asyncio.run(process.crawl(spider_names))
219
-
220
- if show_json:
221
- console.print_json(data={"success": True, "spiders": spider_names})
222
- else:
223
- console.print(Panel(
224
- ":tada: [bold green]所有爬虫运行完成![/bold green]",
225
- title="✅ 全部完成",
226
- border_style="green"
227
- ))
228
- return 0
229
-
230
- # === 情况2:运行单个爬虫 ===
231
- spider_name = spider_arg
232
- if not process.is_spider_registered(spider_name):
233
- available = process.get_spider_names()
234
- msg = f"爬虫 '[cyan]{spider_name}[/cyan]' 未找到。"
235
- if show_json:
236
- console.print_json(data={
237
- "success": False,
238
- "error": msg,
239
- "available": available
240
- })
241
- return 1
242
- else:
243
- panel_content = Text.from_markup(msg + "\n")
244
- if available:
245
- panel_content.append("\n💡 可用爬虫:\n")
246
- for name in sorted(available):
247
- cls = process.get_spider_class(name)
248
- panel_content.append(f" • [cyan]{name}[/cyan] ([green]{cls.__name__}[/green])\n")
249
- else:
250
- panel_content.append("\n💡 未找到爬虫。请检查爬虫模块。")
251
-
252
- console.print(Panel(
253
- panel_content,
254
- title="❌ 爬虫未找到",
255
- border_style="red",
256
- padding=(1, 2)
257
- ))
258
- return 1
259
-
260
- spider_class = process.get_spider_class(spider_name)
261
-
262
- # 显示启动信息
263
- if not show_json:
264
- info_table = Table(
265
- title=f"🚀 启动爬虫: [bold cyan]{spider_name}[/bold cyan]",
266
- box=box.SIMPLE,
267
- show_header=False,
268
- title_style="bold green"
269
- )
270
- info_table.add_column("Key", style="yellow")
271
- info_table.add_column("Value", style="cyan")
272
- info_table.add_row("Project", project_package)
273
- info_table.add_row("Class", spider_class.__name__)
274
- info_table.add_row("Module", spider_class.__module__)
275
- console.print(info_table)
276
- console.print()
277
-
278
- # 注册 stats 记录
279
- if not no_stats:
280
- for crawler in process.crawlers:
281
- crawler.signals.connect(record_stats, signal="spider_closed")
282
-
283
- # 运行爬虫
284
- with Progress(
285
- SpinnerColumn(),
286
- TextColumn("[progress.description]{task.description}"),
287
- transient=True,
288
- ) as progress:
289
- task = progress.add_task(f"正在运行 {spider_name}...", total=None)
290
- asyncio.run(process.crawl(spider_name))
291
-
292
- if show_json:
293
- console.print_json(data={"success": True, "spider": spider_name})
294
- else:
295
- console.print(Panel(
296
- f":tada: [bold green]爬虫 '[cyan]{spider_name}[/cyan]' 运行完成![/bold green]",
297
- title="✅ 完成",
298
- border_style="green"
299
- ))
300
- return 0
301
-
302
- except KeyboardInterrupt:
303
- msg = "⚠️ 爬虫被用户中断。"
304
- if show_json:
305
- console.print_json(data={"success": False, "error": msg})
306
- else:
307
- console.print(f"[bold yellow]{msg}[/bold yellow]")
308
- return 1
309
- except Exception as e:
310
- logger.exception("Exception during 'crawlo run'")
311
- msg = f"意外错误: {e}"
312
- if show_json:
313
- console.print_json(data={"success": False, "error": msg})
314
- else:
315
- console.print(f"[bold red]❌ {msg}[/bold red]")
316
- return 1
317
-
318
-
319
- if __name__ == "__main__":
320
- """
321
- 支持直接运行:
322
- python -m crawlo.commands.run spider_name
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
+ """
324
315
  sys.exit(main(sys.argv[1:]))