crawlo 1.1.6__py3-none-any.whl → 1.1.9__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 (190) 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 +65 -40
  8. crawlo/commands/__init__.py +14 -13
  9. crawlo/commands/check.py +594 -594
  10. crawlo/commands/genspider.py +151 -151
  11. crawlo/commands/help.py +133 -0
  12. crawlo/commands/list.py +155 -155
  13. crawlo/commands/run.py +292 -292
  14. crawlo/commands/startproject.py +418 -418
  15. crawlo/commands/stats.py +188 -188
  16. crawlo/commands/utils.py +186 -186
  17. crawlo/config.py +312 -312
  18. crawlo/config_validator.py +252 -252
  19. crawlo/core/__init__.py +2 -2
  20. crawlo/core/engine.py +345 -345
  21. crawlo/core/processor.py +40 -40
  22. crawlo/core/scheduler.py +136 -136
  23. crawlo/crawler.py +1027 -1027
  24. crawlo/downloader/__init__.py +266 -266
  25. crawlo/downloader/aiohttp_downloader.py +220 -220
  26. crawlo/downloader/cffi_downloader.py +256 -256
  27. crawlo/downloader/httpx_downloader.py +259 -259
  28. crawlo/downloader/hybrid_downloader.py +213 -213
  29. crawlo/downloader/playwright_downloader.py +402 -402
  30. crawlo/downloader/selenium_downloader.py +472 -472
  31. crawlo/event.py +11 -11
  32. crawlo/exceptions.py +81 -81
  33. crawlo/extension/__init__.py +37 -37
  34. crawlo/extension/health_check.py +141 -141
  35. crawlo/extension/log_interval.py +57 -57
  36. crawlo/extension/log_stats.py +81 -81
  37. crawlo/extension/logging_extension.py +43 -43
  38. crawlo/extension/memory_monitor.py +104 -104
  39. crawlo/extension/performance_profiler.py +133 -133
  40. crawlo/extension/request_recorder.py +107 -107
  41. crawlo/filters/__init__.py +154 -154
  42. crawlo/filters/aioredis_filter.py +280 -280
  43. crawlo/filters/memory_filter.py +269 -269
  44. crawlo/items/__init__.py +23 -23
  45. crawlo/items/base.py +21 -21
  46. crawlo/items/fields.py +53 -53
  47. crawlo/items/items.py +104 -104
  48. crawlo/middleware/__init__.py +21 -21
  49. crawlo/middleware/default_header.py +32 -32
  50. crawlo/middleware/download_delay.py +28 -28
  51. crawlo/middleware/middleware_manager.py +135 -135
  52. crawlo/middleware/proxy.py +272 -272
  53. crawlo/middleware/request_ignore.py +30 -30
  54. crawlo/middleware/response_code.py +18 -18
  55. crawlo/middleware/response_filter.py +26 -26
  56. crawlo/middleware/retry.py +124 -124
  57. crawlo/mode_manager.py +211 -211
  58. crawlo/network/__init__.py +21 -21
  59. crawlo/network/request.py +338 -338
  60. crawlo/network/response.py +359 -359
  61. crawlo/pipelines/__init__.py +21 -21
  62. crawlo/pipelines/bloom_dedup_pipeline.py +156 -156
  63. crawlo/pipelines/console_pipeline.py +39 -39
  64. crawlo/pipelines/csv_pipeline.py +316 -316
  65. crawlo/pipelines/database_dedup_pipeline.py +224 -224
  66. crawlo/pipelines/json_pipeline.py +218 -218
  67. crawlo/pipelines/memory_dedup_pipeline.py +115 -115
  68. crawlo/pipelines/mongo_pipeline.py +131 -131
  69. crawlo/pipelines/mysql_pipeline.py +316 -316
  70. crawlo/pipelines/pipeline_manager.py +61 -61
  71. crawlo/pipelines/redis_dedup_pipeline.py +167 -167
  72. crawlo/project.py +187 -187
  73. crawlo/queue/pqueue.py +37 -37
  74. crawlo/queue/queue_manager.py +334 -334
  75. crawlo/queue/redis_priority_queue.py +298 -298
  76. crawlo/settings/__init__.py +7 -7
  77. crawlo/settings/default_settings.py +219 -219
  78. crawlo/settings/setting_manager.py +122 -122
  79. crawlo/spider/__init__.py +639 -639
  80. crawlo/stats_collector.py +59 -59
  81. crawlo/subscriber.py +130 -130
  82. crawlo/task_manager.py +30 -30
  83. crawlo/templates/crawlo.cfg.tmpl +10 -10
  84. crawlo/templates/project/__init__.py.tmpl +3 -3
  85. crawlo/templates/project/items.py.tmpl +17 -17
  86. crawlo/templates/project/middlewares.py.tmpl +109 -110
  87. crawlo/templates/project/pipelines.py.tmpl +96 -97
  88. crawlo/templates/project/run.py.tmpl +46 -252
  89. crawlo/templates/project/settings.py.tmpl +326 -326
  90. crawlo/templates/project/settings_distributed.py.tmpl +119 -119
  91. crawlo/templates/project/settings_gentle.py.tmpl +94 -94
  92. crawlo/templates/project/settings_high_performance.py.tmpl +151 -151
  93. crawlo/templates/project/settings_simple.py.tmpl +68 -68
  94. crawlo/templates/project/spiders/__init__.py.tmpl +5 -5
  95. crawlo/templates/spider/spider.py.tmpl +141 -141
  96. crawlo/tools/__init__.py +182 -182
  97. crawlo/tools/anti_crawler.py +268 -268
  98. crawlo/tools/authenticated_proxy.py +240 -240
  99. crawlo/tools/data_validator.py +180 -180
  100. crawlo/tools/date_tools.py +35 -35
  101. crawlo/tools/distributed_coordinator.py +386 -386
  102. crawlo/tools/retry_mechanism.py +220 -220
  103. crawlo/tools/scenario_adapter.py +262 -262
  104. crawlo/utils/__init__.py +35 -35
  105. crawlo/utils/batch_processor.py +260 -260
  106. crawlo/utils/controlled_spider_mixin.py +439 -439
  107. crawlo/utils/date_tools.py +290 -290
  108. crawlo/utils/db_helper.py +343 -343
  109. crawlo/utils/enhanced_error_handler.py +359 -359
  110. crawlo/utils/env_config.py +105 -105
  111. crawlo/utils/error_handler.py +125 -125
  112. crawlo/utils/func_tools.py +82 -82
  113. crawlo/utils/large_scale_config.py +286 -286
  114. crawlo/utils/large_scale_helper.py +343 -343
  115. crawlo/utils/log.py +128 -128
  116. crawlo/utils/performance_monitor.py +284 -284
  117. crawlo/utils/queue_helper.py +175 -175
  118. crawlo/utils/redis_connection_pool.py +334 -334
  119. crawlo/utils/redis_key_validator.py +199 -199
  120. crawlo/utils/request.py +267 -267
  121. crawlo/utils/request_serializer.py +219 -219
  122. crawlo/utils/spider_loader.py +62 -62
  123. crawlo/utils/system.py +11 -11
  124. crawlo/utils/tools.py +4 -4
  125. crawlo/utils/url.py +39 -39
  126. {crawlo-1.1.6.dist-info → crawlo-1.1.9.dist-info}/METADATA +626 -401
  127. crawlo-1.1.9.dist-info/RECORD +190 -0
  128. examples/__init__.py +7 -7
  129. tests/DOUBLE_CRAWLO_PREFIX_FIX_REPORT.md +81 -81
  130. tests/__init__.py +7 -7
  131. tests/advanced_tools_example.py +275 -275
  132. tests/authenticated_proxy_example.py +236 -236
  133. tests/cleaners_example.py +160 -160
  134. tests/config_validation_demo.py +102 -102
  135. tests/controlled_spider_example.py +205 -205
  136. tests/date_tools_example.py +180 -180
  137. tests/dynamic_loading_example.py +523 -523
  138. tests/dynamic_loading_test.py +104 -104
  139. tests/env_config_example.py +133 -133
  140. tests/error_handling_example.py +171 -171
  141. tests/redis_key_validation_demo.py +130 -130
  142. tests/response_improvements_example.py +144 -144
  143. tests/test_advanced_tools.py +148 -148
  144. tests/test_all_redis_key_configs.py +145 -145
  145. tests/test_authenticated_proxy.py +141 -141
  146. tests/test_cleaners.py +54 -54
  147. tests/test_comprehensive.py +146 -146
  148. tests/test_config_validator.py +193 -193
  149. tests/test_date_tools.py +123 -123
  150. tests/test_double_crawlo_fix.py +207 -207
  151. tests/test_double_crawlo_fix_simple.py +124 -124
  152. tests/test_dynamic_downloaders_proxy.py +124 -124
  153. tests/test_dynamic_proxy.py +92 -92
  154. tests/test_dynamic_proxy_config.py +146 -146
  155. tests/test_dynamic_proxy_real.py +109 -109
  156. tests/test_edge_cases.py +303 -303
  157. tests/test_enhanced_error_handler.py +270 -270
  158. tests/test_env_config.py +121 -121
  159. tests/test_error_handler_compatibility.py +112 -112
  160. tests/test_final_validation.py +153 -153
  161. tests/test_framework_env_usage.py +103 -103
  162. tests/test_integration.py +356 -356
  163. tests/test_item_dedup_redis_key.py +122 -122
  164. tests/test_parsel.py +29 -29
  165. tests/test_performance.py +327 -327
  166. tests/test_proxy_health_check.py +32 -32
  167. tests/test_proxy_middleware_integration.py +136 -136
  168. tests/test_proxy_providers.py +56 -56
  169. tests/test_proxy_stats.py +19 -19
  170. tests/test_proxy_strategies.py +59 -59
  171. tests/test_queue_manager_double_crawlo.py +230 -230
  172. tests/test_queue_manager_redis_key.py +176 -176
  173. tests/test_redis_config.py +28 -28
  174. tests/test_redis_connection_pool.py +294 -294
  175. tests/test_redis_key_naming.py +181 -181
  176. tests/test_redis_key_validator.py +123 -123
  177. tests/test_redis_queue.py +224 -224
  178. tests/test_request_serialization.py +70 -70
  179. tests/test_response_improvements.py +152 -152
  180. tests/test_scheduler.py +241 -241
  181. tests/test_simple_response.py +61 -61
  182. tests/test_telecom_spider_redis_key.py +205 -205
  183. tests/test_template_content.py +87 -87
  184. tests/test_template_redis_key.py +134 -134
  185. tests/test_tools.py +153 -153
  186. tests/tools_example.py +257 -257
  187. crawlo-1.1.6.dist-info/RECORD +0 -189
  188. {crawlo-1.1.6.dist-info → crawlo-1.1.9.dist-info}/WHEEL +0 -0
  189. {crawlo-1.1.6.dist-info → crawlo-1.1.9.dist-info}/entry_points.txt +0 -0
  190. {crawlo-1.1.6.dist-info → crawlo-1.1.9.dist-info}/top_level.txt +0 -0
