crawlo 1.1.8__py3-none-any.whl → 1.1.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 (190) 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 +65 -65
  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 +132 -132
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +292 -292
  14. crawlo/commands/startproject.py +418 -418
  15. crawlo/commands/stats.py +188 -188
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +252 -252
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +345 -345
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +136 -136
  23. crawlo/crawler.py +1027 -1027
  24. crawlo/downloader/__init__.py +266 -266
  25. crawlo/downloader/aiohttp_downloader.py +220 -220
  26. crawlo/downloader/cffi_downloader.py +256 -256
  27. crawlo/downloader/httpx_downloader.py +259 -259
  28. crawlo/downloader/hybrid_downloader.py +213 -213
  29. crawlo/downloader/playwright_downloader.py +402 -402
  30. crawlo/downloader/selenium_downloader.py +472 -472
  31. crawlo/event.py +11 -11
  32. crawlo/exceptions.py +81 -81
  33. crawlo/extension/__init__.py +37 -37
  34. crawlo/extension/health_check.py +141 -141
  35. crawlo/extension/log_interval.py +57 -57
  36. crawlo/extension/log_stats.py +81 -81
  37. crawlo/extension/logging_extension.py +43 -43
  38. crawlo/extension/memory_monitor.py +104 -104
  39. crawlo/extension/performance_profiler.py +133 -133
  40. crawlo/extension/request_recorder.py +107 -107
  41. crawlo/filters/__init__.py +154 -154
  42. crawlo/filters/aioredis_filter.py +280 -280
  43. crawlo/filters/memory_filter.py +269 -269
  44. crawlo/items/__init__.py +23 -23
  45. crawlo/items/base.py +21 -21
  46. crawlo/items/fields.py +53 -53
  47. crawlo/items/items.py +104 -104
  48. crawlo/middleware/__init__.py +21 -21
  49. crawlo/middleware/default_header.py +32 -32
  50. crawlo/middleware/download_delay.py +28 -28
  51. crawlo/middleware/middleware_manager.py +135 -135
  52. crawlo/middleware/proxy.py +272 -272
  53. crawlo/middleware/request_ignore.py +30 -30
  54. crawlo/middleware/response_code.py +18 -18
  55. crawlo/middleware/response_filter.py +26 -26
  56. crawlo/middleware/retry.py +124 -124
  57. crawlo/mode_manager.py +211 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +338 -338
  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 +224 -224
  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 +316 -316
  70. crawlo/pipelines/pipeline_manager.py +61 -61
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +187 -187
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +334 -334
  75. crawlo/queue/redis_priority_queue.py +298 -298
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +219 -219
  78. crawlo/settings/setting_manager.py +122 -122
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +130 -130
  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 +109 -109
  87. crawlo/templates/project/pipelines.py.tmpl +96 -96
  88. crawlo/templates/project/run.py.tmpl +45 -45
  89. crawlo/templates/project/settings.py.tmpl +326 -326
  90. crawlo/templates/project/settings_distributed.py.tmpl +119 -119
  91. crawlo/templates/project/settings_gentle.py.tmpl +94 -94
  92. crawlo/templates/project/settings_high_performance.py.tmpl +151 -151
  93. crawlo/templates/project/settings_simple.py.tmpl +68 -68
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/spider/spider.py.tmpl +141 -141
  96. crawlo/tools/__init__.py +182 -182
  97. crawlo/tools/anti_crawler.py +268 -268
  98. crawlo/tools/authenticated_proxy.py +240 -240
  99. crawlo/tools/data_validator.py +180 -180
  100. crawlo/tools/date_tools.py +35 -35
  101. crawlo/tools/distributed_coordinator.py +386 -386
  102. crawlo/tools/retry_mechanism.py +220 -220
  103. crawlo/tools/scenario_adapter.py +262 -262
  104. crawlo/utils/__init__.py +35 -35
  105. crawlo/utils/batch_processor.py +260 -260
  106. crawlo/utils/controlled_spider_mixin.py +439 -439
  107. crawlo/utils/date_tools.py +290 -290
  108. crawlo/utils/db_helper.py +343 -343
  109. crawlo/utils/enhanced_error_handler.py +359 -359
  110. crawlo/utils/env_config.py +105 -105
  111. crawlo/utils/error_handler.py +125 -125
  112. crawlo/utils/func_tools.py +82 -82
  113. crawlo/utils/large_scale_config.py +286 -286
  114. crawlo/utils/large_scale_helper.py +343 -343
  115. crawlo/utils/log.py +128 -128
  116. crawlo/utils/performance_monitor.py +284 -284
  117. crawlo/utils/queue_helper.py +175 -175
  118. crawlo/utils/redis_connection_pool.py +334 -334
  119. crawlo/utils/redis_key_validator.py +199 -199
  120. crawlo/utils/request.py +267 -267
  121. crawlo/utils/request_serializer.py +219 -219
  122. crawlo/utils/spider_loader.py +62 -62
  123. crawlo/utils/system.py +11 -11
  124. crawlo/utils/tools.py +4 -4
  125. crawlo/utils/url.py +39 -39
  126. {crawlo-1.1.8.dist-info → crawlo-1.1.9.dist-info}/METADATA +626 -626
  127. crawlo-1.1.9.dist-info/RECORD +190 -0
  128. examples/__init__.py +7 -7
  129. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  130. tests/__init__.py +7 -7
  131. tests/advanced_tools_example.py +275 -275
  132. tests/authenticated_proxy_example.py +236 -236
  133. tests/cleaners_example.py +160 -160
  134. tests/config_validation_demo.py +102 -102
  135. tests/controlled_spider_example.py +205 -205
  136. tests/date_tools_example.py +180 -180
  137. tests/dynamic_loading_example.py +523 -523
  138. tests/dynamic_loading_test.py +104 -104
  139. tests/env_config_example.py +133 -133
  140. tests/error_handling_example.py +171 -171
  141. tests/redis_key_validation_demo.py +130 -130
  142. tests/response_improvements_example.py +144 -144
  143. tests/test_advanced_tools.py +148 -148
  144. tests/test_all_redis_key_configs.py +145 -145
  145. tests/test_authenticated_proxy.py +141 -141
  146. tests/test_cleaners.py +54 -54
  147. tests/test_comprehensive.py +146 -146
  148. tests/test_config_validator.py +193 -193
  149. tests/test_date_tools.py +123 -123
  150. tests/test_double_crawlo_fix.py +207 -207
  151. tests/test_double_crawlo_fix_simple.py +124 -124
  152. tests/test_dynamic_downloaders_proxy.py +124 -124
  153. tests/test_dynamic_proxy.py +92 -92
  154. tests/test_dynamic_proxy_config.py +146 -146
  155. tests/test_dynamic_proxy_real.py +109 -109
  156. tests/test_edge_cases.py +303 -303
  157. tests/test_enhanced_error_handler.py +270 -270
  158. tests/test_env_config.py +121 -121
  159. tests/test_error_handler_compatibility.py +112 -112
  160. tests/test_final_validation.py +153 -153
  161. tests/test_framework_env_usage.py +103 -103
  162. tests/test_integration.py +356 -356
  163. tests/test_item_dedup_redis_key.py +122 -122
  164. tests/test_parsel.py +29 -29
  165. tests/test_performance.py +327 -327
  166. tests/test_proxy_health_check.py +32 -32
  167. tests/test_proxy_middleware_integration.py +136 -136
  168. tests/test_proxy_providers.py +56 -56
  169. tests/test_proxy_stats.py +19 -19
  170. tests/test_proxy_strategies.py +59 -59
  171. tests/test_queue_manager_double_crawlo.py +230 -230
  172. tests/test_queue_manager_redis_key.py +176 -176
  173. tests/test_redis_config.py +28 -28
  174. tests/test_redis_connection_pool.py +294 -294
  175. tests/test_redis_key_naming.py +181 -181
  176. tests/test_redis_key_validator.py +123 -123
  177. tests/test_redis_queue.py +224 -224
  178. tests/test_request_serialization.py +70 -70
  179. tests/test_response_improvements.py +152 -152
  180. tests/test_scheduler.py +241 -241
  181. tests/test_simple_response.py +61 -61
  182. tests/test_telecom_spider_redis_key.py +205 -205
  183. tests/test_template_content.py +87 -87
  184. tests/test_template_redis_key.py +134 -134
  185. tests/test_tools.py +153 -153
  186. tests/tools_example.py +257 -257
  187. crawlo-1.1.8.dist-info/RECORD +0 -190
  188. {crawlo-1.1.8.dist-info → crawlo-1.1.9.dist-info}/WHEEL +0 -0
  189. {crawlo-1.1.8.dist-info → crawlo-1.1.9.dist-info}/entry_points.txt +0 -0
  190. {crawlo-1.1.8.dist-info → crawlo-1.1.9.dist-info}/top_level.txt +0 -0
