crawlo 1.3.5__py3-none-any.whl → 1.3.6__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 (289) hide show
  1. crawlo/__init__.py +87 -87
  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 -341
  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 +45 -45
  16. crawlo/core/engine.py +439 -439
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +257 -257
  19. crawlo/crawler.py +638 -638
  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 -228
  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 -61
  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 +27 -27
  40. crawlo/factories/base.py +68 -68
  41. crawlo/factories/crawler.py +103 -103
  42. crawlo/factories/registry.py +84 -84
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +257 -257
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/framework.py +292 -291
  47. crawlo/initialization/__init__.py +39 -39
  48. crawlo/initialization/built_in.py +425 -425
  49. crawlo/initialization/context.py +141 -141
  50. crawlo/initialization/core.py +193 -193
  51. crawlo/initialization/phases.py +148 -148
  52. crawlo/initialization/registry.py +145 -145
  53. crawlo/items/__init__.py +23 -23
  54. crawlo/items/base.py +23 -23
  55. crawlo/items/fields.py +52 -52
  56. crawlo/items/items.py +104 -104
  57. crawlo/logging/__init__.py +37 -37
  58. crawlo/logging/config.py +96 -96
  59. crawlo/logging/factory.py +128 -128
  60. crawlo/logging/manager.py +111 -111
  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 -212
  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 +325 -325
  85. crawlo/pipelines/pipeline_manager.py +76 -76
  86. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  87. crawlo/project.py +327 -327
  88. crawlo/queue/pqueue.py +42 -42
  89. crawlo/queue/queue_manager.py +503 -503
  90. crawlo/queue/redis_priority_queue.py +326 -326
  91. crawlo/settings/__init__.py +7 -7
  92. crawlo/settings/default_settings.py +321 -321
  93. crawlo/settings/setting_manager.py +214 -214
  94. crawlo/spider/__init__.py +657 -657
  95. crawlo/stats_collector.py +73 -73
  96. crawlo/subscriber.py +129 -129
  97. crawlo/task_manager.py +138 -138
  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 +167 -167
  104. crawlo/templates/project/settings_distributed.py.tmpl +166 -166
  105. crawlo/templates/project/settings_gentle.py.tmpl +166 -166
  106. crawlo/templates/project/settings_high_performance.py.tmpl +167 -167
  107. crawlo/templates/project/settings_minimal.py.tmpl +65 -65
  108. crawlo/templates/project/settings_simple.py.tmpl +164 -164
  109. crawlo/templates/project/spiders/__init__.py.tmpl +9 -9
  110. crawlo/templates/run.py.tmpl +34 -34
  111. crawlo/templates/spider/spider.py.tmpl +143 -143
  112. crawlo/templates/spiders_init.py.tmpl +9 -9
  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 +364 -364
  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 +25 -25
  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 -165
  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 +79 -79
  138. crawlo/utils/performance_monitor.py +285 -285
  139. crawlo/utils/queue_helper.py +175 -175
  140. crawlo/utils/redis_connection_pool.py +388 -388
  141. crawlo/utils/redis_key_validator.py +198 -198
  142. crawlo/utils/request.py +267 -267
  143. crawlo/utils/request_serializer.py +225 -225
  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.5.dist-info → crawlo-1.3.6.dist-info}/METADATA +1126 -1126
  149. crawlo-1.3.6.dist-info/RECORD +290 -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 +106 -106
  154. tests/baidu_performance_test.py +108 -108
  155. tests/baidu_test.py +59 -59
  156. tests/cleaners_example.py +160 -160
  157. tests/comprehensive_framework_test.py +212 -212
  158. tests/comprehensive_test.py +81 -81
  159. tests/comprehensive_testing_summary.md +186 -186
  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 +69 -69
  164. tests/debug_framework_logger.py +84 -84
  165. tests/debug_log_config.py +126 -126
  166. tests/debug_log_levels.py +63 -63
  167. tests/debug_pipelines.py +66 -66
  168. tests/detailed_log_test.py +233 -233
  169. tests/distributed_test.py +66 -66
  170. tests/distributed_test_debug.py +76 -76
  171. tests/dynamic_loading_example.py +523 -523
  172. tests/dynamic_loading_test.py +104 -104
  173. tests/env_config_example.py +133 -133
  174. tests/error_handling_example.py +171 -171
  175. tests/final_comprehensive_test.py +151 -151
  176. tests/final_log_test.py +260 -260
  177. tests/final_validation_test.py +182 -182
  178. tests/fix_log_test.py +142 -142
  179. tests/framework_performance_test.py +202 -202
  180. tests/log_buffering_test.py +111 -111
  181. tests/log_generation_timing_test.py +153 -153
  182. tests/optimized_performance_test.py +211 -211
  183. tests/performance_comparison.py +245 -245
  184. tests/queue_blocking_test.py +113 -113
  185. tests/queue_test.py +89 -89
  186. tests/redis_key_validation_demo.py +130 -130
  187. tests/request_params_example.py +150 -150
  188. tests/response_improvements_example.py +144 -144
  189. tests/scrapy_comparison/ofweek_scrapy.py +138 -138
  190. tests/scrapy_comparison/scrapy_test.py +133 -133
  191. tests/simple_command_test.py +119 -119
  192. tests/simple_crawlo_test.py +127 -127
  193. tests/simple_log_test.py +57 -57
  194. tests/simple_log_test2.py +137 -137
  195. tests/simple_optimization_test.py +128 -128
  196. tests/simple_queue_type_test.py +42 -0
  197. tests/simple_spider_test.py +49 -49
  198. tests/simple_test.py +47 -47
  199. tests/spider_log_timing_test.py +177 -177
  200. tests/test_advanced_tools.py +148 -148
  201. tests/test_all_commands.py +230 -230
  202. tests/test_all_redis_key_configs.py +145 -145
  203. tests/test_authenticated_proxy.py +141 -141
  204. tests/test_batch_processor.py +178 -178
  205. tests/test_cleaners.py +54 -54
  206. tests/test_component_factory.py +174 -174
  207. tests/test_comprehensive.py +146 -146
  208. tests/test_config_consistency.py +80 -80
  209. tests/test_config_merge.py +152 -152
  210. tests/test_config_validator.py +182 -182
  211. tests/test_controlled_spider_mixin.py +79 -79
  212. tests/test_crawlo_proxy_integration.py +108 -108
  213. tests/test_date_tools.py +123 -123
  214. tests/test_default_header_middleware.py +158 -158
  215. tests/test_distributed.py +65 -65
  216. tests/test_double_crawlo_fix.py +207 -207
  217. tests/test_double_crawlo_fix_simple.py +124 -124
  218. tests/test_download_delay_middleware.py +221 -221
  219. tests/test_downloader_proxy_compatibility.py +268 -268
  220. tests/test_dynamic_downloaders_proxy.py +124 -124
  221. tests/test_dynamic_proxy.py +92 -92
  222. tests/test_dynamic_proxy_config.py +146 -146
  223. tests/test_dynamic_proxy_real.py +109 -109
  224. tests/test_edge_cases.py +303 -303
  225. tests/test_enhanced_error_handler.py +270 -270
  226. tests/test_enhanced_error_handler_comprehensive.py +245 -245
  227. tests/test_env_config.py +121 -121
  228. tests/test_error_handler_compatibility.py +112 -112
  229. tests/test_factories.py +252 -252
  230. tests/test_final_validation.py +153 -153
  231. tests/test_framework_env_usage.py +103 -103
  232. tests/test_framework_logger.py +66 -66
  233. tests/test_framework_startup.py +64 -64
  234. tests/test_get_component_logger.py +83 -83
  235. tests/test_integration.py +169 -169
  236. tests/test_item_dedup_redis_key.py +122 -122
  237. tests/test_large_scale_config.py +112 -112
  238. tests/test_large_scale_helper.py +235 -235
  239. tests/test_logging_system.py +282 -282
  240. tests/test_mode_change.py +72 -72
  241. tests/test_mode_consistency.py +51 -51
  242. tests/test_offsite_middleware.py +221 -221
  243. tests/test_parsel.py +29 -29
  244. tests/test_performance.py +327 -327
  245. tests/test_performance_monitor.py +115 -115
  246. tests/test_proxy_api.py +264 -264
  247. tests/test_proxy_health_check.py +32 -32
  248. tests/test_proxy_middleware.py +121 -121
  249. tests/test_proxy_middleware_enhanced.py +216 -216
  250. tests/test_proxy_middleware_integration.py +136 -136
  251. tests/test_proxy_middleware_refactored.py +184 -184
  252. tests/test_proxy_providers.py +56 -56
  253. tests/test_proxy_stats.py +19 -19
  254. tests/test_proxy_strategies.py +59 -59
  255. tests/test_queue_empty_check.py +41 -41
  256. tests/test_queue_manager_double_crawlo.py +173 -173
  257. tests/test_queue_manager_redis_key.py +176 -176
  258. tests/test_queue_type.py +107 -0
  259. tests/test_random_user_agent.py +72 -72
  260. tests/test_real_scenario_proxy.py +195 -195
  261. tests/test_redis_config.py +28 -28
  262. tests/test_redis_connection_pool.py +294 -294
  263. tests/test_redis_key_naming.py +181 -181
  264. tests/test_redis_key_validator.py +123 -123
  265. tests/test_redis_queue.py +224 -224
  266. tests/test_request_ignore_middleware.py +182 -182
  267. tests/test_request_params.py +111 -111
  268. tests/test_request_serialization.py +70 -70
  269. tests/test_response_code_middleware.py +349 -349
  270. tests/test_response_filter_middleware.py +427 -427
  271. tests/test_response_improvements.py +152 -152
  272. tests/test_retry_middleware.py +241 -241
  273. tests/test_scheduler.py +252 -252
  274. tests/test_scheduler_config_update.py +133 -133
  275. tests/test_simple_response.py +61 -61
  276. tests/test_telecom_spider_redis_key.py +205 -205
  277. tests/test_template_content.py +87 -87
  278. tests/test_template_redis_key.py +134 -134
  279. tests/test_tools.py +159 -159
  280. tests/test_user_agents.py +96 -96
  281. tests/tools_example.py +260 -260
  282. tests/untested_features_report.md +138 -138
  283. tests/verify_debug.py +51 -51
  284. tests/verify_distributed.py +117 -117
  285. tests/verify_log_fix.py +111 -111
  286. crawlo-1.3.5.dist-info/RECORD +0 -288
  287. {crawlo-1.3.5.dist-info → crawlo-1.3.6.dist-info}/WHEEL +0 -0
  288. {crawlo-1.3.5.dist-info → crawlo-1.3.6.dist-info}/entry_points.txt +0 -0
  289. {crawlo-1.3.5.dist-info → crawlo-1.3.6.dist-info}/top_level.txt +0 -0
crawlo/commands/run.py CHANGED
@@ -1,341 +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.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:]))
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:]))