crawlo 1.2.0__py3-none-any.whl → 1.2.1__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 (220) hide show
  1. crawlo/__init__.py +61 -61
  2. crawlo/__version__.py +1 -1
  3. crawlo/cleaners/__init__.py +60 -60
  4. crawlo/cleaners/data_formatter.py +225 -225
  5. crawlo/cleaners/encoding_converter.py +125 -125
  6. crawlo/cleaners/text_cleaner.py +232 -232
  7. crawlo/cli.py +65 -65
  8. crawlo/commands/__init__.py +14 -14
  9. crawlo/commands/check.py +594 -594
  10. crawlo/commands/genspider.py +151 -151
  11. crawlo/commands/help.py +142 -132
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +292 -292
  14. crawlo/commands/startproject.py +418 -418
  15. crawlo/commands/stats.py +188 -188
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +252 -252
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +354 -354
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +143 -143
  23. crawlo/crawler.py +1027 -1027
  24. crawlo/downloader/__init__.py +266 -266
  25. crawlo/downloader/aiohttp_downloader.py +220 -220
  26. crawlo/downloader/cffi_downloader.py +256 -256
  27. crawlo/downloader/httpx_downloader.py +259 -259
  28. crawlo/downloader/hybrid_downloader.py +213 -213
  29. crawlo/downloader/playwright_downloader.py +402 -402
  30. crawlo/downloader/selenium_downloader.py +472 -472
  31. crawlo/event.py +11 -11
  32. crawlo/exceptions.py +81 -81
  33. crawlo/extension/__init__.py +37 -37
  34. crawlo/extension/health_check.py +141 -141
  35. crawlo/extension/log_interval.py +57 -57
  36. crawlo/extension/log_stats.py +81 -81
  37. crawlo/extension/logging_extension.py +43 -43
  38. crawlo/extension/memory_monitor.py +104 -104
  39. crawlo/extension/performance_profiler.py +133 -133
  40. crawlo/extension/request_recorder.py +107 -107
  41. crawlo/filters/__init__.py +154 -154
  42. crawlo/filters/aioredis_filter.py +280 -280
  43. crawlo/filters/memory_filter.py +269 -269
  44. crawlo/items/__init__.py +23 -23
  45. crawlo/items/base.py +21 -21
  46. crawlo/items/fields.py +53 -53
  47. crawlo/items/items.py +104 -104
  48. crawlo/middleware/__init__.py +21 -21
  49. crawlo/middleware/default_header.py +132 -32
  50. crawlo/middleware/download_delay.py +105 -28
  51. crawlo/middleware/middleware_manager.py +135 -135
  52. crawlo/middleware/offsite.py +116 -0
  53. crawlo/middleware/proxy.py +366 -272
  54. crawlo/middleware/request_ignore.py +88 -30
  55. crawlo/middleware/response_code.py +164 -18
  56. crawlo/middleware/response_filter.py +138 -26
  57. crawlo/middleware/retry.py +124 -124
  58. crawlo/mode_manager.py +211 -211
  59. crawlo/network/__init__.py +21 -21
  60. crawlo/network/request.py +338 -338
  61. crawlo/network/response.py +359 -359
  62. crawlo/pipelines/__init__.py +21 -21
  63. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  64. crawlo/pipelines/console_pipeline.py +39 -39
  65. crawlo/pipelines/csv_pipeline.py +316 -316
  66. crawlo/pipelines/database_dedup_pipeline.py +224 -224
  67. crawlo/pipelines/json_pipeline.py +218 -218
  68. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  69. crawlo/pipelines/mongo_pipeline.py +131 -131
  70. crawlo/pipelines/mysql_pipeline.py +316 -316
  71. crawlo/pipelines/pipeline_manager.py +61 -61
  72. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  73. crawlo/project.py +187 -187
  74. crawlo/queue/pqueue.py +37 -37
  75. crawlo/queue/queue_manager.py +337 -337
  76. crawlo/queue/redis_priority_queue.py +298 -298
  77. crawlo/settings/__init__.py +7 -7
  78. crawlo/settings/default_settings.py +226 -219
  79. crawlo/settings/setting_manager.py +122 -122
  80. crawlo/spider/__init__.py +639 -639
  81. crawlo/stats_collector.py +59 -59
  82. crawlo/subscriber.py +130 -130
  83. crawlo/task_manager.py +30 -30
  84. crawlo/templates/crawlo.cfg.tmpl +10 -10
  85. crawlo/templates/project/__init__.py.tmpl +3 -3
  86. crawlo/templates/project/items.py.tmpl +17 -17
  87. crawlo/templates/project/middlewares.py.tmpl +118 -109
  88. crawlo/templates/project/pipelines.py.tmpl +96 -96
  89. crawlo/templates/project/run.py.tmpl +45 -45
  90. crawlo/templates/project/settings.py.tmpl +327 -326
  91. crawlo/templates/project/settings_distributed.py.tmpl +119 -119
  92. crawlo/templates/project/settings_gentle.py.tmpl +94 -94
  93. crawlo/templates/project/settings_high_performance.py.tmpl +151 -151
  94. crawlo/templates/project/settings_simple.py.tmpl +68 -68
  95. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  96. crawlo/templates/spider/spider.py.tmpl +143 -141
  97. crawlo/tools/__init__.py +182 -182
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/tools/data_validator.py +180 -180
  101. crawlo/tools/date_tools.py +35 -35
  102. crawlo/tools/distributed_coordinator.py +386 -386
  103. crawlo/tools/retry_mechanism.py +220 -220
  104. crawlo/tools/scenario_adapter.py +262 -262
  105. crawlo/utils/__init__.py +35 -35
  106. crawlo/utils/batch_processor.py +260 -260
  107. crawlo/utils/controlled_spider_mixin.py +439 -439
  108. crawlo/utils/date_tools.py +290 -290
  109. crawlo/utils/db_helper.py +343 -343
  110. crawlo/utils/enhanced_error_handler.py +359 -359
  111. crawlo/utils/env_config.py +105 -105
  112. crawlo/utils/error_handler.py +125 -125
  113. crawlo/utils/func_tools.py +82 -82
  114. crawlo/utils/large_scale_config.py +286 -286
  115. crawlo/utils/large_scale_helper.py +343 -343
  116. crawlo/utils/log.py +128 -128
  117. crawlo/utils/performance_monitor.py +284 -284
  118. crawlo/utils/queue_helper.py +175 -175
  119. crawlo/utils/redis_connection_pool.py +334 -334
  120. crawlo/utils/redis_key_validator.py +199 -199
  121. crawlo/utils/request.py +267 -267
  122. crawlo/utils/request_serializer.py +219 -219
  123. crawlo/utils/spider_loader.py +62 -62
  124. crawlo/utils/system.py +11 -11
  125. crawlo/utils/tools.py +4 -4
  126. crawlo/utils/url.py +39 -39
  127. {crawlo-1.2.0.dist-info → crawlo-1.2.1.dist-info}/METADATA +692 -697
  128. crawlo-1.2.1.dist-info/RECORD +220 -0
  129. examples/__init__.py +7 -7
  130. examples/aiohttp_settings.py +42 -0
  131. examples/curl_cffi_settings.py +41 -0
  132. examples/default_header_middleware_example.py +107 -0
  133. examples/default_header_spider_example.py +129 -0
  134. examples/download_delay_middleware_example.py +160 -0
  135. examples/httpx_settings.py +42 -0
  136. examples/multi_downloader_proxy_example.py +81 -0
  137. examples/offsite_middleware_example.py +55 -0
  138. examples/offsite_spider_example.py +107 -0
  139. examples/proxy_spider_example.py +166 -0
  140. examples/request_ignore_middleware_example.py +51 -0
  141. examples/request_ignore_spider_example.py +99 -0
  142. examples/response_code_middleware_example.py +52 -0
  143. examples/response_filter_middleware_example.py +67 -0
  144. examples/tong_hua_shun_settings.py +62 -0
  145. examples/tong_hua_shun_spider.py +170 -0
  146. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  147. tests/__init__.py +7 -7
  148. tests/advanced_tools_example.py +275 -275
  149. tests/authenticated_proxy_example.py +236 -236
  150. tests/cleaners_example.py +160 -160
  151. tests/config_validation_demo.py +102 -102
  152. tests/controlled_spider_example.py +205 -205
  153. tests/date_tools_example.py +180 -180
  154. tests/dynamic_loading_example.py +523 -523
  155. tests/dynamic_loading_test.py +104 -104
  156. tests/env_config_example.py +133 -133
  157. tests/error_handling_example.py +171 -171
  158. tests/redis_key_validation_demo.py +130 -130
  159. tests/response_improvements_example.py +144 -144
  160. tests/test_advanced_tools.py +148 -148
  161. tests/test_all_redis_key_configs.py +145 -145
  162. tests/test_authenticated_proxy.py +141 -141
  163. tests/test_cleaners.py +54 -54
  164. tests/test_comprehensive.py +146 -146
  165. tests/test_config_validator.py +193 -193
  166. tests/test_crawlo_proxy_integration.py +173 -0
  167. tests/test_date_tools.py +123 -123
  168. tests/test_default_header_middleware.py +159 -0
  169. tests/test_double_crawlo_fix.py +207 -207
  170. tests/test_double_crawlo_fix_simple.py +124 -124
  171. tests/test_download_delay_middleware.py +222 -0
  172. tests/test_downloader_proxy_compatibility.py +269 -0
  173. tests/test_dynamic_downloaders_proxy.py +124 -124
  174. tests/test_dynamic_proxy.py +92 -92
  175. tests/test_dynamic_proxy_config.py +146 -146
  176. tests/test_dynamic_proxy_real.py +109 -109
  177. tests/test_edge_cases.py +303 -303
  178. tests/test_enhanced_error_handler.py +270 -270
  179. tests/test_env_config.py +121 -121
  180. tests/test_error_handler_compatibility.py +112 -112
  181. tests/test_final_validation.py +153 -153
  182. tests/test_framework_env_usage.py +103 -103
  183. tests/test_integration.py +356 -356
  184. tests/test_item_dedup_redis_key.py +122 -122
  185. tests/test_offsite_middleware.py +222 -0
  186. tests/test_parsel.py +29 -29
  187. tests/test_performance.py +327 -327
  188. tests/test_proxy_api.py +265 -0
  189. tests/test_proxy_health_check.py +32 -32
  190. tests/test_proxy_middleware.py +122 -0
  191. tests/test_proxy_middleware_enhanced.py +217 -0
  192. tests/test_proxy_middleware_integration.py +136 -136
  193. tests/test_proxy_providers.py +56 -56
  194. tests/test_proxy_stats.py +19 -19
  195. tests/test_proxy_strategies.py +59 -59
  196. tests/test_queue_manager_double_crawlo.py +173 -173
  197. tests/test_queue_manager_redis_key.py +176 -176
  198. tests/test_real_scenario_proxy.py +196 -0
  199. tests/test_redis_config.py +28 -28
  200. tests/test_redis_connection_pool.py +294 -294
  201. tests/test_redis_key_naming.py +181 -181
  202. tests/test_redis_key_validator.py +123 -123
  203. tests/test_redis_queue.py +224 -224
  204. tests/test_request_ignore_middleware.py +183 -0
  205. tests/test_request_serialization.py +70 -70
  206. tests/test_response_code_middleware.py +350 -0
  207. tests/test_response_filter_middleware.py +428 -0
  208. tests/test_response_improvements.py +152 -152
  209. tests/test_retry_middleware.py +242 -0
  210. tests/test_scheduler.py +241 -241
  211. tests/test_simple_response.py +61 -61
  212. tests/test_telecom_spider_redis_key.py +205 -205
  213. tests/test_template_content.py +87 -87
  214. tests/test_template_redis_key.py +134 -134
  215. tests/test_tools.py +153 -153
  216. tests/tools_example.py +257 -257
  217. crawlo-1.2.0.dist-info/RECORD +0 -190
  218. {crawlo-1.2.0.dist-info → crawlo-1.2.1.dist-info}/WHEEL +0 -0
  219. {crawlo-1.2.0.dist-info → crawlo-1.2.1.dist-info}/entry_points.txt +0 -0
  220. {crawlo-1.2.0.dist-info → crawlo-1.2.1.dist-info}/top_level.txt +0 -0