crawlo/event.py CHANGED
@@ -1,11 +1,11 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
-
4
- spider_error = "spider_error"
5
- spider_opened = "spider_open"
6
- spider_closed = "spider_closed"
7
- ignore_request = "ignore_request"
8
- request_scheduled = "request_scheduled"
9
- response_received = "request_received"
10
- item_successful = "item_successful"
11
- item_discard = "item_discard"
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+
4
+ spider_error = "spider_error"
5
+ spider_opened = "spider_open"
6
+ spider_closed = "spider_closed"
7
+ ignore_request = "ignore_request"
8
+ request_scheduled = "request_scheduled"
9
+ response_received = "request_received"
10
+ item_successful = "item_successful"
11
+ item_discard = "item_discard"
crawlo/exceptions.py CHANGED
@@ -1,82 +1,82 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- class TransformTypeError(TypeError):
4
- pass
5
-
6
-
7
- class OutputError(Exception):
8
- pass
9
-
10
-
11
- class SpiderTypeError(TypeError):
12
- pass
13
-
14
-
15
- class ItemInitError(Exception):
16
- pass
17
-
18
-
19
- class ItemAttributeError(Exception):
20
- pass
21
-
22
-
23
- class DecodeError(Exception):
24
- pass
25
-
26
-
27
- class MiddlewareInitError(Exception):
28
- pass
29
-
30
-
31
- class PipelineInitError(Exception):
32
- pass
33
-
34
-
35
- class InvalidOutputError(Exception):
36
- pass
37
-
38
-
39
- class RequestMethodError(Exception):
40
- pass
41
-
42
-
43
- class IgnoreRequestError(Exception):
44
- def __init__(self, msg):
45
- self.msg = msg
46
- super(IgnoreRequestError, self).__init__(msg)
47
-
48
-
49
- class ItemDiscard(Exception):
50
- def __init__(self, msg):
51
- self.msg = msg
52
- super(ItemDiscard, self).__init__(msg)
53
-
54
-
55
- class NotConfigured(Exception):
56
- pass
57
-
58
-
59
- class NotConfiguredError(Exception):
60
- pass
61
-
62
-
63
- class ExtensionInitError(Exception):
64
- pass
65
-
66
-
67
- class ReceiverTypeError(Exception):
68
- pass
69
-
70
-
71
- class SpiderCreationError(Exception):
72
- """爬虫实例化失败异常"""
73
- pass
74
-
75
-
76
- class ItemValidationError(Exception):
77
- """Item 字段验证错误"""
78
- pass
79
-
80
-
81
- class DropItem(Exception):
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ class TransformTypeError(TypeError):
4
+ pass
5
+
6
+
7
+ class OutputError(Exception):
8
+ pass
9
+
10
+
11
+ class SpiderTypeError(TypeError):
12
+ pass
13
+
14
+
15
+ class ItemInitError(Exception):
16
+ pass
17
+
18
+
19
+ class ItemAttributeError(Exception):
20
+ pass
21
+
22
+
23
+ class DecodeError(Exception):
24
+ pass
25
+
26
+
27
+ class MiddlewareInitError(Exception):
28
+ pass
29
+
30
+
31
+ class PipelineInitError(Exception):
32
+ pass
33
+
34
+
35
+ class InvalidOutputError(Exception):
36
+ pass
37
+
38
+
39
+ class RequestMethodError(Exception):
40
+ pass
41
+
42
+
43
+ class IgnoreRequestError(Exception):
44
+ def __init__(self, msg):
45
+ self.msg = msg
46
+ super(IgnoreRequestError, self).__init__(msg)
47
+
48
+
49
+ class ItemDiscard(Exception):
50
+ def __init__(self, msg):
51
+ self.msg = msg
52
+ super(ItemDiscard, self).__init__(msg)
53
+
54
+
55
+ class NotConfigured(Exception):
56
+ pass
57
+
58
+
59
+ class NotConfiguredError(Exception):
60
+ pass
61
+
62
+
63
+ class ExtensionInitError(Exception):
64
+ pass
65
+
66
+
67
+ class ReceiverTypeError(Exception):
68
+ pass
69
+
70
+
71
+ class SpiderCreationError(Exception):
72
+ """爬虫实例化失败异常"""
73
+ pass
74
+
75
+
76
+ class ItemValidationError(Exception):
77
+ """Item 字段验证错误"""
78
+ pass
79
+
80
+
81
+ class DropItem(Exception):
82
82
  pass
