crawlo 1.2.8__py3-none-any.whl → 1.2.9__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 (221) hide show
  1. crawlo/__init__.py +63 -61
  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 +323 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +186 -186
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -251
  15. crawlo/core/__init__.py +2 -2
  16. crawlo/core/engine.py +366 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +256 -251
  19. crawlo/crawler.py +1103 -1100
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -107
  22. crawlo/downloader/__init__.py +273 -266
  23. crawlo/downloader/aiohttp_downloader.py +226 -228
  24. crawlo/downloader/cffi_downloader.py +245 -256
  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 +43 -43
  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/filters/__init__.py +154 -154
  40. crawlo/filters/aioredis_filter.py +234 -234
  41. crawlo/filters/memory_filter.py +269 -269
  42. crawlo/items/__init__.py +23 -23
  43. crawlo/items/base.py +21 -21
  44. crawlo/items/fields.py +52 -52
  45. crawlo/items/items.py +104 -104
  46. crawlo/middleware/__init__.py +21 -21
  47. crawlo/middleware/default_header.py +132 -132
  48. crawlo/middleware/download_delay.py +104 -104
  49. crawlo/middleware/middleware_manager.py +136 -136
  50. crawlo/middleware/offsite.py +114 -114
  51. crawlo/middleware/proxy.py +386 -368
  52. crawlo/middleware/request_ignore.py +86 -86
  53. crawlo/middleware/response_code.py +163 -163
  54. crawlo/middleware/response_filter.py +136 -136
  55. crawlo/middleware/retry.py +124 -124
  56. crawlo/middleware/simple_proxy.py +65 -0
  57. crawlo/mode_manager.py +211 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +379 -338
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +157 -157
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +223 -223
  66. crawlo/pipelines/json_pipeline.py +218 -218
  67. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  68. crawlo/pipelines/mongo_pipeline.py +131 -131
  69. crawlo/pipelines/mysql_pipeline.py +317 -317
  70. crawlo/pipelines/pipeline_manager.py +62 -62
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +290 -315
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +379 -378
  75. crawlo/queue/redis_priority_queue.py +306 -306
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +216 -220
  78. crawlo/settings/setting_manager.py +163 -122
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +129 -129
  82. crawlo/task_manager.py +30 -30
  83. crawlo/templates/crawlo.cfg.tmpl +10 -10
  84. crawlo/templates/project/__init__.py.tmpl +3 -3
  85. crawlo/templates/project/items.py.tmpl +17 -17
  86. crawlo/templates/project/middlewares.py.tmpl +118 -118
  87. crawlo/templates/project/pipelines.py.tmpl +96 -96
  88. crawlo/templates/project/settings.py.tmpl +261 -288
  89. crawlo/templates/project/settings_distributed.py.tmpl +174 -157
  90. crawlo/templates/project/settings_gentle.py.tmpl +95 -100
  91. crawlo/templates/project/settings_high_performance.py.tmpl +125 -134
  92. crawlo/templates/project/settings_minimal.py.tmpl +30 -0
  93. crawlo/templates/project/settings_simple.py.tmpl +96 -98
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +47 -47
  96. crawlo/templates/spider/spider.py.tmpl +143 -143
  97. crawlo/tools/__init__.py +200 -182
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/{cleaners → tools}/data_formatter.py +225 -225
  101. crawlo/tools/data_validator.py +180 -180
  102. crawlo/tools/date_tools.py +290 -36
  103. crawlo/tools/distributed_coordinator.py +388 -387
  104. crawlo/{cleaners → tools}/encoding_converter.py +127 -126
  105. crawlo/tools/request_tools.py +83 -0
  106. crawlo/tools/retry_mechanism.py +224 -221
  107. crawlo/tools/scenario_adapter.py +262 -262
  108. crawlo/{cleaners → tools}/text_cleaner.py +232 -232
  109. crawlo/utils/__init__.py +35 -35
  110. crawlo/utils/batch_processor.py +259 -259
  111. crawlo/utils/controlled_spider_mixin.py +439 -439
  112. crawlo/utils/db_helper.py +343 -343
  113. crawlo/utils/enhanced_error_handler.py +356 -356
  114. crawlo/utils/env_config.py +142 -142
  115. crawlo/utils/error_handler.py +123 -123
  116. crawlo/utils/func_tools.py +82 -82
  117. crawlo/utils/large_scale_config.py +286 -286
  118. crawlo/utils/large_scale_helper.py +344 -344
  119. crawlo/utils/log.py +187 -128
  120. crawlo/utils/performance_monitor.py +285 -285
  121. crawlo/utils/queue_helper.py +175 -175
  122. crawlo/utils/redis_connection_pool.py +351 -351
  123. crawlo/utils/redis_key_validator.py +198 -198
  124. crawlo/utils/request.py +267 -267
  125. crawlo/utils/request_serializer.py +218 -218
  126. crawlo/utils/spider_loader.py +61 -61
  127. crawlo/utils/system.py +11 -11
  128. crawlo/utils/tools.py +4 -4
  129. crawlo/utils/url.py +39 -39
  130. {crawlo-1.2.8.dist-info → crawlo-1.2.9.dist-info}/METADATA +1011 -764
  131. crawlo-1.2.9.dist-info/RECORD +219 -0
  132. examples/__init__.py +7 -7
  133. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  134. tests/__init__.py +7 -7
  135. tests/advanced_tools_example.py +275 -275
  136. tests/authenticated_proxy_example.py +107 -237
  137. tests/cleaners_example.py +160 -160
  138. tests/config_validation_demo.py +143 -103
  139. tests/controlled_spider_example.py +205 -205
  140. tests/date_tools_example.py +180 -180
  141. tests/debug_pipelines.py +67 -0
  142. tests/dynamic_loading_example.py +523 -523
  143. tests/dynamic_loading_test.py +104 -104
  144. tests/env_config_example.py +133 -133
  145. tests/error_handling_example.py +171 -171
  146. tests/redis_key_validation_demo.py +130 -130
  147. tests/request_params_example.py +151 -0
  148. tests/response_improvements_example.py +144 -144
  149. tests/test_advanced_tools.py +148 -148
  150. tests/test_all_redis_key_configs.py +145 -145
  151. tests/test_authenticated_proxy.py +141 -141
  152. tests/test_cleaners.py +54 -54
  153. tests/test_comprehensive.py +146 -146
  154. tests/test_config_consistency.py +80 -80
  155. tests/test_config_merge.py +153 -0
  156. tests/test_config_validator.py +182 -193
  157. tests/test_crawlo_proxy_integration.py +109 -173
  158. tests/test_date_tools.py +123 -123
  159. tests/test_default_header_middleware.py +158 -158
  160. tests/test_distributed.py +65 -0
  161. tests/test_double_crawlo_fix.py +207 -207
  162. tests/test_double_crawlo_fix_simple.py +124 -124
  163. tests/test_download_delay_middleware.py +221 -221
  164. tests/test_downloader_proxy_compatibility.py +268 -268
  165. tests/test_dynamic_downloaders_proxy.py +124 -124
  166. tests/test_dynamic_proxy.py +92 -92
  167. tests/test_dynamic_proxy_config.py +146 -146
  168. tests/test_dynamic_proxy_real.py +109 -109
  169. tests/test_edge_cases.py +303 -303
  170. tests/test_enhanced_error_handler.py +270 -270
  171. tests/test_env_config.py +121 -121
  172. tests/test_error_handler_compatibility.py +112 -112
  173. tests/test_final_validation.py +153 -153
  174. tests/test_framework_env_usage.py +103 -103
  175. tests/test_integration.py +169 -357
  176. tests/test_item_dedup_redis_key.py +122 -122
  177. tests/test_mode_consistency.py +51 -51
  178. tests/test_offsite_middleware.py +221 -221
  179. tests/test_parsel.py +29 -29
  180. tests/test_performance.py +327 -327
  181. tests/test_proxy_api.py +264 -264
  182. tests/test_proxy_health_check.py +32 -32
  183. tests/test_proxy_middleware.py +121 -121
  184. tests/test_proxy_middleware_enhanced.py +216 -216
  185. tests/test_proxy_middleware_integration.py +136 -136
  186. tests/test_proxy_middleware_refactored.py +185 -0
  187. tests/test_proxy_providers.py +56 -56
  188. tests/test_proxy_stats.py +19 -19
  189. tests/test_proxy_strategies.py +59 -59
  190. tests/test_queue_manager_double_crawlo.py +173 -173
  191. tests/test_queue_manager_redis_key.py +176 -176
  192. tests/test_random_user_agent.py +73 -0
  193. tests/test_real_scenario_proxy.py +195 -195
  194. tests/test_redis_config.py +28 -28
  195. tests/test_redis_connection_pool.py +294 -294
  196. tests/test_redis_key_naming.py +181 -181
  197. tests/test_redis_key_validator.py +123 -123
  198. tests/test_redis_queue.py +224 -224
  199. tests/test_request_ignore_middleware.py +182 -182
  200. tests/test_request_params.py +112 -0
  201. tests/test_request_serialization.py +70 -70
  202. tests/test_response_code_middleware.py +349 -349
  203. tests/test_response_filter_middleware.py +427 -427
  204. tests/test_response_improvements.py +152 -152
  205. tests/test_retry_middleware.py +241 -241
  206. tests/test_scheduler.py +252 -252
  207. tests/test_scheduler_config_update.py +133 -133
  208. tests/test_simple_response.py +61 -61
  209. tests/test_telecom_spider_redis_key.py +205 -205
  210. tests/test_template_content.py +87 -87
  211. tests/test_template_redis_key.py +134 -134
  212. tests/test_tools.py +159 -153
  213. tests/test_user_agents.py +97 -0
  214. tests/tools_example.py +260 -257
  215. tests/verify_distributed.py +117 -0
  216. crawlo/cleaners/__init__.py +0 -61
  217. crawlo/utils/date_tools.py +0 -290
  218. crawlo-1.2.8.dist-info/RECORD +0 -209
  219. {crawlo-1.2.8.dist-info → crawlo-1.2.9.dist-info}/WHEEL +0 -0
  220. {crawlo-1.2.8.dist-info → crawlo-1.2.9.dist-info}/entry_points.txt +0 -0
  221. {crawlo-1.2.8.dist-info → crawlo-1.2.9.dist-info}/top_level.txt +0 -0
