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