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,87 +1,87 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- """
4
- RequestIgnoreMiddleware 中间件
5
- 用于处理和记录被忽略的请求
6
- """
7
- from crawlo.utils.log import get_logger
8
- from crawlo.exceptions import IgnoreRequestError
9
- from crawlo.event import ignore_request
10
-
11
-
12
- class RequestIgnoreMiddleware(object):
13
- """
14
- RequestIgnoreMiddleware 中间件
15
- 用于处理和记录被忽略的请求,提供详细的统计信息
16
- """
17
-
18
- def __init__(self, stats, log_level):
19
- """
20
- 初始化中间件
21
-
22
- Args:
23
- stats: 统计信息收集器
24
- log_level: 日志级别
25
- """
26
- self.logger = get_logger(self.__class__.__name__, log_level)
27
- self.stats = stats
28
-
29
- @classmethod
30
- def create_instance(cls, crawler):
31
- """
32
- 创建中间件实例
33
-
34
- Args:
35
- crawler: 爬虫实例
36
-
37
- Returns:
38
- RequestIgnoreMiddleware: 中间件实例
39
- """
40
- o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
41
- crawler.subscriber.subscribe(o.request_ignore, event=ignore_request)
42
- return o
43
-
44
- async def request_ignore(self, exc, request, _spider):
45
- """
46
- 处理被忽略的请求事件
47
-
48
- Args:
49
- exc: 异常对象
50
- request: 被忽略的请求
51
- _spider: 爬虫实例
52
- """
53
- # 记录被忽略的请求
54
- self.logger.info(f'请求被忽略: {request.url}')
55
- self.stats.inc_value('request_ignore_count')
56
-
57
- # 记录忽略原因
58
- reason = getattr(exc, 'msg', 'unknown')
59
- if reason:
60
- self.stats.inc_value(f'request_ignore_count/reason/{reason}')
61
-
62
- # 记录请求的域名分布
63
- try:
64
- from urllib.parse import urlparse
65
- parsed_url = urlparse(request.url)
66
- domain = parsed_url.netloc
67
- if domain:
68
- self.stats.inc_value(f'request_ignore_count/domain/{domain}')
69
- except Exception:
70
- self.stats.inc_value('request_ignore_count/domain/invalid_url')
71
-
72
- @staticmethod
73
- def process_exception(_request, exc, _spider):
74
- """
75
- 处理异常,识别IgnoreRequestError
76
-
77
- Args:
78
- _request: 请求对象
79
- exc: 异常对象
80
- _spider: 爬虫实例
81
-
82
- Returns:
83
- bool: 如果是IgnoreRequestError则返回True,否则返回None
84
- """
85
- if isinstance(exc, IgnoreRequestError):
86
- return True
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ """
4
+ RequestIgnoreMiddleware 中间件
5
+ 用于处理和记录被忽略的请求
6
+ """
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.exceptions import IgnoreRequestError
9
+ from crawlo.event import ignore_request
10
+
11
+
12
+ class RequestIgnoreMiddleware(object):
13
+ """
14
+ RequestIgnoreMiddleware 中间件
15
+ 用于处理和记录被忽略的请求,提供详细的统计信息
16
+ """
17
+
18
+ def __init__(self, stats, log_level):
19
+ """
20
+ 初始化中间件
21
+
22
+ Args:
23
+ stats: 统计信息收集器
24
+ log_level: 日志级别
25
+ """
26
+ self.logger = get_logger(self.__class__.__name__, log_level)
27
+ self.stats = stats
28
+
29
+ @classmethod
30
+ def create_instance(cls, crawler):
31
+ """
32
+ 创建中间件实例
33
+
34
+ Args:
35
+ crawler: 爬虫实例
36
+
37
+ Returns:
38
+ RequestIgnoreMiddleware: 中间件实例
39
+ """
40
+ o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
41
+ crawler.subscriber.subscribe(o.request_ignore, event=ignore_request)
42
+ return o
43
+
44
+ async def request_ignore(self, exc, request, _spider):
45
+ """
46
+ 处理被忽略的请求事件
47
+
48
+ Args:
49
+ exc: 异常对象
50
+ request: 被忽略的请求
51
+ _spider: 爬虫实例
52
+ """
53
+ # 记录被忽略的请求
54
+ self.logger.info(f'请求被忽略: {request.url}')
55
+ self.stats.inc_value('request_ignore_count')
56
+
57
+ # 记录忽略原因
58
+ reason = getattr(exc, 'msg', 'unknown')
59
+ if reason:
60
+ self.stats.inc_value(f'request_ignore_count/reason/{reason}')
61
+
62
+ # 记录请求的域名分布
63
+ try:
64
+ from urllib.parse import urlparse
65
+ parsed_url = urlparse(request.url)
66
+ domain = parsed_url.netloc
67
+ if domain:
68
+ self.stats.inc_value(f'request_ignore_count/domain/{domain}')
69
+ except Exception:
70
+ self.stats.inc_value('request_ignore_count/domain/invalid_url')
71
+
72
+ @staticmethod
73
+ def process_exception(_request, exc, _spider):
74
+ """
75
+ 处理异常,识别IgnoreRequestError
76
+
77
+ Args:
78
+ _request: 请求对象
79
+ exc: 异常对象
80
+ _spider: 爬虫实例
81
+
82
+ Returns:
83
+ bool: 如果是IgnoreRequestError则返回True,否则返回None
84
+ """
85
+ if isinstance(exc, IgnoreRequestError):
86
+ return True
87
87
  return None
