crawlo 1.2.5__py3-none-any.whl → 1.2.7__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 (209) 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 +75 -88
  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 +138 -144
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +323 -323
  14. crawlo/commands/startproject.py +436 -436
  15. crawlo/commands/stats.py +187 -187
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +251 -251
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +365 -354
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +251 -143
  23. crawlo/crawler.py +1099 -1110
  24. crawlo/data/__init__.py +5 -5
  25. crawlo/data/user_agents.py +107 -107
  26. crawlo/downloader/__init__.py +266 -266
  27. crawlo/downloader/aiohttp_downloader.py +228 -221
  28. crawlo/downloader/cffi_downloader.py +256 -256
  29. crawlo/downloader/httpx_downloader.py +259 -259
  30. crawlo/downloader/hybrid_downloader.py +212 -212
  31. crawlo/downloader/playwright_downloader.py +402 -402
  32. crawlo/downloader/selenium_downloader.py +472 -472
  33. crawlo/event.py +11 -11
  34. crawlo/exceptions.py +81 -81
  35. crawlo/extension/__init__.py +39 -38
  36. crawlo/extension/health_check.py +141 -141
  37. crawlo/extension/log_interval.py +57 -57
  38. crawlo/extension/log_stats.py +81 -81
  39. crawlo/extension/logging_extension.py +43 -43
  40. crawlo/extension/memory_monitor.py +104 -104
  41. crawlo/extension/performance_profiler.py +133 -133
  42. crawlo/extension/request_recorder.py +107 -107
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +234 -281
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/items/__init__.py +23 -23
  47. crawlo/items/base.py +21 -21
  48. crawlo/items/fields.py +52 -52
  49. crawlo/items/items.py +104 -104
  50. crawlo/middleware/__init__.py +21 -21
  51. crawlo/middleware/default_header.py +131 -131
  52. crawlo/middleware/download_delay.py +104 -104
  53. crawlo/middleware/middleware_manager.py +136 -135
  54. crawlo/middleware/offsite.py +114 -114
  55. crawlo/middleware/proxy.py +367 -367
  56. crawlo/middleware/request_ignore.py +86 -86
  57. crawlo/middleware/response_code.py +163 -163
  58. crawlo/middleware/response_filter.py +136 -136
  59. crawlo/middleware/retry.py +124 -124
  60. crawlo/mode_manager.py +211 -211
  61. crawlo/network/__init__.py +21 -21
  62. crawlo/network/request.py +338 -338
  63. crawlo/network/response.py +359 -359
  64. crawlo/pipelines/__init__.py +21 -21
  65. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  66. crawlo/pipelines/console_pipeline.py +39 -39
  67. crawlo/pipelines/csv_pipeline.py +316 -316
  68. crawlo/pipelines/database_dedup_pipeline.py +222 -222
  69. crawlo/pipelines/json_pipeline.py +218 -218
  70. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  71. crawlo/pipelines/mongo_pipeline.py +131 -131
  72. crawlo/pipelines/mysql_pipeline.py +317 -317
  73. crawlo/pipelines/pipeline_manager.py +62 -61
  74. crawlo/pipelines/redis_dedup_pipeline.py +166 -165
  75. crawlo/project.py +314 -279
  76. crawlo/queue/pqueue.py +37 -37
  77. crawlo/queue/queue_manager.py +377 -337
  78. crawlo/queue/redis_priority_queue.py +306 -299
  79. crawlo/settings/__init__.py +7 -7
  80. crawlo/settings/default_settings.py +219 -217
  81. crawlo/settings/setting_manager.py +122 -122
  82. crawlo/spider/__init__.py +639 -639
  83. crawlo/stats_collector.py +59 -59
  84. crawlo/subscriber.py +129 -129
  85. crawlo/task_manager.py +30 -30
  86. crawlo/templates/crawlo.cfg.tmpl +10 -10
  87. crawlo/templates/project/__init__.py.tmpl +3 -3
  88. crawlo/templates/project/items.py.tmpl +17 -17
  89. crawlo/templates/project/middlewares.py.tmpl +118 -118
  90. crawlo/templates/project/pipelines.py.tmpl +96 -96
  91. crawlo/templates/project/settings.py.tmpl +288 -324
  92. crawlo/templates/project/settings_distributed.py.tmpl +157 -154
  93. crawlo/templates/project/settings_gentle.py.tmpl +101 -128
  94. crawlo/templates/project/settings_high_performance.py.tmpl +135 -150
  95. crawlo/templates/project/settings_simple.py.tmpl +99 -103
  96. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  97. crawlo/templates/run.py.tmpl +45 -47
  98. crawlo/templates/spider/spider.py.tmpl +143 -143
  99. crawlo/tools/__init__.py +182 -182
  100. crawlo/tools/anti_crawler.py +268 -268
  101. crawlo/tools/authenticated_proxy.py +240 -240
  102. crawlo/tools/data_validator.py +180 -180
  103. crawlo/tools/date_tools.py +35 -35
  104. crawlo/tools/distributed_coordinator.py +386 -386
  105. crawlo/tools/retry_mechanism.py +220 -220
  106. crawlo/tools/scenario_adapter.py +262 -262
  107. crawlo/utils/__init__.py +35 -35
  108. crawlo/utils/batch_processor.py +259 -259
  109. crawlo/utils/controlled_spider_mixin.py +439 -439
  110. crawlo/utils/date_tools.py +290 -290
  111. crawlo/utils/db_helper.py +343 -343
  112. crawlo/utils/enhanced_error_handler.py +356 -356
  113. crawlo/utils/env_config.py +143 -106
  114. crawlo/utils/error_handler.py +123 -123
  115. crawlo/utils/func_tools.py +82 -82
  116. crawlo/utils/large_scale_config.py +286 -286
  117. crawlo/utils/large_scale_helper.py +344 -344
  118. crawlo/utils/log.py +128 -128
  119. crawlo/utils/performance_monitor.py +285 -285
  120. crawlo/utils/queue_helper.py +175 -175
  121. crawlo/utils/redis_connection_pool.py +351 -334
  122. crawlo/utils/redis_key_validator.py +198 -198
  123. crawlo/utils/request.py +267 -267
  124. crawlo/utils/request_serializer.py +218 -218
  125. crawlo/utils/spider_loader.py +61 -61
  126. crawlo/utils/system.py +11 -11
  127. crawlo/utils/tools.py +4 -4
  128. crawlo/utils/url.py +39 -39
  129. {crawlo-1.2.5.dist-info → crawlo-1.2.7.dist-info}/METADATA +764 -764
  130. crawlo-1.2.7.dist-info/RECORD +209 -0
  131. examples/__init__.py +7 -7
  132. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  133. tests/__init__.py +7 -7
  134. tests/advanced_tools_example.py +275 -275
  135. tests/authenticated_proxy_example.py +236 -236
  136. tests/cleaners_example.py +160 -160
  137. tests/config_validation_demo.py +102 -102
  138. tests/controlled_spider_example.py +205 -205
  139. tests/date_tools_example.py +180 -180
  140. tests/dynamic_loading_example.py +523 -523
  141. tests/dynamic_loading_test.py +104 -104
  142. tests/env_config_example.py +133 -133
  143. tests/error_handling_example.py +171 -171
  144. tests/redis_key_validation_demo.py +130 -130
  145. tests/response_improvements_example.py +144 -144
  146. tests/test_advanced_tools.py +148 -148
  147. tests/test_all_redis_key_configs.py +145 -145
  148. tests/test_authenticated_proxy.py +141 -141
  149. tests/test_cleaners.py +54 -54
  150. tests/test_comprehensive.py +146 -146
  151. tests/test_config_consistency.py +81 -0
  152. tests/test_config_validator.py +193 -193
  153. tests/test_crawlo_proxy_integration.py +172 -172
  154. tests/test_date_tools.py +123 -123
  155. tests/test_default_header_middleware.py +158 -158
  156. tests/test_double_crawlo_fix.py +207 -207
  157. tests/test_double_crawlo_fix_simple.py +124 -124
  158. tests/test_download_delay_middleware.py +221 -221
  159. tests/test_downloader_proxy_compatibility.py +268 -268
  160. tests/test_dynamic_downloaders_proxy.py +124 -124
  161. tests/test_dynamic_proxy.py +92 -92
  162. tests/test_dynamic_proxy_config.py +146 -146
  163. tests/test_dynamic_proxy_real.py +109 -109
  164. tests/test_edge_cases.py +303 -303
  165. tests/test_enhanced_error_handler.py +270 -270
  166. tests/test_env_config.py +121 -121
  167. tests/test_error_handler_compatibility.py +112 -112
  168. tests/test_final_validation.py +153 -153
  169. tests/test_framework_env_usage.py +103 -103
  170. tests/test_integration.py +356 -356
  171. tests/test_item_dedup_redis_key.py +122 -122
  172. tests/test_mode_consistency.py +52 -0
  173. tests/test_offsite_middleware.py +221 -221
  174. tests/test_parsel.py +29 -29
  175. tests/test_performance.py +327 -327
  176. tests/test_proxy_api.py +264 -264
  177. tests/test_proxy_health_check.py +32 -32
  178. tests/test_proxy_middleware.py +121 -121
  179. tests/test_proxy_middleware_enhanced.py +216 -216
  180. tests/test_proxy_middleware_integration.py +136 -136
  181. tests/test_proxy_providers.py +56 -56
  182. tests/test_proxy_stats.py +19 -19
  183. tests/test_proxy_strategies.py +59 -59
  184. tests/test_queue_manager_double_crawlo.py +173 -173
  185. tests/test_queue_manager_redis_key.py +176 -176
  186. tests/test_real_scenario_proxy.py +195 -195
  187. tests/test_redis_config.py +28 -28
  188. tests/test_redis_connection_pool.py +294 -294
  189. tests/test_redis_key_naming.py +181 -181
  190. tests/test_redis_key_validator.py +123 -123
  191. tests/test_redis_queue.py +224 -224
  192. tests/test_request_ignore_middleware.py +182 -182
  193. tests/test_request_serialization.py +70 -70
  194. tests/test_response_code_middleware.py +349 -349
  195. tests/test_response_filter_middleware.py +427 -427
  196. tests/test_response_improvements.py +152 -152
  197. tests/test_retry_middleware.py +241 -241
  198. tests/test_scheduler.py +252 -241
  199. tests/test_scheduler_config_update.py +134 -0
  200. tests/test_simple_response.py +61 -61
  201. tests/test_telecom_spider_redis_key.py +205 -205
  202. tests/test_template_content.py +87 -87
  203. tests/test_template_redis_key.py +134 -134
  204. tests/test_tools.py +153 -153
  205. tests/tools_example.py +257 -257
  206. crawlo-1.2.5.dist-info/RECORD +0 -206
  207. {crawlo-1.2.5.dist-info → crawlo-1.2.7.dist-info}/WHEEL +0 -0
  208. {crawlo-1.2.5.dist-info → crawlo-1.2.7.dist-info}/entry_points.txt +0 -0
  209. {crawlo-1.2.5.dist-info → crawlo-1.2.7.dist-info}/top_level.txt +0 -0