crawlo/commands/list.py CHANGED
@@ -1,156 +1,156 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- # @Time : 2025-08-31 22:33
5
- # @Author : crawl-coder
6
- # @Desc : 命令行入口:crawlo list,用于列出所有已注册的爬虫
7
- """
8
- import sys
9
- from pathlib import Path
10
- from importlib import import_module
11
-
12
- from rich.console import Console
13
- from rich.table import Table
14
- from rich.panel import Panel
15
- from rich.text import Text
16
- from rich import box
17
-
18
- from crawlo.crawler import CrawlerProcess
19
- from crawlo.utils.log import get_logger
20
- from .utils import validate_project_environment, show_error_panel
21
-
22
- logger = get_logger(__name__)
23
- console = Console()
24
-
25
-
26
- def main(args):
27
- """
28
- 主函数:列出所有可用爬虫
29
- 用法: crawlo list [--json]
30
- """
31
- show_json = "--json" in args
32
-
33
- # 过滤掉参数后检查是否有额外参数
34
- filtered_args = [arg for arg in args if not arg.startswith('--')]
35
- if filtered_args:
36
- if show_json:
37
- console.print_json(data={"success": False, "error": "Usage: crawlo list [--json]"})
38
- else:
39
- console.print("[bold red]❌ Error:[/bold red] Usage: [blue]crawlo list[/blue] [--json]")
40
- return 1
41
-
42
- try:
43
- # 验证项目环境
44
- is_valid, project_package, error_msg = validate_project_environment()
45
- if not is_valid:
46
- if show_json:
47
- console.print_json(data={"success": False, "error": error_msg})
48
- else:
49
- show_error_panel("Not a Crawlo Project", error_msg)
50
- return 1
51
-
52
- # 初始化 CrawlerProcess 并加载爬虫模块
53
- spider_modules = [f"{project_package}.spiders"]
54
- process = CrawlerProcess(spider_modules=spider_modules)
55
-
56
- # 获取所有爬虫名称
57
- spider_names = process.get_spider_names()
58
- if not spider_names:
59
- if show_json:
60
- console.print_json(data={
61
- "success": True,
62
- "spiders": [],
63
- "message": "No spiders found in project"
64
- })
65
- else:
66
- console.print(Panel(
67
- Text.from_markup(
68
- ":envelope_with_arrow: [bold]No spiders found[/bold] in '[cyan]spiders/[/cyan]' directory.\n\n"
69
- "[bold]💡 Make sure:[/bold]\n"
70
- " • Spider classes inherit from [blue]`crawlo.spider.Spider`[/blue]\n"
71
- " • Each spider has a [green]`name`[/green] attribute\n"
72
- " • Spiders are imported in [cyan]`spiders/__init__.py`[/cyan] (if using package)"
73
- ),
74
- title="📭 No Spiders Found",
75
- border_style="yellow",
76
- padding=(1, 2)
77
- ))
78
- return 0
79
-
80
- # 准备爬虫信息
81
- spider_info = []
82
- for name in sorted(spider_names):
83
- spider_cls = process.get_spider_class(name)
84
- module_name = spider_cls.__module__.replace(f"{project_package}.", "")
85
-
86
- # 获取额外信息
87
- start_urls_count = len(getattr(spider_cls, 'start_urls', []))
88
- allowed_domains = getattr(spider_cls, 'allowed_domains', [])
89
- custom_settings = getattr(spider_cls, 'custom_settings', {})
90
-
91
- spider_info.append({
92
- "name": name,
93
- "class": spider_cls.__name__,
94
- "module": module_name,
95
- "start_urls_count": start_urls_count,
96
- "allowed_domains": allowed_domains,
97
- "has_custom_settings": bool(custom_settings)
98
- })
99
-
100
- # JSON 输出
101
- if show_json:
102
- console.print_json(data={
103
- "success": True,
104
- "count": len(spider_info),
105
- "spiders": spider_info
106
- })
107
- return 0
108
-
109
- # 表格输出
110
- table = Table(
111
- title=f"📋 Found {len(spider_names)} spider(s)",
112
- box=box.ROUNDED,
113
- show_header=True,
114
- header_style="bold magenta",
115
- title_style="bold green"
116
- )
117
- table.add_column("Name", style="cyan", no_wrap=True)
118
- table.add_column("Class", style="green")
119
- table.add_column("Module", style="dim")
120
- table.add_column("URLs", style="blue", justify="center")
121
- table.add_column("Domains", style="yellow")
122
- table.add_column("Custom Settings", style="magenta", justify="center")
123
-
124
- for info in spider_info:
125
- domains_display = ", ".join(info["allowed_domains"][:2]) # 显示前2个域名
126
- if len(info["allowed_domains"]) > 2:
127
- domains_display += f" (+{len(info['allowed_domains'])-2})"
128
- elif not domains_display:
129
- domains_display = "-"
130
-
131
- table.add_row(
132
- info["name"],
133
- info["class"],
134
- info["module"],
135
- str(info["start_urls_count"]),
136
- domains_display,
137
- "✓" if info["has_custom_settings"] else "-"
138
- )
139
-
140
- console.print(table)
141
-
142
- # 显示使用提示
143
- console.print("\n[bold]🚀 Next steps:[/bold]")
144
- console.print(" [blue]crawlo run[/blue] <spider_name> # Run a specific spider")
145
- console.print(" [blue]crawlo run[/blue] all # Run all spiders")
146
- console.print(" [blue]crawlo check[/blue] <spider_name> # Check spider validity")
147
-
148
- return 0
149
-
150
- except Exception as e:
151
- if show_json:
152
- console.print_json(data={"success": False, "error": str(e)})
153
- else:
154
- console.print(f"[bold red]❌ Unexpected error:[/bold red] {e}")
155
- logger.exception("Exception during 'crawlo list'")
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ # @Time : 2025-08-31 22:33
5
+ # @Author : crawl-coder
6
+ # @Desc : 命令行入口:crawlo list,用于列出所有已注册的爬虫
7
+ """
8
+ import sys
9
+ from pathlib import Path
10
+ from importlib import import_module
11
+
12
+ from rich.console import Console
13
+ from rich.table import Table
14
+ from rich.panel import Panel
15
+ from rich.text import Text
16
+ from rich import box
17
+
18
+ from crawlo.crawler import CrawlerProcess
19
+ from crawlo.utils.log import get_logger
20
+ from .utils import validate_project_environment, show_error_panel
21
+
22
+ logger = get_logger(__name__)
23
+ console = Console()
24
+
25
+
26
+ def main(args):
27
+ """
28
+ 主函数:列出所有可用爬虫
29
+ 用法: crawlo list [--json]
30
+ """
31
+ show_json = "--json" in args
32
+
33
+ # 过滤掉参数后检查是否有额外参数
34
+ filtered_args = [arg for arg in args if not arg.startswith('--')]
35
+ if filtered_args:
36
+ if show_json:
37
+ console.print_json(data={"success": False, "error": "Usage: crawlo list [--json]"})
38
+ else:
39
+ console.print("[bold red]❌ Error:[/bold red] Usage: [blue]crawlo list[/blue] [--json]")
40
+ return 1
41
+
42
+ try:
43
+ # 验证项目环境
44
+ is_valid, project_package, error_msg = validate_project_environment()
45
+ if not is_valid:
46
+ if show_json:
47
+ console.print_json(data={"success": False, "error": error_msg})
48
+ else:
49
+ show_error_panel("Not a Crawlo Project", error_msg)
50
+ return 1
51
+
52
+ # 初始化 CrawlerProcess 并加载爬虫模块
53
+ spider_modules = [f"{project_package}.spiders"]
54
+ process = CrawlerProcess(spider_modules=spider_modules)
55
+
56
+ # 获取所有爬虫名称
57
+ spider_names = process.get_spider_names()
58
+ if not spider_names:
59
+ if show_json:
60
+ console.print_json(data={
61
+ "success": True,
62
+ "spiders": [],
63
+ "message": "No spiders found in project"
64
+ })
65
+ else:
66
+ console.print(Panel(
67
+ Text.from_markup(
68
+ ":envelope_with_arrow: [bold]No spiders found[/bold] in '[cyan]spiders/[/cyan]' directory.\n\n"
69
+ "[bold]💡 Make sure:[/bold]\n"
70
+ " • Spider classes inherit from [blue]`crawlo.spider.Spider`[/blue]\n"
71
+ " • Each spider has a [green]`name`[/green] attribute\n"
72
+ " • Spiders are imported in [cyan]`spiders/__init__.py`[/cyan] (if using package)"
73
+ ),
74
+ title="📭 No Spiders Found",
75
+ border_style="yellow",
76
+ padding=(1, 2)
77
+ ))
78
+ return 0
79
+
80
+ # 准备爬虫信息
81
+ spider_info = []
82
+ for name in sorted(spider_names):
83
+ spider_cls = process.get_spider_class(name)
84
+ module_name = spider_cls.__module__.replace(f"{project_package}.", "")
85
+
86
+ # 获取额外信息
87
+ start_urls_count = len(getattr(spider_cls, 'start_urls', []))
88
+ allowed_domains = getattr(spider_cls, 'allowed_domains', [])
89
+ custom_settings = getattr(spider_cls, 'custom_settings', {})
90
+
91
+ spider_info.append({
92
+ "name": name,
93
+ "class": spider_cls.__name__,
94
+ "module": module_name,
95
+ "start_urls_count": start_urls_count,
96
+ "allowed_domains": allowed_domains,
97
+ "has_custom_settings": bool(custom_settings)
98
+ })
99
+
100
+ # JSON 输出
101
+ if show_json:
102
+ console.print_json(data={
103
+ "success": True,
104
+ "count": len(spider_info),
105
+ "spiders": spider_info
106
+ })
107
+ return 0
108
+
109
+ # 表格输出
110
+ table = Table(
111
+ title=f"📋 Found {len(spider_names)} spider(s)",
112
+ box=box.ROUNDED,
113
+ show_header=True,
114
+ header_style="bold magenta",
115
+ title_style="bold green"
116
+ )
117
+ table.add_column("Name", style="cyan", no_wrap=True)
118
+ table.add_column("Class", style="green")
119
+ table.add_column("Module", style="dim")
120
+ table.add_column("URLs", style="blue", justify="center")
121
+ table.add_column("Domains", style="yellow")
122
+ table.add_column("Custom Settings", style="magenta", justify="center")
123
+
124
+ for info in spider_info:
125
+ domains_display = ", ".join(info["allowed_domains"][:2]) # 显示前2个域名
126
+ if len(info["allowed_domains"]) > 2:
127
+ domains_display += f" (+{len(info['allowed_domains'])-2})"
128
+ elif not domains_display:
129
+ domains_display = "-"
130
+
131
+ table.add_row(
132
+ info["name"],
133
+ info["class"],
134
+ info["module"],
135
+ str(info["start_urls_count"]),
136
+ domains_display,
137
+ "✓" if info["has_custom_settings"] else "-"
138
+ )
139
+
140
+ console.print(table)
141
+
142
+ # 显示使用提示
143
+ console.print("\n[bold]🚀 Next steps:[/bold]")
144
+ console.print(" [blue]crawlo run[/blue] <spider_name> # Run a specific spider")
145
+ console.print(" [blue]crawlo run[/blue] all # Run all spiders")
146
+ console.print(" [blue]crawlo check[/blue] <spider_name> # Check spider validity")
147
+
148
+ return 0
149
+
150
+ except Exception as e:
151
+ if show_json:
152
+ console.print_json(data={"success": False, "error": str(e)})
153
+ else:
154
+ console.print(f"[bold red]❌ Unexpected error:[/bold red] {e}")
155
+ logger.exception("Exception during 'crawlo list'")
156
156
  return 1