crawlo 1.2.3__py3-none-any.whl → 1.2.5__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 (222) hide show
  1. crawlo/__init__.py +61 -61
  2. crawlo/__version__.py +1 -1
  3. crawlo/cleaners/__init__.py +60 -60
  4. crawlo/cleaners/data_formatter.py +225 -225
  5. crawlo/cleaners/encoding_converter.py +125 -125
  6. crawlo/cleaners/text_cleaner.py +232 -232
  7. crawlo/cli.py +88 -81
  8. crawlo/commands/__init__.py +14 -14
  9. crawlo/commands/check.py +594 -594
  10. crawlo/commands/genspider.py +151 -151
  11. crawlo/commands/help.py +144 -142
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +323 -292
  14. crawlo/commands/startproject.py +436 -417
  15. crawlo/commands/stats.py +187 -187
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +251 -251
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +354 -354
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +143 -143
  23. crawlo/crawler.py +1110 -1027
  24. crawlo/data/__init__.py +5 -5
  25. crawlo/data/user_agents.py +107 -107
  26. crawlo/downloader/__init__.py +266 -266
  27. crawlo/downloader/aiohttp_downloader.py +220 -220
  28. crawlo/downloader/cffi_downloader.py +256 -256
  29. crawlo/downloader/httpx_downloader.py +259 -259
  30. crawlo/downloader/hybrid_downloader.py +212 -212
  31. crawlo/downloader/playwright_downloader.py +402 -402
  32. crawlo/downloader/selenium_downloader.py +472 -472
  33. crawlo/event.py +11 -11
  34. crawlo/exceptions.py +81 -81
  35. crawlo/extension/__init__.py +37 -37
  36. crawlo/extension/health_check.py +141 -141
  37. crawlo/extension/log_interval.py +57 -57
  38. crawlo/extension/log_stats.py +81 -81
  39. crawlo/extension/logging_extension.py +43 -43
  40. crawlo/extension/memory_monitor.py +104 -104
  41. crawlo/extension/performance_profiler.py +133 -133
  42. crawlo/extension/request_recorder.py +107 -107
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +280 -280
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/items/__init__.py +23 -23
  47. crawlo/items/base.py +21 -21
  48. crawlo/items/fields.py +52 -52
  49. crawlo/items/items.py +104 -104
  50. crawlo/middleware/__init__.py +21 -21
  51. crawlo/middleware/default_header.py +131 -131
  52. crawlo/middleware/download_delay.py +104 -104
  53. crawlo/middleware/middleware_manager.py +135 -135
  54. crawlo/middleware/offsite.py +114 -114
  55. crawlo/middleware/proxy.py +367 -367
  56. crawlo/middleware/request_ignore.py +86 -86
  57. crawlo/middleware/response_code.py +163 -163
  58. crawlo/middleware/response_filter.py +136 -136
  59. crawlo/middleware/retry.py +124 -124
  60. crawlo/mode_manager.py +211 -211
  61. crawlo/network/__init__.py +21 -21
  62. crawlo/network/request.py +338 -338
  63. crawlo/network/response.py +359 -359
  64. crawlo/pipelines/__init__.py +21 -21
  65. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  66. crawlo/pipelines/console_pipeline.py +39 -39
  67. crawlo/pipelines/csv_pipeline.py +316 -316
  68. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  69. crawlo/pipelines/json_pipeline.py +218 -218
  70. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  71. crawlo/pipelines/mongo_pipeline.py +131 -131
  72. crawlo/pipelines/mysql_pipeline.py +317 -317
  73. crawlo/pipelines/pipeline_manager.py +61 -61
  74. crawlo/pipelines/redis_dedup_pipeline.py +165 -165
  75. crawlo/project.py +279 -187
  76. crawlo/queue/pqueue.py +37 -37
  77. crawlo/queue/queue_manager.py +337 -337
  78. crawlo/queue/redis_priority_queue.py +298 -298
  79. crawlo/settings/__init__.py +7 -7
  80. crawlo/settings/default_settings.py +217 -226
  81. crawlo/settings/setting_manager.py +122 -122
  82. crawlo/spider/__init__.py +639 -639
  83. crawlo/stats_collector.py +59 -59
  84. crawlo/subscriber.py +129 -129
  85. crawlo/task_manager.py +30 -30
  86. crawlo/templates/crawlo.cfg.tmpl +10 -10
  87. crawlo/templates/project/__init__.py.tmpl +3 -3
  88. crawlo/templates/project/items.py.tmpl +17 -17
  89. crawlo/templates/project/middlewares.py.tmpl +118 -118
  90. crawlo/templates/project/pipelines.py.tmpl +96 -96
  91. crawlo/templates/project/settings.py.tmpl +324 -325
  92. crawlo/templates/project/settings_distributed.py.tmpl +154 -121
  93. crawlo/templates/project/settings_gentle.py.tmpl +127 -94
  94. crawlo/templates/project/settings_high_performance.py.tmpl +149 -151
  95. crawlo/templates/project/settings_simple.py.tmpl +102 -68
  96. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  97. crawlo/templates/{project/run.py.tmpl → run.py.tmpl} +47 -45
  98. crawlo/templates/spider/spider.py.tmpl +143 -143
  99. crawlo/tools/__init__.py +182 -182
  100. crawlo/tools/anti_crawler.py +268 -268
  101. crawlo/tools/authenticated_proxy.py +240 -240
  102. crawlo/tools/data_validator.py +180 -180
  103. crawlo/tools/date_tools.py +35 -35
  104. crawlo/tools/distributed_coordinator.py +386 -386
  105. crawlo/tools/retry_mechanism.py +220 -220
  106. crawlo/tools/scenario_adapter.py +262 -262
  107. crawlo/utils/__init__.py +35 -35
  108. crawlo/utils/batch_processor.py +259 -259
  109. crawlo/utils/controlled_spider_mixin.py +439 -439
  110. crawlo/utils/date_tools.py +290 -290
  111. crawlo/utils/db_helper.py +343 -343
  112. crawlo/utils/enhanced_error_handler.py +356 -356
  113. crawlo/utils/env_config.py +105 -105
  114. crawlo/utils/error_handler.py +123 -123
  115. crawlo/utils/func_tools.py +82 -82
  116. crawlo/utils/large_scale_config.py +286 -286
  117. crawlo/utils/large_scale_helper.py +344 -344
  118. crawlo/utils/log.py +128 -128
  119. crawlo/utils/performance_monitor.py +285 -285
  120. crawlo/utils/queue_helper.py +175 -175
  121. crawlo/utils/redis_connection_pool.py +334 -334
  122. crawlo/utils/redis_key_validator.py +198 -198
  123. crawlo/utils/request.py +267 -267
  124. crawlo/utils/request_serializer.py +218 -218
  125. crawlo/utils/spider_loader.py +61 -61
  126. crawlo/utils/system.py +11 -11
  127. crawlo/utils/tools.py +4 -4
  128. crawlo/utils/url.py +39 -39
  129. {crawlo-1.2.3.dist-info → crawlo-1.2.5.dist-info}/METADATA +764 -692
  130. crawlo-1.2.5.dist-info/RECORD +206 -0
  131. examples/__init__.py +7 -7
  132. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  133. tests/__init__.py +7 -7
  134. tests/advanced_tools_example.py +275 -275
  135. tests/authenticated_proxy_example.py +236 -236
  136. tests/cleaners_example.py +160 -160
  137. tests/config_validation_demo.py +102 -102
  138. tests/controlled_spider_example.py +205 -205
  139. tests/date_tools_example.py +180 -180
  140. tests/dynamic_loading_example.py +523 -523
  141. tests/dynamic_loading_test.py +104 -104
  142. tests/env_config_example.py +133 -133
  143. tests/error_handling_example.py +171 -171
  144. tests/redis_key_validation_demo.py +130 -130
  145. tests/response_improvements_example.py +144 -144
  146. tests/test_advanced_tools.py +148 -148
  147. tests/test_all_redis_key_configs.py +145 -145
  148. tests/test_authenticated_proxy.py +141 -141
  149. tests/test_cleaners.py +54 -54
  150. tests/test_comprehensive.py +146 -146
  151. tests/test_config_validator.py +193 -193
  152. tests/test_crawlo_proxy_integration.py +172 -172
  153. tests/test_date_tools.py +123 -123
  154. tests/test_default_header_middleware.py +158 -158
  155. tests/test_double_crawlo_fix.py +207 -207
  156. tests/test_double_crawlo_fix_simple.py +124 -124
  157. tests/test_download_delay_middleware.py +221 -221
  158. tests/test_downloader_proxy_compatibility.py +268 -268
  159. tests/test_dynamic_downloaders_proxy.py +124 -124
  160. tests/test_dynamic_proxy.py +92 -92
  161. tests/test_dynamic_proxy_config.py +146 -146
  162. tests/test_dynamic_proxy_real.py +109 -109
  163. tests/test_edge_cases.py +303 -303
  164. tests/test_enhanced_error_handler.py +270 -270
  165. tests/test_env_config.py +121 -121
  166. tests/test_error_handler_compatibility.py +112 -112
  167. tests/test_final_validation.py +153 -153
  168. tests/test_framework_env_usage.py +103 -103
  169. tests/test_integration.py +356 -356
  170. tests/test_item_dedup_redis_key.py +122 -122
  171. tests/test_offsite_middleware.py +221 -221
  172. tests/test_parsel.py +29 -29
  173. tests/test_performance.py +327 -327
  174. tests/test_proxy_api.py +264 -264
  175. tests/test_proxy_health_check.py +32 -32
  176. tests/test_proxy_middleware.py +121 -121
  177. tests/test_proxy_middleware_enhanced.py +216 -216
  178. tests/test_proxy_middleware_integration.py +136 -136
  179. tests/test_proxy_providers.py +56 -56
  180. tests/test_proxy_stats.py +19 -19
  181. tests/test_proxy_strategies.py +59 -59
  182. tests/test_queue_manager_double_crawlo.py +173 -173
  183. tests/test_queue_manager_redis_key.py +176 -176
  184. tests/test_real_scenario_proxy.py +195 -195
  185. tests/test_redis_config.py +28 -28
  186. tests/test_redis_connection_pool.py +294 -294
  187. tests/test_redis_key_naming.py +181 -181
  188. tests/test_redis_key_validator.py +123 -123
  189. tests/test_redis_queue.py +224 -224
  190. tests/test_request_ignore_middleware.py +182 -182
  191. tests/test_request_serialization.py +70 -70
  192. tests/test_response_code_middleware.py +349 -349
  193. tests/test_response_filter_middleware.py +427 -427
  194. tests/test_response_improvements.py +152 -152
  195. tests/test_retry_middleware.py +241 -241
  196. tests/test_scheduler.py +241 -241
  197. tests/test_simple_response.py +61 -61
  198. tests/test_telecom_spider_redis_key.py +205 -205
  199. tests/test_template_content.py +87 -87
  200. tests/test_template_redis_key.py +134 -134
  201. tests/test_tools.py +153 -153
  202. tests/tools_example.py +257 -257
  203. crawlo-1.2.3.dist-info/RECORD +0 -222
  204. examples/aiohttp_settings.py +0 -42
  205. examples/curl_cffi_settings.py +0 -41
  206. examples/default_header_middleware_example.py +0 -107
  207. examples/default_header_spider_example.py +0 -129
  208. examples/download_delay_middleware_example.py +0 -160
  209. examples/httpx_settings.py +0 -42
  210. examples/multi_downloader_proxy_example.py +0 -81
  211. examples/offsite_middleware_example.py +0 -55
  212. examples/offsite_spider_example.py +0 -107
  213. examples/proxy_spider_example.py +0 -166
  214. examples/request_ignore_middleware_example.py +0 -51
  215. examples/request_ignore_spider_example.py +0 -99
  216. examples/response_code_middleware_example.py +0 -52
  217. examples/response_filter_middleware_example.py +0 -67
  218. examples/tong_hua_shun_settings.py +0 -62
  219. examples/tong_hua_shun_spider.py +0 -170
  220. {crawlo-1.2.3.dist-info → crawlo-1.2.5.dist-info}/WHEEL +0 -0
  221. {crawlo-1.2.3.dist-info → crawlo-1.2.5.dist-info}/entry_points.txt +0 -0
  222. {crawlo-1.2.3.dist-info → crawlo-1.2.5.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