@@ -1,155 +1,158 @@
1
- # -*- coding: UTF-8 -*-
2
- """
3
- {{project_name}} 项目配置文件(分布式版)
4
- =============================
5
- 基于 Crawlo 框架的分布式爬虫项目配置。
6
- 适合大规模数据采集和多节点部署。
7
- """
8
- import os
9
- from crawlo.config import CrawloConfig
10
-
11
- # ============================== 项目基本信息 ==============================
12
- PROJECT_NAME = '{{project_name}}'
13
-
14
- # ============================== 分布式配置说明 ==============================
15
- #
16
- # 本模板专为分布式部署设计,适用于以下场景:
17
- # - 大规模数据采集任务
18
- # - 需要多节点协同工作的项目
19
- # - 高并发、高吞吐量需求
20
- #
21
- # 运行模式特点:
22
- # - RUN_MODE = 'distributed'(分布式模式)
23
- # - QUEUE_TYPE = 'redis'(使用Redis队列实现分布式协调)
24
- # - FILTER_CLASS = 'crawlo.filters.aioredis_filter.AioRedisFilter'(Redis过滤器)
25
- # - DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.redis_dedup_pipeline.RedisDedupPipeline'(Redis去重)
26
- #
27
- # 部署要求:
28
- # - 需要配置Redis服务器连接参数
29
- # - 建议使用独立的Redis数据库避免数据冲突
30
- # - 多节点部署时确保所有节点能访问同一Redis实例
31
- #
32
- # 🎯 最佳使用方式:
33
- # 推荐使用配置工厂方式创建分布式配置:
34
- # from crawlo.config import CrawloConfig
35
- # config = CrawloConfig.distributed(
36
- # redis_host='your_redis_host',
37
- # redis_port=6379,
38
- # redis_password='your_password',
39
- # project_name='{{project_name}}'
40
- # )
41
- # process = CrawlerProcess(settings=config.to_dict())
42
-
43
- # ============================== 分布式配置 ==============================
44
- # 使用配置工厂创建分布式配置
45
- CONFIG = CrawloConfig.distributed(
46
- redis_host=os.getenv('REDIS_HOST', '127.0.0.1'),
47
- redis_port=int(os.getenv('REDIS_PORT', 6379)),
48
- redis_password=os.getenv('REDIS_PASSWORD', ''),
49
- project_name='{{project_name}}',
50
- concurrency=16,
51
- download_delay=1.0
52
- )
53
-
54
- # 获取配置
55
- locals().update(CONFIG.to_dict())
56
-
57
- # ============================== 网络请求配置 ==============================
58
- DOWNLOADER = "crawlo.downloader.httpx_downloader.HttpXDownloader"
59
- DOWNLOAD_TIMEOUT = 60
60
- VERIFY_SSL = True
61
-
62
- # ============================== 并发配置 ==============================
63
- CONCURRENCY = 16
64
- MAX_RUNNING_SPIDERS = 5
65
- DOWNLOAD_DELAY = 1.0
66
-
67
- # ============================== 队列配置 ==============================
68
- SCHEDULER_MAX_QUEUE_SIZE = 5000
69
- QUEUE_MAX_RETRIES = 5
70
- QUEUE_TIMEOUT = 300
71
-
72
- # ============================== Redis 配置 ==============================
73
- REDIS_HOST = os.getenv('REDIS_HOST', '127.0.0.1')
74
- REDIS_PORT = int(os.getenv('REDIS_PORT', 6379))
75
- REDIS_PASSWORD = os.getenv('REDIS_PASSWORD', '')
76
- REDIS_DB = int(os.getenv('REDIS_DB', 0))
77
-
78
- # 根据是否有密码生成 URL
79
- if REDIS_PASSWORD:
80
- REDIS_URL = f'redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
81
- else:
82
- REDIS_URL = f'redis://{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
83
-
84
- # ============================== 数据存储配置 ==============================
85
- # MySQL 配置
86
- MYSQL_HOST = os.getenv('MYSQL_HOST', '127.0.0.1')
87
- MYSQL_PORT = int(os.getenv('MYSQL_PORT', 3306))
88
- MYSQL_USER = os.getenv('MYSQL_USER', 'root')
89
- MYSQL_PASSWORD = os.getenv('MYSQL_PASSWORD', '123456')
90
- MYSQL_DB = os.getenv('MYSQL_DB', '{{project_name}}')
91
- MYSQL_TABLE = '{{project_name}}_data'
92
- MYSQL_BATCH_SIZE = 100
93
- MYSQL_USE_BATCH = True
94
-
95
- # MongoDB 配置
96
- MONGO_URI = os.getenv('MONGO_URI', 'mongodb://localhost:27017')
97
- MONGO_DATABASE = '{{project_name}}_db'
98
- MONGO_COLLECTION = '{{project_name}}_items'
99
- MONGO_BATCH_SIZE = 100
100
- MONGO_USE_BATCH = True
101
-
102
- # ============================== 去重配置 ==============================
103
- # 明确指定分布式模式下使用Redis去重管道
104
- DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.redis_dedup_pipeline.RedisDedupPipeline'
105
- FILTER_CLASS = 'crawlo.filters.aioredis_filter.AioRedisFilter'
106
- REDIS_TTL = 0
107
- CLEANUP_FP = 0
108
- FILTER_DEBUG = True
109
-
110
- # ============================== 中间件与管道 ==============================
111
- MIDDLEWARES = [
112
- 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware',
113
- 'crawlo.middleware.download_delay.DownloadDelayMiddleware',
114
- 'crawlo.middleware.default_header.DefaultHeaderMiddleware',
115
- 'crawlo.middleware.proxy.ProxyMiddleware',
116
- 'crawlo.middleware.offsite.OffsiteMiddleware',
117
-
118
- 'crawlo.middleware.retry.RetryMiddleware',
119
- 'crawlo.middleware.response_code.ResponseCodeMiddleware',
120
- 'crawlo.middleware.response_filter.ResponseFilterMiddleware',
121
- ]
122
-
123
- PIPELINES = [
124
- 'crawlo.pipelines.console_pipeline.ConsolePipeline',
125
- # '{{project_name}}.pipelines.DatabasePipeline',
126
- # 'crawlo.pipelines.mysql_pipeline.AsyncmyMySQLPipeline',
127
- # 'crawlo.pipelines.mongo_pipeline.MongoPipeline',
128
- ]
129
-
130
- # 明确添加Redis去重管道到管道列表开头
131
- PIPELINES.insert(0, DEFAULT_DEDUP_PIPELINE)
132
-
133
- # ============================== 扩展组件 ==============================
134
- EXTENSIONS = [
135
- 'crawlo.extension.log_interval.LogIntervalExtension',
136
- 'crawlo.extension.log_stats.LogStats',
137
- 'crawlo.extension.logging_extension.CustomLoggerExtension',
138
- # 'crawlo.extension.memory_monitor.MemoryMonitorExtension',
139
- # 'crawlo.extension.request_recorder.RequestRecorderExtension',
140
- ]
141
-
142
- # ============================== 日志配置 ==============================
143
- LOG_LEVEL = 'INFO'
144
- LOG_FILE = f'logs/{{project_name}}.log'
145
- STATS_DUMP = True
146
-
147
- # ============================== 代理配置 ==============================
148
- PROXY_ENABLED = False
149
- PROXY_API_URL = ""
150
- PROXY_EXTRACTOR = "proxy"
151
- PROXY_REFRESH_INTERVAL = 60
152
- PROXY_API_TIMEOUT = 10
153
-
154
- # ============================== 自定义配置 ==============================
1
+ # -*- coding: UTF-8 -*-
2
+ """
3
+ {{project_name}} 项目配置文件(分布式版)
4
+ =============================
5
+ 基于 Crawlo 框架的分布式爬虫项目配置。
6
+ 适合大规模数据采集和多节点部署。
7
+ """
8
+ import os
9
+ from crawlo.config import CrawloConfig
10
+
11
+ # ============================== 项目基本信息 ==============================
12
+ PROJECT_NAME = '{{project_name}}'
13
+
14
+ # ============================== 分布式配置说明 ==============================
15
+ RUN_MODE = 'distributed'
16
+ QUEUE_TYPE = 'redis'
17
+ FILTER_CLASS = 'crawlo.filters.aioredis_filter.AioRedisFilter'
18
+ DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.redis_dedup_pipeline.RedisDedupPipeline'
19
+ # 本模板专为分布式部署设计,适用于以下场景:
20
+ # - 大规模数据采集任务
21
+ # - 需要多节点协同工作的项目
22
+ # - 高并发、高吞吐量需求
23
+ #
24
+ # 运行模式特点:
25
+ # - RUN_MODE = 'distributed'(分布式模式)
26
+ # - QUEUE_TYPE = 'redis'(使用Redis队列实现分布式协调)
27
+ # - FILTER_CLASS = 'crawlo.filters.aioredis_filter.AioRedisFilter'(Redis过滤器)
28
+ # - DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.redis_dedup_pipeline.RedisDedupPipeline'(Redis去重)
29
+ #
30
+ # 部署要求:
31
+ # - 需要配置Redis服务器连接参数
32
+ # - 建议使用独立的Redis数据库避免数据冲突
33
+ # - 多节点部署时确保所有节点能访问同一Redis实例
34
+ #
35
+ # 🎯 最佳使用方式:
36
+ # 推荐使用配置工厂方式创建分布式配置:
37
+ # from crawlo.config import CrawloConfig
38
+ # config = CrawloConfig.distributed(
39
+ # redis_host='your_redis_host',
40
+ # redis_port=6379,
41
+ # redis_password='your_password',
42
+ # project_name='{{project_name}}'
43
+ # )
44
+ # process = CrawlerProcess(settings=config.to_dict())
45
+
46
+ # ============================== 分布式配置 ==============================
47
+ # 使用配置工厂创建分布式配置
48
+ CONFIG = CrawloConfig.distributed(
49
+ redis_host=os.getenv('REDIS_HOST', '127.0.0.1'),
50
+ redis_port=int(os.getenv('REDIS_PORT', 6379)),
51
+ redis_password=os.getenv('REDIS_PASSWORD', ''),
52
+ project_name='{{project_name}}',
53
+ concurrency=16,
54
+ download_delay=1.0
55
+ )
56
+
57
+ # 获取配置
58
+ locals().update(CONFIG.to_dict())
59
+
60
+ # ============================== 网络请求配置 ==============================
61
+ DOWNLOADER = "crawlo.downloader.httpx_downloader.HttpXDownloader"
62
+ DOWNLOAD_TIMEOUT = 60
63
+ VERIFY_SSL = True
64
+
65
+ # ============================== 并发配置 ==============================
66
+ CONCURRENCY = 16
67
+ MAX_RUNNING_SPIDERS = 5
68
+ DOWNLOAD_DELAY = 1.0
69
+
70
+ # ============================== 队列配置 ==============================
71
+ SCHEDULER_MAX_QUEUE_SIZE = 5000
72
+ QUEUE_MAX_RETRIES = 5
73
+ QUEUE_TIMEOUT = 300
74
+
75
+ # ============================== Redis 配置 ==============================
76
+ REDIS_HOST = os.getenv('REDIS_HOST', '127.0.0.1')
77
+ REDIS_PORT = int(os.getenv('REDIS_PORT', 6379))
78
+ REDIS_PASSWORD = os.getenv('REDIS_PASSWORD', '')
79
+ REDIS_DB = int(os.getenv('REDIS_DB', 0))
80
+
81
+ # 根据是否有密码生成 URL
82
+ if REDIS_PASSWORD:
83
+ REDIS_URL = f'redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
84
+ else:
85
+ REDIS_URL = f'redis://{REDIS_HOST}:{REDIS_PORT}/{REDIS_DB}'
86
+
87
+ # ============================== 数据存储配置 ==============================
88
+ # MySQL 配置
89
+ MYSQL_HOST = os.getenv('MYSQL_HOST', '127.0.0.1')
90
+ MYSQL_PORT = int(os.getenv('MYSQL_PORT', 3306))
91
+ MYSQL_USER = os.getenv('MYSQL_USER', 'root')
92
+ MYSQL_PASSWORD = os.getenv('MYSQL_PASSWORD', '123456')
93
+ MYSQL_DB = os.getenv('MYSQL_DB', '{{project_name}}')
94
+ MYSQL_TABLE = '{{project_name}}_data'
95
+ MYSQL_BATCH_SIZE = 100
96
+ MYSQL_USE_BATCH = True
97
+
98
+ # MongoDB 配置
99
+ MONGO_URI = os.getenv('MONGO_URI', 'mongodb://localhost:27017')
100
+ MONGO_DATABASE = '{{project_name}}_db'
101
+ MONGO_COLLECTION = '{{project_name}}_items'
102
+ MONGO_BATCH_SIZE = 100
103
+ MONGO_USE_BATCH = True
104
+
105
+ # ============================== 去重配置 ==============================
106
+ # 明确指定分布式模式下使用Redis去重管道
107
+ DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.redis_dedup_pipeline.RedisDedupPipeline'
108
+ FILTER_CLASS = 'crawlo.filters.aioredis_filter.AioRedisFilter'
109
+ REDIS_TTL = 0
110
+ CLEANUP_FP = 0
111
+ FILTER_DEBUG = True
112
+
113
+ # ============================== 中间件与管道 ==============================
114
+ MIDDLEWARES = [
115
+ 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware',
116
+ 'crawlo.middleware.download_delay.DownloadDelayMiddleware',
117
+ 'crawlo.middleware.default_header.DefaultHeaderMiddleware',
118
+ 'crawlo.middleware.proxy.ProxyMiddleware',
119
+ 'crawlo.middleware.offsite.OffsiteMiddleware',
120
+
121
+ 'crawlo.middleware.retry.RetryMiddleware',
122
+ 'crawlo.middleware.response_code.ResponseCodeMiddleware',
123
+ 'crawlo.middleware.response_filter.ResponseFilterMiddleware',
124
+ ]
125
+
126
+ PIPELINES = [
127
+ 'crawlo.pipelines.console_pipeline.ConsolePipeline',
128
+ # '{{project_name}}.pipelines.DatabasePipeline',
129
+ # 'crawlo.pipelines.mysql_pipeline.AsyncmyMySQLPipeline',
130
+ # 'crawlo.pipelines.mongo_pipeline.MongoPipeline',
131
+ ]
132
+
133
+ # 明确添加Redis去重管道到管道列表开头
134
+ PIPELINES.insert(0, DEFAULT_DEDUP_PIPELINE)
135
+
136
+ # ============================== 扩展组件 ==============================
137
+ EXTENSIONS = [
138
+ 'crawlo.extension.log_interval.LogIntervalExtension',
139
+ 'crawlo.extension.log_stats.LogStats',
140
+ 'crawlo.extension.logging_extension.CustomLoggerExtension',
141
+ # 'crawlo.extension.memory_monitor.MemoryMonitorExtension',
142
+ # 'crawlo.extension.request_recorder.RequestRecorderExtension',
143
+ ]
144
+
145
+ # ============================== 日志配置 ==============================
146
+ LOG_LEVEL = 'INFO'
147
+ LOG_FILE = f'logs/{{project_name}}.log'
148
+ STATS_DUMP = True
149
+
150
+ # ============================== 代理配置 ==============================
151
+ PROXY_ENABLED = False
152
+ PROXY_API_URL = ""
153
+ PROXY_EXTRACTOR = "proxy"
154
+ PROXY_REFRESH_INTERVAL = 60
155
+ PROXY_API_TIMEOUT = 10
156
+
157
+ # ============================== 自定义配置 ==============================
155
158
  # 在此处添加项目特定的配置项