@@ -1,38 +1,38 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- from typing import List, Any
4
- from pprint import pformat
5
-
6
- from crawlo.utils.log import get_logger
7
- from crawlo.project import load_class
8
- from crawlo.exceptions import ExtensionInitError
9
-
10
-
11
- class ExtensionManager(object):
12
-
13
- def __init__(self, crawler: Any):
14
- self.crawler = crawler
15
- self.extensions: List = []
16
- extensions = self.crawler.settings.get_list('EXTENSIONS')
17
- self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
18
- self._add_extensions(extensions)
19
-
20
- @classmethod
21
- def create_instance(cls, *args: Any, **kwargs: Any) -> 'ExtensionManager':
22
- return cls(*args, **kwargs)
23
-
24
- def _add_extensions(self, extensions: List[str]) -> None:
25
- for extension_path in extensions:
26
- try:
27
- extension_cls = load_class(extension_path)
28
- if not hasattr(extension_cls, 'create_instance'):
29
- raise ExtensionInitError(
30
- f"Extension '{extension_path}' init failed: Must have method 'create_instance()'"
31
- )
32
- self.extensions.append(extension_cls.create_instance(self.crawler))
33
- except Exception as e:
34
- self.logger.error(f"Failed to load extension '{extension_path}': {e}")
35
- raise ExtensionInitError(f"Failed to load extension '{extension_path}': {e}")
36
-
37
- if extensions:
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ from typing import List, Any
4
+ from pprint import pformat
5
+
6
+ from crawlo.utils.log import get_logger
7
+ from crawlo.project import load_class
8
+ from crawlo.exceptions import ExtensionInitError
9
+
10
+
11
+ class ExtensionManager(object):
12
+
13
+ def __init__(self, crawler: Any):
14
+ self.crawler = crawler
15
+ self.extensions: List = []
16
+ extensions = self.crawler.settings.get_list('EXTENSIONS')
17
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
18
+ self._add_extensions(extensions)
19
+
20
+ @classmethod
21
+ def create_instance(cls, *args: Any, **kwargs: Any) -> 'ExtensionManager':
22
+ return cls(*args, **kwargs)
23
+
24
+ def _add_extensions(self, extensions: List[str]) -> None:
25
+ for extension_path in extensions:
26
+ try:
27
+ extension_cls = load_class(extension_path)
28
+ if not hasattr(extension_cls, 'create_instance'):
29
+ raise ExtensionInitError(
30
+ f"Extension '{extension_path}' init failed: Must have method 'create_instance()'"
31
+ )
32
+ self.extensions.append(extension_cls.create_instance(self.crawler))
33
+ except Exception as e:
34
+ self.logger.error(f"Failed to load extension '{extension_path}': {e}")
35
+ raise ExtensionInitError(f"Failed to load extension '{extension_path}': {e}")
36
+
37
+ if extensions:
38
38
  self.logger.info(f"Enabled extensions: \n{pformat(extensions)}")