@@ -1,222 +1,222 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- """
4
- DownloadDelayMiddleware 测试文件
5
- 用于测试下载延迟中间件的功能
6
- """
7
-
8
- import asyncio
9
- import unittest
10
- from unittest.mock import Mock, patch
11
-
12
- from crawlo.middleware.download_delay import DownloadDelayMiddleware
13
- from crawlo.exceptions import NotConfiguredError
14
- from crawlo.settings.setting_manager import SettingManager
15
-
16
-
17
- class MockLogger:
18
- """Mock Logger 类,用于测试日志输出"""
19
- def __init__(self, name, level=None):
20
- self.name = name
21
- self.level = level
22
- self.logs = []
23
-
24
- def debug(self, msg):
25
- self.logs.append(('debug', msg))
26
-
27
- def info(self, msg):
28
- self.logs.append(('info', msg))
29
-
30
- def warning(self, msg):
31
- self.logs.append(('warning', msg))
32
-
33
- def error(self, msg):
34
- self.logs.append(('error', msg))
35
-
36
-
37
- class MockStats:
38
- """Mock Stats 类,用于测试统计信息"""
39
- def __init__(self):
40
- self.stats = {}
41
-
42
- def inc_value(self, key, value=1):
43
- if key in self.stats:
44
- self.stats[key] += value
45
- else:
46
- self.stats[key] = value
47
-
48
-
49
- class TestDownloadDelayMiddleware(unittest.TestCase):
50
- """DownloadDelayMiddleware 测试类"""
51
-
52
- def setUp(self):
53
- """测试前准备"""
54
- # 创建设置管理器
55
- self.settings = SettingManager()
56
-
57
- # 创建爬虫模拟对象
58
- self.crawler = Mock()
59
- self.crawler.settings = self.settings
60
-
61
- # 创建请求和爬虫模拟对象
62
- self.request = Mock()
63
- self.spider = Mock()
64
-
65
- @patch('crawlo.utils.log.get_logger')
66
- def test_middleware_initialization_without_delay(self, mock_get_logger):
67
- """测试没有设置DOWNLOAD_DELAY时中间件初始化"""
68
- # 设置DOWNLOAD_DELAY为0
69
- self.settings.set('DOWNLOAD_DELAY', 0)
70
- mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
71
-
72
- # 应该抛出NotConfiguredError异常
73
- with self.assertRaises(NotConfiguredError) as context:
74
- DownloadDelayMiddleware.create_instance(self.crawler)
75
-
76
- self.assertIn("DOWNLOAD_DELAY not set or is zero", str(context.exception))
77
-
78
- @patch('crawlo.utils.log.get_logger')
79
- def test_middleware_initialization_with_delay(self, mock_get_logger):
80
- """测试正确设置DOWNLOAD_DELAY时中间件初始化"""
81
- # 设置DOWNLOAD_DELAY
82
- self.settings.set('DOWNLOAD_DELAY', 2.0)
83
- self.settings.set('RANDOMNESS', False)
84
- self.settings.set('RANDOM_RANGE', [0.5, 1.5])
85
- self.settings.set('LOG_LEVEL', 'INFO')
86
-
87
- mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
88
-
89
- # 应该正常创建实例
90
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
91
- self.assertIsInstance(middleware, DownloadDelayMiddleware)
92
- self.assertEqual(middleware.delay, 2.0)
93
- self.assertFalse(middleware.randomness)
94
-
95
- @patch('crawlo.utils.log.get_logger')
96
- def test_middleware_initialization_with_randomness(self, mock_get_logger):
97
- """测试启用随机延迟时中间件初始化"""
98
- # 设置DOWNLOAD_DELAY和随机配置
99
- self.settings.set('DOWNLOAD_DELAY', 1.0)
100
- self.settings.set('RANDOMNESS', True)
101
- self.settings.set('RANDOM_RANGE', [0.5, 2.0])
102
- self.settings.set('LOG_LEVEL', 'INFO')
103
-
104
- mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
105
-
106
- # 应该正常创建实例
107
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
108
- self.assertIsInstance(middleware, DownloadDelayMiddleware)
109
- self.assertEqual(middleware.delay, 1.0)
110
- self.assertTrue(middleware.randomness)
111
- self.assertEqual(middleware.floor, 0.5)
112
- self.assertEqual(middleware.upper, 2.0)
113
-
114
- @patch('crawlo.utils.log.get_logger')
115
- def test_middleware_initialization_with_invalid_random_range(self, mock_get_logger):
116
- """测试随机范围配置无效时中间件初始化"""
117
- # 设置DOWNLOAD_DELAY和无效的随机配置
118
- self.settings.set('DOWNLOAD_DELAY', 1.0)
119
- self.settings.set('RANDOMNESS', True)
120
- self.settings.set('RANDOM_RANGE', ['invalid', 'range'])
121
- self.settings.set('LOG_LEVEL', 'INFO')
122
-
123
- mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
124
-
125
- # 应该正常创建实例,使用默认随机范围
126
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
127
- self.assertIsInstance(middleware, DownloadDelayMiddleware)
128
- self.assertEqual(middleware.floor, 0.5)
129
- self.assertEqual(middleware.upper, 1.5)
130
-
131
- @patch('crawlo.utils.log.get_logger')
132
- def test_middleware_initialization_with_incomplete_random_range(self, mock_get_logger):
133
- """测试随机范围配置不完整时中间件初始化"""
134
- # 设置DOWNLOAD_DELAY和不完整的随机配置
135
- self.settings.set('DOWNLOAD_DELAY', 1.0)
136
- self.settings.set('RANDOMNESS', True)
137
- self.settings.set('RANDOM_RANGE', [0.8]) # 只有一个值
138
- self.settings.set('LOG_LEVEL', 'INFO')
139
-
140
- mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
141
-
142
- # 应该正常创建实例,使用默认随机范围
143
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
144
- self.assertIsInstance(middleware, DownloadDelayMiddleware)
145
- self.assertEqual(middleware.floor, 0.5)
146
- self.assertEqual(middleware.upper, 1.5)
147
-
148
- @patch('crawlo.middleware.download_delay.sleep')
149
- @patch('crawlo.utils.log.get_logger')
150
- def test_process_request_without_randomness(self, mock_get_logger, mock_sleep):
151
- """测试不启用随机延迟时的请求处理"""
152
- # 设置DOWNLOAD_DELAY
153
- self.settings.set('DOWNLOAD_DELAY', 1.5)
154
- self.settings.set('RANDOMNESS', False)
155
- self.settings.set('LOG_LEVEL', 'DEBUG') # 使用DEBUG级别以启用日志
156
-
157
- mock_logger = MockLogger('DownloadDelayMiddleware')
158
- mock_get_logger.return_value = mock_logger
159
-
160
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
161
-
162
- # 执行请求处理
163
- asyncio.run(middleware.process_request(self.request, self.spider))
164
-
165
- # 验证sleep被调用且参数正确
166
- mock_sleep.assert_called_once_with(1.5)
167
-
168
- @patch('crawlo.middleware.download_delay.sleep')
169
- @patch('crawlo.middleware.download_delay.uniform')
170
- @patch('crawlo.utils.log.get_logger')
171
- def test_process_request_with_randomness(self, mock_get_logger, mock_uniform, mock_sleep):
172
- """测试启用随机延迟时的请求处理"""
173
- # 设置DOWNLOAD_DELAY和随机配置
174
- self.settings.set('DOWNLOAD_DELAY', 2.0)
175
- self.settings.set('RANDOMNESS', True)
176
- self.settings.set('RANDOM_RANGE', [0.5, 1.5])
177
- self.settings.set('LOG_LEVEL', 'DEBUG') # 使用DEBUG级别以启用日志
178
-
179
- mock_logger = MockLogger('DownloadDelayMiddleware')
180
- mock_get_logger.return_value = mock_logger
181
- mock_uniform.return_value = 2.5 # 模拟随机数返回2.5
182
-
183
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
184
-
185
- # 执行请求处理
186
- asyncio.run(middleware.process_request(self.request, self.spider))
187
-
188
- # 验证uniform被调用且参数正确
189
- mock_uniform.assert_called_once_with(1.0, 3.0) # 2.0*0.5=1.0, 2.0*1.5=3.0
190
- # 验证sleep被调用且参数正确
191
- mock_sleep.assert_called_once_with(2.5)
192
-
193
- @patch('crawlo.middleware.download_delay.sleep')
194
- @patch('crawlo.utils.log.get_logger')
195
- def test_process_request_with_stats(self, mock_get_logger, mock_sleep):
196
- """测试带统计信息的请求处理"""
197
- # 设置DOWNLOAD_DELAY
198
- self.settings.set('DOWNLOAD_DELAY', 1.0)
199
- self.settings.set('RANDOMNESS', False)
200
- self.settings.set('LOG_LEVEL', 'INFO')
201
-
202
- # 添加统计收集器到爬虫
203
- mock_stats = MockStats()
204
- self.crawler.stats = mock_stats
205
-
206
- mock_logger = MockLogger('DownloadDelayMiddleware')
207
- mock_get_logger.return_value = mock_logger
208
-
209
- middleware = DownloadDelayMiddleware.create_instance(self.crawler)
210
-
211
- # 执行请求处理
212
- asyncio.run(middleware.process_request(self.request, self.spider))
213
-
214
- # 验证统计信息
215
- self.assertIn('download_delay/fixed_count', mock_stats.stats)
216
- self.assertEqual(mock_stats.stats['download_delay/fixed_count'], 1)
217
- self.assertIn('download_delay/fixed_total_time', mock_stats.stats)
218
- self.assertEqual(mock_stats.stats['download_delay/fixed_total_time'], 1.0)
219
-
220
-
221
- if __name__ == '__main__':
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ """
4
+ DownloadDelayMiddleware 测试文件
5
+ 用于测试下载延迟中间件的功能
6
+ """
7
+
8
+ import asyncio
9
+ import unittest
10
+ from unittest.mock import Mock, patch
11
+
12
+ from crawlo.middleware.download_delay import DownloadDelayMiddleware
13
+ from crawlo.exceptions import NotConfiguredError
14
+ from crawlo.settings.setting_manager import SettingManager
15
+
16
+
17
+ class MockLogger:
18
+ """Mock Logger 类,用于测试日志输出"""
19
+ def __init__(self, name, level=None):
20
+ self.name = name
21
+ self.level = level
22
+ self.logs = []
23
+
24
+ def debug(self, msg):
25
+ self.logs.append(('debug', msg))
26
+
27
+ def info(self, msg):
28
+ self.logs.append(('info', msg))
29
+
30
+ def warning(self, msg):
31
+ self.logs.append(('warning', msg))
32
+
33
+ def error(self, msg):
34
+ self.logs.append(('error', msg))
35
+
36
+
37
+ class MockStats:
38
+ """Mock Stats 类,用于测试统计信息"""
39
+ def __init__(self):
40
+ self.stats = {}
41
+
42
+ def inc_value(self, key, value=1):
43
+ if key in self.stats:
44
+ self.stats[key] += value
45
+ else:
46
+ self.stats[key] = value
47
+
48
+
49
+ class TestDownloadDelayMiddleware(unittest.TestCase):
50
+ """DownloadDelayMiddleware 测试类"""
51
+
52
+ def setUp(self):
53
+ """测试前准备"""
54
+ # 创建设置管理器
55
+ self.settings = SettingManager()
56
+
57
+ # 创建爬虫模拟对象
58
+ self.crawler = Mock()
59
+ self.crawler.settings = self.settings
60
+
61
+ # 创建请求和爬虫模拟对象
62
+ self.request = Mock()
63
+ self.spider = Mock()
64
+
65
+ @patch('crawlo.utils.log.get_logger')
66
+ def test_middleware_initialization_without_delay(self, mock_get_logger):
67
+ """测试没有设置DOWNLOAD_DELAY时中间件初始化"""
68
+ # 设置DOWNLOAD_DELAY为0
69
+ self.settings.set('DOWNLOAD_DELAY', 0)
70
+ mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
71
+
72
+ # 应该抛出NotConfiguredError异常
73
+ with self.assertRaises(NotConfiguredError) as context:
74
+ DownloadDelayMiddleware.create_instance(self.crawler)
75
+
76
+ self.assertIn("DOWNLOAD_DELAY not set or is zero", str(context.exception))
77
+
78
+ @patch('crawlo.utils.log.get_logger')
79
+ def test_middleware_initialization_with_delay(self, mock_get_logger):
80
+ """测试正确设置DOWNLOAD_DELAY时中间件初始化"""
81
+ # 设置DOWNLOAD_DELAY
82
+ self.settings.set('DOWNLOAD_DELAY', 2.0)
83
+ self.settings.set('RANDOMNESS', False)
84
+ self.settings.set('RANDOM_RANGE', [0.5, 1.5])
85
+ self.settings.set('LOG_LEVEL', 'INFO')
86
+
87
+ mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
88
+
89
+ # 应该正常创建实例
90
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
91
+ self.assertIsInstance(middleware, DownloadDelayMiddleware)
92
+ self.assertEqual(middleware.delay, 2.0)
93
+ self.assertFalse(middleware.randomness)
94
+
95
+ @patch('crawlo.utils.log.get_logger')
96
+ def test_middleware_initialization_with_randomness(self, mock_get_logger):
97
+ """测试启用随机延迟时中间件初始化"""
98
+ # 设置DOWNLOAD_DELAY和随机配置
99
+ self.settings.set('DOWNLOAD_DELAY', 1.0)
100
+ self.settings.set('RANDOMNESS', True)
101
+ self.settings.set('RANDOM_RANGE', [0.5, 2.0])
102
+ self.settings.set('LOG_LEVEL', 'INFO')
103
+
104
+ mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
105
+
106
+ # 应该正常创建实例
107
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
108
+ self.assertIsInstance(middleware, DownloadDelayMiddleware)
109
+ self.assertEqual(middleware.delay, 1.0)
110
+ self.assertTrue(middleware.randomness)
111
+ self.assertEqual(middleware.floor, 0.5)
112
+ self.assertEqual(middleware.upper, 2.0)
113
+
114
+ @patch('crawlo.utils.log.get_logger')
115
+ def test_middleware_initialization_with_invalid_random_range(self, mock_get_logger):
116
+ """测试随机范围配置无效时中间件初始化"""
117
+ # 设置DOWNLOAD_DELAY和无效的随机配置
118
+ self.settings.set('DOWNLOAD_DELAY', 1.0)
119
+ self.settings.set('RANDOMNESS', True)
120
+ self.settings.set('RANDOM_RANGE', ['invalid', 'range'])
121
+ self.settings.set('LOG_LEVEL', 'INFO')
122
+
123
+ mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
124
+
125
+ # 应该正常创建实例,使用默认随机范围
126
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
127
+ self.assertIsInstance(middleware, DownloadDelayMiddleware)
128
+ self.assertEqual(middleware.floor, 0.5)
129
+ self.assertEqual(middleware.upper, 1.5)
130
+
131
+ @patch('crawlo.utils.log.get_logger')
132
+ def test_middleware_initialization_with_incomplete_random_range(self, mock_get_logger):
133
+ """测试随机范围配置不完整时中间件初始化"""
134
+ # 设置DOWNLOAD_DELAY和不完整的随机配置
135
+ self.settings.set('DOWNLOAD_DELAY', 1.0)
136
+ self.settings.set('RANDOMNESS', True)
137
+ self.settings.set('RANDOM_RANGE', [0.8]) # 只有一个值
138
+ self.settings.set('LOG_LEVEL', 'INFO')
139
+
140
+ mock_get_logger.return_value = MockLogger('DownloadDelayMiddleware')
141
+
142
+ # 应该正常创建实例,使用默认随机范围
143
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
144
+ self.assertIsInstance(middleware, DownloadDelayMiddleware)
145
+ self.assertEqual(middleware.floor, 0.5)
146
+ self.assertEqual(middleware.upper, 1.5)
147
+
148
+ @patch('crawlo.middleware.download_delay.sleep')
149
+ @patch('crawlo.utils.log.get_logger')
150
+ def test_process_request_without_randomness(self, mock_get_logger, mock_sleep):
151
+ """测试不启用随机延迟时的请求处理"""
152
+ # 设置DOWNLOAD_DELAY
153
+ self.settings.set('DOWNLOAD_DELAY', 1.5)
154
+ self.settings.set('RANDOMNESS', False)
155
+ self.settings.set('LOG_LEVEL', 'DEBUG') # 使用DEBUG级别以启用日志
156
+
157
+ mock_logger = MockLogger('DownloadDelayMiddleware')
158
+ mock_get_logger.return_value = mock_logger
159
+
160
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
161
+
162
+ # 执行请求处理
163
+ asyncio.run(middleware.process_request(self.request, self.spider))
164
+
165
+ # 验证sleep被调用且参数正确
166
+ mock_sleep.assert_called_once_with(1.5)
167
+
168
+ @patch('crawlo.middleware.download_delay.sleep')
169
+ @patch('crawlo.middleware.download_delay.uniform')
170
+ @patch('crawlo.utils.log.get_logger')
171
+ def test_process_request_with_randomness(self, mock_get_logger, mock_uniform, mock_sleep):
172
+ """测试启用随机延迟时的请求处理"""
173
+ # 设置DOWNLOAD_DELAY和随机配置
174
+ self.settings.set('DOWNLOAD_DELAY', 2.0)
175
+ self.settings.set('RANDOMNESS', True)
176
+ self.settings.set('RANDOM_RANGE', [0.5, 1.5])
177
+ self.settings.set('LOG_LEVEL', 'DEBUG') # 使用DEBUG级别以启用日志
178
+
179
+ mock_logger = MockLogger('DownloadDelayMiddleware')
180
+ mock_get_logger.return_value = mock_logger
181
+ mock_uniform.return_value = 2.5 # 模拟随机数返回2.5
182
+
183
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
184
+
185
+ # 执行请求处理
186
+ asyncio.run(middleware.process_request(self.request, self.spider))
187
+
188
+ # 验证uniform被调用且参数正确
189
+ mock_uniform.assert_called_once_with(1.0, 3.0) # 2.0*0.5=1.0, 2.0*1.5=3.0
190
+ # 验证sleep被调用且参数正确
191
+ mock_sleep.assert_called_once_with(2.5)
192
+
193
+ @patch('crawlo.middleware.download_delay.sleep')
194
+ @patch('crawlo.utils.log.get_logger')
195
+ def test_process_request_with_stats(self, mock_get_logger, mock_sleep):
196
+ """测试带统计信息的请求处理"""
197
+ # 设置DOWNLOAD_DELAY
198
+ self.settings.set('DOWNLOAD_DELAY', 1.0)
199
+ self.settings.set('RANDOMNESS', False)
200
+ self.settings.set('LOG_LEVEL', 'INFO')
201
+
202
+ # 添加统计收集器到爬虫
203
+ mock_stats = MockStats()
204
+ self.crawler.stats = mock_stats
205
+
206
+ mock_logger = MockLogger('DownloadDelayMiddleware')
207
+ mock_get_logger.return_value = mock_logger
208
+
209
+ middleware = DownloadDelayMiddleware.create_instance(self.crawler)
210
+
211
+ # 执行请求处理
212
+ asyncio.run(middleware.process_request(self.request, self.spider))
213
+
214
+ # 验证统计信息
215
+ self.assertIn('download_delay/fixed_count', mock_stats.stats)
216
+ self.assertEqual(mock_stats.stats['download_delay/fixed_count'], 1)
217
+ self.assertIn('download_delay/fixed_total_time', mock_stats.stats)
218
+ self.assertEqual(mock_stats.stats['download_delay/fixed_total_time'], 1.0)
219
+
220
+
221
+ if __name__ == '__main__':
222
222
  unittest.main()