crawlo 1.3.3__py3-none-any.whl → 1.3.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of crawlo might be problematic. Click here for more details.

Files changed (279) hide show
  1. crawlo/__init__.py +87 -63
  2. crawlo/__version__.py +1 -1
  3. crawlo/cli.py +75 -75
  4. crawlo/commands/__init__.py +14 -14
  5. crawlo/commands/check.py +594 -594
  6. crawlo/commands/genspider.py +151 -151
  7. crawlo/commands/help.py +138 -138
  8. crawlo/commands/list.py +155 -155
  9. crawlo/commands/run.py +341 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +196 -196
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -277
  15. crawlo/core/__init__.py +46 -2
  16. crawlo/core/engine.py +439 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +257 -256
  19. crawlo/crawler.py +639 -1167
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -194
  22. crawlo/downloader/__init__.py +273 -273
  23. crawlo/downloader/aiohttp_downloader.py +228 -226
  24. crawlo/downloader/cffi_downloader.py +245 -245
  25. crawlo/downloader/httpx_downloader.py +259 -259
  26. crawlo/downloader/hybrid_downloader.py +212 -212
  27. crawlo/downloader/playwright_downloader.py +402 -402
  28. crawlo/downloader/selenium_downloader.py +472 -472
  29. crawlo/event.py +11 -11
  30. crawlo/exceptions.py +81 -81
  31. crawlo/extension/__init__.py +39 -39
  32. crawlo/extension/health_check.py +141 -141
  33. crawlo/extension/log_interval.py +57 -57
  34. crawlo/extension/log_stats.py +81 -81
  35. crawlo/extension/logging_extension.py +61 -52
  36. crawlo/extension/memory_monitor.py +104 -104
  37. crawlo/extension/performance_profiler.py +133 -133
  38. crawlo/extension/request_recorder.py +107 -107
  39. crawlo/factories/__init__.py +28 -0
  40. crawlo/factories/base.py +69 -0
  41. crawlo/factories/crawler.py +104 -0
  42. crawlo/factories/registry.py +85 -0
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +257 -234
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/framework.py +292 -0
  47. crawlo/initialization/__init__.py +40 -0
  48. crawlo/initialization/built_in.py +426 -0
  49. crawlo/initialization/context.py +142 -0
  50. crawlo/initialization/core.py +194 -0
  51. crawlo/initialization/phases.py +149 -0
  52. crawlo/initialization/registry.py +146 -0
  53. crawlo/items/__init__.py +23 -23
  54. crawlo/items/base.py +23 -22
  55. crawlo/items/fields.py +52 -52
  56. crawlo/items/items.py +104 -104
  57. crawlo/logging/__init__.py +38 -0
  58. crawlo/logging/config.py +97 -0
  59. crawlo/logging/factory.py +129 -0
  60. crawlo/logging/manager.py +112 -0
  61. crawlo/middleware/__init__.py +21 -21
  62. crawlo/middleware/default_header.py +132 -132
  63. crawlo/middleware/download_delay.py +104 -104
  64. crawlo/middleware/middleware_manager.py +135 -135
  65. crawlo/middleware/offsite.py +123 -123
  66. crawlo/middleware/proxy.py +386 -386
  67. crawlo/middleware/request_ignore.py +86 -86
  68. crawlo/middleware/response_code.py +163 -163
  69. crawlo/middleware/response_filter.py +136 -136
  70. crawlo/middleware/retry.py +124 -124
  71. crawlo/middleware/simple_proxy.py +65 -65
  72. crawlo/mode_manager.py +212 -187
  73. crawlo/network/__init__.py +21 -21
  74. crawlo/network/request.py +379 -379
  75. crawlo/network/response.py +359 -359
  76. crawlo/pipelines/__init__.py +21 -21
  77. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  78. crawlo/pipelines/console_pipeline.py +39 -39
  79. crawlo/pipelines/csv_pipeline.py +316 -316
  80. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  81. crawlo/pipelines/json_pipeline.py +218 -218
  82. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  83. crawlo/pipelines/mongo_pipeline.py +131 -131
  84. crawlo/pipelines/mysql_pipeline.py +318 -318
  85. crawlo/pipelines/pipeline_manager.py +76 -75
  86. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  87. crawlo/project.py +327 -325
  88. crawlo/queue/pqueue.py +43 -37
  89. crawlo/queue/queue_manager.py +503 -379
  90. crawlo/queue/redis_priority_queue.py +326 -306
  91. crawlo/settings/__init__.py +7 -7
  92. crawlo/settings/default_settings.py +321 -225
  93. crawlo/settings/setting_manager.py +214 -198
  94. crawlo/spider/__init__.py +657 -639
  95. crawlo/stats_collector.py +73 -59
  96. crawlo/subscriber.py +129 -129
  97. crawlo/task_manager.py +139 -30
  98. crawlo/templates/crawlo.cfg.tmpl +10 -10
  99. crawlo/templates/project/__init__.py.tmpl +3 -3
  100. crawlo/templates/project/items.py.tmpl +17 -17
  101. crawlo/templates/project/middlewares.py.tmpl +118 -118
  102. crawlo/templates/project/pipelines.py.tmpl +96 -96
  103. crawlo/templates/project/settings.py.tmpl +168 -267
  104. crawlo/templates/project/settings_distributed.py.tmpl +167 -180
  105. crawlo/templates/project/settings_gentle.py.tmpl +167 -61
  106. crawlo/templates/project/settings_high_performance.py.tmpl +168 -131
  107. crawlo/templates/project/settings_minimal.py.tmpl +66 -35
  108. crawlo/templates/project/settings_simple.py.tmpl +165 -102
  109. crawlo/templates/project/spiders/__init__.py.tmpl +10 -6
  110. crawlo/templates/run.py.tmpl +34 -38
  111. crawlo/templates/spider/spider.py.tmpl +143 -143
  112. crawlo/templates/spiders_init.py.tmpl +10 -0
  113. crawlo/tools/__init__.py +200 -200
  114. crawlo/tools/anti_crawler.py +268 -268
  115. crawlo/tools/authenticated_proxy.py +240 -240
  116. crawlo/tools/data_formatter.py +225 -225
  117. crawlo/tools/data_validator.py +180 -180
  118. crawlo/tools/date_tools.py +289 -289
  119. crawlo/tools/distributed_coordinator.py +388 -388
  120. crawlo/tools/encoding_converter.py +127 -127
  121. crawlo/tools/network_diagnostic.py +365 -0
  122. crawlo/tools/request_tools.py +82 -82
  123. crawlo/tools/retry_mechanism.py +224 -224
  124. crawlo/tools/scenario_adapter.py +262 -262
  125. crawlo/tools/text_cleaner.py +232 -232
  126. crawlo/utils/__init__.py +34 -34
  127. crawlo/utils/batch_processor.py +259 -259
  128. crawlo/utils/class_loader.py +26 -0
  129. crawlo/utils/controlled_spider_mixin.py +439 -439
  130. crawlo/utils/db_helper.py +343 -343
  131. crawlo/utils/enhanced_error_handler.py +356 -356
  132. crawlo/utils/env_config.py +142 -142
  133. crawlo/utils/error_handler.py +165 -124
  134. crawlo/utils/func_tools.py +82 -82
  135. crawlo/utils/large_scale_config.py +286 -286
  136. crawlo/utils/large_scale_helper.py +344 -344
  137. crawlo/utils/log.py +44 -200
  138. crawlo/utils/performance_monitor.py +285 -285
  139. crawlo/utils/queue_helper.py +175 -175
  140. crawlo/utils/redis_connection_pool.py +388 -351
  141. crawlo/utils/redis_key_validator.py +198 -198
  142. crawlo/utils/request.py +267 -267
  143. crawlo/utils/request_serializer.py +225 -218
  144. crawlo/utils/spider_loader.py +61 -61
  145. crawlo/utils/system.py +11 -11
  146. crawlo/utils/tools.py +4 -4
  147. crawlo/utils/url.py +39 -39
  148. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/METADATA +1126 -1020
  149. crawlo-1.3.4.dist-info/RECORD +278 -0
  150. examples/__init__.py +7 -7
  151. tests/__init__.py +7 -7
  152. tests/advanced_tools_example.py +275 -275
  153. tests/authenticated_proxy_example.py +107 -107
  154. tests/baidu_performance_test.py +109 -0
  155. tests/baidu_test.py +60 -0
  156. tests/cleaners_example.py +160 -160
  157. tests/comprehensive_framework_test.py +213 -0
  158. tests/comprehensive_test.py +82 -0
  159. tests/comprehensive_testing_summary.md +187 -0
  160. tests/config_validation_demo.py +142 -142
  161. tests/controlled_spider_example.py +205 -205
  162. tests/date_tools_example.py +180 -180
  163. tests/debug_configure.py +70 -0
  164. tests/debug_framework_logger.py +85 -0
  165. tests/debug_log_levels.py +64 -0
  166. tests/debug_pipelines.py +66 -66
  167. tests/distributed_test.py +67 -0
  168. tests/distributed_test_debug.py +77 -0
  169. tests/dynamic_loading_example.py +523 -523
  170. tests/dynamic_loading_test.py +104 -104
  171. tests/env_config_example.py +133 -133
  172. tests/error_handling_example.py +171 -171
  173. tests/final_command_test_report.md +0 -0
  174. tests/final_comprehensive_test.py +152 -0
  175. tests/final_validation_test.py +183 -0
  176. tests/framework_performance_test.py +203 -0
  177. tests/optimized_performance_test.py +212 -0
  178. tests/performance_comparison.py +246 -0
  179. tests/queue_blocking_test.py +114 -0
  180. tests/queue_test.py +90 -0
  181. tests/redis_key_validation_demo.py +130 -130
  182. tests/request_params_example.py +150 -150
  183. tests/response_improvements_example.py +144 -144
  184. tests/scrapy_comparison/ofweek_scrapy.py +139 -0
  185. tests/scrapy_comparison/scrapy_test.py +134 -0
  186. tests/simple_command_test.py +120 -0
  187. tests/simple_crawlo_test.py +128 -0
  188. tests/simple_log_test.py +58 -0
  189. tests/simple_optimization_test.py +129 -0
  190. tests/simple_spider_test.py +50 -0
  191. tests/simple_test.py +48 -0
  192. tests/test_advanced_tools.py +148 -148
  193. tests/test_all_commands.py +231 -0
  194. tests/test_all_redis_key_configs.py +145 -145
  195. tests/test_authenticated_proxy.py +141 -141
  196. tests/test_batch_processor.py +179 -0
  197. tests/test_cleaners.py +54 -54
  198. tests/test_component_factory.py +175 -0
  199. tests/test_comprehensive.py +146 -146
  200. tests/test_config_consistency.py +80 -80
  201. tests/test_config_merge.py +152 -152
  202. tests/test_config_validator.py +182 -182
  203. tests/test_controlled_spider_mixin.py +80 -0
  204. tests/test_crawlo_proxy_integration.py +108 -108
  205. tests/test_date_tools.py +123 -123
  206. tests/test_default_header_middleware.py +158 -158
  207. tests/test_distributed.py +65 -65
  208. tests/test_double_crawlo_fix.py +207 -207
  209. tests/test_double_crawlo_fix_simple.py +124 -124
  210. tests/test_download_delay_middleware.py +221 -221
  211. tests/test_downloader_proxy_compatibility.py +268 -268
  212. tests/test_dynamic_downloaders_proxy.py +124 -124
  213. tests/test_dynamic_proxy.py +92 -92
  214. tests/test_dynamic_proxy_config.py +146 -146
  215. tests/test_dynamic_proxy_real.py +109 -109
  216. tests/test_edge_cases.py +303 -303
  217. tests/test_enhanced_error_handler.py +270 -270
  218. tests/test_enhanced_error_handler_comprehensive.py +246 -0
  219. tests/test_env_config.py +121 -121
  220. tests/test_error_handler_compatibility.py +112 -112
  221. tests/test_factories.py +253 -0
  222. tests/test_final_validation.py +153 -153
  223. tests/test_framework_env_usage.py +103 -103
  224. tests/test_framework_logger.py +67 -0
  225. tests/test_framework_startup.py +65 -0
  226. tests/test_integration.py +169 -169
  227. tests/test_item_dedup_redis_key.py +122 -122
  228. tests/test_large_scale_config.py +113 -0
  229. tests/test_large_scale_helper.py +236 -0
  230. tests/test_mode_change.py +73 -0
  231. tests/test_mode_consistency.py +51 -51
  232. tests/test_offsite_middleware.py +221 -221
  233. tests/test_parsel.py +29 -29
  234. tests/test_performance.py +327 -327
  235. tests/test_performance_monitor.py +116 -0
  236. tests/test_proxy_api.py +264 -264
  237. tests/test_proxy_health_check.py +32 -32
  238. tests/test_proxy_middleware.py +121 -121
  239. tests/test_proxy_middleware_enhanced.py +216 -216
  240. tests/test_proxy_middleware_integration.py +136 -136
  241. tests/test_proxy_middleware_refactored.py +184 -184
  242. tests/test_proxy_providers.py +56 -56
  243. tests/test_proxy_stats.py +19 -19
  244. tests/test_proxy_strategies.py +59 -59
  245. tests/test_queue_empty_check.py +42 -0
  246. tests/test_queue_manager_double_crawlo.py +173 -173
  247. tests/test_queue_manager_redis_key.py +176 -176
  248. tests/test_random_user_agent.py +72 -72
  249. tests/test_real_scenario_proxy.py +195 -195
  250. tests/test_redis_config.py +28 -28
  251. tests/test_redis_connection_pool.py +294 -294
  252. tests/test_redis_key_naming.py +181 -181
  253. tests/test_redis_key_validator.py +123 -123
  254. tests/test_redis_queue.py +224 -224
  255. tests/test_request_ignore_middleware.py +182 -182
  256. tests/test_request_params.py +111 -111
  257. tests/test_request_serialization.py +70 -70
  258. tests/test_response_code_middleware.py +349 -349
  259. tests/test_response_filter_middleware.py +427 -427
  260. tests/test_response_improvements.py +152 -152
  261. tests/test_retry_middleware.py +241 -241
  262. tests/test_scheduler.py +252 -252
  263. tests/test_scheduler_config_update.py +133 -133
  264. tests/test_simple_response.py +61 -61
  265. tests/test_telecom_spider_redis_key.py +205 -205
  266. tests/test_template_content.py +87 -87
  267. tests/test_template_redis_key.py +134 -134
  268. tests/test_tools.py +159 -159
  269. tests/test_user_agents.py +96 -96
  270. tests/tools_example.py +260 -260
  271. tests/untested_features_report.md +139 -0
  272. tests/verify_debug.py +52 -0
  273. tests/verify_distributed.py +117 -117
  274. tests/verify_log_fix.py +112 -0
  275. crawlo-1.3.3.dist-info/RECORD +0 -219
  276. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +0 -82
  277. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/WHEEL +0 -0
  278. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/entry_points.txt +0 -0
  279. {crawlo-1.3.3.dist-info → crawlo-1.3.4.dist-info}/top_level.txt +0 -0
@@ -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}")