@@ -1,164 +1,164 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- """
4
- ResponseCodeMiddleware 中间件
5
- 用于处理HTTP响应状态码,记录统计信息并支持特殊状态码处理
6
- """
7
- from crawlo.utils.log import get_logger
8
-
9
-
10
- class ResponseCodeMiddleware(object):
11
- """
12
- ResponseCodeMiddleware 中间件
13
- 用于处理HTTP响应状态码,记录统计信息并支持特殊状态码处理
14
-
15
- 功能特性:
16
- - 记录各种HTTP状态码的出现次数
17
- - 支持特殊状态码的详细处理
18
- - 提供详细的日志信息
19
- - 支持状态码分类统计(2xx, 3xx, 4xx, 5xx)
20
- """
21
-
22
- def __init__(self, stats, log_level):
23
- """
24
- 初始化中间件
25
-
26
- Args:
27
- stats: 统计信息收集器
28
- log_level: 日志级别
29
- """
30
- self.logger = get_logger(self.__class__.__name__, log_level)
31
- self.stats = stats
32
-
33
- @classmethod
34
- def create_instance(cls, crawler):
35
- """
36
- 创建中间件实例
37
-
38
- Args:
39
- crawler: 爬虫实例
40
-
41
- Returns:
42
- ResponseCodeMiddleware: 中间件实例
43
- """
44
- o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
45
- return o
46
-
47
- def _get_status_category(self, status_code):
48
- """
49
- 获取状态码分类
50
-
51
- Args:
52
- status_code (int): HTTP状态码
53
-
54
- Returns:
55
- str: 状态码分类 (2xx, 3xx, 4xx, 5xx, other)
56
- """
57
- if 200 <= status_code < 300:
58
- return "2xx"
59
- elif 300 <= status_code < 400:
60
- return "3xx"
61
- elif 400 <= status_code < 500:
62
- return "4xx"
63
- elif 500 <= status_code < 600:
64
- return "5xx"
65
- else:
66
- return "other"
67
-
68
- def _is_success_response(self, status_code):
69
- """
70
- 判断是否为成功响应
71
-
72
- Args:
73
- status_code (int): HTTP状态码
74
-
75
- Returns:
76
- bool: 是否为成功响应
77
- """
78
- return 200 <= status_code < 300
79
-
80
- def _is_redirect_response(self, status_code):
81
- """
82
- 判断是否为重定向响应
83
-
84
- Args:
85
- status_code (int): HTTP状态码
86
-
87
- Returns:
88
- bool: 是否为重定向响应
89
- """
90
- return 300 <= status_code < 400
91
-
92
- def _is_client_error(self, status_code):
93
- """
94
- 判断是否为客户端错误
95
-
96
- Args:
97
- status_code (int): HTTP状态码
98
-
99
- Returns:
100
- bool: 是否为客户端错误
101
- """
102
- return 400 <= status_code < 500
103
-
104
- def _is_server_error(self, status_code):
105
- """
106
- 判断是否为服务器错误
107
-
108
- Args:
109
- status_code (int): HTTP状态码
110
-
111
- Returns:
112
- bool: 是否为服务器错误
113
- """
114
- return 500 <= status_code < 600
115
-
116
- def process_response(self, request, response, spider):
117
- """
118
- 处理响应,记录状态码统计信息
119
-
120
- Args:
121
- request: 请求对象
122
- response: 响应对象
123
- spider: 爬虫实例
124
-
125
- Returns:
126
- response: 响应对象
127
- """
128
- status_code = response.status_code
129
-
130
- # 记录具体状态码统计
131
- self.stats.inc_value(f'response_status_code/count/{status_code}')
132
-
133
- # 记录状态码分类统计
134
- category = self._get_status_category(status_code)
135
- self.stats.inc_value(f'response_status_code/category/{category}')
136
-
137
- # 记录成功/失败统计
138
- if self._is_success_response(status_code):
139
- self.stats.inc_value('response_status_code/success_count')
140
- elif self._is_client_error(status_code) or self._is_server_error(status_code):
141
- self.stats.inc_value('response_status_code/error_count')
142
-
143
- # 记录响应大小统计
144
- if hasattr(response, 'content_length') and response.content_length:
145
- self.stats.inc_value('response_total_bytes', response.content_length)
146
-
147
- # 记录域名统计
148
- try:
149
- from urllib.parse import urlparse
150
- parsed_url = urlparse(response.url)
151
- domain = parsed_url.netloc
152
- if domain:
153
- self.stats.inc_value(f'response_status_code/domain/{domain}/count/{status_code}')
154
- self.stats.inc_value(f'response_status_code/domain/{domain}/category/{category}')
155
- except Exception:
156
- self.stats.inc_value('response_status_code/domain/invalid_url/count/{status_code}')
157
-
158
- # 详细日志记录
159
- self.logger.debug(
160
- f'收到响应: {status_code} {response.url} '
161
- f'(分类: {category}, 大小: {getattr(response, "content_length", "unknown")} bytes)'
162
- )
163
-
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ """
4
+ ResponseCodeMiddleware 中间件
5
+ 用于处理HTTP响应状态码,记录统计信息并支持特殊状态码处理
6
+ """
7
+ from crawlo.utils.log import get_logger
8
+
9
+
10
+ class ResponseCodeMiddleware(object):
11
+ """
12
+ ResponseCodeMiddleware 中间件
13
+ 用于处理HTTP响应状态码,记录统计信息并支持特殊状态码处理
14
+
15
+ 功能特性:
16
+ - 记录各种HTTP状态码的出现次数
17
+ - 支持特殊状态码的详细处理
18
+ - 提供详细的日志信息
19
+ - 支持状态码分类统计(2xx, 3xx, 4xx, 5xx)
20
+ """
21
+
22
+ def __init__(self, stats, log_level):
23
+ """
24
+ 初始化中间件
25
+
26
+ Args:
27
+ stats: 统计信息收集器
28
+ log_level: 日志级别
29
+ """
30
+ self.logger = get_logger(self.__class__.__name__, log_level)
31
+ self.stats = stats
32
+
33
+ @classmethod
34
+ def create_instance(cls, crawler):
35
+ """
36
+ 创建中间件实例
37
+
38
+ Args:
39
+ crawler: 爬虫实例
40
+
41
+ Returns:
42
+ ResponseCodeMiddleware: 中间件实例
43
+ """
44
+ o = cls(stats=crawler.stats, log_level=crawler.settings.get('LOG_LEVEL'))
45
+ return o
46
+
47
+ def _get_status_category(self, status_code):
48
+ """
49
+ 获取状态码分类
50
+
51
+ Args:
52
+ status_code (int): HTTP状态码
53
+
54
+ Returns:
55
+ str: 状态码分类 (2xx, 3xx, 4xx, 5xx, other)
56
+ """
57
+ if 200 <= status_code < 300:
58
+ return "2xx"
59
+ elif 300 <= status_code < 400:
60
+ return "3xx"
61
+ elif 400 <= status_code < 500:
62
+ return "4xx"
63
+ elif 500 <= status_code < 600:
64
+ return "5xx"
65
+ else:
66
+ return "other"
67
+
68
+ def _is_success_response(self, status_code):
69
+ """
70
+ 判断是否为成功响应
71
+
72
+ Args:
73
+ status_code (int): HTTP状态码
74
+
75
+ Returns:
76
+ bool: 是否为成功响应
77
+ """
78
+ return 200 <= status_code < 300
79
+
80
+ def _is_redirect_response(self, status_code):
81
+ """
82
+ 判断是否为重定向响应
83
+
84
+ Args:
85
+ status_code (int): HTTP状态码
86
+
87
+ Returns:
88
+ bool: 是否为重定向响应
89
+ """
90
+ return 300 <= status_code < 400
91
+
92
+ def _is_client_error(self, status_code):
93
+ """
94
+ 判断是否为客户端错误
95
+
96
+ Args:
97
+ status_code (int): HTTP状态码
98
+
99
+ Returns:
100
+ bool: 是否为客户端错误
101
+ """
102
+ return 400 <= status_code < 500
103
+
104
+ def _is_server_error(self, status_code):
105
+ """
106
+ 判断是否为服务器错误
107
+
108
+ Args:
109
+ status_code (int): HTTP状态码
110
+
111
+ Returns:
112
+ bool: 是否为服务器错误
113
+ """
114
+ return 500 <= status_code < 600
115
+
116
+ def process_response(self, request, response, spider):
117
+ """
118
+ 处理响应,记录状态码统计信息
119
+
120
+ Args:
121
+ request: 请求对象
122
+ response: 响应对象
123
+ spider: 爬虫实例
124
+
125
+ Returns:
126
+ response: 响应对象
127
+ """
128
+ status_code = response.status_code
129
+
130
+ # 记录具体状态码统计
131
+ self.stats.inc_value(f'response_status_code/count/{status_code}')
132
+
133
+ # 记录状态码分类统计
134
+ category = self._get_status_category(status_code)
135
+ self.stats.inc_value(f'response_status_code/category/{category}')
136
+
137
+ # 记录成功/失败统计
138
+ if self._is_success_response(status_code):
139
+ self.stats.inc_value('response_status_code/success_count')
140
+ elif self._is_client_error(status_code) or self._is_server_error(status_code):
141
+ self.stats.inc_value('response_status_code/error_count')
142
+
143
+ # 记录响应大小统计
144
+ if hasattr(response, 'content_length') and response.content_length:
145
+ self.stats.inc_value('response_total_bytes', response.content_length)
146
+
147
+ # 记录域名统计
148
+ try:
149
+ from urllib.parse import urlparse
150
+ parsed_url = urlparse(response.url)
151
+ domain = parsed_url.netloc
152
+ if domain:
153
+ self.stats.inc_value(f'response_status_code/domain/{domain}/count/{status_code}')
154
+ self.stats.inc_value(f'response_status_code/domain/{domain}/category/{category}')
155
+ except Exception:
156
+ self.stats.inc_value('response_status_code/domain/invalid_url/count/{status_code}')
157
+
158
+ # 详细日志记录
159
+ self.logger.debug(
160
+ f'收到响应: {status_code} {response.url} '
161
+ f'(分类: {category}, 大小: {getattr(response, "content_length", "unknown")} bytes)'
162
+ )
163
+
164
164
  return response