@@ -1,142 +1,142 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- import asyncio
4
- from typing import Any, Optional, Dict
5
- from datetime import datetime, timedelta
6
-
7
- from crawlo.utils.log import get_logger
8
- from crawlo.event import spider_opened, spider_closed, response_received, request_scheduled
9
-
10
-
11
- class HealthCheckExtension:
12
- """
13
- 健康检查扩展
14
- 监控爬虫的健康状态,包括响应时间、错误率等指标
15
- """
16
-
17
- def __init__(self, crawler: Any):
18
- self.settings = crawler.settings
19
- self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
20
-
21
- # 获取配置参数
22
- self.enabled = self.settings.get_bool('HEALTH_CHECK_ENABLED', True)
23
- self.check_interval = self.settings.get_int('HEALTH_CHECK_INTERVAL', 60) # 默认60秒
24
-
25
- # 健康状态统计
26
- self.stats: Dict[str, Any] = {
27
- 'start_time': None,
28
- 'total_requests': 0,
29
- 'total_responses': 0,
30
- 'error_responses': 0,
31
- 'last_check_time': None,
32
- 'response_times': [], # 存储最近的响应时间
33
- }
34
-
35
- self.task: Optional[asyncio.Task] = None
36
-
37
- @classmethod
38
- def create_instance(cls, crawler: Any) -> 'HealthCheckExtension':
39
- # 只有当配置启用时才创建实例
40
- if not crawler.settings.get_bool('HEALTH_CHECK_ENABLED', True):
41
- from crawlo.exceptions import NotConfigured
42
- raise NotConfigured("HealthCheckExtension: HEALTH_CHECK_ENABLED is False")
43
-
44
- o = cls(crawler)
45
- if o.enabled:
46
- crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
47
- crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
48
- crawler.subscriber.subscribe(o.response_received, event=response_received)
49
- crawler.subscriber.subscribe(o.request_scheduled, event=request_scheduled)
50
- return o
51
-
52
- async def spider_opened(self) -> None:
53
- """爬虫启动时初始化健康检查"""
54
- if not self.enabled:
55
- return
56
-
57
- self.stats['start_time'] = datetime.now()
58
- self.task = asyncio.create_task(self._health_check_loop())
59
- self.logger.info("Health check extension started.")
60
-
61
- async def spider_closed(self) -> None:
62
- """爬虫关闭时停止健康检查"""
63
- if not self.enabled:
64
- return
65
-
66
- if self.task:
67
- self.task.cancel()
68
- try:
69
- await self.task
70
- except asyncio.CancelledError:
71
- pass
72
-
73
- # 输出最终健康状态
74
- await self._check_health()
75
- self.logger.info("Health check extension stopped.")
76
-
77
- async def request_scheduled(self, request: Any, spider: Any) -> None:
78
- """记录调度的请求"""
79
- if not self.enabled:
80
- return
81
- self.stats['total_requests'] += 1
82
-
83
- async def response_received(self, response: Any, spider: Any) -> None:
84
- """记录接收到的响应"""
85
- if not self.enabled:
86
- return
87
-
88
- self.stats['total_responses'] += 1
89
-
90
- # 记录错误响应
91
- if hasattr(response, 'status_code') and response.status_code >= 400:
92
- self.stats['error_responses'] += 1
93
-
94
- async def _health_check_loop(self) -> None:
95
- """健康检查循环"""
96
- while True:
97
- try:
98
- await asyncio.sleep(self.check_interval)
99
- await self._check_health()
100
- except asyncio.CancelledError:
101
- break
102
- except Exception as e:
103
- self.logger.error(f"Error in health check loop: {e}")
104
-
105
- async def _check_health(self) -> None:
106
- """执行健康检查并输出报告"""
107
- try:
108
- now_time = datetime.now()
109
- self.stats['last_check_time'] = now_time
110
-
111
- # 计算基本统计信息
112
- runtime = (now_time - self.stats['start_time']).total_seconds() if self.stats['start_time'] else 0
113
- requests_per_second = self.stats['total_requests'] / runtime if runtime > 0 else 0
114
- responses_per_second = self.stats['total_responses'] / runtime if runtime > 0 else 0
115
-
116
- # 计算错误率
117
- error_rate = (
118
- self.stats['error_responses'] / self.stats['total_responses']
119
- if self.stats['total_responses'] > 0 else 0
120
- )
121
-
122
- # 输出健康报告
123
- health_report = {
124
- 'runtime_seconds': round(runtime, 2),
125
- 'total_requests': self.stats['total_requests'],
126
- 'total_responses': self.stats['total_responses'],
127
- 'requests_per_second': round(requests_per_second, 2),
128
- 'responses_per_second': round(responses_per_second, 2),
129
- 'error_responses': self.stats['error_responses'],
130
- 'error_rate': f"{error_rate:.2%}",
131
- }
132
-
133
- # 根据错误率判断健康状态
134
- if error_rate > 0.1: # 错误率超过10%
135
- self.logger.warning(f"Health check report: {health_report}")
136
- elif error_rate > 0.05: # 错误率超过5%
137
- self.logger.info(f"Health check report: {health_report}")
138
- else:
139
- self.logger.debug(f"Health check report: {health_report}")
140
-
141
- except Exception as e:
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ from typing import Any, Optional, Dict
5
+ from datetime import datetime, timedelta
6
+
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.event import spider_opened, spider_closed, response_received, request_scheduled
9
+
10
+
11
+ class HealthCheckExtension:
12
+ """
13
+ 健康检查扩展
14
+ 监控爬虫的健康状态,包括响应时间、错误率等指标
15
+ """
16
+
17
+ def __init__(self, crawler: Any):
18
+ self.settings = crawler.settings
19
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
20
+
21
+ # 获取配置参数
22
+ self.enabled = self.settings.get_bool('HEALTH_CHECK_ENABLED', True)
23
+ self.check_interval = self.settings.get_int('HEALTH_CHECK_INTERVAL', 60) # 默认60秒
24
+
25
+ # 健康状态统计
26
+ self.stats: Dict[str, Any] = {
27
+ 'start_time': None,
28
+ 'total_requests': 0,
29
+ 'total_responses': 0,
30
+ 'error_responses': 0,
31
+ 'last_check_time': None,
32
+ 'response_times': [], # 存储最近的响应时间
33
+ }
34
+
35
+ self.task: Optional[asyncio.Task] = None
36
+
37
+ @classmethod
38
+ def create_instance(cls, crawler: Any) -> 'HealthCheckExtension':
39
+ # 只有当配置启用时才创建实例
40
+ if not crawler.settings.get_bool('HEALTH_CHECK_ENABLED', True):
41
+ from crawlo.exceptions import NotConfigured
42
+ raise NotConfigured("HealthCheckExtension: HEALTH_CHECK_ENABLED is False")
43
+
44
+ o = cls(crawler)
45
+ if o.enabled:
46
+ crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
47
+ crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
48
+ crawler.subscriber.subscribe(o.response_received, event=response_received)
49
+ crawler.subscriber.subscribe(o.request_scheduled, event=request_scheduled)
50
+ return o
51
+
52
+ async def spider_opened(self) -> None:
53
+ """爬虫启动时初始化健康检查"""
54
+ if not self.enabled:
55
+ return
56
+
57
+ self.stats['start_time'] = datetime.now()
58
+ self.task = asyncio.create_task(self._health_check_loop())
59
+ self.logger.info("Health check extension started.")
60
+
61
+ async def spider_closed(self) -> None:
62
+ """爬虫关闭时停止健康检查"""
63
+ if not self.enabled:
64
+ return
65
+
66
+ if self.task:
67
+ self.task.cancel()
68
+ try:
69
+ await self.task
70
+ except asyncio.CancelledError:
71
+ pass
72
+
73
+ # 输出最终健康状态
74
+ await self._check_health()
75
+ self.logger.info("Health check extension stopped.")
76
+
77
+ async def request_scheduled(self, request: Any, spider: Any) -> None:
78
+ """记录调度的请求"""
79
+ if not self.enabled:
80
+ return
81
+ self.stats['total_requests'] += 1
82
+
83
+ async def response_received(self, response: Any, spider: Any) -> None:
84
+ """记录接收到的响应"""
85
+ if not self.enabled:
86
+ return
87
+
88
+ self.stats['total_responses'] += 1
89
+
90
+ # 记录错误响应
91
+ if hasattr(response, 'status_code') and response.status_code >= 400:
92
+ self.stats['error_responses'] += 1
93
+
94
+ async def _health_check_loop(self) -> None:
95
+ """健康检查循环"""
96
+ while True:
97
+ try:
98
+ await asyncio.sleep(self.check_interval)
99
+ await self._check_health()
100
+ except asyncio.CancelledError:
101
+ break
102
+ except Exception as e:
103
+ self.logger.error(f"Error in health check loop: {e}")
104
+
105
+ async def _check_health(self) -> None:
106
+ """执行健康检查并输出报告"""
107
+ try:
108
+ now_time = datetime.now()
109
+ self.stats['last_check_time'] = now_time
110
+
111
+ # 计算基本统计信息
112
+ runtime = (now_time - self.stats['start_time']).total_seconds() if self.stats['start_time'] else 0
113
+ requests_per_second = self.stats['total_requests'] / runtime if runtime > 0 else 0
114
+ responses_per_second = self.stats['total_responses'] / runtime if runtime > 0 else 0
115
+
116
+ # 计算错误率
117
+ error_rate = (
118
+ self.stats['error_responses'] / self.stats['total_responses']
119
+ if self.stats['total_responses'] > 0 else 0
120
+ )
121
+
122
+ # 输出健康报告
123
+ health_report = {
124
+ 'runtime_seconds': round(runtime, 2),
125
+ 'total_requests': self.stats['total_requests'],
126
+ 'total_responses': self.stats['total_responses'],
127
+ 'requests_per_second': round(requests_per_second, 2),
128
+ 'responses_per_second': round(responses_per_second, 2),
129
+ 'error_responses': self.stats['error_responses'],
130
+ 'error_rate': f"{error_rate:.2%}",
131
+ }
132
+
133
+ # 根据错误率判断健康状态
134
+ if error_rate > 0.1: # 错误率超过10%
135
+ self.logger.warning(f"Health check report: {health_report}")
136
+ elif error_rate > 0.05: # 错误率超过5%
137
+ self.logger.info(f"Health check report: {health_report}")
138
+ else:
139
+ self.logger.debug(f"Health check report: {health_report}")
140
+
141
+ except Exception as e:
142
142
  self.logger.error(f"Error in health check: {e}")
