crawlo 1.4.7__py3-none-any.whl → 1.4.8__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 (348) hide show
  1. crawlo/__init__.py +90 -90
  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 +186 -186
  7. crawlo/commands/help.py +140 -140
  8. crawlo/commands/list.py +155 -155
  9. crawlo/commands/run.py +379 -379
  10. crawlo/commands/startproject.py +460 -460
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +196 -196
  13. crawlo/config.py +320 -320
  14. crawlo/config_validator.py +277 -277
  15. crawlo/core/__init__.py +52 -52
  16. crawlo/core/engine.py +451 -451
  17. crawlo/core/processor.py +47 -47
  18. crawlo/core/scheduler.py +290 -290
  19. crawlo/crawler.py +698 -698
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -194
  22. crawlo/downloader/__init__.py +280 -280
  23. crawlo/downloader/aiohttp_downloader.py +233 -233
  24. crawlo/downloader/cffi_downloader.py +250 -250
  25. crawlo/downloader/httpx_downloader.py +265 -265
  26. crawlo/downloader/hybrid_downloader.py +212 -212
  27. crawlo/downloader/playwright_downloader.py +425 -425
  28. crawlo/downloader/selenium_downloader.py +486 -486
  29. crawlo/event.py +45 -45
  30. crawlo/exceptions.py +214 -214
  31. crawlo/extension/__init__.py +64 -64
  32. crawlo/extension/health_check.py +141 -141
  33. crawlo/extension/log_interval.py +94 -94
  34. crawlo/extension/log_stats.py +70 -70
  35. crawlo/extension/logging_extension.py +53 -53
  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 +27 -27
  40. crawlo/factories/base.py +68 -68
  41. crawlo/factories/crawler.py +104 -104
  42. crawlo/factories/registry.py +84 -84
  43. crawlo/factories/utils.py +134 -134
  44. crawlo/filters/__init__.py +170 -170
  45. crawlo/filters/aioredis_filter.py +347 -347
  46. crawlo/filters/memory_filter.py +261 -261
  47. crawlo/framework.py +306 -306
  48. crawlo/initialization/__init__.py +44 -44
  49. crawlo/initialization/built_in.py +391 -391
  50. crawlo/initialization/context.py +141 -141
  51. crawlo/initialization/core.py +240 -240
  52. crawlo/initialization/phases.py +229 -229
  53. crawlo/initialization/registry.py +143 -143
  54. crawlo/initialization/utils.py +48 -48
  55. crawlo/interfaces.py +23 -23
  56. crawlo/items/__init__.py +23 -23
  57. crawlo/items/base.py +23 -23
  58. crawlo/items/fields.py +52 -52
  59. crawlo/items/items.py +104 -104
  60. crawlo/logging/__init__.py +42 -42
  61. crawlo/logging/config.py +280 -276
  62. crawlo/logging/factory.py +175 -175
  63. crawlo/logging/manager.py +104 -104
  64. crawlo/middleware/__init__.py +87 -87
  65. crawlo/middleware/default_header.py +132 -132
  66. crawlo/middleware/download_delay.py +104 -104
  67. crawlo/middleware/middleware_manager.py +142 -142
  68. crawlo/middleware/offsite.py +123 -123
  69. crawlo/middleware/proxy.py +209 -209
  70. crawlo/middleware/request_ignore.py +86 -86
  71. crawlo/middleware/response_code.py +150 -150
  72. crawlo/middleware/response_filter.py +136 -136
  73. crawlo/middleware/retry.py +124 -124
  74. crawlo/mode_manager.py +287 -287
  75. crawlo/network/__init__.py +21 -21
  76. crawlo/network/request.py +408 -376
  77. crawlo/network/response.py +598 -569
  78. crawlo/pipelines/__init__.py +52 -52
  79. crawlo/pipelines/base_pipeline.py +452 -452
  80. crawlo/pipelines/bloom_dedup_pipeline.py +145 -146
  81. crawlo/pipelines/console_pipeline.py +39 -39
  82. crawlo/pipelines/csv_pipeline.py +316 -316
  83. crawlo/pipelines/database_dedup_pipeline.py +196 -197
  84. crawlo/pipelines/json_pipeline.py +218 -218
  85. crawlo/pipelines/memory_dedup_pipeline.py +104 -105
  86. crawlo/pipelines/mongo_pipeline.py +140 -139
  87. crawlo/pipelines/mysql_pipeline.py +468 -469
  88. crawlo/pipelines/pipeline_manager.py +100 -100
  89. crawlo/pipelines/redis_dedup_pipeline.py +155 -155
  90. crawlo/project.py +347 -347
  91. crawlo/queue/__init__.py +9 -9
  92. crawlo/queue/pqueue.py +38 -38
  93. crawlo/queue/queue_manager.py +591 -591
  94. crawlo/queue/redis_priority_queue.py +518 -518
  95. crawlo/settings/__init__.py +7 -7
  96. crawlo/settings/default_settings.py +287 -284
  97. crawlo/settings/setting_manager.py +219 -219
  98. crawlo/spider/__init__.py +658 -657
  99. crawlo/stats_collector.py +81 -81
  100. crawlo/subscriber.py +129 -129
  101. crawlo/task_manager.py +138 -138
  102. crawlo/templates/crawlo.cfg.tmpl +10 -10
  103. crawlo/templates/project/__init__.py.tmpl +1 -1
  104. crawlo/templates/project/items.py.tmpl +13 -13
  105. crawlo/templates/project/middlewares.py.tmpl +38 -38
  106. crawlo/templates/project/pipelines.py.tmpl +35 -35
  107. crawlo/templates/project/settings.py.tmpl +113 -109
  108. crawlo/templates/project/settings_distributed.py.tmpl +160 -156
  109. crawlo/templates/project/settings_gentle.py.tmpl +174 -170
  110. crawlo/templates/project/settings_high_performance.py.tmpl +175 -171
  111. crawlo/templates/project/settings_minimal.py.tmpl +102 -98
  112. crawlo/templates/project/settings_simple.py.tmpl +172 -168
  113. crawlo/templates/project/spiders/__init__.py.tmpl +9 -9
  114. crawlo/templates/run.py.tmpl +23 -23
  115. crawlo/templates/spider/spider.py.tmpl +32 -32
  116. crawlo/templates/spiders_init.py.tmpl +4 -4
  117. crawlo/tools/__init__.py +86 -86
  118. crawlo/tools/date_tools.py +289 -289
  119. crawlo/tools/distributed_coordinator.py +384 -384
  120. crawlo/tools/scenario_adapter.py +262 -262
  121. crawlo/tools/text_cleaner.py +232 -232
  122. crawlo/utils/__init__.py +74 -50
  123. crawlo/utils/batch_processor.py +276 -276
  124. crawlo/utils/config_manager.py +442 -442
  125. crawlo/utils/controlled_spider_mixin.py +439 -439
  126. crawlo/utils/db_helper.py +250 -250
  127. crawlo/utils/encoding_helper.py +190 -0
  128. crawlo/utils/error_handler.py +410 -410
  129. crawlo/utils/fingerprint.py +121 -121
  130. crawlo/utils/func_tools.py +82 -82
  131. crawlo/utils/large_scale_helper.py +344 -344
  132. crawlo/utils/leak_detector.py +335 -335
  133. crawlo/utils/misc.py +81 -81
  134. crawlo/utils/mongo_connection_pool.py +157 -157
  135. crawlo/utils/mysql_connection_pool.py +197 -197
  136. crawlo/utils/performance_monitor.py +285 -285
  137. crawlo/utils/queue_helper.py +175 -175
  138. crawlo/utils/redis_checker.py +90 -90
  139. crawlo/utils/redis_connection_pool.py +578 -578
  140. crawlo/utils/redis_key_validator.py +198 -198
  141. crawlo/utils/request.py +278 -278
  142. crawlo/utils/request_serializer.py +225 -225
  143. crawlo/utils/resource_manager.py +337 -337
  144. crawlo/utils/response_helper.py +113 -0
  145. crawlo/utils/selector_helper.py +138 -137
  146. crawlo/utils/singleton.py +69 -69
  147. crawlo/utils/spider_loader.py +201 -201
  148. crawlo/utils/text_helper.py +94 -94
  149. {crawlo-1.4.7.dist-info → crawlo-1.4.8.dist-info}/METADATA +831 -689
  150. crawlo-1.4.8.dist-info/RECORD +347 -0
  151. examples/__init__.py +7 -7
  152. tests/__init__.py +7 -7
  153. tests/advanced_tools_example.py +217 -217
  154. tests/authenticated_proxy_example.py +110 -110
  155. tests/baidu_performance_test.py +108 -108
  156. tests/baidu_test.py +59 -59
  157. tests/bug_check_test.py +250 -250
  158. tests/cleaners_example.py +160 -160
  159. tests/comprehensive_framework_test.py +212 -212
  160. tests/comprehensive_test.py +81 -81
  161. tests/comprehensive_testing_summary.md +186 -186
  162. tests/config_validation_demo.py +142 -142
  163. tests/controlled_spider_example.py +205 -205
  164. tests/date_tools_example.py +180 -180
  165. tests/debug_configure.py +69 -69
  166. tests/debug_framework_logger.py +84 -84
  167. tests/debug_log_config.py +126 -126
  168. tests/debug_log_levels.py +63 -63
  169. tests/debug_pipelines.py +66 -66
  170. tests/detailed_log_test.py +233 -233
  171. tests/direct_selector_helper_test.py +96 -96
  172. tests/distributed_dedup_test.py +467 -467
  173. tests/distributed_test.py +66 -66
  174. tests/distributed_test_debug.py +76 -76
  175. tests/dynamic_loading_example.py +523 -523
  176. tests/dynamic_loading_test.py +104 -104
  177. tests/error_handling_example.py +171 -171
  178. tests/explain_mysql_update_behavior.py +76 -76
  179. tests/final_comprehensive_test.py +151 -151
  180. tests/final_log_test.py +260 -260
  181. tests/final_validation_test.py +182 -182
  182. tests/fix_log_test.py +142 -142
  183. tests/framework_performance_test.py +202 -202
  184. tests/log_buffering_test.py +111 -111
  185. tests/log_generation_timing_test.py +153 -153
  186. tests/monitor_redis_dedup.sh +72 -72
  187. tests/ofweek_scrapy/ofweek_scrapy/items.py +12 -12
  188. tests/ofweek_scrapy/ofweek_scrapy/middlewares.py +100 -100
  189. tests/ofweek_scrapy/ofweek_scrapy/pipelines.py +13 -13
  190. tests/ofweek_scrapy/ofweek_scrapy/settings.py +84 -84
  191. tests/ofweek_scrapy/ofweek_scrapy/spiders/__init__.py +4 -4
  192. tests/ofweek_scrapy/scrapy.cfg +11 -11
  193. tests/optimized_performance_test.py +211 -211
  194. tests/performance_comparison.py +244 -244
  195. tests/queue_blocking_test.py +113 -113
  196. tests/queue_test.py +89 -89
  197. tests/redis_key_validation_demo.py +130 -130
  198. tests/request_params_example.py +150 -150
  199. tests/response_improvements_example.py +144 -144
  200. tests/scrapy_comparison/ofweek_scrapy.py +138 -138
  201. tests/scrapy_comparison/scrapy_test.py +133 -133
  202. tests/simple_cli_test.py +54 -54
  203. tests/simple_command_test.py +119 -119
  204. tests/simple_crawlo_test.py +126 -126
  205. tests/simple_follow_test.py +38 -38
  206. tests/simple_log_test2.py +137 -137
  207. tests/simple_optimization_test.py +128 -128
  208. tests/simple_queue_type_test.py +41 -41
  209. tests/simple_response_selector_test.py +94 -94
  210. tests/simple_selector_helper_test.py +154 -154
  211. tests/simple_selector_test.py +207 -207
  212. tests/simple_spider_test.py +49 -49
  213. tests/simple_url_test.py +73 -73
  214. tests/simulate_mysql_update_test.py +139 -139
  215. tests/spider_log_timing_test.py +177 -177
  216. tests/test_advanced_tools.py +148 -148
  217. tests/test_all_commands.py +230 -230
  218. tests/test_all_pipeline_fingerprints.py +133 -133
  219. tests/test_all_redis_key_configs.py +145 -145
  220. tests/test_asyncmy_usage.py +56 -56
  221. tests/test_batch_processor.py +178 -178
  222. tests/test_cleaners.py +54 -54
  223. tests/test_cli_arguments.py +118 -118
  224. tests/test_component_factory.py +174 -174
  225. tests/test_config_consistency.py +80 -80
  226. tests/test_config_merge.py +152 -152
  227. tests/test_config_validator.py +182 -182
  228. tests/test_controlled_spider_mixin.py +79 -79
  229. tests/test_crawler_process_import.py +38 -38
  230. tests/test_crawler_process_spider_modules.py +47 -47
  231. tests/test_crawlo_proxy_integration.py +114 -114
  232. tests/test_date_tools.py +123 -123
  233. tests/test_dedup_fix.py +220 -220
  234. tests/test_dedup_pipeline_consistency.py +124 -124
  235. tests/test_default_header_middleware.py +313 -313
  236. tests/test_distributed.py +65 -65
  237. tests/test_double_crawlo_fix.py +204 -204
  238. tests/test_double_crawlo_fix_simple.py +124 -124
  239. tests/test_download_delay_middleware.py +221 -221
  240. tests/test_downloader_proxy_compatibility.py +272 -272
  241. tests/test_edge_cases.py +305 -305
  242. tests/test_encoding_core.py +56 -56
  243. tests/test_encoding_detection.py +126 -126
  244. tests/test_enhanced_error_handler.py +270 -270
  245. tests/test_enhanced_error_handler_comprehensive.py +245 -245
  246. tests/test_error_handler_compatibility.py +112 -112
  247. tests/test_factories.py +252 -252
  248. tests/test_factory_compatibility.py +196 -196
  249. tests/test_final_validation.py +153 -153
  250. tests/test_fingerprint_consistency.py +135 -135
  251. tests/test_fingerprint_simple.py +51 -51
  252. tests/test_get_component_logger.py +83 -83
  253. tests/test_hash_performance.py +99 -99
  254. tests/test_integration.py +169 -169
  255. tests/test_item_dedup_redis_key.py +122 -122
  256. tests/test_large_scale_helper.py +235 -235
  257. tests/test_logging_enhancements.py +374 -374
  258. tests/test_logging_final.py +184 -184
  259. tests/test_logging_integration.py +312 -312
  260. tests/test_logging_system.py +282 -282
  261. tests/test_middleware_debug.py +141 -141
  262. tests/test_mode_consistency.py +51 -51
  263. tests/test_multi_directory.py +67 -67
  264. tests/test_multiple_spider_modules.py +80 -80
  265. tests/test_mysql_pipeline_config.py +164 -164
  266. tests/test_mysql_pipeline_error.py +98 -98
  267. tests/test_mysql_pipeline_init_log.py +82 -82
  268. tests/test_mysql_pipeline_integration.py +132 -132
  269. tests/test_mysql_pipeline_refactor.py +143 -143
  270. tests/test_mysql_pipeline_refactor_simple.py +85 -85
  271. tests/test_mysql_pipeline_robustness.py +195 -195
  272. tests/test_mysql_pipeline_types.py +88 -88
  273. tests/test_mysql_update_columns.py +93 -93
  274. tests/test_offsite_middleware.py +244 -244
  275. tests/test_offsite_middleware_simple.py +203 -203
  276. tests/test_optimized_selector_naming.py +100 -100
  277. tests/test_parsel.py +29 -29
  278. tests/test_performance.py +327 -327
  279. tests/test_performance_monitor.py +115 -115
  280. tests/test_pipeline_fingerprint_consistency.py +86 -86
  281. tests/test_priority_behavior.py +211 -211
  282. tests/test_priority_consistency.py +151 -151
  283. tests/test_priority_consistency_fixed.py +249 -249
  284. tests/test_proxy_health_check.py +32 -32
  285. tests/test_proxy_middleware.py +217 -217
  286. tests/test_proxy_middleware_enhanced.py +212 -212
  287. tests/test_proxy_middleware_integration.py +142 -142
  288. tests/test_proxy_middleware_refactored.py +207 -207
  289. tests/test_proxy_only.py +83 -83
  290. tests/test_proxy_providers.py +56 -56
  291. tests/test_proxy_stats.py +19 -19
  292. tests/test_proxy_strategies.py +59 -59
  293. tests/test_proxy_with_downloader.py +152 -152
  294. tests/test_queue_empty_check.py +41 -41
  295. tests/test_queue_manager_double_crawlo.py +173 -173
  296. tests/test_queue_manager_redis_key.py +179 -179
  297. tests/test_queue_naming.py +154 -154
  298. tests/test_queue_type.py +106 -106
  299. tests/test_queue_type_redis_config_consistency.py +130 -130
  300. tests/test_random_headers_default.py +322 -322
  301. tests/test_random_headers_necessity.py +308 -308
  302. tests/test_random_user_agent.py +72 -72
  303. tests/test_redis_config.py +28 -28
  304. tests/test_redis_connection_pool.py +294 -294
  305. tests/test_redis_key_naming.py +181 -181
  306. tests/test_redis_key_validator.py +123 -123
  307. tests/test_redis_queue.py +224 -224
  308. tests/test_redis_queue_name_fix.py +175 -175
  309. tests/test_redis_queue_type_fallback.py +129 -129
  310. tests/test_request_ignore_middleware.py +182 -182
  311. tests/test_request_params.py +111 -111
  312. tests/test_request_serialization.py +70 -70
  313. tests/test_response_code_middleware.py +349 -349
  314. tests/test_response_filter_middleware.py +427 -427
  315. tests/test_response_follow.py +104 -104
  316. tests/test_response_improvements.py +152 -152
  317. tests/test_response_selector_methods.py +92 -92
  318. tests/test_response_url_methods.py +70 -70
  319. tests/test_response_urljoin.py +86 -86
  320. tests/test_retry_middleware.py +333 -333
  321. tests/test_retry_middleware_realistic.py +273 -273
  322. tests/test_scheduler.py +252 -252
  323. tests/test_scheduler_config_update.py +133 -133
  324. tests/test_scrapy_style_encoding.py +112 -112
  325. tests/test_selector_helper.py +100 -100
  326. tests/test_selector_optimizations.py +146 -146
  327. tests/test_simple_response.py +61 -61
  328. tests/test_spider_loader.py +49 -49
  329. tests/test_spider_loader_comprehensive.py +69 -69
  330. tests/test_spider_modules.py +84 -84
  331. tests/test_spiders/test_spider.py +9 -9
  332. tests/test_telecom_spider_redis_key.py +205 -205
  333. tests/test_template_content.py +87 -87
  334. tests/test_template_redis_key.py +134 -134
  335. tests/test_tools.py +159 -159
  336. tests/test_user_agent_randomness.py +176 -176
  337. tests/test_user_agents.py +96 -96
  338. tests/untested_features_report.md +138 -138
  339. tests/verify_debug.py +51 -51
  340. tests/verify_distributed.py +117 -117
  341. tests/verify_log_fix.py +111 -111
  342. tests/verify_mysql_warnings.py +109 -109
  343. crawlo/utils/log.py +0 -80
  344. crawlo/utils/url_utils.py +0 -40
  345. crawlo-1.4.7.dist-info/RECORD +0 -347
  346. {crawlo-1.4.7.dist-info → crawlo-1.4.8.dist-info}/WHEEL +0 -0
  347. {crawlo-1.4.7.dist-info → crawlo-1.4.8.dist-info}/entry_points.txt +0 -0
  348. {crawlo-1.4.7.dist-info → crawlo-1.4.8.dist-info}/top_level.txt +0 -0
