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
crawlo/core/engine.py CHANGED
@@ -1,172 +1,172 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
- import asyncio
4
- from inspect import iscoroutine
5
- from typing import Optional, Generator, Callable
6
-
7
- from crawlo import Request, Item
8
- from crawlo.spider import Spider
9
- from crawlo.utils.log import get_logger
10
- from crawlo.exceptions import OutputError
11
- from crawlo.core.scheduler import Scheduler
12
- from crawlo.core.processor import Processor
13
- from crawlo.task_manager import TaskManager
14
- from crawlo.project import load_class
15
- from crawlo.downloader import DownloaderBase
16
- from crawlo.utils.func_tools import transform
17
- from crawlo.event import spider_opened, spider_error, request_scheduled
18
-
19
-
20
- class Engine(object):
21
-
22
- def __init__(self, crawler):
23
- self.running = False
24
- self.normal = True
25
- self.crawler = crawler
26
- self.settings = crawler.settings
27
- self.spider: Optional[Spider] = None
28
- self.downloader: Optional[DownloaderBase] = None
29
- self.scheduler: Optional[Scheduler] = None
30
- self.processor: Optional[Processor] = None
31
- self.start_requests: Optional[Generator] = None
32
- self.task_manager: Optional[TaskManager] = TaskManager(self.settings.get_int('CONCURRENCY'))
33
-
34
- self.logger = get_logger(name=self.__class__.__name__)
35
-
36
- def _get_downloader_cls(self):
37
- """获取下载器类,支持多种配置方式"""
38
- # 方式1: 使用 DOWNLOADER_TYPE 简化名称(推荐)
39
- downloader_type = self.settings.get('DOWNLOADER_TYPE')
40
- if downloader_type:
41
- try:
42
- from crawlo.downloader import get_downloader_class
43
- downloader_cls = get_downloader_class(downloader_type)
44
- self.logger.debug(f"使用下载器类型: {downloader_type} -> {downloader_cls.__name__}")
45
- return downloader_cls
46
- except (ImportError, ValueError) as e:
47
- self.logger.warning(f"无法使用下载器类型 '{downloader_type}': {e},回退到默认配置")
48
-
49
- # 方式2: 使用 DOWNLOADER 完整类路径(兼容旧版本)
50
- downloader_cls = load_class(self.settings.get('DOWNLOADER'))
51
- if not issubclass(downloader_cls, DownloaderBase):
52
- raise TypeError(f'Downloader {downloader_cls.__name__} is not subclass of DownloaderBase.')
53
- return downloader_cls
54
-
55
- def engine_start(self):
56
- self.running = True
57
- self.logger.info(
58
- f"Crawlo (version {self.settings.get_float('VERSION')}) started. "
59
- f"(project name : {self.settings.get('PROJECT_NAME')})"
60
- )
61
-
62
- async def start_spider(self, spider):
63
- self.spider = spider
64
-
65
- self.scheduler = Scheduler.create_instance(self.crawler)
66
- if hasattr(self.scheduler, 'open'):
67
- await self.scheduler.open()
68
-
69
- downloader_cls = self._get_downloader_cls()
70
- self.downloader = downloader_cls(self.crawler)
71
- if hasattr(self.downloader, 'open'):
72
- self.downloader.open()
73
-
74
- self.processor = Processor(self.crawler)
75
- if hasattr(self.processor, 'open'):
76
- self.processor.open()
77
-
78
- self.start_requests = iter(spider.start_requests())
79
- await self._open_spider()
80
-
81
- async def crawl(self):
82
- """
83
- Crawl the spider
84
- """
85
- while self.running:
86
- if request := await self._get_next_request():
87
- await self._crawl(request)
88
- try:
89
- start_request = next(self.start_requests)
90
- except StopIteration:
91
- self.start_requests = None
92
- except Exception as exp:
93
- # 1、发去请求的request全部运行完毕
94
- # 2、调度器是否空闲
95
- # 3、下载器是否空闲
96
- if not await self._exit():
97
- continue
98
- self.running = False
99
- if self.start_requests is not None:
100
- self.logger.error(f"启动请求时发生错误: {str(exp)}")
101
- else:
102
- # 请求入队
103
- await self.enqueue_request(start_request)
104
-
105
- if not self.running:
106
- await self.close_spider()
107
-
108
- async def _open_spider(self):
109
- asyncio.create_task(self.crawler.subscriber.notify(spider_opened))
110
- crawling = asyncio.create_task(self.crawl())
111
- await crawling
112
-
113
- async def _crawl(self, request):
114
- # TODO 实现并发
115
- async def crawl_task():
116
- outputs = await self._fetch(request)
117
- # TODO 处理output
118
- if outputs:
119
- await self._handle_spider_output(outputs)
120
-
121
- # 使用异步任务创建,遵守并发限制
122
- await self.task_manager.create_task(crawl_task())
123
-
124
- async def _fetch(self, request):
125
- async def _successful(_response):
126
- callback: Callable = request.callback or self.spider.parse
127
- if _outputs := callback(_response):
128
- if iscoroutine(_outputs):
129
- await _outputs
130
- else:
131
- return transform(_outputs, _response)
132
-
133
- _response = await self.downloader.fetch(request)
134
- if _response is None:
135
- return None
136
- output = await _successful(_response)
137
- return output
138
-
139
- async def enqueue_request(self, start_request):
140
- await self._schedule_request(start_request)
141
-
142
- async def _schedule_request(self, request):
143
- # TODO 去重
144
- if await self.scheduler.enqueue_request(request):
145
- asyncio.create_task(self.crawler.subscriber.notify(request_scheduled, request, self.crawler.spider))
146
-
147
- async def _get_next_request(self):
148
- return await self.scheduler.next_request()
149
-
150
- async def _handle_spider_output(self, outputs):
151
- async for spider_output in outputs:
152
- if isinstance(spider_output, (Request, Item)):
153
- await self.processor.enqueue(spider_output)
154
- elif isinstance(spider_output, Exception):
155
- asyncio.create_task(
156
- self.crawler.subscriber.notify(spider_error, spider_output, self.spider)
157
- )
158
- raise spider_output
159
- else:
160
- raise OutputError(f'{type(self.spider)} must return `Request` or `Item`.')
161
-
162
- async def _exit(self):
163
- if self.scheduler.idle() and self.downloader.idle() and self.task_manager.all_done() and self.processor.idle():
164
- return True
165
- return False
166
-
167
- async def close_spider(self):
168
- await asyncio.gather(*self.task_manager.current_task)
169
- await self.scheduler.close()
170
- await self.downloader.close()
171
- if self.normal:
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+ import asyncio
4
+ from inspect import iscoroutine
5
+ from typing import Optional, Generator, Callable
6
+
7
+ from crawlo import Request, Item
8
+ from crawlo.spider import Spider
9
+ from crawlo.utils.log import get_logger
10
+ from crawlo.exceptions import OutputError
11
+ from crawlo.core.scheduler import Scheduler
12
+ from crawlo.core.processor import Processor
13
+ from crawlo.task_manager import TaskManager
14
+ from crawlo.project import load_class
15
+ from crawlo.downloader import DownloaderBase
16
+ from crawlo.utils.func_tools import transform
17
+ from crawlo.event import spider_opened, spider_error, request_scheduled
18
+
19
+
20
+ class Engine(object):
21
+
22
+ def __init__(self, crawler):
23
+ self.running = False
24
+ self.normal = True
25
+ self.crawler = crawler
26
+ self.settings = crawler.settings
27
+ self.spider: Optional[Spider] = None
28
+ self.downloader: Optional[DownloaderBase] = None
29
+ self.scheduler: Optional[Scheduler] = None
30
+ self.processor: Optional[Processor] = None
31
+ self.start_requests: Optional[Generator] = None
32
+ self.task_manager: Optional[TaskManager] = TaskManager(self.settings.get_int('CONCURRENCY'))
33
+
34
+ self.logger = get_logger(name=self.__class__.__name__)
35
+
36
+ def _get_downloader_cls(self):
37
+ """获取下载器类,支持多种配置方式"""
38
+ # 方式1: 使用 DOWNLOADER_TYPE 简化名称(推荐)
39
+ downloader_type = self.settings.get('DOWNLOADER_TYPE')
40
+ if downloader_type:
41
+ try:
42
+ from crawlo.downloader import get_downloader_class
43
+ downloader_cls = get_downloader_class(downloader_type)
44
+ self.logger.debug(f"使用下载器类型: {downloader_type} -> {downloader_cls.__name__}")
45
+ return downloader_cls
46
+ except (ImportError, ValueError) as e:
47
+ self.logger.warning(f"无法使用下载器类型 '{downloader_type}': {e},回退到默认配置")
48
+
49
+ # 方式2: 使用 DOWNLOADER 完整类路径(兼容旧版本)
50
+ downloader_cls = load_class(self.settings.get('DOWNLOADER'))
51
+ if not issubclass(downloader_cls, DownloaderBase):
52
+ raise TypeError(f'Downloader {downloader_cls.__name__} is not subclass of DownloaderBase.')
53
+ return downloader_cls
54
+
55
+ def engine_start(self):
56
+ self.running = True
57
+ self.logger.info(
58
+ f"Crawlo (version {self.settings.get_float('VERSION')}) started. "
59
+ f"(project name : {self.settings.get('PROJECT_NAME')})"
60
+ )
61
+
62
+ async def start_spider(self, spider):
63
+ self.spider = spider
64
+
65
+ self.scheduler = Scheduler.create_instance(self.crawler)
66
+ if hasattr(self.scheduler, 'open'):
67
+ await self.scheduler.open()
68
+
69
+ downloader_cls = self._get_downloader_cls()
70
+ self.downloader = downloader_cls(self.crawler)
71
+ if hasattr(self.downloader, 'open'):
72
+ self.downloader.open()
73
+
74
+ self.processor = Processor(self.crawler)
75
+ if hasattr(self.processor, 'open'):
76
+ self.processor.open()
77
+
78
+ self.start_requests = iter(spider.start_requests())
79
+ await self._open_spider()
80
+
81
+ async def crawl(self):
82
+ """
83
+ Crawl the spider
84
+ """
85
+ while self.running:
86
+ if request := await self._get_next_request():
87
+ await self._crawl(request)
88
+ try:
89
+ start_request = next(self.start_requests)
90
+ except StopIteration:
91
+ self.start_requests = None
92
+ except Exception as exp:
93
+ # 1、发去请求的request全部运行完毕
94
+ # 2、调度器是否空闲
95
+ # 3、下载器是否空闲
96
+ if not await self._exit():
97
+ continue
98
+ self.running = False
99
+ if self.start_requests is not None:
100
+ self.logger.error(f"启动请求时发生错误: {str(exp)}")
101
+ else:
102
+ # 请求入队
103
+ await self.enqueue_request(start_request)
104
+
105
+ if not self.running:
106
+ await self.close_spider()
107
+
108
+ async def _open_spider(self):
109
+ asyncio.create_task(self.crawler.subscriber.notify(spider_opened))
110
+ crawling = asyncio.create_task(self.crawl())
111
+ await crawling
112
+
113
+ async def _crawl(self, request):
114
+ # TODO 实现并发
115
+ async def crawl_task():
116
+ outputs = await self._fetch(request)
117
+ # TODO 处理output
118
+ if outputs:
119
+ await self._handle_spider_output(outputs)
120
+
121
+ # 使用异步任务创建,遵守并发限制
122
+ await self.task_manager.create_task(crawl_task())
123
+
124
+ async def _fetch(self, request):
125
+ async def _successful(_response):
126
+ callback: Callable = request.callback or self.spider.parse
127
+ if _outputs := callback(_response):
128
+ if iscoroutine(_outputs):
129
+ await _outputs
130
+ else:
131
+ return transform(_outputs, _response)
132
+
133
+ _response = await self.downloader.fetch(request)
134
+ if _response is None:
135
+ return None
136
+ output = await _successful(_response)
137
+ return output
138
+
139
+ async def enqueue_request(self, start_request):
140
+ await self._schedule_request(start_request)
141
+
142
+ async def _schedule_request(self, request):
143
+ # TODO 去重
144
+ if await self.scheduler.enqueue_request(request):
145
+ asyncio.create_task(self.crawler.subscriber.notify(request_scheduled, request, self.crawler.spider))
146
+
147
+ async def _get_next_request(self):
148
+ return await self.scheduler.next_request()
149
+
150
+ async def _handle_spider_output(self, outputs):
151
+ async for spider_output in outputs:
152
+ if isinstance(spider_output, (Request, Item)):
153
+ await self.processor.enqueue(spider_output)
154
+ elif isinstance(spider_output, Exception):
155
+ asyncio.create_task(
156
+ self.crawler.subscriber.notify(spider_error, spider_output, self.spider)
157
+ )
158
+ raise spider_output
159
+ else:
160
+ raise OutputError(f'{type(self.spider)} must return `Request` or `Item`.')
161
+
162
+ async def _exit(self):
163
+ if self.scheduler.idle() and self.downloader.idle() and self.task_manager.all_done() and self.processor.idle():
164
+ return True
165
+ return False
166
+
167
+ async def close_spider(self):
168
+ await asyncio.gather(*self.task_manager.current_task)
169
+ await self.scheduler.close()
170
+ await self.downloader.close()
171
+ if self.normal:
172
172
  await self.crawler.close()