@@ -1,128 +1,101 @@
1
- # -*- coding: UTF-8 -*-
2
- """
3
- {{project_name}} 项目配置文件(温和版)
4
- =============================
5
- 基于 Crawlo 框架的温和爬虫项目配置。
6
- 适合对目标网站友好的低负载爬取。
7
- """
8
- import os
9
- from crawlo.config import CrawloConfig
10
-
11
- # ============================== 项目基本信息 ==============================
12
- PROJECT_NAME = '{{project_name}}'
13
-
14
- # ============================== 温和模式配置说明 ==============================
15
- #
16
- # 本模板专为对目标网站友好的低负载爬取设计,适用于以下场景:
17
- # - 需要避免对目标网站造成过大压力
18
- # - 长时间运行的监控类爬虫
19
- # - 对目标网站有友好性要求的项目
20
- #
21
- # 运行模式特点:
22
- # - RUN_MODE = 'standalone'(单机模式)
23
- # - QUEUE_TYPE = 'memory'(使用内存队列)
24
- # - FILTER_CLASS = 'crawlo.filters.memory_filter.MemoryFilter'(内存过滤器)
25
- # - DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.memory_dedup_pipeline.MemoryDedupPipeline'(内存去重)
26
- #
27
- # 配置特点:
28
- # - 低并发:CONCURRENCY = 2
29
- # - 高延迟:DOWNLOAD_DELAY = 3.0秒
30
- # - 随机化:启用RANDOMNESS增加随机性
31
- # - 连接池限制:减少连接数避免给服务器造成压力
32
- #
33
- # 扩展建议:
34
- # - 如需跨会话去重,可将FILTER_CLASS和DEFAULT_DEDUP_PIPELINE改为Redis实现
35
- # - 可根据目标网站特性调整DOWNLOAD_DELAY和RANDOM_RANGE参数
36
- #
37
- # 🎯 最佳使用方式:
38
- # 推荐使用配置工厂方式创建温和模式配置:
39
- # from crawlo.config import CrawloConfig
40
- # config = CrawloConfig.presets().gentle()
41
- # process = CrawlerProcess(settings=config.to_dict())
42
-
43
- # ============================== 温和模式配置 ==============================
44
- # 使用配置工厂创建温和模式配置
45
- CONFIG = CrawloConfig.presets().gentle()
46
-
47
- # 获取配置
48
- locals().update(CONFIG.to_dict())
49
-
50
- # ============================== 网络请求配置 ==============================
51
- DOWNLOADER = "crawlo.downloader.httpx_downloader.HttpXDownloader"
52
- DOWNLOAD_TIMEOUT = 60
53
- VERIFY_SSL = True
54
-
55
- # ============================== 低并发配置 ==============================
56
- CONCURRENCY = 2
57
- MAX_RUNNING_SPIDERS = 1
58
- DOWNLOAD_DELAY = 3.0
59
- RANDOMNESS = True
60
- RANDOM_RANGE = (2.0, 5.0)
61
-
62
- # ============================== 连接池配置 ==============================
63
- CONNECTION_POOL_LIMIT = 10
64
- CONNECTION_POOL_LIMIT_PER_HOST = 5
65
-
66
- # ============================== 重试配置 ==============================
67
- MAX_RETRY_TIMES = 3
68
- RETRY_HTTP_CODES = [408, 429, 500, 502, 503, 504, 522, 524]
69
- IGNORE_HTTP_CODES = [403, 404]
70
-
71
- # ============================== 队列配置 ==============================
72
- SCHEDULER_MAX_QUEUE_SIZE = 1000
73
- QUEUE_MAX_RETRIES = 3
74
- QUEUE_TIMEOUT = 300
75
-
76
- # ============================== 数据存储配置 ==============================
77
- # MySQL 配置
78
- MYSQL_HOST = os.getenv('MYSQL_HOST', '127.0.0.1')
79
- MYSQL_PORT = int(os.getenv('MYSQL_PORT', 3306))
80
- MYSQL_USER = os.getenv('MYSQL_USER', 'root')
81
- MYSQL_PASSWORD = os.getenv('MYSQL_PASSWORD', '123456')
82
- MYSQL_DB = os.getenv('MYSQL_DB', '{{project_name}}')
83
- MYSQL_TABLE = '{{project_name}}_data'
84
-
85
- # MongoDB 配置
86
- MONGO_URI = os.getenv('MONGO_URI', 'mongodb://localhost:27017')
87
- MONGO_DATABASE = '{{project_name}}_db'
88
- MONGO_COLLECTION = '{{project_name}}_items'
89
-
90
- # ============================== 去重配置 ==============================
91
- # 明确指定温和模式下使用内存去重管道
92
- DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.memory_dedup_pipeline.MemoryDedupPipeline'
93
- FILTER_CLASS = 'crawlo.filters.memory_filter.MemoryFilter'
94
- REDIS_TTL = 0
95
- CLEANUP_FP = 0
96
- FILTER_DEBUG = True
97
-
98
- # ============================== 中间件与管道 ==============================
99
- MIDDLEWARES = [
100
- 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware',
101
- 'crawlo.middleware.download_delay.DownloadDelayMiddleware',
102
- 'crawlo.middleware.default_header.DefaultHeaderMiddleware',
103
- 'crawlo.middleware.retry.RetryMiddleware',
104
- 'crawlo.middleware.response_code.ResponseCodeMiddleware',
105
- ]
106
-
107
- PIPELINES = [
108
- 'crawlo.pipelines.console_pipeline.ConsolePipeline',
109
- # '{{project_name}}.pipelines.DatabasePipeline',
110
- ]
111
-
112
- # 明确添加内存去重管道到管道列表开头
113
- PIPELINES.insert(0, DEFAULT_DEDUP_PIPELINE)
114
-
115
- # ============================== 扩展组件 ==============================
116
- EXTENSIONS = [
117
- 'crawlo.extension.log_interval.LogIntervalExtension',
118
- 'crawlo.extension.log_stats.LogStats',
119
- 'crawlo.extension.logging_extension.CustomLoggerExtension',
120
- ]
121
-
122
- # ============================== 日志配置 ==============================
123
- LOG_LEVEL = 'INFO'
124
- LOG_FILE = f'logs/{{project_name}}.log'
125
- STATS_DUMP = True
126
-
127
- # ============================== 自定义配置 ==============================
128
- # 在此处添加项目特定的配置项
1
+ # -*- coding: UTF-8 -*-
2
+ """
3
+ 温和模式配置模板
4
+ 低负载配置,对目标网站友好
5
+ """
6
+
7
+ # ============================== 项目基本信息 ==============================
8
+ PROJECT_NAME = '{{project_name}}'
9
+
10
+ # ============================== 温和运行模式 ==============================
11
+ # 运行模式:'standalone'(单机), 'distributed'(分布式), 'auto'(自动检测)
12
+ RUN_MODE = 'standalone' # 单机模式 - 适用于开发和小规模数据采集
13
+
14
+ # 并发配置
15
+ CONCURRENCY = 2 # 极低并发数以减少目标网站压力
16
+ DOWNLOAD_DELAY = 3.0 # 增加延迟以降低目标网站压力
17
+ RANDOMNESS = True # 启用随机延迟
18
+ RANDOM_RANGE = (0.5, 2.0) # 随机延迟范围
19
+
20
+ # ============================== 队列配置 ==============================
21
+
22
+ # 队列类型:'auto'(自动选择), 'memory'(内存队列), 'redis'(分布式队列)
23
+ QUEUE_TYPE = 'auto' # 自动检测,如果Redis可用则使用Redis队列
24
+ SCHEDULER_MAX_QUEUE_SIZE = 500
25
+ SCHEDULER_QUEUE_NAME = f'crawlo:{{project_name}}:queue:requests'
26
+ QUEUE_MAX_RETRIES = 3
27
+ QUEUE_TIMEOUT = 300
28
+
29
+ # ============================== 去重过滤配置 ==============================
30
+
31
+ # 温和模式下使用内存去重管道和过滤器
32
+ DEFAULT_DEDUP_PIPELINE = 'crawlo.pipelines.memory_dedup_pipeline.MemoryDedupPipeline'
33
+ FILTER_CLASS = 'crawlo.filters.memory_filter.MemoryFilter'
34
+
35
+ # --- Redis 配置(用于分布式去重和队列) ---
36
+ REDIS_HOST = '127.0.0.1'
37
+ REDIS_PORT = 6379
38
+ REDIS_PASSWORD = '' # 如果有密码,请填写
39
+
40
+ # 根据是否有密码生成 URL
41
+ if REDIS_PASSWORD:
42
+ REDIS_URL = f'redis://:{REDIS_PASSWORD}@{REDIS_HOST}:{REDIS_PORT}/0'
43
+ else:
44
+ REDIS_URL = f'redis://{REDIS_HOST}:{REDIS_PORT}/0'
45
+
46
+ # Redis key配置已移至各组件中,使用统一的命名规范
47
+ # crawlo:{project_name}:filter:fingerprint (请求去重)
48
+ # crawlo:{project_name}:item:fingerprint (数据项去重)
49
+ # crawlo:{project_name}:queue:requests (请求队列)
50
+ # crawlo:{project_name}:queue:processing (处理中队列)
51
+ # crawlo:{project_name}:queue:failed (失败队列)
52
+
53
+ REDIS_TTL = 0
54
+ CLEANUP_FP = 0
55
+ FILTER_DEBUG = True
56
+ DECODE_RESPONSES = True
57
+
58
+ # ============================== 中间件配置 ==============================
59
+
60
+ MIDDLEWARES = [
61
+ # === 请求预处理阶段 ===
62
+ 'crawlo.middleware.request_ignore.RequestIgnoreMiddleware',
63
+ 'crawlo.middleware.download_delay.DownloadDelayMiddleware',
64
+ 'crawlo.middleware.default_header.DefaultHeaderMiddleware',
65
+ 'crawlo.middleware.proxy.ProxyMiddleware',
66
+ 'crawlo.middleware.offsite.OffsiteMiddleware',
67
+
68
+ # === 响应处理阶段 ===
69
+ 'crawlo.middleware.retry.RetryMiddleware',
70
+ 'crawlo.middleware.response_code.ResponseCodeMiddleware',
71
+ 'crawlo.middleware.response_filter.ResponseFilterMiddleware',
72
+ ]
73
+
74
+ # ============================== 数据管道配置 ==============================
75
+
76
+ # 数据处理管道(启用的存储方式)
77
+ PIPELINES = [
78
+ 'crawlo.pipelines.console_pipeline.ConsolePipeline',
79
+ # '{{project_name}}.pipelines.DatabasePipeline', # 自定义数据库管道
80
+ # 'crawlo.pipelines.mysql_pipeline.AsyncmyMySQLPipeline', # MySQL 存储
81
+ # 'crawlo.pipelines.mongo_pipeline.MongoPipeline', # MongoDB 存储
82
+ ]
83
+
84
+ # 明确添加默认去重管道到管道列表开头
85
+ PIPELINES.insert(0, DEFAULT_DEDUP_PIPELINE)
86
+
87
+ # ============================== 扩展组件 ==============================
88
+
89
+ EXTENSIONS = [
90
+ 'crawlo.extension.log_interval.LogIntervalExtension',
91
+ 'crawlo.extension.log_stats.LogStats',
92
+ 'crawlo.extension.logging_extension.CustomLoggerExtension',
93
+ ]
94
+
95
+ # ============================== 日志配置 ==============================
96
+
97
+ LOG_LEVEL = 'INFO'
98
+ STATS_DUMP = True
99
+ LOG_FILE = f'logs/{{project_name}}.log'
100
+ LOG_FORMAT = '%(asctime)s - [%(name)s] - %(levelname)s: %(message)s'
101
+ LOG_ENCODING = 'utf-8'