@@ -1,58 +1,58 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- import asyncio
4
- from typing import Any, Optional
5
-
6
- from crawlo.utils.log import get_logger
7
- from crawlo.event import spider_opened, spider_closed
8
-
9
-
10
- class LogIntervalExtension(object):
11
-
12
- def __init__(self, crawler: Any):
13
- self.task: Optional[asyncio.Task] = None
14
- self.stats = crawler.stats
15
- self.item_count = 0
16
- self.response_count = 0
17
- self.seconds = crawler.settings.get('INTERVAL', 60) # 默认60秒
18
- self.interval = int(self.seconds / 60) if self.seconds % 60 == 0 else self.seconds
19
- self.interval = "" if self.interval == 1 else self.interval
20
- self.unit = 'min' if self.seconds % 60 == 0 else 's'
21
-
22
- self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
23
-
24
- @classmethod
25
- def create_instance(cls, crawler: Any) -> 'LogIntervalExtension':
26
- o = cls(crawler)
27
- crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
28
- crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
29
- return o
30
-
31
- async def spider_opened(self) -> None:
32
- self.task = asyncio.create_task(self.interval_log())
33
-
34
- async def spider_closed(self) -> None:
35
- if self.task:
36
- self.task.cancel()
37
- try:
38
- await self.task
39
- except asyncio.CancelledError:
40
- pass
41
- self.task = None
42
-
43
- async def interval_log(self) -> None:
44
- while True:
45
- try:
46
- last_item_count = self.stats.get_value('item_successful_count', default=0)
47
- last_response_count = self.stats.get_value('response_received_count', default=0)
48
- item_rate = last_item_count - self.item_count
49
- response_rate = last_response_count - self.response_count
50
- self.item_count, self.response_count = last_item_count, last_response_count
51
- self.logger.info(
52
- f'Crawled {last_response_count} pages (at {response_rate} pages/{self.interval}{self.unit}),'
53
- f' Got {last_item_count} items (at {item_rate} items/{self.interval}{self.unit}).'
54
- )
55
- await asyncio.sleep(self.seconds)
56
- except Exception as e:
57
- self.logger.error(f"Error in interval logging: {e}")
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ from typing import Any, Optional
5
+
6
+ from crawlo.utils.log import get_logger
7
+ from crawlo.event import spider_opened, spider_closed
8
+
9
+
10
+ class LogIntervalExtension(object):
11
+
12
+ def __init__(self, crawler: Any):
13
+ self.task: Optional[asyncio.Task] = None
14
+ self.stats = crawler.stats
15
+ self.item_count = 0
16
+ self.response_count = 0
17
+ self.seconds = crawler.settings.get('INTERVAL', 60) # 默认60秒
18
+ self.interval = int(self.seconds / 60) if self.seconds % 60 == 0 else self.seconds
19
+ self.interval = "" if self.interval == 1 else self.interval
20
+ self.unit = 'min' if self.seconds % 60 == 0 else 's'
21
+
22
+ self.logger = get_logger(self.__class__.__name__, crawler.settings.get('LOG_LEVEL'))
23
+
24
+ @classmethod
25
+ def create_instance(cls, crawler: Any) -> 'LogIntervalExtension':
26
+ o = cls(crawler)
27
+ crawler.subscriber.subscribe(o.spider_opened, event=spider_opened)
28
+ crawler.subscriber.subscribe(o.spider_closed, event=spider_closed)
29
+ return o
30
+
31
+ async def spider_opened(self) -> None:
32
+ self.task = asyncio.create_task(self.interval_log())
33
+
34
+ async def spider_closed(self) -> None:
35
+ if self.task:
36
+ self.task.cancel()
37
+ try:
38
+ await self.task
39
+ except asyncio.CancelledError:
40
+ pass
41
+ self.task = None
42
+
43
+ async def interval_log(self) -> None:
44
+ while True:
45
+ try:
46
+ last_item_count = self.stats.get_value('item_successful_count', default=0)
47
+ last_response_count = self.stats.get_value('response_received_count', default=0)
48
+ item_rate = last_item_count - self.item_count
49
+ response_rate = last_response_count - self.response_count
50
+ self.item_count, self.response_count = last_item_count, last_response_count
51
+ self.logger.info(
52
+ f'Crawled {last_response_count} pages (at {response_rate} pages/{self.interval}{self.unit}),'
53
+ f' Got {last_item_count} items (at {item_rate} items/{self.interval}{self.unit}).'
54
+ )
55
+ await asyncio.sleep(self.seconds)
56
+ except Exception as e:
57
+ self.logger.error(f"Error in interval logging: {e}")
58
58
  await asyncio.sleep(self.seconds) # 即使出错也继续执行