crawlo 1.3.3__py3-none-any.whl → 1.3.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 (289) hide show
  1. crawlo/__init__.py +87 -63
  2. crawlo/__version__.py +1 -1
  3. crawlo/cli.py +75 -75
  4. crawlo/commands/__init__.py +14 -14
  5. crawlo/commands/check.py +594 -594
  6. crawlo/commands/genspider.py +151 -151
  7. crawlo/commands/help.py +138 -138
  8. crawlo/commands/list.py +155 -155
  9. crawlo/commands/run.py +341 -323
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +196 -196
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -277
  15. crawlo/core/__init__.py +46 -2
  16. crawlo/core/engine.py +439 -365
  17. crawlo/core/processor.py +40 -40
  18. crawlo/core/scheduler.py +257 -256
  19. crawlo/crawler.py +639 -1167
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -194
  22. crawlo/downloader/__init__.py +273 -273
  23. crawlo/downloader/aiohttp_downloader.py +228 -226
  24. crawlo/downloader/cffi_downloader.py +245 -245
  25. crawlo/downloader/httpx_downloader.py +259 -259
  26. crawlo/downloader/hybrid_downloader.py +212 -212
  27. crawlo/downloader/playwright_downloader.py +402 -402
  28. crawlo/downloader/selenium_downloader.py +472 -472
  29. crawlo/event.py +11 -11
  30. crawlo/exceptions.py +81 -81
  31. crawlo/extension/__init__.py +39 -39
  32. crawlo/extension/health_check.py +141 -141
  33. crawlo/extension/log_interval.py +57 -57
  34. crawlo/extension/log_stats.py +81 -81
  35. crawlo/extension/logging_extension.py +61 -52
  36. crawlo/extension/memory_monitor.py +104 -104
  37. crawlo/extension/performance_profiler.py +133 -133
  38. crawlo/extension/request_recorder.py +107 -107
  39. crawlo/factories/__init__.py +28 -0
  40. crawlo/factories/base.py +69 -0
  41. crawlo/factories/crawler.py +104 -0
  42. crawlo/factories/registry.py +85 -0
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +257 -234
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/framework.py +292 -0
  47. crawlo/initialization/__init__.py +40 -0
  48. crawlo/initialization/built_in.py +426 -0
  49. crawlo/initialization/context.py +142 -0
  50. crawlo/initialization/core.py +194 -0
  51. crawlo/initialization/phases.py +149 -0
  52. crawlo/initialization/registry.py +146 -0
  53. crawlo/items/__init__.py +23 -23
  54. crawlo/items/base.py +23 -22
  55. crawlo/items/fields.py +52 -52
  56. crawlo/items/items.py +104 -104
  57. crawlo/logging/__init__.py +38 -0
  58. crawlo/logging/config.py +97 -0
  59. crawlo/logging/factory.py +129 -0
  60. crawlo/logging/manager.py +112 -0
  61. crawlo/middleware/__init__.py +21 -21
  62. crawlo/middleware/default_header.py +132 -132
  63. crawlo/middleware/download_delay.py +104 -104
  64. crawlo/middleware/middleware_manager.py +135 -135
  65. crawlo/middleware/offsite.py +123 -123
  66. crawlo/middleware/proxy.py +386 -386
  67. crawlo/middleware/request_ignore.py +86 -86
  68. crawlo/middleware/response_code.py +163 -163
  69. crawlo/middleware/response_filter.py +136 -136
  70. crawlo/middleware/retry.py +124 -124
  71. crawlo/middleware/simple_proxy.py +65 -65
  72. crawlo/mode_manager.py +212 -187
  73. crawlo/network/__init__.py +21 -21
  74. crawlo/network/request.py +379 -379
  75. crawlo/network/response.py +359 -359
  76. crawlo/pipelines/__init__.py +21 -21
  77. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  78. crawlo/pipelines/console_pipeline.py +39 -39
  79. crawlo/pipelines/csv_pipeline.py +316 -316
  80. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  81. crawlo/pipelines/json_pipeline.py +218 -218
  82. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  83. crawlo/pipelines/mongo_pipeline.py +131 -131
  84. crawlo/pipelines/mysql_pipeline.py +325 -318
  85. crawlo/pipelines/pipeline_manager.py +76 -75
  86. crawlo/pipelines/redis_dedup_pipeline.py +166 -166
  87. crawlo/project.py +327 -325
  88. crawlo/queue/pqueue.py +43 -37
  89. crawlo/queue/queue_manager.py +503 -379
  90. crawlo/queue/redis_priority_queue.py +326 -306
  91. crawlo/settings/__init__.py +7 -7
  92. crawlo/settings/default_settings.py +321 -225
  93. crawlo/settings/setting_manager.py +214 -198
  94. crawlo/spider/__init__.py +657 -639
  95. crawlo/stats_collector.py +73 -59
  96. crawlo/subscriber.py +129 -129
  97. crawlo/task_manager.py +139 -30
  98. crawlo/templates/crawlo.cfg.tmpl +10 -10
  99. crawlo/templates/project/__init__.py.tmpl +3 -3
  100. crawlo/templates/project/items.py.tmpl +17 -17
  101. crawlo/templates/project/middlewares.py.tmpl +118 -118
  102. crawlo/templates/project/pipelines.py.tmpl +96 -96
  103. crawlo/templates/project/settings.py.tmpl +168 -267
  104. crawlo/templates/project/settings_distributed.py.tmpl +167 -180
  105. crawlo/templates/project/settings_gentle.py.tmpl +167 -61
  106. crawlo/templates/project/settings_high_performance.py.tmpl +168 -131
  107. crawlo/templates/project/settings_minimal.py.tmpl +66 -35
  108. crawlo/templates/project/settings_simple.py.tmpl +165 -102
  109. crawlo/templates/project/spiders/__init__.py.tmpl +10 -6
  110. crawlo/templates/run.py.tmpl +34 -38
  111. crawlo/templates/spider/spider.py.tmpl +143 -143
  112. crawlo/templates/spiders_init.py.tmpl +10 -0
  113. crawlo/tools/__init__.py +200 -200
  114. crawlo/tools/anti_crawler.py +268 -268
  115. crawlo/tools/authenticated_proxy.py +240 -240
  116. crawlo/tools/data_formatter.py +225 -225
  117. crawlo/tools/data_validator.py +180 -180
  118. crawlo/tools/date_tools.py +289 -289
  119. crawlo/tools/distributed_coordinator.py +388 -388
  120. crawlo/tools/encoding_converter.py +127 -127
  121. crawlo/tools/network_diagnostic.py +365 -0
  122. crawlo/tools/request_tools.py +82 -82
  123. crawlo/tools/retry_mechanism.py +224 -224
  124. crawlo/tools/scenario_adapter.py +262 -262
  125. crawlo/tools/text_cleaner.py +232 -232
  126. crawlo/utils/__init__.py +34 -34
  127. crawlo/utils/batch_processor.py +259 -259
  128. crawlo/utils/class_loader.py +26 -0
  129. crawlo/utils/controlled_spider_mixin.py +439 -439
  130. crawlo/utils/db_helper.py +343 -343
  131. crawlo/utils/enhanced_error_handler.py +356 -356
  132. crawlo/utils/env_config.py +142 -142
  133. crawlo/utils/error_handler.py +165 -124
  134. crawlo/utils/func_tools.py +82 -82
  135. crawlo/utils/large_scale_config.py +286 -286
  136. crawlo/utils/large_scale_helper.py +344 -344
  137. crawlo/utils/log.py +80 -200
  138. crawlo/utils/performance_monitor.py +285 -285
  139. crawlo/utils/queue_helper.py +175 -175
  140. crawlo/utils/redis_connection_pool.py +388 -351
  141. crawlo/utils/redis_key_validator.py +198 -198
  142. crawlo/utils/request.py +267 -267
  143. crawlo/utils/request_serializer.py +225 -218
  144. crawlo/utils/spider_loader.py +61 -61
  145. crawlo/utils/system.py +11 -11
  146. crawlo/utils/tools.py +4 -4
  147. crawlo/utils/url.py +39 -39
  148. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/METADATA +1126 -1020
  149. crawlo-1.3.5.dist-info/RECORD +288 -0
  150. examples/__init__.py +7 -7
  151. tests/__init__.py +7 -7
  152. tests/advanced_tools_example.py +275 -275
  153. tests/authenticated_proxy_example.py +107 -107
  154. tests/baidu_performance_test.py +109 -0
  155. tests/baidu_test.py +60 -0
  156. tests/cleaners_example.py +160 -160
  157. tests/comprehensive_framework_test.py +213 -0
  158. tests/comprehensive_test.py +82 -0
  159. tests/comprehensive_testing_summary.md +187 -0
  160. tests/config_validation_demo.py +142 -142
  161. tests/controlled_spider_example.py +205 -205
  162. tests/date_tools_example.py +180 -180
  163. tests/debug_configure.py +70 -0
  164. tests/debug_framework_logger.py +85 -0
  165. tests/debug_log_config.py +127 -0
  166. tests/debug_log_levels.py +64 -0
  167. tests/debug_pipelines.py +66 -66
  168. tests/detailed_log_test.py +234 -0
  169. tests/distributed_test.py +67 -0
  170. tests/distributed_test_debug.py +77 -0
  171. tests/dynamic_loading_example.py +523 -523
  172. tests/dynamic_loading_test.py +104 -104
  173. tests/env_config_example.py +133 -133
  174. tests/error_handling_example.py +171 -171
  175. tests/final_command_test_report.md +0 -0
  176. tests/final_comprehensive_test.py +152 -0
  177. tests/final_log_test.py +261 -0
  178. tests/final_validation_test.py +183 -0
  179. tests/fix_log_test.py +143 -0
  180. tests/framework_performance_test.py +203 -0
  181. tests/log_buffering_test.py +112 -0
  182. tests/log_generation_timing_test.py +154 -0
  183. tests/optimized_performance_test.py +212 -0
  184. tests/performance_comparison.py +246 -0
  185. tests/queue_blocking_test.py +114 -0
  186. tests/queue_test.py +90 -0
  187. tests/redis_key_validation_demo.py +130 -130
  188. tests/request_params_example.py +150 -150
  189. tests/response_improvements_example.py +144 -144
  190. tests/scrapy_comparison/ofweek_scrapy.py +139 -0
  191. tests/scrapy_comparison/scrapy_test.py +134 -0
  192. tests/simple_command_test.py +120 -0
  193. tests/simple_crawlo_test.py +128 -0
  194. tests/simple_log_test.py +58 -0
  195. tests/simple_log_test2.py +138 -0
  196. tests/simple_optimization_test.py +129 -0
  197. tests/simple_spider_test.py +50 -0
  198. tests/simple_test.py +48 -0
  199. tests/spider_log_timing_test.py +178 -0
  200. tests/test_advanced_tools.py +148 -148
  201. tests/test_all_commands.py +231 -0
  202. tests/test_all_redis_key_configs.py +145 -145
  203. tests/test_authenticated_proxy.py +141 -141
  204. tests/test_batch_processor.py +179 -0
  205. tests/test_cleaners.py +54 -54
  206. tests/test_component_factory.py +175 -0
  207. tests/test_comprehensive.py +146 -146
  208. tests/test_config_consistency.py +80 -80
  209. tests/test_config_merge.py +152 -152
  210. tests/test_config_validator.py +182 -182
  211. tests/test_controlled_spider_mixin.py +80 -0
  212. tests/test_crawlo_proxy_integration.py +108 -108
  213. tests/test_date_tools.py +123 -123
  214. tests/test_default_header_middleware.py +158 -158
  215. tests/test_distributed.py +65 -65
  216. tests/test_double_crawlo_fix.py +207 -207
  217. tests/test_double_crawlo_fix_simple.py +124 -124
  218. tests/test_download_delay_middleware.py +221 -221
  219. tests/test_downloader_proxy_compatibility.py +268 -268
  220. tests/test_dynamic_downloaders_proxy.py +124 -124
  221. tests/test_dynamic_proxy.py +92 -92
  222. tests/test_dynamic_proxy_config.py +146 -146
  223. tests/test_dynamic_proxy_real.py +109 -109
  224. tests/test_edge_cases.py +303 -303
  225. tests/test_enhanced_error_handler.py +270 -270
  226. tests/test_enhanced_error_handler_comprehensive.py +246 -0
  227. tests/test_env_config.py +121 -121
  228. tests/test_error_handler_compatibility.py +112 -112
  229. tests/test_factories.py +253 -0
  230. tests/test_final_validation.py +153 -153
  231. tests/test_framework_env_usage.py +103 -103
  232. tests/test_framework_logger.py +67 -0
  233. tests/test_framework_startup.py +65 -0
  234. tests/test_get_component_logger.py +84 -0
  235. tests/test_integration.py +169 -169
  236. tests/test_item_dedup_redis_key.py +122 -122
  237. tests/test_large_scale_config.py +113 -0
  238. tests/test_large_scale_helper.py +236 -0
  239. tests/test_logging_system.py +283 -0
  240. tests/test_mode_change.py +73 -0
  241. tests/test_mode_consistency.py +51 -51
  242. tests/test_offsite_middleware.py +221 -221
  243. tests/test_parsel.py +29 -29
  244. tests/test_performance.py +327 -327
  245. tests/test_performance_monitor.py +116 -0
  246. tests/test_proxy_api.py +264 -264
  247. tests/test_proxy_health_check.py +32 -32
  248. tests/test_proxy_middleware.py +121 -121
  249. tests/test_proxy_middleware_enhanced.py +216 -216
  250. tests/test_proxy_middleware_integration.py +136 -136
  251. tests/test_proxy_middleware_refactored.py +184 -184
  252. tests/test_proxy_providers.py +56 -56
  253. tests/test_proxy_stats.py +19 -19
  254. tests/test_proxy_strategies.py +59 -59
  255. tests/test_queue_empty_check.py +42 -0
  256. tests/test_queue_manager_double_crawlo.py +173 -173
  257. tests/test_queue_manager_redis_key.py +176 -176
  258. tests/test_random_user_agent.py +72 -72
  259. tests/test_real_scenario_proxy.py +195 -195
  260. tests/test_redis_config.py +28 -28
  261. tests/test_redis_connection_pool.py +294 -294
  262. tests/test_redis_key_naming.py +181 -181
  263. tests/test_redis_key_validator.py +123 -123
  264. tests/test_redis_queue.py +224 -224
  265. tests/test_request_ignore_middleware.py +182 -182
  266. tests/test_request_params.py +111 -111
  267. tests/test_request_serialization.py +70 -70
  268. tests/test_response_code_middleware.py +349 -349
  269. tests/test_response_filter_middleware.py +427 -427
  270. tests/test_response_improvements.py +152 -152
  271. tests/test_retry_middleware.py +241 -241
  272. tests/test_scheduler.py +252 -252
  273. tests/test_scheduler_config_update.py +133 -133
  274. tests/test_simple_response.py +61 -61
  275. tests/test_telecom_spider_redis_key.py +205 -205
  276. tests/test_template_content.py +87 -87
  277. tests/test_template_redis_key.py +134 -134
  278. tests/test_tools.py +159 -159
  279. tests/test_user_agents.py +96 -96
  280. tests/tools_example.py +260 -260
  281. tests/untested_features_report.md +139 -0
  282. tests/verify_debug.py +52 -0
  283. tests/verify_distributed.py +117 -117
  284. tests/verify_log_fix.py +112 -0
  285. crawlo-1.3.3.dist-info/RECORD +0 -219
  286. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +0 -82
  287. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/WHEEL +0 -0
  288. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/entry_points.txt +0 -0
  289. {crawlo-1.3.3.dist-info → crawlo-1.3.5.dist-info}/top_level.txt +0 -0
