crawlo 1.3.1__py3-none-any.whl → 1.3.3__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 (219) hide show
  1. crawlo/__init__.py +63 -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 +322 -314
  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 +2 -2
  16. crawlo/core/engine.py +365 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +256 -256
  19. crawlo/crawler.py +1166 -1168
  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 +226 -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 +52 -45
  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 +135 -135
  50. crawlo/middleware/offsite.py +123 -115
  51. crawlo/middleware/proxy.py +386 -386
  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 -65
  57. crawlo/mode_manager.py +187 -148
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +379 -379
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  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 +318 -318
  70. crawlo/pipelines/pipeline_manager.py +75 -75
  71. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  72. crawlo/project.py +325 -297
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +379 -379
  75. crawlo/queue/redis_priority_queue.py +306 -306
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +225 -225
  78. crawlo/settings/setting_manager.py +198 -198
  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 +266 -261
  89. crawlo/templates/project/settings_distributed.py.tmpl +179 -174
  90. crawlo/templates/project/settings_gentle.py.tmpl +60 -95
  91. crawlo/templates/project/settings_high_performance.py.tmpl +130 -125
  92. crawlo/templates/project/settings_minimal.py.tmpl +34 -29
  93. crawlo/templates/project/settings_simple.py.tmpl +101 -96
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +38 -47
  96. crawlo/templates/spider/spider.py.tmpl +143 -143
  97. crawlo/tools/__init__.py +200 -200
  98. crawlo/tools/anti_crawler.py +268 -268
  99. crawlo/tools/authenticated_proxy.py +240 -240
  100. crawlo/tools/data_formatter.py +225 -225
  101. crawlo/tools/data_validator.py +180 -180
  102. crawlo/tools/date_tools.py +289 -289
  103. crawlo/tools/distributed_coordinator.py +388 -388
  104. crawlo/tools/encoding_converter.py +127 -127
  105. crawlo/tools/request_tools.py +82 -82
  106. crawlo/tools/retry_mechanism.py +224 -224
  107. crawlo/tools/scenario_adapter.py +262 -262
  108. crawlo/tools/text_cleaner.py +232 -232
  109. crawlo/utils/__init__.py +34 -34
  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 +199 -146
  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.3.1.dist-info → crawlo-1.3.3.dist-info}/METADATA +1020 -1020
  131. crawlo-1.3.3.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 -107
  137. tests/cleaners_example.py +160 -160
  138. tests/config_validation_demo.py +142 -142
  139. tests/controlled_spider_example.py +205 -205
  140. tests/date_tools_example.py +180 -180
  141. tests/debug_pipelines.py +66 -66
  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 +150 -150
  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 +152 -152
  156. tests/test_config_validator.py +182 -182
  157. tests/test_crawlo_proxy_integration.py +108 -108
  158. tests/test_date_tools.py +123 -123
  159. tests/test_default_header_middleware.py +158 -158
  160. tests/test_distributed.py +65 -65
  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 -169
  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 +184 -184
  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 +72 -72
  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 +111 -111
  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 -159
  213. tests/test_user_agents.py +96 -96
  214. tests/tools_example.py +260 -260
  215. tests/verify_distributed.py +117 -117
  216. crawlo-1.3.1.dist-info/RECORD +0 -219
  217. {crawlo-1.3.1.dist-info → crawlo-1.3.3.dist-info}/WHEEL +0 -0
  218. {crawlo-1.3.1.dist-info → crawlo-1.3.3.dist-info}/entry_points.txt +0 -0
  219. {crawlo-1.3.1.dist-info → crawlo-1.3.3.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