crawlo 1.1.3__py3-none-any.whl → 1.1.4__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 (118) hide show
  1. crawlo/__init__.py +34 -34
  2. crawlo/__version__.py +1 -1
  3. crawlo/cli.py +40 -40
  4. crawlo/commands/__init__.py +13 -13
  5. crawlo/commands/check.py +594 -594
  6. crawlo/commands/genspider.py +151 -151
  7. crawlo/commands/list.py +155 -155
  8. crawlo/commands/run.py +285 -285
  9. crawlo/commands/startproject.py +196 -196
  10. crawlo/commands/stats.py +188 -188
  11. crawlo/commands/utils.py +186 -186
  12. crawlo/config.py +279 -279
  13. crawlo/core/__init__.py +2 -2
  14. crawlo/core/engine.py +171 -171
  15. crawlo/core/enhanced_engine.py +189 -189
  16. crawlo/core/processor.py +40 -40
  17. crawlo/core/scheduler.py +165 -165
  18. crawlo/crawler.py +1027 -1027
  19. crawlo/downloader/__init__.py +242 -242
  20. crawlo/downloader/aiohttp_downloader.py +212 -212
  21. crawlo/downloader/cffi_downloader.py +251 -251
  22. crawlo/downloader/httpx_downloader.py +259 -259
  23. crawlo/event.py +11 -11
  24. crawlo/exceptions.py +81 -81
  25. crawlo/extension/__init__.py +38 -31
  26. crawlo/extension/health_check.py +142 -0
  27. crawlo/extension/log_interval.py +58 -49
  28. crawlo/extension/log_stats.py +82 -44
  29. crawlo/extension/logging_extension.py +44 -35
  30. crawlo/extension/memory_monitor.py +89 -0
  31. crawlo/extension/performance_profiler.py +118 -0
  32. crawlo/extension/request_recorder.py +108 -0
  33. crawlo/filters/__init__.py +154 -154
  34. crawlo/filters/aioredis_filter.py +241 -241
  35. crawlo/filters/memory_filter.py +269 -269
  36. crawlo/items/__init__.py +23 -23
  37. crawlo/items/base.py +21 -21
  38. crawlo/items/fields.py +53 -53
  39. crawlo/items/items.py +104 -104
  40. crawlo/middleware/__init__.py +21 -21
  41. crawlo/middleware/default_header.py +32 -32
  42. crawlo/middleware/download_delay.py +28 -28
  43. crawlo/middleware/middleware_manager.py +135 -135
  44. crawlo/middleware/proxy.py +248 -248
  45. crawlo/middleware/request_ignore.py +30 -30
  46. crawlo/middleware/response_code.py +18 -18
  47. crawlo/middleware/response_filter.py +26 -26
  48. crawlo/middleware/retry.py +124 -124
  49. crawlo/mode_manager.py +200 -200
  50. crawlo/network/__init__.py +21 -21
  51. crawlo/network/request.py +311 -311
  52. crawlo/network/response.py +271 -271
  53. crawlo/pipelines/__init__.py +21 -21
  54. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  55. crawlo/pipelines/console_pipeline.py +39 -39
  56. crawlo/pipelines/csv_pipeline.py +316 -316
  57. crawlo/pipelines/database_dedup_pipeline.py +224 -224
  58. crawlo/pipelines/json_pipeline.py +218 -218
  59. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  60. crawlo/pipelines/mongo_pipeline.py +132 -117
  61. crawlo/pipelines/mysql_pipeline.py +317 -195
  62. crawlo/pipelines/pipeline_manager.py +56 -56
  63. crawlo/pipelines/redis_dedup_pipeline.py +162 -162
  64. crawlo/project.py +153 -153
  65. crawlo/queue/pqueue.py +37 -37
  66. crawlo/queue/queue_manager.py +307 -307
  67. crawlo/queue/redis_priority_queue.py +208 -208
  68. crawlo/settings/__init__.py +7 -7
  69. crawlo/settings/default_settings.py +278 -244
  70. crawlo/settings/setting_manager.py +99 -99
  71. crawlo/spider/__init__.py +639 -639
  72. crawlo/stats_collector.py +59 -59
  73. crawlo/subscriber.py +131 -106
  74. crawlo/task_manager.py +30 -30
  75. crawlo/templates/crawlo.cfg.tmpl +10 -10
  76. crawlo/templates/project/__init__.py.tmpl +3 -3
  77. crawlo/templates/project/items.py.tmpl +17 -17
  78. crawlo/templates/project/middlewares.py.tmpl +111 -87
  79. crawlo/templates/project/pipelines.py.tmpl +97 -341
  80. crawlo/templates/project/run.py.tmpl +251 -251
  81. crawlo/templates/project/settings.py.tmpl +279 -250
  82. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  83. crawlo/templates/spider/spider.py.tmpl +142 -178
  84. crawlo/utils/__init__.py +7 -7
  85. crawlo/utils/controlled_spider_mixin.py +439 -439
  86. crawlo/utils/date_tools.py +233 -233
  87. crawlo/utils/db_helper.py +343 -343
  88. crawlo/utils/func_tools.py +82 -82
  89. crawlo/utils/large_scale_config.py +286 -286
  90. crawlo/utils/large_scale_helper.py +343 -343
  91. crawlo/utils/log.py +128 -128
  92. crawlo/utils/queue_helper.py +175 -175
  93. crawlo/utils/request.py +267 -267
  94. crawlo/utils/request_serializer.py +219 -219
  95. crawlo/utils/spider_loader.py +62 -62
  96. crawlo/utils/system.py +11 -11
  97. crawlo/utils/tools.py +4 -4
  98. crawlo/utils/url.py +39 -39
  99. crawlo-1.1.4.dist-info/METADATA +403 -0
  100. crawlo-1.1.4.dist-info/RECORD +117 -0
  101. examples/__init__.py +7 -7
  102. examples/controlled_spider_example.py +205 -205
  103. tests/__init__.py +7 -7
  104. tests/test_final_validation.py +153 -153
  105. tests/test_proxy_health_check.py +32 -32
  106. tests/test_proxy_middleware_integration.py +136 -136
  107. tests/test_proxy_providers.py +56 -56
  108. tests/test_proxy_stats.py +19 -19
  109. tests/test_proxy_strategies.py +59 -59
  110. tests/test_redis_config.py +28 -28
  111. tests/test_redis_queue.py +224 -224
  112. tests/test_request_serialization.py +70 -70
  113. tests/test_scheduler.py +241 -241
  114. crawlo-1.1.3.dist-info/METADATA +0 -635
  115. crawlo-1.1.3.dist-info/RECORD +0 -113
  116. {crawlo-1.1.3.dist-info → crawlo-1.1.4.dist-info}/WHEEL +0 -0
  117. {crawlo-1.1.3.dist-info → crawlo-1.1.4.dist-info}/entry_points.txt +0 -0
  118. {crawlo-1.1.3.dist-info → crawlo-1.1.4.dist-info}/top_level.txt +0 -0