@@ -1,7 +1,7 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- """
4
- # @Time : 2025-05-11 11:08
5
- # @Author : oscar
6
- # @Desc : None
7
- """
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ """
4
+ # @Time : 2025-05-11 11:08
5
+ # @Author : oscar
6
+ # @Desc : None
7
+ """
@@ -1,225 +1,321 @@
1
- # -*- coding:UTF-8 -*-
2
- """
3
- 默认配置文件
4
- 包含 Crawlo 框架的所有默认设置项
5
- """
6
- # 添加环境变量配置工具导入
7
- from crawlo.utils.env_config import get_redis_config, get_runtime_config, get_version
8
-
9
- # ============================== 项目基础配置 ==============================
10
-
11
- # 项目名称(用于日志、Redis Key 等标识)
12
- PROJECT_NAME = get_runtime_config()['PROJECT_NAME']
13
-
14
- # 项目版本号 - 从框架的__version__.py文件中读取,如果不存在则使用默认值
15
- VERSION = get_version()
16
-
17
- # 运行模式:standalone/distributed/auto
18
- RUN_MODE = get_runtime_config()['CRAWLO_MODE']
19
-
20
- # 并发数配置
21
- CONCURRENCY = get_runtime_config()['CONCURRENCY']
22
-
23
- # ============================== 爬虫核心配置 ==============================
24
-
25
- # 默认下载器
26
- DOWNLOADER = "crawlo.downloader.httpx_downloader.HttpXDownloader"
27
-
28
- # 请求延迟(秒)
29
- DOWNLOAD_DELAY = 1
30
-
31
- # 随机延迟配置
32
- RANDOMNESS = False # 是否启用随机延迟
33
- RANDOM_RANGE = [0.5, 1.5] # 随机延迟范围因子,实际延迟 = DOWNLOAD_DELAY * RANDOM_RANGE[0] 到 DOWNLOAD_DELAY * RANDOM_RANGE[1]
34
-
35
- # 深度优先级(负数表示深度优先,正数表示广度优先)
36
- DEPTH_PRIORITY = 1
37
-
38
- # 调度器队列最大大小
39
- SCHEDULER_MAX_QUEUE_SIZE = 1000
40
-
41
- # 调度器队列名称(遵循统一命名规范)
42
- SCHEDULER_QUEUE_NAME = f"crawlo:{PROJECT_NAME}:queue:requests"
43
-
44
- # 队列类型:memory/redis/auto
45
- QUEUE_TYPE = 'auto'
46
-
47
-
48
- # 默认使用内存过滤器和去重管道,确保在无Redis环境下也能正常运行
49
- # 在auto模式下,如果Redis可用,框架会自动更新为Redis实现以提供更好的去重能力
50
- DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.memory_dedup_pipeline.MemoryDedupPipeline'
51
- FILTER_CLASS = 'crawlo.filters.memory_filter.MemoryFilter'
52
-
53
-
54
- MYSQL_HOST = '127.0.0.1'
55
- MYSQL_PORT = 3306
56
- MYSQL_USER = 'root'
57
- MYSQL_PASSWORD = '123456'
58
- MYSQL_DB = 'crawl_pro'
59
- MYSQL_TABLE = 'crawlo'
60
- MYSQL_BATCH_SIZE = 100
61
- MYSQL_USE_BATCH = False # 是否启用批量插入
62
-
63
-
64
- # --- Redis 过滤器配置 ---
65
- # 使用环境变量配置工具获取 Redis 配置
66
- redis_config = get_redis_config()
67
- REDIS_HOST = redis_config['REDIS_HOST']
68
- REDIS_PORT = redis_config['REDIS_PORT']
69
- REDIS_PASSWORD = redis_config['REDIS_PASSWORD']
70
- REDIS_DB = redis_config['REDIS_DB']
71
-
72
- # 根据是否有密码生成不同的 URL 格式
73
- if REDIS_PASSWORD:
74
- REDIS_URL = f'redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
75
- else:
76
- REDIS_URL = f'redis://{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
77
-
78
- # 统一的Redis key命名规范配置
79
- # REDIS_KEY_PREFIX 已移至各组件中,使用统一的命名规范
80
- # crawlo:{PROJECT_NAME}:filter:fingerprint (请求去重)
81
- # crawlo:{PROJECT_NAME}:item:fingerprint (数据项去重)
82
- # crawlo:{PROJECT_NAME}:queue:requests (请求队列)
83
- # crawlo:{PROJECT_NAME}:queue:processing (处理中队列)
84
- # crawlo:{PROJECT_NAME}:queue:failed (失败队列)
85
-
86
- REDIS_TTL = 0 # 指纹过期时间(0 表示永不过期)
87
- CLEANUP_FP = 0 # 程序结束时是否清理指纹(0=不清理)
88
- FILTER_DEBUG = True # 是否开启去重调试日志
89
- DECODE_RESPONSES = True # Redis 返回是否解码为字符串
90
-
91
- # ============================== 框架默认中间件配置 ==============================
92
-
93
- # 框架中间件列表(框架默认中间件 + 用户自定义中间件)
94
- MIDDLEWARES = [
95
- # === 请求预处理阶段 ===
96
- 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware', # 1. 忽略无效请求
97
- 'crawlo.middleware.download_delay.DownloadDelayMiddleware', # 2. 控制请求频率
98
- 'crawlo.middleware.default_header.DefaultHeaderMiddleware', # 3. 添加默认请求头
99
- 'crawlo.middleware.offsite.OffsiteMiddleware', # 5. 站外请求过滤
100
-
101
- # === 响应处理阶段 ===
102
- 'crawlo.middleware.retry.RetryMiddleware', # 6. 失败请求重试
103
- 'crawlo.middleware.response_code.ResponseCodeMiddleware', # 7. 处理特殊状态码
104
- 'crawlo.middleware.response_filter.ResponseFilterMiddleware', # 8. 响应内容过滤
105
- ]
106
-
107
- # ============================== 框架默认管道配置 ==============================
108
-
109
- # 框架数据处理管道列表(框架默认管道 + 用户自定义管道)
110
- PIPELINES = [
111
- 'crawlo.pipelines.console_pipeline.ConsolePipeline',
112
- ]
113
-
114
- # 明确添加默认去重管道到管道列表开头
115
- # 注意:此操作已移至SettingManager中处理,避免重复插入
116
- # PIPELINES.insert(0, DEFAULT_DEDUP_PIPELINE)
117
-
118
- # ============================== 框架默认扩展配置 ==============================
119
-
120
- # 框架扩展组件列表(框架默认扩展 + 用户自定义扩展)
121
- EXTENSIONS = [
122
- 'crawlo.extension.log_interval.LogIntervalExtension', # 定时日志
123
- 'crawlo.extension.log_stats.LogStats', # 统计信息
124
- 'crawlo.extension.logging_extension.CustomLoggerExtension', # 自定义日志
125
- ]
126
-
127
- # ============================== 日志与监控 ==============================
128
-
129
- LOG_LEVEL = 'DEBUG' # 日志级别: DEBUG/INFO/WARNING/ERROR,改为INFO级别
130
- STATS_DUMP = True # 是否周期性输出统计信息
131
- LOG_FILE = f'logs/{PROJECT_NAME}.log' # 日志文件路径
132
- LOG_FORMAT = '%(asctime)s - [%(name)s] - %(levelname)s: %(message)s'
133
- LOG_ENCODING = 'utf-8'
134
-
135
- # ============================== 代理配置 ==============================
136
-
137
- # 代理功能默认不启用,如需使用请在项目配置文件中启用并配置相关参数
138
- PROXY_ENABLED = False # 是否启用代理
139
-
140
- # 简化版代理配置(适用于SimpleProxyMiddleware)
141
- PROXY_LIST = [] # 代理列表,例如: ["http://proxy1:8080", "http://proxy2:8080"]
142
-
143
- # 高级代理配置(适用于ProxyMiddleware)
144
- PROXY_API_URL = "" # 代理获取接口(请替换为真实地址)
145
-
146
- # 代理提取方式(支持字段路径或函数)
147
- # 示例: "proxy" 适用于 {"proxy": "http://1.1.1.1:8080"}
148
- # 示例: "data.proxy" 适用于 {"data": {"proxy": "http://1.1.1.1:8080"}}
149
- PROXY_EXTRACTOR = "proxy"
150
-
151
- # 代理刷新控制
152
- PROXY_REFRESH_INTERVAL = 60 # 代理刷新间隔(秒)
153
- PROXY_API_TIMEOUT = 10 # 请求代理 API 超时时间
154
-
155
- # ============================== Curl-Cffi 特有配置 ==============================
156
-
157
- # 浏览器指纹模拟(仅 CurlCffi 下载器有效)
158
- CURL_BROWSER_TYPE = "chrome" # 可选: chrome, edge, safari, firefox 或版本如 chrome136
159
-
160
- # 自定义浏览器版本映射(可覆盖默认行为)
161
- CURL_BROWSER_VERSION_MAP = {
162
- "chrome": "chrome136",
163
- "edge": "edge101",
164
- "safari": "safari184",
165
- "firefox": "firefox135",
166
- }
167
-
168
- # ============================== 下载器优化配置 ==============================
169
-
170
- # 下载器健康检查
171
- DOWNLOADER_HEALTH_CHECK = True # 是否启用下载器健康检查
172
- HEALTH_CHECK_INTERVAL = 60 # 健康检查间隔(秒)
173
-
174
- # 请求统计配置
175
- REQUEST_STATS_ENABLED = True # 是否启用请求统计
176
- STATS_RESET_ON_START = False # 启动时是否重置统计
177
-
178
- # HttpX 下载器专用配置
179
- HTTPX_HTTP2 = True # 是否启用HTTP/2支持
180
- HTTPX_FOLLOW_REDIRECTS = True # 是否自动跟随重定向
181
-
182
- # AioHttp 下载器专用配置
183
- AIOHTTP_AUTO_DECOMPRESS = True # 是否自动解压响应
184
- AIOHTTP_FORCE_CLOSE = False # 是否强制关闭连接
185
-
186
- # ============================== Selenium 下载器配置 ==============================
187
-
188
- # Selenium 基础配置
189
- SELENIUM_BROWSER_TYPE = "chrome" # 浏览器类型: chrome, firefox, edge
190
- SELENIUM_HEADLESS = True # 是否无头模式
191
- SELENIUM_TIMEOUT = 30 # 超时时间(秒)
192
- SELENIUM_LOAD_TIMEOUT = 10 # 页面加载超时时间(秒)
193
- SELENIUM_WINDOW_WIDTH = 1920 # 窗口宽度
194
- SELENIUM_WINDOW_HEIGHT = 1080 # 窗口高度
195
- SELENIUM_WAIT_FOR_ELEMENT = None # 等待特定元素选择器
196
- SELENIUM_ENABLE_JS = True # 是否启用JavaScript
197
- SELENIUM_PROXY = None # 代理设置
198
- SELENIUM_SINGLE_BROWSER_MODE = True # 单浏览器多标签页模式
199
- SELENIUM_MAX_TABS_PER_BROWSER = 10 # 单浏览器最大标签页数量
200
-
201
- # ============================== Playwright 下载器配置 ==============================
202
-
203
- # Playwright 基础配置
204
- PLAYWRIGHT_BROWSER_TYPE = "chromium" # 浏览器类型: chromium, firefox, webkit
205
- PLAYWRIGHT_HEADLESS = True # 是否无头模式
206
- PLAYWRIGHT_TIMEOUT = 30000 # 超时时间(毫秒)
207
- PLAYWRIGHT_LOAD_TIMEOUT = 10000 # 页面加载超时时间(毫秒)
208
- PLAYWRIGHT_VIEWPORT_WIDTH = 1920 # 视口宽度
209
- PLAYWRIGHT_VIEWPORT_HEIGHT = 1080 # 视口高度
210
- PLAYWRIGHT_WAIT_FOR_ELEMENT = None # 等待特定元素选择器
211
- PLAYWRIGHT_PROXY = None # 代理设置
212
- PLAYWRIGHT_SINGLE_BROWSER_MODE = True # 单浏览器多标签页模式
213
- PLAYWRIGHT_MAX_PAGES_PER_BROWSER = 10 # 单浏览器最大页面数量
214
-
215
- # 通用优化配置
216
- CONNECTION_TTL_DNS_CACHE = 300 # DNS缓存TTL(秒)
217
- CONNECTION_KEEPALIVE_TIMEOUT = 15 # Keep-Alive超时(秒)
218
-
219
- # ============================== 内存监控配置 ==============================
220
-
221
- # 内存监控扩展默认不启用,如需使用请在项目配置文件中启用
222
- MEMORY_MONITOR_ENABLED = False # 是否启用内存监控
223
- MEMORY_MONITOR_INTERVAL = 60 # 内存监控检查间隔(秒)
224
- MEMORY_WARNING_THRESHOLD = 80.0 # 内存使用率警告阈值(百分比)
225
- MEMORY_CRITICAL_THRESHOLD = 90.0 # 内存使用率严重阈值(百分比)
1
+ # -*- coding:UTF-8 -*-
2
+ """
3
+ 默认配置文件
4
+ 包含 Crawlo 框架的所有默认设置项
5
+ """
6
+ # 添加环境变量配置工具导入
7
+ from crawlo.utils.env_config import get_redis_config, get_runtime_config, get_version
8
+
9
+ # 框架初始化控制
10
+ FRAMEWORK_INIT_ORDER = [
11
+ 'log_system', # 日志系统
12
+ 'settings_system', # 配置系统
13
+ 'core_components', # 核心组件
14
+ 'extensions', # 扩展组件
15
+ 'full_initialization' # 完全初始化
16
+ ]
17
+ FRAMEWORK_INIT_STATE = 'uninitialized'
18
+
19
+ # ============================== 项目基础配置 ==============================
20
+
21
+ # 项目名称(用于日志、Redis Key 等标识)
22
+ PROJECT_NAME = get_runtime_config()['PROJECT_NAME']
23
+
24
+ # 确保项目名称不为空
25
+ if not PROJECT_NAME or PROJECT_NAME == 'None':
26
+ PROJECT_NAME = 'crawlo'
27
+
28
+ # 项目版本号 - 从框架的__version__.py文件中读取,如果不存在则使用默认值
29
+ VERSION = get_version()
30
+
31
+ # 运行模式:standalone/distributed/auto
32
+ RUN_MODE = get_runtime_config()['CRAWLO_MODE']
33
+
34
+ # 并发数配置 - 优化默认值以提高性能
35
+ CONCURRENCY = get_runtime_config()['CONCURRENCY']
36
+
37
+ # ============================== 爬虫核心配置 ==============================
38
+
39
+ # 默认下载器
40
+ DOWNLOADER = "crawlo.downloader.httpx_downloader.HttpXDownloader"
41
+
42
+ # 请求延迟(秒)- 优化默认值以提高性能
43
+ DOWNLOAD_DELAY = 0.5
44
+
45
+ # 随机延迟配置
46
+ RANDOMNESS = False # 是否启用随机延迟
47
+ RANDOM_RANGE = [0.5, 1.5] # 随机延迟范围因子,实际延迟 = DOWNLOAD_DELAY * RANDOM_RANGE[0] 到 DOWNLOAD_DELAY * RANDOM_RANGE[1]
48
+
49
+ # 深度优先级(负数表示深度优先,正数表示广度优先)
50
+ DEPTH_PRIORITY = 1
51
+
52
+ # 调度器队列最大大小 - 优化默认值以提高性能
53
+ SCHEDULER_MAX_QUEUE_SIZE = 5000
54
+ # 背压控制配置 - 优化默认值以提高性能
55
+ BACKPRESSURE_RATIO = 0.9 # 背压触发阈值(队列大小达到最大容量的90%时触发背压控制)
56
+
57
+ # 请求生成控制
58
+ REQUEST_GENERATION_BATCH_SIZE = 10 # 请求生成批处理大小
59
+ REQUEST_GENERATION_INTERVAL = 0.01 # 请求生成间隔(秒)
60
+ ENABLE_CONTROLLED_REQUEST_GENERATION = False # 是否启用受控请求生成
61
+
62
+ # 调度器队列名称(遵循统一命名规范)
63
+ SCHEDULER_QUEUE_NAME = f"crawlo:{PROJECT_NAME}:queue:requests"
64
+
65
+ # 队列类型:memory/redis/auto
66
+ QUEUE_TYPE = 'auto'
67
+
68
+ # 队列配置
69
+ QUEUE_MAX_RETRIES = 3 # 队列操作最大重试次数
70
+ QUEUE_TIMEOUT = 300 # 队列操作超时时间(秒)
71
+
72
+ # 默认使用内存过滤器和去重管道,确保在无Redis环境下也能正常运行
73
+ # 在auto模式下,如果Redis可用,框架会自动更新为Redis实现以提供更好的去重能力
74
+ DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.memory_dedup_pipeline.MemoryDedupPipeline'
75
+ FILTER_CLASS = 'crawlo.filters.memory_filter.MemoryFilter'
76
+
77
+ MYSQL_HOST = '127.0.0.1'
78
+ MYSQL_PORT = 3306
79
+ MYSQL_USER = 'root'
80
+ MYSQL_PASSWORD = '123456'
81
+ MYSQL_DB = 'crawl_pro'
82
+ MYSQL_TABLE = 'crawlo'
83
+ MYSQL_BATCH_SIZE = 100
84
+ MYSQL_USE_BATCH = False # 是否启用批量插入
85
+
86
+ # --- Redis 过滤器配置 ---
87
+ # 使用环境变量配置工具获取 Redis 配置
88
+ redis_config = get_redis_config()
89
+ REDIS_HOST = redis_config['REDIS_HOST']
90
+ REDIS_PORT = redis_config['REDIS_PORT']
91
+ REDIS_PASSWORD = redis_config['REDIS_PASSWORD']
92
+ REDIS_DB = redis_config['REDIS_DB']
93
+
94
+ # 根据是否有密码生成不同的 URL 格式
95
+ if REDIS_PASSWORD:
96
+ REDIS_URL = f'redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
97
+ else:
98
+ REDIS_URL = f'redis://{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
99
+
100
+ # 统一的Redis key命名规范配置
101
+ # REDIS_KEY_PREFIX 已移至各组件中,使用统一的命名规范
102
+ # crawlo:{PROJECT_NAME}:filter:fingerprint (请求去重)
103
+ # crawlo:{PROJECT_NAME}:item:fingerprint (数据项去重)
104
+ # crawlo:{PROJECT_NAME}:queue:requests (请求队列)
105
+ # crawlo:{PROJECT_NAME}:queue:processing (处理中队列)
106
+ # crawlo:{PROJECT_NAME}:queue:failed (失败队列)
107
+
108
+ REDIS_TTL = 0 # 指纹过期时间(0 表示永不过期)
109
+ CLEANUP_FP = 0 # 程序结束时是否清理指纹(0=不清理)
110
+ FILTER_DEBUG = True # 是否开启去重调试日志
111
+ DECODE_RESPONSES = True # Redis 返回是否解码为字符串
112
+
113
+ # ============================== 框架默认中间件配置 ==============================
114
+
115
+ # 框架中间件列表(框架默认中间件 + 用户自定义中间件)
116
+ MIDDLEWARES = [
117
+ # === 请求预处理阶段 ===
118
+ 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware', # 1. 忽略无效请求
119
+ 'crawlo.middleware.download_delay.DownloadDelayMiddleware', # 2. 控制请求频率
120
+ 'crawlo.middleware.default_header.DefaultHeaderMiddleware', # 3. 添加默认请求头
121
+ 'crawlo.middleware.offsite.OffsiteMiddleware', # 5. 站外请求过滤
122
+
123
+ # === 响应处理阶段 ===
124
+ 'crawlo.middleware.retry.RetryMiddleware', # 6. 失败请求重试
125
+ 'crawlo.middleware.response_code.ResponseCodeMiddleware', # 7. 处理特殊状态码
126
+ 'crawlo.middleware.response_filter.ResponseFilterMiddleware', # 8. 响应内容过滤
127
+ ]
128
+
129
+ # ============================== 框架默认管道配置 ==============================
130
+
131
+ # 框架数据处理管道列表(框架默认管道 + 用户自定义管道)
132
+ PIPELINES = [
133
+ 'crawlo.pipelines.console_pipeline.ConsolePipeline',
134
+ ]
135
+
136
+ # ============================== 框架默认扩展配置 ==============================
137
+
138
+ # 框架扩展组件列表(框架默认扩展 + 用户自定义扩展)
139
+ EXTENSIONS = [
140
+ 'crawlo.extension.log_interval.LogIntervalExtension', # 定时日志
141
+ 'crawlo.extension.log_stats.LogStats', # 统计信息
142
+ 'crawlo.extension.logging_extension.CustomLoggerExtension', # 自定义日志
143
+ ]
144
+
145
+ # ============================== 日志与监控 ==============================
146
+
147
+ LOG_LEVEL = None # 日志级别: DEBUG/INFO/WARNING/ERROR,默认为None,由用户在项目settings中设置
148
+ STATS_DUMP = True # 是否周期性输出统计信息
149
+ LOG_FILE = None # 日志文件路径,将在项目配置中设置
150
+ LOG_FORMAT = '%(asctime)s - [%(name)s] - %(levelname)s: %(message)s'
151
+ LOG_ENCODING = 'utf-8'
152
+
153
+ # ============================== 代理配置 ==============================
154
+
155
+ # 代理功能默认不启用,如需使用请在项目配置文件中启用并配置相关参数
156
+ PROXY_ENABLED = False # 是否启用代理
157
+
158
+ # 简化版代理配置(适用于SimpleProxyMiddleware)
159
+ PROXY_LIST = [] # 代理列表,例如: ["http://proxy1:8080", "http://proxy2:8080"]
160
+
161
+ # 高级代理配置(适用于ProxyMiddleware)
162
+ PROXY_API_URL = "" # 代理获取接口(请替换为真实地址)
163
+
164
+ # 代理提取方式(支持字段路径或函数)
165
+ # 示例: "proxy" 适用于 {"proxy": "http://1.1.1.1:8080"}
166
+ # 示例: "data.proxy" 适用于 {"data": {"proxy": "http://1.1.1.1:8080"}}
167
+ PROXY_EXTRACTOR = "proxy"
168
+
169
+ # 代理刷新控制
170
+ PROXY_REFRESH_INTERVAL = 60 # 代理刷新间隔(秒)
171
+ PROXY_API_TIMEOUT = 10 # 请求代理 API 超时时间
172
+ PROXY_POOL_SIZE = 5 # 代理池大小
173
+ PROXY_HEALTH_CHECK_THRESHOLD = 0.5 # 代理健康检查阈值
174
+
175
+ # ============================== Curl-Cffi 特有配置 ==============================
176
+
177
+ # 浏览器指纹模拟(仅 CurlCffi 下载器有效)
178
+ CURL_BROWSER_TYPE = "chrome" # 可选: chrome, edge, safari, firefox 或版本如 chrome136
179
+
180
+ # 自定义浏览器版本映射(可覆盖默认行为)
181
+ CURL_BROWSER_VERSION_MAP = {
182
+ "chrome": "chrome136",
183
+ "edge": "edge101",
184
+ "safari": "safari184",
185
+ "firefox": "firefox135",
186
+ }
187
+
188
+ # ============================== 下载器优化配置 ==============================
189
+
190
+ # 下载器健康检查
191
+ DOWNLOADER_HEALTH_CHECK = True # 是否启用下载器健康检查
192
+ HEALTH_CHECK_INTERVAL = 60 # 健康检查间隔(秒)
193
+
194
+ # 请求统计配置
195
+ REQUEST_STATS_ENABLED = True # 是否启用请求统计
196
+ STATS_RESET_ON_START = False # 启动时是否重置统计
197
+
198
+ # HttpX 下载器专用配置
199
+ HTTPX_HTTP2 = True # 是否启用HTTP/2支持
200
+ HTTPX_FOLLOW_REDIRECTS = True # 是否自动跟随重定向
201
+
202
+ # AioHttp 下载器专用配置
203
+ AIOHTTP_AUTO_DECOMPRESS = True # 是否自动解压响应
204
+ AIOHTTP_FORCE_CLOSE = False # 是否强制关闭连接
205
+
206
+ # 通用下载器配置
207
+ DOWNLOAD_TIMEOUT = 30 # 下载超时时间(秒)
208
+ VERIFY_SSL = True # 是否验证SSL证书
209
+ CONNECTION_POOL_LIMIT = 100 # 连接池大小限制
210
+ CONNECTION_POOL_LIMIT_PER_HOST = 20 # 每个主机的连接池大小限制
211
+ DOWNLOAD_MAXSIZE = 10 * 1024 * 1024 # 最大下载大小(字节)
212
+ DOWNLOAD_STATS = True # 是否启用下载统计
213
+ DOWNLOAD_WARN_SIZE = 1024 * 1024 # 下载警告大小(字节)
214
+ DOWNLOAD_RETRY_TIMES = 3 # 下载重试次数
215
+ MAX_RETRY_TIMES = 3 # 最大重试次数
216
+
217
+ # ============================== Selenium 下载器配置 ==============================
218
+
219
+ # Selenium 基础配置
220
+ SELENIUM_BROWSER_TYPE = "chrome" # 浏览器类型: chrome, firefox, edge
221
+ SELENIUM_HEADLESS = True # 是否无头模式
222
+ SELENIUM_TIMEOUT = 30 # 超时时间(秒)
223
+ SELENIUM_LOAD_TIMEOUT = 10 # 页面加载超时时间(秒)
224
+ SELENIUM_WINDOW_WIDTH = 1920 # 窗口宽度
225
+ SELENIUM_WINDOW_HEIGHT = 1080 # 窗口高度
226
+ SELENIUM_WAIT_FOR_ELEMENT = None # 等待特定元素选择器
227
+ SELENIUM_ENABLE_JS = True # 是否启用JavaScript
228
+ SELENIUM_PROXY = None # 代理设置
229
+ SELENIUM_SINGLE_BROWSER_MODE = True # 单浏览器多标签页模式
230
+ SELENIUM_MAX_TABS_PER_BROWSER = 10 # 单浏览器最大标签页数量
231
+
232
+ # ============================== Playwright 下载器配置 ==============================
233
+
234
+ # Playwright 基础配置
235
+ PLAYWRIGHT_BROWSER_TYPE = "chromium" # 浏览器类型: chromium, firefox, webkit
236
+ PLAYWRIGHT_HEADLESS = True # 是否无头模式
237
+ PLAYWRIGHT_TIMEOUT = 30000 # 超时时间(毫秒)
238
+ PLAYWRIGHT_LOAD_TIMEOUT = 10000 # 页面加载超时时间(毫秒)
239
+ PLAYWRIGHT_VIEWPORT_WIDTH = 1920 # 视口宽度
240
+ PLAYWRIGHT_VIEWPORT_HEIGHT = 1080 # 视口高度
241
+ PLAYWRIGHT_WAIT_FOR_ELEMENT = None # 等待特定元素选择器
242
+ PLAYWRIGHT_PROXY = None # 代理设置
243
+ PLAYWRIGHT_SINGLE_BROWSER_MODE = True # 单浏览器多标签页模式
244
+ PLAYWRIGHT_MAX_PAGES_PER_BROWSER = 10 # 单浏览器最大页面数量
245
+
246
+ # 通用优化配置
247
+ CONNECTION_TTL_DNS_CACHE = 300 # DNS缓存TTL(秒)
248
+ CONNECTION_KEEPALIVE_TIMEOUT = 15 # Keep-Alive超时(秒)
249
+
250
+ # ============================== 内存监控配置 ==============================
251
+
252
+ # 内存监控扩展默认不启用,如需使用请在项目配置文件中启用
253
+ MEMORY_MONITOR_ENABLED = False # 是否启用内存监控
254
+ MEMORY_MONITOR_INTERVAL = 60 # 内存监控检查间隔(秒)
255
+ MEMORY_WARNING_THRESHOLD = 80.0 # 内存使用率警告阈值(百分比)
256
+ MEMORY_CRITICAL_THRESHOLD = 90.0 # 内存使用率严重阈值(百分比)
257
+
258
+ # ============================== 性能分析配置 ==============================
259
+
260
+ # 性能分析扩展默认不启用
261
+ PERFORMANCE_PROFILER_ENABLED = False # 是否启用性能分析
262
+ PERFORMANCE_PROFILER_OUTPUT_DIR = 'profiling' # 性能分析输出目录
263
+ PERFORMANCE_PROFILER_INTERVAL = 300 # 性能分析间隔(秒)
264
+
265
+ # ============================== 健康检查配置 ==============================
266
+
267
+ # 健康检查扩展默认启用
268
+ HEALTH_CHECK_ENABLED = True # 是否启用健康检查
269
+
270
+ # ============================== 日志间隔配置 ==============================
271
+
272
+ # 日志间隔扩展配置
273
+ INTERVAL = 60 # 日志输出间隔(秒)
274
+
275
+ # ============================== 自定义日志配置 ==============================
276
+
277
+ # 自定义日志扩展配置
278
+ LOG_ENABLE_CUSTOM = False # 是否启用自定义日志
279
+
280
+ # ============================== 默认请求头配置 ==============================
281
+
282
+ # 默认请求头配置
283
+ DEFAULT_REQUEST_HEADERS = {} # 默认请求头
284
+ USER_AGENT = None # 用户代理
285
+ USER_AGENTS = [] # 用户代理列表
286
+ RANDOM_HEADERS = {} # 随机请求头
287
+ RANDOM_USER_AGENT_ENABLED = False # 是否启用随机用户代理
288
+ USER_AGENT_DEVICE_TYPE = "all" # 用户代理设备类型
289
+
290
+ # ============================== 站外过滤配置 ==============================
291
+
292
+ # 站外过滤配置
293
+ ALLOWED_DOMAINS = [] # 允许的域名列表
294
+
295
+ # ============================== Bloom过滤器配置 ==============================
296
+
297
+ # Bloom过滤器配置
298
+ BLOOM_FILTER_CAPACITY = 1000000 # Bloom过滤器容量
299
+ BLOOM_FILTER_ERROR_RATE = 0.001 # Bloom过滤器错误率
300
+
301
+ # ============================== CSV管道配置 ==============================
302
+
303
+ # CSV管道配置
304
+ CSV_DELIMITER = ',' # CSV分隔符
305
+ CSV_QUOTECHAR = '"' # CSV引号字符
306
+ CSV_INCLUDE_HEADERS = True # 是否包含表头
307
+ CSV_EXTRASACTION = 'ignore' # 额外字段处理方式:ignore, raise
308
+ CSV_FIELDNAMES = None # 字段名列表
309
+ CSV_FILE = None # CSV文件路径
310
+ CSV_DICT_FILE = None # CSV字典文件路径
311
+ CSV_BATCH_SIZE = 100 # CSV批处理大小
312
+ CSV_BATCH_FILE = None # CSV批处理文件路径
313
+
314
+ # ============================== 数据库去重管道配置 ==============================
315
+
316
+ # 数据库去重管道配置
317
+ DB_HOST = 'localhost' # 数据库主机
318
+ DB_PORT = 3306 # 数据库端口
319
+ DB_USER = 'root' # 数据库用户
320
+ DB_PASSWORD = '' # 数据库密码
321
+ DB_NAME = 'crawlo' # 数据库名称