crawlo 1.3.2__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 -123
  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 -187
  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 -266
  89. crawlo/templates/project/settings_distributed.py.tmpl +179 -179
  90. crawlo/templates/project/settings_gentle.py.tmpl +60 -60
  91. crawlo/templates/project/settings_high_performance.py.tmpl +130 -130
  92. crawlo/templates/project/settings_minimal.py.tmpl +34 -34
  93. crawlo/templates/project/settings_simple.py.tmpl +101 -101
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/run.py.tmpl +38 -38
  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.2.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.2.dist-info/RECORD +0 -219
  217. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/WHEEL +0 -0
  218. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/entry_points.txt +0 -0
  219. {crawlo-1.3.2.dist-info → crawlo-1.3.3.dist-info}/top_level.txt +0 -0
@@ -1,199 +1,199 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- import json
4
- from copy import deepcopy
5
- from importlib import import_module
6
- from collections.abc import MutableMapping
7
-
8
- from crawlo.settings import default_settings
9
-
10
-
11
- class SettingManager(MutableMapping):
12
-
13
- def __init__(self, values=None):
14
- self.attributes = {}
15
- self.set_settings(default_settings)
16
- # 在初始化时合并配置
17
- self._merge_config(values)
18
-
19
- def _merge_config(self, user_config):
20
- """合并默认配置和用户配置"""
21
- if not user_config:
22
- return
23
-
24
- # 合并中间件配置
25
- if 'MIDDLEWARES' in user_config:
26
- default_middlewares = self.attributes.get('MIDDLEWARES', [])
27
- user_middlewares = user_config['MIDDLEWARES']
28
- # 如果用户配置了空列表,则仍然使用默认配置
29
- if user_middlewares:
30
- # 过滤掉空值和注释
31
- user_middlewares = [middleware for middleware in user_middlewares if middleware and not middleware.strip().startswith('#')]
32
- # 合并默认中间件和用户中间件,去重但保持顺序
33
- merged_middlewares = default_middlewares[:]
34
- for middleware in user_middlewares:
35
- if middleware not in merged_middlewares:
36
- merged_middlewares.append(middleware)
37
- self.attributes['MIDDLEWARES'] = merged_middlewares
38
-
39
- # 合并管道配置
40
- if 'PIPELINES' in user_config:
41
- default_pipelines = self.attributes.get('PIPELINES', [])
42
- user_pipelines = user_config['PIPELINES']
43
- # 如果用户配置了空列表,则仍然使用默认配置
44
- if user_pipelines:
45
- # 过滤掉空值和注释
46
- user_pipelines = [pipeline for pipeline in user_pipelines if pipeline and not pipeline.strip().startswith('#')]
47
- # 合并默认管道和用户管道,去重但保持顺序
48
- merged_pipelines = default_pipelines[:]
49
- for pipeline in user_pipelines:
50
- if pipeline not in merged_pipelines:
51
- merged_pipelines.append(pipeline)
52
- self.attributes['PIPELINES'] = merged_pipelines
53
-
54
- # 特殊处理PIPELINES,确保去重管道在最前面
55
- dedup_pipeline = self.attributes.get('DEFAULT_DEDUP_PIPELINE')
56
- if dedup_pipeline:
57
- pipelines = self.attributes.get('PIPELINES', [])
58
- # 移除所有去重管道实例(如果存在)
59
- pipelines = [item for item in pipelines if item != dedup_pipeline]
60
- # 在开头插入去重管道
61
- pipelines.insert(0, dedup_pipeline)
62
- self.attributes['PIPELINES'] = pipelines
63
-
64
- # 合并扩展配置
65
- if 'EXTENSIONS' in user_config:
66
- default_extensions = self.attributes.get('EXTENSIONS', [])
67
- user_extensions = user_config['EXTENSIONS']
68
- # 如果用户配置了空列表,则仍然使用默认配置
69
- if user_extensions:
70
- # 过滤掉空值和注释
71
- user_extensions = [extension for extension in user_extensions if extension and not extension.strip().startswith('#')]
72
- # 合并默认扩展和用户扩展,去重但保持顺序
73
- merged_extensions = default_extensions[:]
74
- for extension in user_extensions:
75
- if extension not in merged_extensions:
76
- merged_extensions.append(extension)
77
- self.attributes['EXTENSIONS'] = merged_extensions
78
-
79
- # 更新其他用户配置
80
- for key, value in user_config.items():
81
- if key not in ['MIDDLEWARES', 'PIPELINES', 'EXTENSIONS']:
82
- self.attributes[key] = value
83
-
84
- def get(self, key, default=None):
85
- """安全获取值,不触发递归"""
86
- value = self.attributes.get(key, default)
87
- return value if value is not None else default
88
-
89
- def _get_merged_list(self, key, default=None):
90
- """这个方法已不再需要,因为配置合并已在配置加载时完成"""
91
- return self.attributes.get(key, default or [])
92
-
93
- def get_int(self, key, default=0):
94
- return int(self.get(key, default=default))
95
-
96
- def get_float(self, key, default=0.0):
97
- return float(self.get(key, default=default))
98
-
99
- def get_bool(self, key, default=False):
100
- got = self.get(key, default=default)
101
- if isinstance(got, bool):
102
- return got
103
- if isinstance(got, (int, float)):
104
- return bool(got)
105
- got_lower = str(got).strip().lower()
106
- if got_lower in ('1', 'true'):
107
- return True
108
- if got_lower in ('0', 'false'):
109
- return False
110
- raise ValueError(
111
- f"Unsupported value for boolean setting: {got}. "
112
- "Supported values are: 0/1, True/False, '0'/'1', 'True'/'False' (case-insensitive)."
113
- )
114
-
115
- def get_list(self, key, default=None):
116
- values = self.get(key, default or [])
117
- if isinstance(values, str):
118
- return [v.strip() for v in values.split(',') if v.strip()]
119
- try:
120
- return list(values)
121
- except TypeError:
122
- return [values]
123
-
124
- def get_dict(self, key, default=None):
125
- value = self.get(key, default or {})
126
- if isinstance(value, str):
127
- value = json.loads(value)
128
- try:
129
- return dict(value)
130
- except TypeError:
131
- return value
132
-
133
- def set(self, key, value):
134
- self.attributes[key] = value
135
-
136
- def set_settings(self, module):
137
- if isinstance(module, str):
138
- module = import_module(module)
139
-
140
- # 收集模块中的所有配置项
141
- module_settings = {}
142
- for key in dir(module):
143
- if key.isupper():
144
- module_settings[key] = getattr(module, key)
145
-
146
- # 使用合并逻辑而不是直接设置
147
- self._merge_config(module_settings)
148
-
149
- # 实现 MutableMapping 必须的方法
150
- def __getitem__(self, item):
151
- return self.attributes[item]
152
-
153
- def __setitem__(self, key, value):
154
- self.set(key, value)
155
-
156
- def __delitem__(self, key):
157
- del self.attributes[key]
158
-
159
- def __iter__(self):
160
- return iter(self.attributes)
161
-
162
- def __len__(self):
163
- return len(self.attributes)
164
-
165
- def __str__(self):
166
- return f'<Settings: {self.attributes}>'
167
-
168
- __repr__ = __str__
169
-
170
- def update_attributes(self, attributes):
171
- if attributes is not None:
172
- for key, value in attributes.items():
173
- self.set(key, value)
174
-
175
- def copy(self):
176
- return deepcopy(self)
177
-
178
- def __deepcopy__(self, memo):
179
- """
180
- 自定义深度复制方法,避免复制logger等不可pickle的对象
181
- """
182
- # 创建一个新的实例
183
- cls = self.__class__
184
- new_instance = cls.__new__(cls)
185
-
186
- # 复制attributes字典,但排除不可pickle的对象
187
- new_attributes = {}
188
- for key, value in self.attributes.items():
189
- try:
190
- # 尝试深度复制值
191
- new_attributes[key] = deepcopy(value, memo)
192
- except Exception:
193
- # 如果复制失败,保留原始引用(对于logger等对象)
194
- new_attributes[key] = value
195
-
196
- # 设置新实例的attributes
197
- new_instance.attributes = new_attributes
198
-
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ import json
4
+ from copy import deepcopy
5
+ from importlib import import_module
6
+ from collections.abc import MutableMapping
7
+
8
+ from crawlo.settings import default_settings
9
+
10
+
11
+ class SettingManager(MutableMapping):
12
+
13
+ def __init__(self, values=None):
14
+ self.attributes = {}
15
+ self.set_settings(default_settings)
16
+ # 在初始化时合并配置
17
+ self._merge_config(values)
18
+
19
+ def _merge_config(self, user_config):
20
+ """合并默认配置和用户配置"""
21
+ if not user_config:
22
+ return
23
+
24
+ # 合并中间件配置
25
+ if 'MIDDLEWARES' in user_config:
26
+ default_middlewares = self.attributes.get('MIDDLEWARES', [])
27
+ user_middlewares = user_config['MIDDLEWARES']
28
+ # 如果用户配置了空列表,则仍然使用默认配置
29
+ if user_middlewares:
30
+ # 过滤掉空值和注释
31
+ user_middlewares = [middleware for middleware in user_middlewares if middleware and not middleware.strip().startswith('#')]
32
+ # 合并默认中间件和用户中间件,去重但保持顺序
33
+ merged_middlewares = default_middlewares[:]
34
+ for middleware in user_middlewares:
35
+ if middleware not in merged_middlewares:
36
+ merged_middlewares.append(middleware)
37
+ self.attributes['MIDDLEWARES'] = merged_middlewares
38
+
39
+ # 合并管道配置
40
+ if 'PIPELINES' in user_config:
41
+ default_pipelines = self.attributes.get('PIPELINES', [])
42
+ user_pipelines = user_config['PIPELINES']
43
+ # 如果用户配置了空列表,则仍然使用默认配置
44
+ if user_pipelines:
45
+ # 过滤掉空值和注释
46
+ user_pipelines = [pipeline for pipeline in user_pipelines if pipeline and not pipeline.strip().startswith('#')]
47
+ # 合并默认管道和用户管道,去重但保持顺序
48
+ merged_pipelines = default_pipelines[:]
49
+ for pipeline in user_pipelines:
50
+ if pipeline not in merged_pipelines:
51
+ merged_pipelines.append(pipeline)
52
+ self.attributes['PIPELINES'] = merged_pipelines
53
+
54
+ # 特殊处理PIPELINES,确保去重管道在最前面
55
+ dedup_pipeline = self.attributes.get('DEFAULT_DEDUP_PIPELINE')
56
+ if dedup_pipeline:
57
+ pipelines = self.attributes.get('PIPELINES', [])
58
+ # 移除所有去重管道实例(如果存在)
59
+ pipelines = [item for item in pipelines if item != dedup_pipeline]
60
+ # 在开头插入去重管道
61
+ pipelines.insert(0, dedup_pipeline)
62
+ self.attributes['PIPELINES'] = pipelines
63
+
64
+ # 合并扩展配置
65
+ if 'EXTENSIONS' in user_config:
66
+ default_extensions = self.attributes.get('EXTENSIONS', [])
67
+ user_extensions = user_config['EXTENSIONS']
68
+ # 如果用户配置了空列表,则仍然使用默认配置
69
+ if user_extensions:
70
+ # 过滤掉空值和注释
71
+ user_extensions = [extension for extension in user_extensions if extension and not extension.strip().startswith('#')]
72
+ # 合并默认扩展和用户扩展,去重但保持顺序
73
+ merged_extensions = default_extensions[:]
74
+ for extension in user_extensions:
75
+ if extension not in merged_extensions:
76
+ merged_extensions.append(extension)
77
+ self.attributes['EXTENSIONS'] = merged_extensions
78
+
79
+ # 更新其他用户配置
80
+ for key, value in user_config.items():
81
+ if key not in ['MIDDLEWARES', 'PIPELINES', 'EXTENSIONS']:
82
+ self.attributes[key] = value
83
+
84
+ def get(self, key, default=None):
85
+ """安全获取值,不触发递归"""
86
+ value = self.attributes.get(key, default)
87
+ return value if value is not None else default
88
+
89
+ def _get_merged_list(self, key, default=None):
90
+ """这个方法已不再需要,因为配置合并已在配置加载时完成"""
91
+ return self.attributes.get(key, default or [])
92
+
93
+ def get_int(self, key, default=0):
94
+ return int(self.get(key, default=default))
95
+
96
+ def get_float(self, key, default=0.0):
97
+ return float(self.get(key, default=default))
98
+
99
+ def get_bool(self, key, default=False):
100
+ got = self.get(key, default=default)
101
+ if isinstance(got, bool):
102
+ return got
103
+ if isinstance(got, (int, float)):
104
+ return bool(got)
105
+ got_lower = str(got).strip().lower()
106
+ if got_lower in ('1', 'true'):
107
+ return True
108
+ if got_lower in ('0', 'false'):
109
+ return False
110
+ raise ValueError(
111
+ f"Unsupported value for boolean setting: {got}. "
112
+ "Supported values are: 0/1, True/False, '0'/'1', 'True'/'False' (case-insensitive)."
113
+ )
114
+
115
+ def get_list(self, key, default=None):
116
+ values = self.get(key, default or [])
117
+ if isinstance(values, str):
118
+ return [v.strip() for v in values.split(',') if v.strip()]
119
+ try:
120
+ return list(values)
121
+ except TypeError:
122
+ return [values]
123
+
124
+ def get_dict(self, key, default=None):
125
+ value = self.get(key, default or {})
126
+ if isinstance(value, str):
127
+ value = json.loads(value)
128
+ try:
129
+ return dict(value)
130
+ except TypeError:
131
+ return value
132
+
133
+ def set(self, key, value):
134
+ self.attributes[key] = value
135
+
136
+ def set_settings(self, module):
137
+ if isinstance(module, str):
138
+ module = import_module(module)
139
+
140
+ # 收集模块中的所有配置项
141
+ module_settings = {}
142
+ for key in dir(module):
143
+ if key.isupper():
144
+ module_settings[key] = getattr(module, key)
145
+
146
+ # 使用合并逻辑而不是直接设置
147
+ self._merge_config(module_settings)
148
+
149
+ # 实现 MutableMapping 必须的方法
150
+ def __getitem__(self, item):
151
+ return self.attributes[item]
152
+
153
+ def __setitem__(self, key, value):
154
+ self.set(key, value)
155
+
156
+ def __delitem__(self, key):
157
+ del self.attributes[key]
158
+
159
+ def __iter__(self):
160
+ return iter(self.attributes)
161
+
162
+ def __len__(self):
163
+ return len(self.attributes)
164
+
165
+ def __str__(self):
166
+ return f'<Settings: {self.attributes}>'
167
+
168
+ __repr__ = __str__
169
+
170
+ def update_attributes(self, attributes):
171
+ if attributes is not None:
172
+ for key, value in attributes.items():
173
+ self.set(key, value)
174
+
175
+ def copy(self):
176
+ return deepcopy(self)
177
+
178
+ def __deepcopy__(self, memo):
179
+ """
180
+ 自定义深度复制方法,避免复制logger等不可pickle的对象
181
+ """
182
+ # 创建一个新的实例
183
+ cls = self.__class__
184
+ new_instance = cls.__new__(cls)
185
+
186
+ # 复制attributes字典,但排除不可pickle的对象
187
+ new_attributes = {}
188
+ for key, value in self.attributes.items():
189
+ try:
190
+ # 尝试深度复制值
191
+ new_attributes[key] = deepcopy(value, memo)
192
+ except Exception:
193
+ # 如果复制失败,保留原始引用(对于logger等对象)
194
+ new_attributes[key] = value
195
+
196
+ # 设置新实例的attributes
197
+ new_instance.attributes = new_attributes
198
+
199
199
  return new_instance