@@ -1,219 +1,219 @@
1
- # -*- coding: utf-8 -*-
2
- import json
3
- import asyncio
4
- from pathlib import Path
5
- from typing import Optional
6
- from datetime import datetime
7
- from crawlo.utils.log import get_logger
8
- from crawlo.exceptions import ItemDiscard
9
-
10
-
11
- class JsonPipeline:
12
- """JSON文件输出管道"""
13
-
14
- def __init__(self, crawler):
15
- self.crawler = crawler
16
- self.settings = crawler.settings
17
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
18
-
19
- # 配置文件路径
20
- self.file_path = self._get_file_path()
21
- self.file_handle = None
22
- self.lock = asyncio.Lock() # 异步锁保证线程安全
23
-
24
- # 注册关闭事件
25
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
26
-
27
- @classmethod
28
- def from_crawler(cls, crawler):
29
- return cls(crawler)
30
-
31
- def _get_file_path(self) -> Path:
32
- """获取输出文件路径"""
33
- # 优先级:设置 > 爬虫属性 > 默认路径
34
- file_path = (
35
- self.settings.get('JSON_FILE') or
36
- getattr(self.crawler.spider, 'json_file', None) or
37
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
38
- )
39
-
40
- path = Path(file_path)
41
- path.parent.mkdir(parents=True, exist_ok=True)
42
- return path
43
-
44
- async def _ensure_file_open(self):
45
- """确保文件已打开"""
46
- if self.file_handle is None:
47
- self.file_handle = open(self.file_path, 'w', encoding='utf-8')
48
- self.logger.info(f"JSON文件已创建: {self.file_path}")
49
-
50
- async def process_item(self, item, spider) -> Optional[dict]:
51
- """处理item的核心方法"""
52
- try:
53
- async with self.lock:
54
- await self._ensure_file_open()
55
-
56
- # 转换为字典并序列化
57
- item_dict = dict(item)
58
- json_line = json.dumps(item_dict, ensure_ascii=False, indent=None)
59
-
60
- # 写入文件(每行一个JSON对象)
61
- self.file_handle.write(json_line + '\n')
62
- self.file_handle.flush() # 立即刷新到磁盘
63
-
64
- # 统计
65
- self.crawler.stats.inc_value('json_pipeline/items_written')
66
- self.logger.debug(f"写入JSON项: {len(item_dict)} 字段")
67
-
68
- return item
69
-
70
- except Exception as e:
71
- self.crawler.stats.inc_value('json_pipeline/items_failed')
72
- self.logger.error(f"JSON写入失败: {e}")
73
- raise ItemDiscard(f"JSON Pipeline处理失败: {e}")
74
-
75
- async def spider_closed(self):
76
- """关闭爬虫时清理资源"""
77
- if self.file_handle:
78
- self.file_handle.close()
79
- self.logger.info(f"JSON文件已关闭: {self.file_path}")
80
-
81
-
82
- class JsonLinesPipeline:
83
- """JSON Lines格式输出管道(每行一个JSON对象)"""
84
-
85
- def __init__(self, crawler):
86
- self.crawler = crawler
87
- self.settings = crawler.settings
88
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
89
-
90
- self.file_path = self._get_file_path()
91
- self.file_handle = None
92
- self.items_count = 0
93
- self.lock = asyncio.Lock()
94
-
95
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
96
-
97
- @classmethod
98
- def from_crawler(cls, crawler):
99
- return cls(crawler)
100
-
101
- def _get_file_path(self) -> Path:
102
- """获取输出文件路径"""
103
- file_path = (
104
- self.settings.get('JSONLINES_FILE') or
105
- getattr(self.crawler.spider, 'jsonlines_file', None) or
106
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.jsonl"
107
- )
108
-
109
- path = Path(file_path)
110
- path.parent.mkdir(parents=True, exist_ok=True)
111
- return path
112
-
113
- async def _ensure_file_open(self):
114
- """确保文件已打开"""
115
- if self.file_handle is None:
116
- self.file_handle = open(self.file_path, 'w', encoding='utf-8')
117
- self.logger.info(f"JSONL文件已创建: {self.file_path}")
118
-
119
- async def process_item(self, item, spider) -> Optional[dict]:
120
- """处理item方法"""
121
- try:
122
- async with self.lock:
123
- await self._ensure_file_open()
124
-
125
- item_dict = dict(item)
126
-
127
- # 添加元数据
128
- if self.settings.get_bool('JSON_ADD_METADATA', False):
129
- item_dict['_crawl_time'] = datetime.now().isoformat()
130
- item_dict['_spider_name'] = spider.name
131
-
132
- # 写入JSONL格式
133
- json_line = json.dumps(item_dict, ensure_ascii=False, separators=(',', ':'))
134
- self.file_handle.write(json_line + '\n')
135
- self.file_handle.flush()
136
-
137
- self.items_count += 1
138
-
139
- # 定期日志输出
140
- if self.items_count % 100 == 0:
141
- self.logger.info(f"已写入 {self.items_count} 个JSON对象")
142
-
143
- self.crawler.stats.inc_value('jsonlines_pipeline/items_written')
144
-
145
- return item
146
-
147
- except Exception as e:
148
- self.crawler.stats.inc_value('jsonlines_pipeline/items_failed')
149
- self.logger.error(f"JSONL写入失败: {e}")
150
- raise ItemDiscard(f"JSON Lines Pipeline处理失败: {e}")
151
-
152
- async def spider_closed(self):
153
- """资源清理"""
154
- if self.file_handle:
155
- self.file_handle.close()
156
- self.logger.info(f"JSONL文件已关闭,共写入 {self.items_count} 个项目: {self.file_path}")
157
-
158
-
159
- class JsonArrayPipeline:
160
- """JSON数组格式输出管道(所有item组成一个JSON数组)"""
161
-
162
- def __init__(self, crawler):
163
- self.crawler = crawler
164
- self.settings = crawler.settings
165
- self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
166
-
167
- self.file_path = self._get_file_path()
168
- self.items = [] # 内存中暂存所有items
169
- self.lock = asyncio.Lock()
170
-
171
- crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
172
-
173
- @classmethod
174
- def from_crawler(cls, crawler):
175
- return cls(crawler)
176
-
177
- def _get_file_path(self) -> Path:
178
- """获取输出文件路径"""
179
- file_path = (
180
- self.settings.get('JSON_ARRAY_FILE') or
181
- getattr(self.crawler.spider, 'json_array_file', None) or
182
- f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}_array.json"
183
- )
184
-
185
- path = Path(file_path)
186
- path.parent.mkdir(parents=True, exist_ok=True)
187
- return path
188
-
189
- async def process_item(self, item, spider) -> Optional[dict]:
190
- """处理item方法"""
191
- try:
192
- async with self.lock:
193
- item_dict = dict(item)
194
- self.items.append(item_dict)
195
-
196
- self.crawler.stats.inc_value('json_array_pipeline/items_collected')
197
- self.logger.debug(f"收集item,当前总数: {len(self.items)}")
198
-
199
- return item
200
-
201
- except Exception as e:
202
- self.crawler.stats.inc_value('json_array_pipeline/items_failed')
203
- self.logger.error(f"JSON Array收集失败: {e}")
204
- raise ItemDiscard(f"JSON Array Pipeline处理失败: {e}")
205
-
206
- async def spider_closed(self):
207
- """关闭时写入所有items到JSON数组文件"""
208
- try:
209
- if self.items:
210
- with open(self.file_path, 'w', encoding='utf-8') as f:
211
- json.dump(self.items, f, ensure_ascii=False, indent=2)
212
-
213
- self.logger.info(f"JSON数组文件已保存,包含 {len(self.items)} 个项目: {self.file_path}")
214
- self.crawler.stats.set_value('json_array_pipeline/total_items', len(self.items))
215
- else:
216
- self.logger.warning("没有items需要保存")
217
-
218
- except Exception as e:
1
+ # -*- coding: utf-8 -*-
2
+ import json
3
+ import asyncio
4
+ from pathlib import Path
5
+ from typing import Optional
6
+ from datetime import datetime
7
+ from crawlo.utils.log import get_logger
8
+ from crawlo.exceptions import ItemDiscard
9
+
10
+
11
+ class JsonPipeline:
12
+ """JSON文件输出管道"""
13
+
14
+ def __init__(self, crawler):
15
+ self.crawler = crawler
16
+ self.settings = crawler.settings
17
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
18
+
19
+ # 配置文件路径
20
+ self.file_path = self._get_file_path()
21
+ self.file_handle = None
22
+ self.lock = asyncio.Lock() # 异步锁保证线程安全
23
+
24
+ # 注册关闭事件
25
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
26
+
27
+ @classmethod
28
+ def from_crawler(cls, crawler):
29
+ return cls(crawler)
30
+
31
+ def _get_file_path(self) -> Path:
32
+ """获取输出文件路径"""
33
+ # 优先级:设置 > 爬虫属性 > 默认路径
34
+ file_path = (
35
+ self.settings.get('JSON_FILE') or
36
+ getattr(self.crawler.spider, 'json_file', None) or
37
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
38
+ )
39
+
40
+ path = Path(file_path)
41
+ path.parent.mkdir(parents=True, exist_ok=True)
42
+ return path
43
+
44
+ async def _ensure_file_open(self):
45
+ """确保文件已打开"""
46
+ if self.file_handle is None:
47
+ self.file_handle = open(self.file_path, 'w', encoding='utf-8')
48
+ self.logger.info(f"JSON文件已创建: {self.file_path}")
49
+
50
+ async def process_item(self, item, spider) -> Optional[dict]:
51
+ """处理item的核心方法"""
52
+ try:
53
+ async with self.lock:
54
+ await self._ensure_file_open()
55
+
56
+ # 转换为字典并序列化
57
+ item_dict = dict(item)
58
+ json_line = json.dumps(item_dict, ensure_ascii=False, indent=None)
59
+
60
+ # 写入文件(每行一个JSON对象)
61
+ self.file_handle.write(json_line + '\n')
62
+ self.file_handle.flush() # 立即刷新到磁盘
63
+
64
+ # 统计
65
+ self.crawler.stats.inc_value('json_pipeline/items_written')
66
+ self.logger.debug(f"写入JSON项: {len(item_dict)} 字段")
67
+
68
+ return item
69
+
70
+ except Exception as e:
71
+ self.crawler.stats.inc_value('json_pipeline/items_failed')
72
+ self.logger.error(f"JSON写入失败: {e}")
73
+ raise ItemDiscard(f"JSON Pipeline处理失败: {e}")
74
+
75
+ async def spider_closed(self):
76
+ """关闭爬虫时清理资源"""
77
+ if self.file_handle:
78
+ self.file_handle.close()
79
+ self.logger.info(f"JSON文件已关闭: {self.file_path}")
80
+
81
+
82
+ class JsonLinesPipeline:
83
+ """JSON Lines格式输出管道(每行一个JSON对象)"""
84
+
85
+ def __init__(self, crawler):
86
+ self.crawler = crawler
87
+ self.settings = crawler.settings
88
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
89
+
90
+ self.file_path = self._get_file_path()
91
+ self.file_handle = None
92
+ self.items_count = 0
93
+ self.lock = asyncio.Lock()
94
+
95
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
96
+
97
+ @classmethod
98
+ def from_crawler(cls, crawler):
99
+ return cls(crawler)
100
+
101
+ def _get_file_path(self) -> Path:
102
+ """获取输出文件路径"""
103
+ file_path = (
104
+ self.settings.get('JSONLINES_FILE') or
105
+ getattr(self.crawler.spider, 'jsonlines_file', None) or
106
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.jsonl"
107
+ )
108
+
109
+ path = Path(file_path)
110
+ path.parent.mkdir(parents=True, exist_ok=True)
111
+ return path
112
+
113
+ async def _ensure_file_open(self):
114
+ """确保文件已打开"""
115
+ if self.file_handle is None:
116
+ self.file_handle = open(self.file_path, 'w', encoding='utf-8')
117
+ self.logger.info(f"JSONL文件已创建: {self.file_path}")
118
+
119
+ async def process_item(self, item, spider) -> Optional[dict]:
120
+ """处理item方法"""
121
+ try:
122
+ async with self.lock:
123
+ await self._ensure_file_open()
124
+
125
+ item_dict = dict(item)
126
+
127
+ # 添加元数据
128
+ if self.settings.get_bool('JSON_ADD_METADATA', False):
129
+ item_dict['_crawl_time'] = datetime.now().isoformat()
130
+ item_dict['_spider_name'] = spider.name
131
+
132
+ # 写入JSONL格式
133
+ json_line = json.dumps(item_dict, ensure_ascii=False, separators=(',', ':'))
134
+ self.file_handle.write(json_line + '\n')
135
+ self.file_handle.flush()
136
+
137
+ self.items_count += 1
138
+
139
+ # 定期日志输出
140
+ if self.items_count % 100 == 0:
141
+ self.logger.info(f"已写入 {self.items_count} 个JSON对象")
142
+
143
+ self.crawler.stats.inc_value('jsonlines_pipeline/items_written')
144
+
145
+ return item
146
+
147
+ except Exception as e:
148
+ self.crawler.stats.inc_value('jsonlines_pipeline/items_failed')
149
+ self.logger.error(f"JSONL写入失败: {e}")
150
+ raise ItemDiscard(f"JSON Lines Pipeline处理失败: {e}")
151
+
152
+ async def spider_closed(self):
153
+ """资源清理"""
154
+ if self.file_handle:
155
+ self.file_handle.close()
156
+ self.logger.info(f"JSONL文件已关闭,共写入 {self.items_count} 个项目: {self.file_path}")
157
+
158
+
159
+ class JsonArrayPipeline:
160
+ """JSON数组格式输出管道(所有item组成一个JSON数组)"""
161
+
162
+ def __init__(self, crawler):
163
+ self.crawler = crawler
164
+ self.settings = crawler.settings
165
+ self.logger = get_logger(self.__class__.__name__, self.settings.get('LOG_LEVEL'))
166
+
167
+ self.file_path = self._get_file_path()
168
+ self.items = [] # 内存中暂存所有items
169
+ self.lock = asyncio.Lock()
170
+
171
+ crawler.subscriber.subscribe(self.spider_closed, event='spider_closed')
172
+
173
+ @classmethod
174
+ def from_crawler(cls, crawler):
175
+ return cls(crawler)
176
+
177
+ def _get_file_path(self) -> Path:
178
+ """获取输出文件路径"""
179
+ file_path = (
180
+ self.settings.get('JSON_ARRAY_FILE') or
181
+ getattr(self.crawler.spider, 'json_array_file', None) or
182
+ f"output/{self.crawler.spider.name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}_array.json"
183
+ )
184
+
185
+ path = Path(file_path)
186
+ path.parent.mkdir(parents=True, exist_ok=True)
187
+ return path
188
+
189
+ async def process_item(self, item, spider) -> Optional[dict]:
190
+ """处理item方法"""
191
+ try:
192
+ async with self.lock:
193
+ item_dict = dict(item)
194
+ self.items.append(item_dict)
195
+
196
+ self.crawler.stats.inc_value('json_array_pipeline/items_collected')
197
+ self.logger.debug(f"收集item,当前总数: {len(self.items)}")
198
+
199
+ return item
200
+
201
+ except Exception as e:
202
+ self.crawler.stats.inc_value('json_array_pipeline/items_failed')
203
+ self.logger.error(f"JSON Array收集失败: {e}")
204
+ raise ItemDiscard(f"JSON Array Pipeline处理失败: {e}")
205
+
206
+ async def spider_closed(self):
207
+ """关闭时写入所有items到JSON数组文件"""
208
+ try:
209
+ if self.items:
210
+ with open(self.file_path, 'w', encoding='utf-8') as f:
211
+ json.dump(self.items, f, ensure_ascii=False, indent=2)
212
+
213
+ self.logger.info(f"JSON数组文件已保存,包含 {len(self.items)} 个项目: {self.file_path}")
214
+ self.crawler.stats.set_value('json_array_pipeline/total_items', len(self.items))
215
+ else:
216
+ self.logger.warning("没有items需要保存")
217
+
218
+ except Exception as e:
219
219
  self.logger.error(f"保存JSON数组文件失败: {e}")