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
@@ -0,0 +1,114 @@
1
+ #!/usr/bin/env python
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ 队列阻塞行为测试脚本
5
+ 验证队列满时的阻塞行为
6
+ """
7
+
8
+ import sys
9
+ import os
10
+ import asyncio
11
+ import time
12
+ sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
13
+
14
+ from crawlo.network.request import Request
15
+ from crawlo.queue.queue_manager import QueueConfig, QueueManager
16
+
17
+
18
+ async def test_queue_blocking_behavior():
19
+ """测试队列阻塞行为"""
20
+ print("开始测试队列阻塞行为...")
21
+
22
+ # 初始化框架
23
+ from crawlo.initialization import initialize_framework
24
+ settings = initialize_framework()
25
+
26
+ # 创建一个小型队列配置进行测试
27
+ settings.set('SCHEDULER_MAX_QUEUE_SIZE', 5) # 设置非常小的队列大小
28
+
29
+ # 创建队列配置
30
+ queue_config = QueueConfig.from_settings(settings)
31
+ queue_config.max_queue_size = 5 # 设置小队列大小进行测试
32
+
33
+ # 创建队列管理器
34
+ queue_manager = QueueManager(queue_config)
35
+
36
+ # 初始化队列
37
+ await queue_manager.initialize()
38
+
39
+ print(f"队列类型: {queue_manager._queue_type}")
40
+ print(f"队列最大大小: {queue_config.max_queue_size}")
41
+
42
+ # 创建生产者任务
43
+ async def producer(queue_manager, name, count):
44
+ """生产者:向队列添加请求"""
45
+ print(f"生产者 {name} 开始工作,将添加 {count} 个请求")
46
+ start_time = time.time()
47
+
48
+ for i in range(count):
49
+ request = Request(url=f'https://example.com/page{name}_{i}.html')
50
+ try:
51
+ # 这里应该会阻塞当队列满时
52
+ await queue_manager.put(request)
53
+ print(f"生产者 {name} 成功添加请求 {i}")
54
+ except Exception as e:
55
+ print(f"生产者 {name} 添加请求 {i} 失败: {e}")
56
+
57
+ end_time = time.time()
58
+ print(f"生产者 {name} 完成工作,耗时 {end_time - start_time:.2f} 秒")
59
+
60
+ # 创建消费者任务
61
+ async def consumer(queue_manager, name, count):
62
+ """消费者:从队列获取请求"""
63
+ print(f"消费者 {name} 开始工作,将获取 {count} 个请求")
64
+ start_time = time.time()
65
+
66
+ retrieved_count = 0
67
+ while retrieved_count < count:
68
+ try:
69
+ request = await queue_manager.get(timeout=2.0)
70
+ if request:
71
+ print(f"消费者 {name} 成功获取请求: {request.url}")
72
+ retrieved_count += 1
73
+ # 模拟处理时间
74
+ await asyncio.sleep(0.1)
75
+ else:
76
+ print(f"消费者 {name} 超时,没有获取到请求")
77
+ break
78
+ except Exception as e:
79
+ print(f"消费者 {name} 获取请求失败: {e}")
80
+ break
81
+
82
+ end_time = time.time()
83
+ print(f"消费者 {name} 完成工作,获取了 {retrieved_count} 个请求,耗时 {end_time - start_time:.2f} 秒")
84
+
85
+ # 同时运行生产者和消费者
86
+ print("开始并发测试...")
87
+
88
+ # 生产者尝试添加10个请求到大小为5的队列
89
+ # 消费者会逐渐消费,生产者应该会被阻塞直到有空间
90
+ tasks = [
91
+ asyncio.create_task(producer(queue_manager, "P1", 10)),
92
+ asyncio.create_task(consumer(queue_manager, "C1", 10))
93
+ ]
94
+
95
+ # 等待所有任务完成
96
+ await asyncio.gather(*tasks, return_exceptions=True)
97
+
98
+ final_queue_size = await queue_manager.size()
99
+ print(f"队列最终大小: {final_queue_size}")
100
+
101
+ # 关闭队列
102
+ await queue_manager.close()
103
+
104
+ print("队列阻塞行为测试完成!")
105
+
106
+
107
+ def main():
108
+ """主函数"""
109
+ print("开始队列阻塞行为测试...")
110
+ asyncio.run(test_queue_blocking_behavior())
111
+
112
+
113
+ if __name__ == "__main__":
114
+ main()
tests/queue_test.py ADDED
@@ -0,0 +1,90 @@
1
+ #!/usr/bin/env python
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ 队列系统测试脚本
5
+ """
6
+
7
+ import sys
8
+ import os
9
+ import asyncio
10
+ sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
11
+
12
+ from crawlo.network.request import Request
13
+ from crawlo.queue.queue_manager import QueueConfig, QueueManager
14
+
15
+
16
+ async def test_queue_system():
17
+ """测试队列系统"""
18
+ print("开始测试队列系统...")
19
+
20
+ # 初始化框架
21
+ from crawlo.initialization import initialize_framework
22
+ settings = initialize_framework()
23
+
24
+ # 创建一个小型队列配置进行测试
25
+ settings.set('SCHEDULER_MAX_QUEUE_SIZE', 10)
26
+
27
+ # 创建队列配置
28
+ queue_config = QueueConfig.from_settings(settings)
29
+ queue_config.max_queue_size = 10 # 设置小队列大小进行测试
30
+
31
+ # 创建队列管理器
32
+ queue_manager = QueueManager(queue_config)
33
+
34
+ # 初始化队列
35
+ await queue_manager.initialize()
36
+
37
+ print(f"队列类型: {queue_manager._queue_type}")
38
+ print(f"队列最大大小: {queue_config.max_queue_size}")
39
+
40
+ # 测试添加请求到队列
41
+ print("测试添加请求到队列...")
42
+ tasks = []
43
+ for i in range(15): # 尝试添加15个请求,超过队列大小
44
+ request = Request(url=f'https://example.com/page{i}.html')
45
+ task = asyncio.create_task(queue_manager.put(request))
46
+ tasks.append(task)
47
+
48
+ # 等待所有任务完成
49
+ results = await asyncio.gather(*tasks, return_exceptions=True)
50
+
51
+ success_count = sum(1 for result in results if result is True)
52
+ print(f"成功添加 {success_count} 个请求到队列")
53
+
54
+ queue_size = await queue_manager.size()
55
+ print(f"队列当前大小: {queue_size}")
56
+
57
+ # 测试从队列获取请求
58
+ print("测试从队列获取请求...")
59
+ retrieved_count = 0
60
+ while retrieved_count < 15:
61
+ try:
62
+ request = await queue_manager.get(timeout=1.0)
63
+ if request:
64
+ print(f"成功获取请求: {request.url}")
65
+ retrieved_count += 1
66
+ else:
67
+ break
68
+ except Exception as e:
69
+ print(f"获取请求失败: {e}")
70
+ break
71
+
72
+ print(f"总共获取了 {retrieved_count} 个请求")
73
+
74
+ final_queue_size = await queue_manager.size()
75
+ print(f"队列最终大小: {final_queue_size}")
76
+
77
+ # 关闭队列
78
+ await queue_manager.close()
79
+
80
+ print("队列系统测试完成!")
81
+
82
+
83
+ def main():
84
+ """主函数"""
85
+ print("开始队列系统测试...")
86
+ asyncio.run(test_queue_system())
87
+
88
+
89
+ if __name__ == "__main__":
90
+ main()
@@ -1,131 +1,131 @@
1
- #!/usr/bin/env python3
2
- # -*- coding: utf-8 -*-
3
- """
4
- Redis Key 验证演示脚本
5
- 演示如何使用Redis Key验证工具
6
- """
7
- import sys
8
- import os
9
-
10
- # 添加项目根目录到路径
11
- sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
12
-
13
- from crawlo.utils.redis_key_validator import (
14
- RedisKeyValidator,
15
- validate_redis_key_naming,
16
- validate_multiple_redis_keys,
17
- get_redis_key_info,
18
- print_validation_report
19
- )
20
-
21
-
22
- def demonstrate_redis_key_validation():
23
- """演示Redis Key验证功能"""
24
- print("=== Redis Key 验证功能演示 ===\n")
25
-
26
- # 1. 验证单个有效的Redis Key
27
- print("1. 验证单个有效的Redis Key:")
28
- valid_keys = [
29
- "crawlo:books_distributed:filter:fingerprint",
30
- "crawlo:books_distributed:queue:requests",
31
- "crawlo:books_distributed:queue:processing",
32
- "crawlo:books_distributed:queue:failed",
33
- "crawlo:books_distributed:item:fingerprint"
34
- ]
35
-
36
- for key in valid_keys:
37
- is_valid = validate_redis_key_naming(key, "books_distributed")
38
- print(f" {key} - {'通过' if is_valid else '失败'}")
39
-
40
- print()
41
-
42
- # 2. 验证无效的Redis Key
43
- print("2. 验证无效的Redis Key:")
44
- invalid_keys = [
45
- "invalid_format", # 不以crawlo开头
46
- "crawlo:books_distributed", # 部分缺失
47
- "crawlo:books_distributed:invalid_component:fingerprint", # 无效组件
48
- "crawlo:books_distributed:queue:invalid_subcomponent", # 无效子组件
49
- "crawlo:wrong_project:filter:fingerprint" # 项目名称不匹配
50
- ]
51
-
52
- for key in invalid_keys:
53
- is_valid = validate_redis_key_naming(key, "books_distributed")
54
- print(f" {key} - {'通过' if is_valid else '失败'}")
55
-
56
- print()
57
-
58
- # 3. 批量验证Redis Key
59
- print("3. 批量验证Redis Key:")
60
- all_keys = valid_keys + invalid_keys
61
- is_valid, invalid_keys_list = validate_multiple_redis_keys(all_keys, "books_distributed")
62
-
63
- print(f" 批量验证结果: {'全部通过' if is_valid else '存在无效Key'}")
64
- if not is_valid:
65
- print(" 无效的Key:")
66
- for key in invalid_keys_list:
67
- print(f" - {key}")
68
-
69
- print()
70
-
71
- # 4. 获取Redis Key信息
72
- print("4. 获取Redis Key信息:")
73
- sample_keys = [
74
- "crawlo:api_data_collection:filter:fingerprint",
75
- "crawlo:api_data_collection:queue:requests",
76
- "crawlo:api_data_collection:item:fingerprint"
77
- ]
78
-
79
- for key in sample_keys:
80
- info = get_redis_key_info(key)
81
- print(f" Key: {key}")
82
- if info['valid']:
83
- print(f" 框架: {info['framework']}")
84
- print(f" 项目: {info['project']}")
85
- print(f" 组件: {info['component']}")
86
- if 'sub_component' in info:
87
- print(f" 子组件: {info['sub_component']}")
88
- else:
89
- print(f" 错误: {info.get('error', '无效')}")
90
- print()
91
-
92
- # 5. 打印验证报告
93
- print("5. 打印验证报告:")
94
- print_validation_report(all_keys, "books_distributed")
95
-
96
-
97
- def demonstrate_advanced_validation():
98
- """演示高级验证功能"""
99
- print("\n=== 高级验证功能演示 ===\n")
100
-
101
- validator = RedisKeyValidator()
102
-
103
- # 1. 不指定项目名称的验证
104
- print("1. 不指定项目名称的验证:")
105
- key = "crawlo:any_project:filter:fingerprint"
106
- is_valid = validator.validate_key_naming(key) # 不指定项目名称
107
- print(f" {key} - {'通过' if is_valid else '失败'}")
108
-
109
- # 2. 验证不同项目的Key
110
- print("\n2. 验证不同项目的Key:")
111
- project_keys = {
112
- "books_distributed": [
113
- "crawlo:books_distributed:filter:fingerprint",
114
- "crawlo:books_distributed:queue:requests"
115
- ],
116
- "api_data_collection": [
117
- "crawlo:api_data_collection:filter:fingerprint",
118
- "crawlo:api_data_collection:queue:requests"
119
- ]
120
- }
121
-
122
- for project_name, keys in project_keys.items():
123
- print(f" 项目: {project_name}")
124
- for key in keys:
125
- is_valid = validator.validate_key_naming(key, project_name)
126
- print(f" {key} - {'通过' if is_valid else '失败'}")
127
-
128
-
129
- if __name__ == "__main__":
130
- demonstrate_redis_key_validation()
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """
4
+ Redis Key 验证演示脚本
5
+ 演示如何使用Redis Key验证工具
6
+ """
7
+ import sys
8
+ import os
9
+
10
+ # 添加项目根目录到路径
11
+ sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
12
+
13
+ from crawlo.utils.redis_key_validator import (
14
+ RedisKeyValidator,
15
+ validate_redis_key_naming,
16
+ validate_multiple_redis_keys,
17
+ get_redis_key_info,
18
+ print_validation_report
19
+ )
20
+
21
+
22
+ def demonstrate_redis_key_validation():
23
+ """演示Redis Key验证功能"""
24
+ print("=== Redis Key 验证功能演示 ===\n")
25
+
26
+ # 1. 验证单个有效的Redis Key
27
+ print("1. 验证单个有效的Redis Key:")
28
+ valid_keys = [
29
+ "crawlo:books_distributed:filter:fingerprint",
30
+ "crawlo:books_distributed:queue:requests",
31
+ "crawlo:books_distributed:queue:processing",
32
+ "crawlo:books_distributed:queue:failed",
33
+ "crawlo:books_distributed:item:fingerprint"
34
+ ]
35
+
36
+ for key in valid_keys:
37
+ is_valid = validate_redis_key_naming(key, "books_distributed")
38
+ print(f" {key} - {'通过' if is_valid else '失败'}")
39
+
40
+ print()
41
+
42
+ # 2. 验证无效的Redis Key
43
+ print("2. 验证无效的Redis Key:")
44
+ invalid_keys = [
45
+ "invalid_format", # 不以crawlo开头
46
+ "crawlo:books_distributed", # 部分缺失
47
+ "crawlo:books_distributed:invalid_component:fingerprint", # 无效组件
48
+ "crawlo:books_distributed:queue:invalid_subcomponent", # 无效子组件
49
+ "crawlo:wrong_project:filter:fingerprint" # 项目名称不匹配
50
+ ]
51
+
52
+ for key in invalid_keys:
53
+ is_valid = validate_redis_key_naming(key, "books_distributed")
54
+ print(f" {key} - {'通过' if is_valid else '失败'}")
55
+
56
+ print()
57
+
58
+ # 3. 批量验证Redis Key
59
+ print("3. 批量验证Redis Key:")
60
+ all_keys = valid_keys + invalid_keys
61
+ is_valid, invalid_keys_list = validate_multiple_redis_keys(all_keys, "books_distributed")
62
+
63
+ print(f" 批量验证结果: {'全部通过' if is_valid else '存在无效Key'}")
64
+ if not is_valid:
65
+ print(" 无效的Key:")
66
+ for key in invalid_keys_list:
67
+ print(f" - {key}")
68
+
69
+ print()
70
+
71
+ # 4. 获取Redis Key信息
72
+ print("4. 获取Redis Key信息:")
73
+ sample_keys = [
74
+ "crawlo:api_data_collection:filter:fingerprint",
75
+ "crawlo:api_data_collection:queue:requests",
76
+ "crawlo:api_data_collection:item:fingerprint"
77
+ ]
78
+
79
+ for key in sample_keys:
80
+ info = get_redis_key_info(key)
81
+ print(f" Key: {key}")
82
+ if info['valid']:
83
+ print(f" 框架: {info['framework']}")
84
+ print(f" 项目: {info['project']}")
85
+ print(f" 组件: {info['component']}")
86
+ if 'sub_component' in info:
87
+ print(f" 子组件: {info['sub_component']}")
88
+ else:
89
+ print(f" 错误: {info.get('error', '无效')}")
90
+ print()
91
+
92
+ # 5. 打印验证报告
93
+ print("5. 打印验证报告:")
94
+ print_validation_report(all_keys, "books_distributed")
95
+
96
+
97
+ def demonstrate_advanced_validation():
98
+ """演示高级验证功能"""
99
+ print("\n=== 高级验证功能演示 ===\n")
100
+
101
+ validator = RedisKeyValidator()
102
+
103
+ # 1. 不指定项目名称的验证
104
+ print("1. 不指定项目名称的验证:")
105
+ key = "crawlo:any_project:filter:fingerprint"
106
+ is_valid = validator.validate_key_naming(key) # 不指定项目名称
107
+ print(f" {key} - {'通过' if is_valid else '失败'}")
108
+
109
+ # 2. 验证不同项目的Key
110
+ print("\n2. 验证不同项目的Key:")
111
+ project_keys = {
112
+ "books_distributed": [
113
+ "crawlo:books_distributed:filter:fingerprint",
114
+ "crawlo:books_distributed:queue:requests"
115
+ ],
116
+ "api_data_collection": [
117
+ "crawlo:api_data_collection:filter:fingerprint",
118
+ "crawlo:api_data_collection:queue:requests"
119
+ ]
120
+ }
121
+
122
+ for project_name, keys in project_keys.items():
123
+ print(f" 项目: {project_name}")
124
+ for key in keys:
125
+ is_valid = validator.validate_key_naming(key, project_name)
126
+ print(f" {key} - {'通过' if is_valid else '失败'}")
127
+
128
+
129
+ if __name__ == "__main__":
130
+ demonstrate_redis_key_validation()
131
131
  demonstrate_advanced_validation()