crawlo/commands/run.py CHANGED
@@ -1,293 +1,293 @@
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
25
- from crawlo.commands.stats import record_stats
26
-
27
- logger = get_logger(__name__)
28
- console = Console()
29
-
30
-
31
- def get_project_root():
32
- """
33
- 向上查找 crawlo.cfg 来确定项目根目录
34
- """
35
- current = Path.cwd()
36
- # 首先检查当前目录及其子目录
37
- for root, dirs, files in os.walk(current):
38
- if "crawlo.cfg" in files:
39
- return Path(root)
40
-
41
- # 如果在子目录中没找到,再向上查找
42
- for _ in range(10):
43
- cfg = current / "crawlo.cfg"
44
- if cfg.exists():
45
- return current
46
- if current == current.parent:
47
- break
48
- current = current.parent
49
- return None
50
-
51
-
52
- def main(args):
53
- """
54
- 主函数:运行指定爬虫
55
- 用法:
56
- crawlo run <spider_name>|all [--json] [--no-stats]
57
- """
58
- if len(args) < 1:
59
- console.print("[bold red]❌ Usage:[/bold red] [blue]crawlo run[/blue] <spider_name>|all [bold yellow][--json] [--no-stats][/bold yellow]")
60
- console.print("💡 Examples:")
61
- console.print(" [blue]crawlo run baidu[/blue]")
62
- console.print(" [blue]crawlo run all[/blue]")
63
- console.print(" [blue]crawlo run all --json --no-stats[/blue]")
64
- return 1
65
-
66
- # 解析参数
67
- spider_arg = args[0]
68
- show_json = "--json" in args
69
- no_stats = "--no-stats" in args
70
-
71
- try:
72
- # 1. 查找项目根目录
73
- project_root = get_project_root()
74
- if not project_root:
75
- msg = ":cross_mark: [bold red]Cannot find 'crawlo.cfg'[/bold red]\n💡 Run this command inside your project directory."
76
- if show_json:
77
- console.print_json(data={"success": False, "error": "Project root not found"})
78
- return 1
79
- else:
80
- console.print(Panel(
81
- Text.from_markup(msg),
82
- title="❌ Not in a Crawlo Project",
83
- border_style="red",
84
- padding=(1, 2)
85
- ))
86
- return 1
87
-
88
- project_root_str = str(project_root)
89
- if project_root_str not in sys.path:
90
- sys.path.insert(0, project_root_str)
91
-
92
- # 2. 读取 crawlo.cfg 获取 settings 模块
93
- cfg_file = project_root / "crawlo.cfg"
94
- if not cfg_file.exists():
95
- msg = f"crawlo.cfg not found in {project_root}"
96
- if show_json:
97
- console.print_json(data={"success": False, "error": msg})
98
- return 1
99
- else:
100
- console.print(Panel(msg, title="❌ Missing Config", border_style="red"))
101
- return 1
102
-
103
- config = configparser.ConfigParser()
104
- config.read(cfg_file, encoding="utf-8")
105
-
106
- if not config.has_section("settings") or not config.has_option("settings", "default"):
107
- msg = "Missing [settings] section or 'default' option in crawlo.cfg"
108
- if show_json:
109
- console.print_json(data={"success": False, "error": msg})
110
- return 1
111
- else:
112
- console.print(Panel(msg, title="❌ Invalid Config", border_style="red"))
113
- return 1
114
-
115
- settings_module = config.get("settings", "default")
116
- project_package = settings_module.split(".")[0]
117
-
118
- # 3. 确保项目包可导入
119
- try:
120
- import_module(project_package)
121
- except ImportError as e:
122
- msg = f"Failed to import project package '{project_package}': {e}"
123
- if show_json:
124
- console.print_json(data={"success": False, "error": msg})
125
- return 1
126
- else:
127
- console.print(Panel(msg, title="❌ Import Error", border_style="red"))
128
- return 1
129
-
130
- # 4. 加载 settings 和爬虫模块
131
- settings = get_settings()
132
- spider_modules = [f"{project_package}.spiders"]
133
- process = CrawlerProcess(settings=settings, spider_modules=spider_modules)
134
-
135
- # === 情况1:运行所有爬虫 ===
136
- if spider_arg.lower() == "all":
137
- spider_names = process.get_spider_names()
138
- if not spider_names:
139
- msg = "No spiders found."
140
- if show_json:
141
- console.print_json(data={"success": False, "error": msg})
142
- return 1
143
- else:
144
- console.print(Panel(
145
- Text.from_markup(
146
- ":cross_mark: [bold red]No spiders found.[/bold red]\n\n"
147
- "[bold]💡 Make sure:[/bold]\n"
148
- " • Spiders are defined in '[cyan]spiders/[/cyan]'\n"
149
- " • They have a [green]`name`[/green] attribute\n"
150
- " • Modules are imported (e.g. via [cyan]__init__.py[/cyan])"
151
- ),
152
- title="❌ No Spiders",
153
- border_style="red",
154
- padding=(1, 2)
155
- ))
156
- return 1
157
-
158
- # 显示即将运行的爬虫列表
159
- table = Table(
160
- title=f"🚀 Starting ALL {len(spider_names)} spider(s)",
161
- box=box.ROUNDED,
162
- show_header=True,
163
- header_style="bold magenta"
164
- )
165
- table.add_column("Name", style="cyan")
166
- table.add_column("Class", style="green")
167
-
168
- for name in sorted(spider_names):
169
- cls = process.get_spider_class(name)
170
- table.add_row(name, cls.__name__)
171
-
172
- console.print(table)
173
- console.print()
174
-
175
- # 注册 stats 记录(除非 --no-stats)
176
- if not no_stats:
177
- for crawler in process.crawlers:
178
- crawler.signals.connect(record_stats, signal="spider_closed")
179
-
180
- # 并行运行所有爬虫
181
- with Progress(
182
- SpinnerColumn(),
183
- TextColumn("[progress.description]{task.description}"),
184
- transient=True,
185
- ) as progress:
186
- task = progress.add_task("Running all spiders...", total=None)
187
- asyncio.run(process.crawl(spider_names))
188
-
189
- if show_json:
190
- console.print_json(data={"success": True, "spiders": spider_names})
191
- else:
192
- console.print(Panel(
193
- ":tada: [bold green]All spiders completed successfully![/bold green]",
194
- title="✅ All Done",
195
- border_style="green"
196
- ))
197
- return 0
198
-
199
- # === 情况2:运行单个爬虫 ===
200
- spider_name = spider_arg
201
- if not process.is_spider_registered(spider_name):
202
- available = process.get_spider_names()
203
- msg = f"Spider '[cyan]{spider_name}[/cyan]' not found."
204
- if show_json:
205
- console.print_json(data={
206
- "success": False,
207
- "error": msg,
208
- "available": available
209
- })
210
- return 1
211
- else:
212
- panel_content = Text.from_markup(msg + "\n")
213
- if available:
214
- panel_content.append("\n💡 Available spiders:\n")
215
- for name in sorted(available):
216
- cls = process.get_spider_class(name)
217
- panel_content.append(f" • [cyan]{name}[/cyan] ([green]{cls.__name__}[/green])\n")
218
- else:
219
- panel_content.append("\n💡 No spiders found. Check your spiders module.")
220
-
221
- console.print(Panel(
222
- panel_content,
223
- title="❌ Spider Not Found",
224
- border_style="red",
225
- padding=(1, 2)
226
- ))
227
- return 1
228
-
229
- spider_class = process.get_spider_class(spider_name)
230
-
231
- # 显示启动信息
232
- if not show_json:
233
- info_table = Table(
234
- title=f"🚀 Starting Spider: [bold cyan]{spider_name}[/bold cyan]",
235
- box=box.SIMPLE,
236
- show_header=False,
237
- title_style="bold green"
238
- )
239
- info_table.add_column("Key", style="yellow")
240
- info_table.add_column("Value", style="cyan")
241
- info_table.add_row("Project", project_package)
242
- info_table.add_row("Class", spider_class.__name__)
243
- info_table.add_row("Module", spider_class.__module__)
244
- console.print(info_table)
245
- console.print()
246
-
247
- # 注册 stats 记录
248
- if not no_stats:
249
- for crawler in process.crawlers:
250
- crawler.signals.connect(record_stats, signal="spider_closed")
251
-
252
- # 运行爬虫
253
- with Progress(
254
- SpinnerColumn(),
255
- TextColumn("[progress.description]{task.description}"),
256
- transient=True,
257
- ) as progress:
258
- task = progress.add_task(f"Running {spider_name}...", total=None)
259
- asyncio.run(process.crawl(spider_name))
260
-
261
- if show_json:
262
- console.print_json(data={"success": True, "spider": spider_name})
263
- else:
264
- console.print(Panel(
265
- f":tada: [bold green]Spider '[cyan]{spider_name}[/cyan]' completed successfully![/bold green]",
266
- title="✅ Done",
267
- border_style="green"
268
- ))
269
- return 0
270
-
271
- except KeyboardInterrupt:
272
- msg = "⚠️ Spider interrupted by user."
273
- if show_json:
274
- console.print_json(data={"success": False, "error": msg})
275
- else:
276
- console.print(f"[bold yellow]{msg}[/bold yellow]")
277
- return 1
278
- except Exception as e:
279
- logger.exception("Exception during 'crawlo run'")
280
- msg = f"Unexpected error: {e}"
281
- if show_json:
282
- console.print_json(data={"success": False, "error": msg})
283
- else:
284
- console.print(f"[bold red]❌ {msg}[/bold red]")
285
- return 1
286
-
287
-
288
- if __name__ == "__main__":
289
- """
290
- 支持直接运行:
291
- python -m crawlo.commands.run spider_name
292
- """
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
25
+ from crawlo.commands.stats import record_stats
26
+
27
+ logger = get_logger(__name__)
28
+ console = Console()
29
+
30
+
31
+ def get_project_root():
32
+ """
33
+ 向上查找 crawlo.cfg 来确定项目根目录
34
+ """
35
+ current = Path.cwd()
36
+ # 首先检查当前目录及其子目录
37
+ for root, dirs, files in os.walk(current):
38
+ if "crawlo.cfg" in files:
39
+ return Path(root)
40
+
41
+ # 如果在子目录中没找到,再向上查找
42
+ for _ in range(10):
43
+ cfg = current / "crawlo.cfg"
44
+ if cfg.exists():
45
+ return current
46
+ if current == current.parent:
47
+ break
48
+ current = current.parent
49
+ return None
50
+
51
+
52
+ def main(args):
53
+ """
54
+ 主函数:运行指定爬虫
55
+ 用法:
56
+ crawlo run <spider_name>|all [--json] [--no-stats]
57
+ """
58
+ if len(args) < 1:
59
+ console.print("[bold red]❌ Usage:[/bold red] [blue]crawlo run[/blue] <spider_name>|all [bold yellow][--json] [--no-stats][/bold yellow]")
60
+ console.print("💡 Examples:")
61
+ console.print(" [blue]crawlo run baidu[/blue]")
62
+ console.print(" [blue]crawlo run all[/blue]")
63
+ console.print(" [blue]crawlo run all --json --no-stats[/blue]")
64
+ return 1
65
+
66
+ # 解析参数
67
+ spider_arg = args[0]
68
+ show_json = "--json" in args
69
+ no_stats = "--no-stats" in args
70
+
71
+ try:
72
+ # 1. 查找项目根目录
73
+ project_root = get_project_root()
74
+ if not project_root:
75
+ msg = ":cross_mark: [bold red]Cannot find 'crawlo.cfg'[/bold red]\n💡 Run this command inside your project directory."
76
+ if show_json:
77
+ console.print_json(data={"success": False, "error": "Project root not found"})
78
+ return 1
79
+ else:
80
+ console.print(Panel(
81
+ Text.from_markup(msg),
82
+ title="❌ Not in a Crawlo Project",
83
+ border_style="red",
84
+ padding=(1, 2)
85
+ ))
86
+ return 1
87
+
88
+ project_root_str = str(project_root)
89
+ if project_root_str not in sys.path:
90
+ sys.path.insert(0, project_root_str)
91
+
92
+ # 2. 读取 crawlo.cfg 获取 settings 模块
93
+ cfg_file = project_root / "crawlo.cfg"
94
+ if not cfg_file.exists():
95
+ msg = f"crawlo.cfg not found in {project_root}"
96
+ if show_json:
97
+ console.print_json(data={"success": False, "error": msg})
98
+ return 1
99
+ else:
100
+ console.print(Panel(msg, title="❌ Missing Config", border_style="red"))
101
+ return 1
102
+
103
+ config = configparser.ConfigParser()
104
+ config.read(cfg_file, encoding="utf-8")
105
+
106
+ if not config.has_section("settings") or not config.has_option("settings", "default"):
107
+ msg = "Missing [settings] section or 'default' option in crawlo.cfg"
108
+ if show_json:
109
+ console.print_json(data={"success": False, "error": msg})
110
+ return 1
111
+ else:
112
+ console.print(Panel(msg, title="❌ Invalid Config", border_style="red"))
113
+ return 1
114
+
115
+ settings_module = config.get("settings", "default")
116
+ project_package = settings_module.split(".")[0]
117
+
118
+ # 3. 确保项目包可导入
119
+ try:
120
+ import_module(project_package)
121
+ except ImportError as e:
122
+ msg = f"Failed to import project package '{project_package}': {e}"
123
+ if show_json:
124
+ console.print_json(data={"success": False, "error": msg})
125
+ return 1
126
+ else:
127
+ console.print(Panel(msg, title="❌ Import Error", border_style="red"))
128
+ return 1
129
+
130
+ # 4. 加载 settings 和爬虫模块
131
+ settings = get_settings()
132
+ spider_modules = [f"{project_package}.spiders"]
133
+ process = CrawlerProcess(settings=settings, spider_modules=spider_modules)
134
+
135
+ # === 情况1:运行所有爬虫 ===
136
+ if spider_arg.lower() == "all":
137
+ spider_names = process.get_spider_names()
138
+ if not spider_names:
139
+ msg = "No spiders found."
140
+ if show_json:
141
+ console.print_json(data={"success": False, "error": msg})
142
+ return 1
143
+ else:
144
+ console.print(Panel(
145
+ Text.from_markup(
146
+ ":cross_mark: [bold red]No spiders found.[/bold red]\n\n"
147
+ "[bold]💡 Make sure:[/bold]\n"
148
+ " • Spiders are defined in '[cyan]spiders/[/cyan]'\n"
149
+ " • They have a [green]`name`[/green] attribute\n"
150
+ " • Modules are imported (e.g. via [cyan]__init__.py[/cyan])"
151
+ ),
152
+ title="❌ No Spiders",
153
+ border_style="red",
154
+ padding=(1, 2)
155
+ ))
156
+ return 1
157
+
158
+ # 显示即将运行的爬虫列表
159
+ table = Table(
160
+ title=f"🚀 Starting ALL {len(spider_names)} spider(s)",
161
+ box=box.ROUNDED,
162
+ show_header=True,
163
+ header_style="bold magenta"
164
+ )
165
+ table.add_column("Name", style="cyan")
166
+ table.add_column("Class", style="green")
167
+
168
+ for name in sorted(spider_names):
169
+ cls = process.get_spider_class(name)
170
+ table.add_row(name, cls.__name__)
171
+
172
+ console.print(table)
173
+ console.print()
174
+
175
+ # 注册 stats 记录(除非 --no-stats)
176
+ if not no_stats:
177
+ for crawler in process.crawlers:
178
+ crawler.signals.connect(record_stats, signal="spider_closed")
179
+
180
+ # 并行运行所有爬虫
181
+ with Progress(
182
+ SpinnerColumn(),
183
+ TextColumn("[progress.description]{task.description}"),
184
+ transient=True,
185
+ ) as progress:
186
+ task = progress.add_task("Running all spiders...", total=None)
187
+ asyncio.run(process.crawl(spider_names))
188
+
189
+ if show_json:
190
+ console.print_json(data={"success": True, "spiders": spider_names})
191
+ else:
192
+ console.print(Panel(
193
+ ":tada: [bold green]All spiders completed successfully![/bold green]",
194
+ title="✅ All Done",
195
+ border_style="green"
196
+ ))
197
+ return 0
198
+
199
+ # === 情况2:运行单个爬虫 ===
200
+ spider_name = spider_arg
201
+ if not process.is_spider_registered(spider_name):
202
+ available = process.get_spider_names()
203
+ msg = f"Spider '[cyan]{spider_name}[/cyan]' not found."
204
+ if show_json:
205
+ console.print_json(data={
206
+ "success": False,
207
+ "error": msg,
208
+ "available": available
209
+ })
210
+ return 1
211
+ else:
212
+ panel_content = Text.from_markup(msg + "\n")
213
+ if available:
214
+ panel_content.append("\n💡 Available spiders:\n")
215
+ for name in sorted(available):
216
+ cls = process.get_spider_class(name)
217
+ panel_content.append(f" • [cyan]{name}[/cyan] ([green]{cls.__name__}[/green])\n")
218
+ else:
219
+ panel_content.append("\n💡 No spiders found. Check your spiders module.")
220
+
221
+ console.print(Panel(
222
+ panel_content,
223
+ title="❌ Spider Not Found",
224
+ border_style="red",
225
+ padding=(1, 2)
226
+ ))
227
+ return 1
228
+
229
+ spider_class = process.get_spider_class(spider_name)
230
+
231
+ # 显示启动信息
232
+ if not show_json:
233
+ info_table = Table(
234
+ title=f"🚀 Starting Spider: [bold cyan]{spider_name}[/bold cyan]",
235
+ box=box.SIMPLE,
236
+ show_header=False,
237
+ title_style="bold green"
238
+ )
239
+ info_table.add_column("Key", style="yellow")
240
+ info_table.add_column("Value", style="cyan")
241
+ info_table.add_row("Project", project_package)
242
+ info_table.add_row("Class", spider_class.__name__)
243
+ info_table.add_row("Module", spider_class.__module__)
244
+ console.print(info_table)
245
+ console.print()
246
+
247
+ # 注册 stats 记录
248
+ if not no_stats:
249
+ for crawler in process.crawlers:
250
+ crawler.signals.connect(record_stats, signal="spider_closed")
251
+
252
+ # 运行爬虫
253
+ with Progress(
254
+ SpinnerColumn(),
255
+ TextColumn("[progress.description]{task.description}"),
256
+ transient=True,
257
+ ) as progress:
258
+ task = progress.add_task(f"Running {spider_name}...", total=None)
259
+ asyncio.run(process.crawl(spider_name))
260
+
261
+ if show_json:
262
+ console.print_json(data={"success": True, "spider": spider_name})
263
+ else:
264
+ console.print(Panel(
265
+ f":tada: [bold green]Spider '[cyan]{spider_name}[/cyan]' completed successfully![/bold green]",
266
+ title="✅ Done",
267
+ border_style="green"
268
+ ))
269
+ return 0
270
+
271
+ except KeyboardInterrupt:
272
+ msg = "⚠️ Spider interrupted by user."
273
+ if show_json:
274
+ console.print_json(data={"success": False, "error": msg})
275
+ else:
276
+ console.print(f"[bold yellow]{msg}[/bold yellow]")
277
+ return 1
278
+ except Exception as e:
279
+ logger.exception("Exception during 'crawlo run'")
280
+ msg = f"Unexpected error: {e}"
281
+ if show_json:
282
+ console.print_json(data={"success": False, "error": msg})
283
+ else:
284
+ console.print(f"[bold red]❌ {msg}[/bold red]")
285
+ return 1
286
+
287
+
288
+ if __name__ == "__main__":
289
+ """
290
+ 支持直接运行:
291
+ python -m crawlo.commands.run spider_name
292
+ """
293
293
  sys.exit(main(sys.argv[1:]))