crawlo/__init__.py CHANGED
@@ -1,90 +1,90 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- Crawlo - 一个异步爬虫框架
5
- """
6
-
7
- # 为了向后兼容,从tools中导入cleaners相关的功能
8
- import crawlo.tools as cleaners
9
- from crawlo import tools
10
- from crawlo.crawler import Crawler, CrawlerProcess
11
- from crawlo.downloader import DownloaderBase
12
- from crawlo.items import Item, Field
13
- from crawlo.middleware import BaseMiddleware
14
- from crawlo.network.request import Request
15
- from crawlo.network.response import Response
16
- from crawlo.spider import Spider
17
- from crawlo.utils import (
18
- TimeUtils,
19
- parse_time,
20
- format_time,
21
- time_diff,
22
- to_timestamp,
23
- to_datetime,
24
- now,
25
- to_timezone,
26
- to_utc,
27
- to_local,
28
- from_timestamp_with_tz
29
- )
30
-
31
-
32
- # 延迟导入的辅助函数
33
- def get_framework_initializer():
34
- """延迟导入CoreInitializer以避免循环依赖"""
35
- from crawlo.initialization import CoreInitializer
36
- return CoreInitializer()
37
-
38
-
39
- def initialize_framework(custom_settings=None):
40
- """延迟导入initialize_framework以避免循环依赖"""
41
- from crawlo.initialization import initialize_framework as _initialize_framework
42
- return _initialize_framework(custom_settings)
43
-
44
-
45
- # 向后兼容的别名
46
- def get_bootstrap_manager():
47
- """向后兼容的别名"""
48
- return get_framework_initializer()
49
-
50
-
51
- # 版本号:优先从元数据读取
52
- try:
53
- from importlib.metadata import version
54
-
55
- __version__ = version("crawlo")
56
- except Exception:
57
- # 开发模式下可能未安装,回退到 __version__.py 或 dev
58
- try:
59
- from crawlo.__version__ import __version__
60
- except ImportError:
61
- __version__ = "dev"
62
-
63
- # 定义对外 API
64
- __all__ = [
65
- 'Spider',
66
- 'Item',
67
- 'Field',
68
- 'Request',
69
- 'Response',
70
- 'DownloaderBase',
71
- 'BaseMiddleware',
72
- 'TimeUtils',
73
- 'parse_time',
74
- 'format_time',
75
- 'time_diff',
76
- 'to_timestamp',
77
- 'to_datetime',
78
- 'now',
79
- 'to_timezone',
80
- 'to_utc',
81
- 'to_local',
82
- 'from_timestamp_with_tz',
83
- 'cleaners',
84
- 'tools',
85
- 'Crawler',
86
- 'CrawlerProcess',
87
- 'get_framework_initializer',
88
- 'get_bootstrap_manager',
89
- '__version__',
90
- ]
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ Crawlo - 一个异步爬虫框架
5
+ """
6
+
7
+ # 为了向后兼容,从tools中导入cleaners相关的功能
8
+ import crawlo.tools as cleaners
9
+ from crawlo import tools
10
+ from crawlo.crawler import Crawler, CrawlerProcess
11
+ from crawlo.downloader import DownloaderBase
12
+ from crawlo.items import Item, Field
13
+ from crawlo.middleware import BaseMiddleware
14
+ from crawlo.network.request import Request
15
+ from crawlo.network.response import Response
16
+ from crawlo.spider import Spider
17
+ from crawlo.utils import (
18
+ TimeUtils,
19
+ parse_time,
20
+ format_time,
21
+ time_diff,
22
+ to_timestamp,
23
+ to_datetime,
24
+ now,
25
+ to_timezone,
26
+ to_utc,
27
+ to_local,
28
+ from_timestamp_with_tz
29
+ )
30
+
31
+
32
+ # 延迟导入的辅助函数
33
+ def get_framework_initializer():
34
+ """延迟导入CoreInitializer以避免循环依赖"""
35
+ from crawlo.initialization import CoreInitializer
36
+ return CoreInitializer()
37
+
38
+
39
+ def initialize_framework(custom_settings=None):
40
+ """延迟导入initialize_framework以避免循环依赖"""
41
+ from crawlo.initialization import initialize_framework as _initialize_framework
42
+ return _initialize_framework(custom_settings)
43
+
44
+
45
+ # 向后兼容的别名
46
+ def get_bootstrap_manager():
47
+ """向后兼容的别名"""
48
+ return get_framework_initializer()
49
+
50
+
51
+ # 版本号:优先从元数据读取
52
+ try:
53
+ from importlib.metadata import version
54
+
55
+ __version__ = version("crawlo")
56
+ except Exception:
57
+ # 开发模式下可能未安装,回退到 __version__.py 或 dev
58
+ try:
59
+ from crawlo.__version__ import __version__
60
+ except ImportError:
61
+ __version__ = "dev"
62
+
63
+ # 定义对外 API
64
+ __all__ = [
65
+ 'Spider',
66
+ 'Item',
67
+ 'Field',
68
+ 'Request',
69
+ 'Response',
70
+ 'DownloaderBase',
71
+ 'BaseMiddleware',
72
+ 'TimeUtils',
73
+ 'parse_time',
74
+ 'format_time',
75
+ 'time_diff',
76
+ 'to_timestamp',
77
+ 'to_datetime',
78
+ 'now',
79
+ 'to_timezone',
80
+ 'to_utc',
81
+ 'to_local',
82
+ 'from_timestamp_with_tz',
83
+ 'cleaners',
84
+ 'tools',
85
+ 'Crawler',
86
+ 'CrawlerProcess',
87
+ 'get_framework_initializer',
88
+ 'get_bootstrap_manager',
89
+ '__version__',
90
+ ]
crawlo/__version__.py CHANGED
@@ -1 +1 @@
1
- __version__ = '1.4.7'
1
+ __version__ = '1.4.8'
crawlo/cli.py CHANGED
@@ -1,76 +1,76 @@
1
- # crawlo/cli.py
2
- # !/usr/bin/python
3
- # -*- coding: UTF-8 -*-
4
- import sys
5
- import argparse
6
- from crawlo.commands import get_commands
7
- from crawlo.utils.config_manager import EnvConfigManager
8
-
9
-
10
- def main():
11
- # 获取框架版本号
12
- VERSION = EnvConfigManager.get_version()
13
-
14
- # 获取所有可用命令
15
- commands = get_commands()
16
-
17
- # 创建主解析器
18
- parser = argparse.ArgumentParser(
19
- description="Crawlo: A lightweight web crawler framework.",
20
- usage="crawlo <command> [options]",
21
- add_help=False # 禁用默认帮助,我们自己处理
22
- )
23
-
24
- # 添加帮助参数
25
- parser.add_argument('-h', '--help', action='store_true', help='显示帮助信息')
26
- parser.add_argument('-v', '--version', action='store_true', help='显示版本信息')
27
- parser.add_argument('command', nargs='?', help='可用命令: ' + ', '.join(commands.keys()))
28
-
29
- # 解析已知参数
30
- args, unknown = parser.parse_known_args()
31
-
32
- # 处理版本参数
33
- if args.version:
34
- print(f"Crawlo {VERSION}")
35
- sys.exit(0)
36
-
37
- # 处理帮助参数
38
- if args.help or (args.command is None and not unknown):
39
- # 导入并运行帮助命令
40
- try:
41
- module = __import__(commands['help'], fromlist=['main'])
42
- sys.exit(module.main([]))
43
- except ImportError as e:
44
- print(f"Failed to load help command: {e}")
45
- sys.exit(1)
46
- except Exception as e:
47
- print(f"Help command failed: {e}")
48
- sys.exit(1)
49
-
50
- # 检查命令是否存在
51
- if args.command not in commands:
52
- print(f"Unknown command: {args.command}")
53
- print(f"Available commands: {', '.join(commands.keys())}")
54
- # 显示帮助信息
55
- try:
56
- module = __import__(commands['help'], fromlist=['main'])
57
- module.main([])
58
- except:
59
- pass
60
- sys.exit(1)
61
-
62
- # 动态导入并执行命令
63
- try:
64
- module = __import__(commands[args.command], fromlist=['main'])
65
- # 将未知参数传递给子命令
66
- sys.exit(module.main(unknown))
67
- except ImportError as e:
68
- print(f"Failed to load command '{args.command}': {e}")
69
- sys.exit(1)
70
- except Exception as e:
71
- print(f"Command '{args.command}' failed: {e}")
72
- sys.exit(1)
73
-
74
-
75
- if __name__ == '__main__':
1
+ # crawlo/cli.py
2
+ # !/usr/bin/python
3
+ # -*- coding: UTF-8 -*-
4
+ import sys
5
+ import argparse
6
+ from crawlo.commands import get_commands
7
+ from crawlo.utils.config_manager import EnvConfigManager
8
+
9
+
10
+ def main():
11
+ # 获取框架版本号
12
+ VERSION = EnvConfigManager.get_version()
13
+
14
+ # 获取所有可用命令
15
+ commands = get_commands()
16
+
17
+ # 创建主解析器
18
+ parser = argparse.ArgumentParser(
19
+ description="Crawlo: A lightweight web crawler framework.",
20
+ usage="crawlo <command> [options]",
21
+ add_help=False # 禁用默认帮助,我们自己处理
22
+ )
23
+
24
+ # 添加帮助参数
25
+ parser.add_argument('-h', '--help', action='store_true', help='显示帮助信息')
26
+ parser.add_argument('-v', '--version', action='store_true', help='显示版本信息')
27
+ parser.add_argument('command', nargs='?', help='可用命令: ' + ', '.join(commands.keys()))
28
+
29
+ # 解析已知参数
30
+ args, unknown = parser.parse_known_args()
31
+
32
+ # 处理版本参数
33
+ if args.version:
34
+ print(f"Crawlo {VERSION}")
35
+ sys.exit(0)
36
+
37
+ # 处理帮助参数
38
+ if args.help or (args.command is None and not unknown):
39
+ # 导入并运行帮助命令
40
+ try:
41
+ module = __import__(commands['help'], fromlist=['main'])
42
+ sys.exit(module.main([]))
43
+ except ImportError as e:
44
+ print(f"Failed to load help command: {e}")
45
+ sys.exit(1)
46
+ except Exception as e:
47
+ print(f"Help command failed: {e}")
48
+ sys.exit(1)
49
+
50
+ # 检查命令是否存在
51
+ if args.command not in commands:
52
+ print(f"Unknown command: {args.command}")
53
+ print(f"Available commands: {', '.join(commands.keys())}")
54
+ # 显示帮助信息
55
+ try:
56
+ module = __import__(commands['help'], fromlist=['main'])
57
+ module.main([])
58
+ except:
59
+ pass
60
+ sys.exit(1)
61
+
62
+ # 动态导入并执行命令
63
+ try:
64
+ module = __import__(commands[args.command], fromlist=['main'])
65
+ # 将未知参数传递给子命令
66
+ sys.exit(module.main(unknown))
67
+ except ImportError as e:
68
+ print(f"Failed to load command '{args.command}': {e}")
69
+ sys.exit(1)
70
+ except Exception as e:
71
+ print(f"Command '{args.command}' failed: {e}")
72
+ sys.exit(1)
73
+
74
+
75
+ if __name__ == '__main__':
76
76
  main()
@@ -1,15 +1,15 @@
1
- #!/usr/bin/python
2
- # -*- coding:UTF-8 -*-
3
-
4
- _commands = {
5
- 'startproject': 'crawlo.commands.startproject',
6
- 'genspider': 'crawlo.commands.genspider',
7
- 'run': 'crawlo.commands.run',
8
- 'check': 'crawlo.commands.check',
9
- 'list': 'crawlo.commands.list',
10
- 'stats': 'crawlo.commands.stats',
11
- 'help': 'crawlo.commands.help'
12
- }
13
-
14
- def get_commands():
1
+ #!/usr/bin/python
2
+ # -*- coding:UTF-8 -*-
3
+
4
+ _commands = {
5
+ 'startproject': 'crawlo.commands.startproject',
6
+ 'genspider': 'crawlo.commands.genspider',
7
+ 'run': 'crawlo.commands.run',
8
+ 'check': 'crawlo.commands.check',
9
+ 'list': 'crawlo.commands.list',
10
+ 'stats': 'crawlo.commands.stats',
11
+ 'help': 'crawlo.commands.help'
12
+ }
13
+
14
+ def get_commands():
15
15
  return _commands