crawlo 1.3.4__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 -318
  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 +80 -44
  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.4.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 +127 -0
  166. tests/debug_log_levels.py +63 -63
  167. tests/debug_pipelines.py +66 -66
  168. tests/detailed_log_test.py +234 -0
  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 +261 -0
  177. tests/final_validation_test.py +182 -182
  178. tests/fix_log_test.py +143 -0
  179. tests/framework_performance_test.py +202 -202
  180. tests/log_buffering_test.py +112 -0
  181. tests/log_generation_timing_test.py +154 -0
  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 +138 -0
  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 +178 -0
  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 +84 -0
  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 +283 -0
  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.4.dist-info/RECORD +0 -278
  287. {crawlo-1.3.4.dist-info → crawlo-1.3.6.dist-info}/WHEEL +0 -0
  288. {crawlo-1.3.4.dist-info → crawlo-1.3.6.dist-info}/entry_points.txt +0 -0
  289. {crawlo-1.3.4.dist-info → crawlo-1.3.6.dist-info}/top_level.txt +0 -0
@@ -1,219 +1,219 @@
1
- # -*- coding: utf-8 -*-
2
- import json
3
- import asyncio
4
- from pathlib import Path
5
- from typing import Optional
6
- from datetime import datetime
7
- from crawlo.utils.log import get_logger
8
- from crawlo.exceptions import ItemDiscard
9
-
10
-
11
- class JsonPipeline:
12
- """JSON文件输出管道"""
13
-
14
- def __init__(self, crawler):
15
- self.crawler = crawler
16
- self.settings = crawler.settings
17
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
18
-
19
- # 配置文件路径
20
- self.file_path = self._get_file_path()
21
- self.file_handle = None
22
- self.lock = asyncio.Lock() # 异步锁保证线程安全
23
-
24
- # 注册关闭事件
25
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
26
-
27
- @classmethod
28
- def from_crawler(cls, crawler):
29
- return cls(crawler)
30
-
31
- def _get_file_path(self) -> Path:
32
- """获取输出文件路径"""
33
- # 优先级:设置 > 爬虫属性 > 默认路径
34
- file_path = (
35
- self.settings.get('JSON_FILE') or
36
- getattr(self.crawler.spider, 'json_file', None) or
37
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
38
- )
39
-
40
- path = Path(file_path)
41
- path.parent.mkdir(parents=True, exist_ok=True)
42
- return path
43
-
44
- async def _ensure_file_open(self):
45
- """确保文件已打开"""
46
- if self.file_handle is None:
47
- self.file_handle = open(self.file_path, 'w', encoding='utf-8')
48
- self.logger.info(f"JSON文件已创建: {self.file_path}")
49
-
50
- async def process_item(self, item, spider) -> Optional[dict]:
51
- """处理item的核心方法"""
52
- try:
53
- async with self.lock:
54
- await self._ensure_file_open()
55
-
56
- # 转换为字典并序列化
57
- item_dict = dict(item)
58
- json_line = json.dumps(item_dict, ensure_ascii=False, indent=None)
59
-
60
- # 写入文件(每行一个JSON对象)
61
- self.file_handle.write(json_line + '\n')
62
- self.file_handle.flush() # 立即刷新到磁盘
63
-
64
- # 统计
65
- self.crawler.stats.inc_value('json_pipeline/items_written')
66
- self.logger.debug(f"写入JSON项: {len(item_dict)} 字段")
67
-
68
- return item
69
-
70
- except Exception as e:
71
- self.crawler.stats.inc_value('json_pipeline/items_failed')
72
- self.logger.error(f"JSON写入失败: {e}")
73
- raise ItemDiscard(f"JSON Pipeline处理失败: {e}")
74
-
75
- async def spider_closed(self):
76
- """关闭爬虫时清理资源"""
77
- if self.file_handle:
78
- self.file_handle.close()
79
- self.logger.info(f"JSON文件已关闭: {self.file_path}")
80
-
81
-
82
- class JsonLinesPipeline:
83
- """JSON Lines格式输出管道(每行一个JSON对象)"""
84
-
85
- def __init__(self, crawler):
86
- self.crawler = crawler
87
- self.settings = crawler.settings
88
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
89
-
90
- self.file_path = self._get_file_path()
91
- self.file_handle = None
92
- self.items_count = 0
93
- self.lock = asyncio.Lock()
94
-
95
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
96
-
97
- @classmethod
98
- def from_crawler(cls, crawler):
99
- return cls(crawler)
100
-
101
- def _get_file_path(self) -> Path:
102
- """获取输出文件路径"""
103
- file_path = (
104
- self.settings.get('JSONLINES_FILE') or
105
- getattr(self.crawler.spider, 'jsonlines_file', None) or
106
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.jsonl"
107
- )
108
-
109
- path = Path(file_path)
110
- path.parent.mkdir(parents=True, exist_ok=True)
111
- return path
112
-
113
- async def _ensure_file_open(self):
114
- """确保文件已打开"""
115
- if self.file_handle is None:
116
- self.file_handle = open(self.file_path, 'w', encoding='utf-8')
117
- self.logger.info(f"JSONL文件已创建: {self.file_path}")
118
-
119
- async def process_item(self, item, spider) -> Optional[dict]:
120
- """处理item方法"""
121
- try:
122
- async with self.lock:
123
- await self._ensure_file_open()
124
-
125
- item_dict = dict(item)
126
-
127
- # 添加元数据
128
- if self.settings.get_bool('JSON_ADD_METADATA', False):
129
- item_dict['_crawl_time'] = datetime.now().isoformat()
130
- item_dict['_spider_name'] = spider.name
131
-
132
- # 写入JSONL格式
133
- json_line = json.dumps(item_dict, ensure_ascii=False, separators=(',', ':'))
134
- self.file_handle.write(json_line + '\n')
135
- self.file_handle.flush()
136
-
137
- self.items_count += 1
138
-
139
- # 定期日志输出
140
- if self.items_count % 100 == 0:
141
- self.logger.info(f"已写入 {self.items_count} 个JSON对象")
142
-
143
- self.crawler.stats.inc_value('jsonlines_pipeline/items_written')
144
-
145
- return item
146
-
147
- except Exception as e:
148
- self.crawler.stats.inc_value('jsonlines_pipeline/items_failed')
149
- self.logger.error(f"JSONL写入失败: {e}")
150
- raise ItemDiscard(f"JSON Lines Pipeline处理失败: {e}")
151
-
152
- async def spider_closed(self):
153
- """资源清理"""
154
- if self.file_handle:
155
- self.file_handle.close()
156
- self.logger.info(f"JSONL文件已关闭,共写入 {self.items_count} 个项目: {self.file_path}")
157
-
158
-
159
- class JsonArrayPipeline:
160
- """JSON数组格式输出管道(所有item组成一个JSON数组)"""
161
-
162
- def __init__(self, crawler):
163
- self.crawler = crawler
164
- self.settings = crawler.settings
165
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
166
-
167
- self.file_path = self._get_file_path()
168
- self.items = [] # 内存中暂存所有items
169
- self.lock = asyncio.Lock()
170
-
171
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
172
-
173
- @classmethod
174
- def from_crawler(cls, crawler):
175
- return cls(crawler)
176
-
177
- def _get_file_path(self) -> Path:
178
- """获取输出文件路径"""
179
- file_path = (
180
- self.settings.get('JSON_ARRAY_FILE') or
181
- getattr(self.crawler.spider, 'json_array_file', None) or
182
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}_array.json"
183
- )
184
-
185
- path = Path(file_path)
186
- path.parent.mkdir(parents=True, exist_ok=True)
187
- return path
188
-
189
- async def process_item(self, item, spider) -> Optional[dict]:
190
- """处理item方法"""
191
- try:
192
- async with self.lock:
193
- item_dict = dict(item)
194
- self.items.append(item_dict)
195
-
196
- self.crawler.stats.inc_value('json_array_pipeline/items_collected')
197
- self.logger.debug(f"收集item,当前总数: {len(self.items)}")
198
-
199
- return item
200
-
201
- except Exception as e:
202
- self.crawler.stats.inc_value('json_array_pipeline/items_failed')
203
- self.logger.error(f"JSON Array收集失败: {e}")
204
- raise ItemDiscard(f"JSON Array Pipeline处理失败: {e}")
205
-
206
- async def spider_closed(self):
207
- """关闭时写入所有items到JSON数组文件"""
208
- try:
209
- if self.items:
210
- with open(self.file_path, 'w', encoding='utf-8') as f:
211
- json.dump(self.items, f, ensure_ascii=False, indent=2)
212
-
213
- self.logger.info(f"JSON数组文件已保存,包含 {len(self.items)} 个项目: {self.file_path}")
214
- self.crawler.stats.set_value('json_array_pipeline/total_items', len(self.items))
215
- else:
216
- self.logger.warning("没有items需要保存")
217
-
218
- except Exception as e:
1
+ # -*- coding: utf-8 -*-
2
+ import json
3
+ import asyncio
4
+ from pathlib import Path
5
+ from typing import Optional
6
+ from datetime import datetime
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.exceptions import ItemDiscard
9
+
10
+
11
+ class JsonPipeline:
12
+ """JSON文件输出管道"""
13
+
14
+ def __init__(self, crawler):
15
+ self.crawler = crawler
16
+ self.settings = crawler.settings
17
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
18
+
19
+ # 配置文件路径
20
+ self.file_path = self._get_file_path()
21
+ self.file_handle = None
22
+ self.lock = asyncio.Lock() # 异步锁保证线程安全
23
+
24
+ # 注册关闭事件
25
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
26
+
27
+ @classmethod
28
+ def from_crawler(cls, crawler):
29
+ return cls(crawler)
30
+
31
+ def _get_file_path(self) -> Path:
32
+ """获取输出文件路径"""
33
+ # 优先级:设置 > 爬虫属性 > 默认路径
34
+ file_path = (
35
+ self.settings.get('JSON_FILE') or
36
+ getattr(self.crawler.spider, 'json_file', None) or
37
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
38
+ )
39
+
40
+ path = Path(file_path)
41
+ path.parent.mkdir(parents=True, exist_ok=True)
42
+ return path
43
+
44
+ async def _ensure_file_open(self):
45
+ """确保文件已打开"""
46
+ if self.file_handle is None:
47
+ self.file_handle = open(self.file_path, 'w', encoding='utf-8')
48
+ self.logger.info(f"JSON文件已创建: {self.file_path}")
49
+
50
+ async def process_item(self, item, spider) -> Optional[dict]:
51
+ """处理item的核心方法"""
52
+ try:
53
+ async with self.lock:
54
+ await self._ensure_file_open()
55
+
56
+ # 转换为字典并序列化
57
+ item_dict = dict(item)
58
+ json_line = json.dumps(item_dict, ensure_ascii=False, indent=None)
59
+
60
+ # 写入文件(每行一个JSON对象)
61
+ self.file_handle.write(json_line + '\n')
62
+ self.file_handle.flush() # 立即刷新到磁盘
63
+
64
+ # 统计
65
+ self.crawler.stats.inc_value('json_pipeline/items_written')
66
+ self.logger.debug(f"写入JSON项: {len(item_dict)} 字段")
67
+
68
+ return item
69
+
70
+ except Exception as e:
71
+ self.crawler.stats.inc_value('json_pipeline/items_failed')
72
+ self.logger.error(f"JSON写入失败: {e}")
73
+ raise ItemDiscard(f"JSON Pipeline处理失败: {e}")
74
+
75
+ async def spider_closed(self):
76
+ """关闭爬虫时清理资源"""
77
+ if self.file_handle:
78
+ self.file_handle.close()
79
+ self.logger.info(f"JSON文件已关闭: {self.file_path}")
80
+
81
+
82
+ class JsonLinesPipeline:
83
+ """JSON Lines格式输出管道(每行一个JSON对象)"""
84
+
85
+ def __init__(self, crawler):
86
+ self.crawler = crawler
87
+ self.settings = crawler.settings
88
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
89
+
90
+ self.file_path = self._get_file_path()
91
+ self.file_handle = None
92
+ self.items_count = 0
93
+ self.lock = asyncio.Lock()
94
+
95
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
96
+
97
+ @classmethod
98
+ def from_crawler(cls, crawler):
99
+ return cls(crawler)
100
+
101
+ def _get_file_path(self) -> Path:
102
+ """获取输出文件路径"""
103
+ file_path = (
104
+ self.settings.get('JSONLINES_FILE') or
105
+ getattr(self.crawler.spider, 'jsonlines_file', None) or
106
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.jsonl"
107
+ )
108
+
109
+ path = Path(file_path)
110
+ path.parent.mkdir(parents=True, exist_ok=True)
111
+ return path
112
+
113
+ async def _ensure_file_open(self):
114
+ """确保文件已打开"""
115
+ if self.file_handle is None:
116
+ self.file_handle = open(self.file_path, 'w', encoding='utf-8')
117
+ self.logger.info(f"JSONL文件已创建: {self.file_path}")
118
+
119
+ async def process_item(self, item, spider) -> Optional[dict]:
120
+ """处理item方法"""
121
+ try:
122
+ async with self.lock:
123
+ await self._ensure_file_open()
124
+
125
+ item_dict = dict(item)
126
+
127
+ # 添加元数据
128
+ if self.settings.get_bool('JSON_ADD_METADATA', False):
129
+ item_dict['_crawl_time'] = datetime.now().isoformat()
130
+ item_dict['_spider_name'] = spider.name
131
+
132
+ # 写入JSONL格式
133
+ json_line = json.dumps(item_dict, ensure_ascii=False, separators=(',', ':'))
134
+ self.file_handle.write(json_line + '\n')
135
+ self.file_handle.flush()
136
+
137
+ self.items_count += 1
138
+
139
+ # 定期日志输出
140
+ if self.items_count % 100 == 0:
141
+ self.logger.info(f"已写入 {self.items_count} 个JSON对象")
142
+
143
+ self.crawler.stats.inc_value('jsonlines_pipeline/items_written')
144
+
145
+ return item
146
+
147
+ except Exception as e:
148
+ self.crawler.stats.inc_value('jsonlines_pipeline/items_failed')
149
+ self.logger.error(f"JSONL写入失败: {e}")
150
+ raise ItemDiscard(f"JSON Lines Pipeline处理失败: {e}")
151
+
152
+ async def spider_closed(self):
153
+ """资源清理"""
154
+ if self.file_handle:
155
+ self.file_handle.close()
156
+ self.logger.info(f"JSONL文件已关闭,共写入 {self.items_count} 个项目: {self.file_path}")
157
+
158
+
159
+ class JsonArrayPipeline:
160
+ """JSON数组格式输出管道(所有item组成一个JSON数组)"""
161
+
162
+ def __init__(self, crawler):
163
+ self.crawler = crawler
164
+ self.settings = crawler.settings
165
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
166
+
167
+ self.file_path = self._get_file_path()
168
+ self.items = [] # 内存中暂存所有items
169
+ self.lock = asyncio.Lock()
170
+
171
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
172
+
173
+ @classmethod
174
+ def from_crawler(cls, crawler):
175
+ return cls(crawler)
176
+
177
+ def _get_file_path(self) -> Path:
178
+ """获取输出文件路径"""
179
+ file_path = (
180
+ self.settings.get('JSON_ARRAY_FILE') or
181
+ getattr(self.crawler.spider, 'json_array_file', None) or
182
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}_array.json"
183
+ )
184
+
185
+ path = Path(file_path)
186
+ path.parent.mkdir(parents=True, exist_ok=True)
187
+ return path
188
+
189
+ async def process_item(self, item, spider) -> Optional[dict]:
190
+ """处理item方法"""
191
+ try:
192
+ async with self.lock:
193
+ item_dict = dict(item)
194
+ self.items.append(item_dict)
195
+
196
+ self.crawler.stats.inc_value('json_array_pipeline/items_collected')
197
+ self.logger.debug(f"收集item,当前总数: {len(self.items)}")
198
+
199
+ return item
200
+
201
+ except Exception as e:
202
+ self.crawler.stats.inc_value('json_array_pipeline/items_failed')
203
+ self.logger.error(f"JSON Array收集失败: {e}")
204
+ raise ItemDiscard(f"JSON Array Pipeline处理失败: {e}")
205
+
206
+ async def spider_closed(self):
207
+ """关闭时写入所有items到JSON数组文件"""
208
+ try:
209
+ if self.items:
210
+ with open(self.file_path, 'w', encoding='utf-8') as f:
211
+ json.dump(self.items, f, ensure_ascii=False, indent=2)
212
+
213
+ self.logger.info(f"JSON数组文件已保存,包含 {len(self.items)} 个项目: {self.file_path}")
214
+ self.crawler.stats.set_value('json_array_pipeline/total_items', len(self.items))
215
+ else:
216
+ self.logger.warning("没有items需要保存")
217
+
218
+ except Exception as e:
219
219
  self.logger.error(f"保存JSON数组文件失败: {e}")