crawlo 1.4.1__py3-none-any.whl → 1.4.3__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 (326) hide show
  1. crawlo/__init__.py +93 -93
  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 +151 -151
  7. crawlo/commands/help.py +138 -138
  8. crawlo/commands/list.py +155 -155
  9. crawlo/commands/run.py +341 -341
  10. crawlo/commands/startproject.py +436 -436
  11. crawlo/commands/stats.py +187 -187
  12. crawlo/commands/utils.py +196 -196
  13. crawlo/config.py +312 -312
  14. crawlo/config_validator.py +277 -277
  15. crawlo/core/__init__.py +52 -52
  16. crawlo/core/engine.py +438 -439
  17. crawlo/core/processor.py +47 -47
  18. crawlo/core/scheduler.py +291 -257
  19. crawlo/crawler.py +650 -650
  20. crawlo/data/__init__.py +5 -5
  21. crawlo/data/user_agents.py +194 -194
  22. crawlo/downloader/__init__.py +273 -273
  23. crawlo/downloader/aiohttp_downloader.py +233 -228
  24. crawlo/downloader/cffi_downloader.py +245 -245
  25. crawlo/downloader/httpx_downloader.py +259 -259
  26. crawlo/downloader/hybrid_downloader.py +212 -212
  27. crawlo/downloader/playwright_downloader.py +402 -402
  28. crawlo/downloader/selenium_downloader.py +472 -472
  29. crawlo/event.py +11 -11
  30. crawlo/exceptions.py +81 -81
  31. crawlo/extension/__init__.py +63 -63
  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 +61 -61
  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 +103 -103
  42. crawlo/factories/registry.py +84 -84
  43. crawlo/filters/__init__.py +154 -154
  44. crawlo/filters/aioredis_filter.py +257 -257
  45. crawlo/filters/memory_filter.py +269 -269
  46. crawlo/framework.py +292 -292
  47. crawlo/initialization/__init__.py +44 -44
  48. crawlo/initialization/built_in.py +425 -425
  49. crawlo/initialization/context.py +141 -141
  50. crawlo/initialization/core.py +193 -193
  51. crawlo/initialization/phases.py +148 -148
  52. crawlo/initialization/registry.py +145 -145
  53. crawlo/items/__init__.py +23 -23
  54. crawlo/items/base.py +23 -23
  55. crawlo/items/fields.py +52 -52
  56. crawlo/items/items.py +104 -104
  57. crawlo/logging/__init__.py +45 -37
  58. crawlo/logging/async_handler.py +181 -0
  59. crawlo/logging/config.py +196 -96
  60. crawlo/logging/factory.py +171 -128
  61. crawlo/logging/manager.py +111 -111
  62. crawlo/logging/monitor.py +153 -0
  63. crawlo/logging/sampler.py +167 -0
  64. crawlo/middleware/__init__.py +21 -21
  65. crawlo/middleware/default_header.py +132 -132
  66. crawlo/middleware/download_delay.py +104 -104
  67. crawlo/middleware/middleware_manager.py +135 -135
  68. crawlo/middleware/offsite.py +123 -123
  69. crawlo/middleware/proxy.py +386 -386
  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/middleware/simple_proxy.py +65 -65
  75. crawlo/mode_manager.py +219 -219
  76. crawlo/network/__init__.py +21 -21
  77. crawlo/network/request.py +379 -379
  78. crawlo/network/response.py +359 -359
  79. crawlo/pipelines/__init__.py +21 -21
  80. crawlo/pipelines/bloom_dedup_pipeline.py +146 -146
  81. crawlo/pipelines/console_pipeline.py +39 -39
  82. crawlo/pipelines/csv_pipeline.py +316 -316
  83. crawlo/pipelines/database_dedup_pipeline.py +197 -197
  84. crawlo/pipelines/json_pipeline.py +218 -218
  85. crawlo/pipelines/memory_dedup_pipeline.py +105 -105
  86. crawlo/pipelines/mongo_pipeline.py +131 -131
  87. crawlo/pipelines/mysql_pipeline.py +325 -325
  88. crawlo/pipelines/pipeline_manager.py +100 -84
  89. crawlo/pipelines/redis_dedup_pipeline.py +156 -156
  90. crawlo/project.py +349 -338
  91. crawlo/queue/pqueue.py +42 -42
  92. crawlo/queue/queue_manager.py +526 -522
  93. crawlo/queue/redis_priority_queue.py +370 -367
  94. crawlo/settings/__init__.py +7 -7
  95. crawlo/settings/default_settings.py +284 -284
  96. crawlo/settings/setting_manager.py +219 -219
  97. crawlo/spider/__init__.py +657 -657
  98. crawlo/stats_collector.py +73 -73
  99. crawlo/subscriber.py +129 -129
  100. crawlo/task_manager.py +138 -138
  101. crawlo/templates/crawlo.cfg.tmpl +10 -10
  102. crawlo/templates/project/__init__.py.tmpl +3 -3
  103. crawlo/templates/project/items.py.tmpl +17 -17
  104. crawlo/templates/project/middlewares.py.tmpl +118 -118
  105. crawlo/templates/project/pipelines.py.tmpl +96 -96
  106. crawlo/templates/project/settings.py.tmpl +170 -170
  107. crawlo/templates/project/settings_distributed.py.tmpl +169 -169
  108. crawlo/templates/project/settings_gentle.py.tmpl +166 -166
  109. crawlo/templates/project/settings_high_performance.py.tmpl +167 -167
  110. crawlo/templates/project/settings_minimal.py.tmpl +65 -65
  111. crawlo/templates/project/settings_simple.py.tmpl +164 -164
  112. crawlo/templates/project/spiders/__init__.py.tmpl +9 -9
  113. crawlo/templates/run.py.tmpl +34 -34
  114. crawlo/templates/spider/spider.py.tmpl +143 -143
  115. crawlo/templates/spiders_init.py.tmpl +9 -9
  116. crawlo/tools/__init__.py +200 -200
  117. crawlo/tools/anti_crawler.py +268 -268
  118. crawlo/tools/authenticated_proxy.py +240 -240
  119. crawlo/tools/data_formatter.py +225 -225
  120. crawlo/tools/data_validator.py +180 -180
  121. crawlo/tools/date_tools.py +289 -289
  122. crawlo/tools/distributed_coordinator.py +384 -384
  123. crawlo/tools/encoding_converter.py +127 -127
  124. crawlo/tools/network_diagnostic.py +364 -364
  125. crawlo/tools/request_tools.py +82 -82
  126. crawlo/tools/retry_mechanism.py +224 -224
  127. crawlo/tools/scenario_adapter.py +262 -262
  128. crawlo/tools/text_cleaner.py +232 -232
  129. crawlo/utils/__init__.py +34 -34
  130. crawlo/utils/batch_processor.py +259 -259
  131. crawlo/utils/class_loader.py +25 -25
  132. crawlo/utils/controlled_spider_mixin.py +439 -439
  133. crawlo/utils/db_helper.py +343 -343
  134. crawlo/utils/enhanced_error_handler.py +356 -356
  135. crawlo/utils/env_config.py +142 -142
  136. crawlo/utils/error_handler.py +165 -165
  137. crawlo/utils/fingerprint.py +122 -122
  138. crawlo/utils/func_tools.py +82 -82
  139. crawlo/utils/large_scale_config.py +286 -286
  140. crawlo/utils/large_scale_helper.py +344 -344
  141. crawlo/utils/log.py +79 -79
  142. crawlo/utils/performance_monitor.py +285 -285
  143. crawlo/utils/queue_helper.py +175 -175
  144. crawlo/utils/redis_connection_pool.py +388 -388
  145. crawlo/utils/redis_key_validator.py +198 -198
  146. crawlo/utils/request.py +267 -267
  147. crawlo/utils/request_serializer.py +225 -225
  148. crawlo/utils/spider_loader.py +61 -61
  149. crawlo/utils/system.py +11 -11
  150. crawlo/utils/tools.py +4 -4
  151. crawlo/utils/url.py +39 -39
  152. crawlo-1.4.3.dist-info/METADATA +190 -0
  153. crawlo-1.4.3.dist-info/RECORD +326 -0
  154. examples/__init__.py +7 -7
  155. examples/test_project/__init__.py +7 -7
  156. examples/test_project/run.py +34 -34
  157. examples/test_project/test_project/__init__.py +3 -3
  158. examples/test_project/test_project/items.py +17 -17
  159. examples/test_project/test_project/middlewares.py +118 -118
  160. examples/test_project/test_project/pipelines.py +96 -96
  161. examples/test_project/test_project/settings.py +169 -169
  162. examples/test_project/test_project/spiders/__init__.py +9 -9
  163. examples/test_project/test_project/spiders/of_week_dis.py +143 -143
  164. tests/__init__.py +7 -7
  165. tests/advanced_tools_example.py +275 -275
  166. tests/authenticated_proxy_example.py +106 -106
  167. tests/baidu_performance_test.py +108 -108
  168. tests/baidu_test.py +59 -59
  169. tests/cleaners_example.py +160 -160
  170. tests/comprehensive_framework_test.py +212 -212
  171. tests/comprehensive_test.py +81 -81
  172. tests/comprehensive_testing_summary.md +186 -186
  173. tests/config_validation_demo.py +142 -142
  174. tests/controlled_spider_example.py +205 -205
  175. tests/date_tools_example.py +180 -180
  176. tests/debug_configure.py +69 -69
  177. tests/debug_framework_logger.py +84 -84
  178. tests/debug_log_config.py +126 -126
  179. tests/debug_log_levels.py +63 -63
  180. tests/debug_pipelines.py +66 -66
  181. tests/detailed_log_test.py +233 -233
  182. tests/distributed_test.py +66 -66
  183. tests/distributed_test_debug.py +76 -76
  184. tests/dynamic_loading_example.py +523 -523
  185. tests/dynamic_loading_test.py +104 -104
  186. tests/env_config_example.py +133 -133
  187. tests/error_handling_example.py +171 -171
  188. tests/final_comprehensive_test.py +151 -151
  189. tests/final_log_test.py +260 -260
  190. tests/final_validation_test.py +182 -182
  191. tests/fix_log_test.py +142 -142
  192. tests/framework_performance_test.py +202 -202
  193. tests/log_buffering_test.py +111 -111
  194. tests/log_generation_timing_test.py +153 -153
  195. tests/optimized_performance_test.py +211 -211
  196. tests/performance_comparison.py +245 -245
  197. tests/queue_blocking_test.py +113 -113
  198. tests/queue_test.py +89 -89
  199. tests/redis_key_validation_demo.py +130 -130
  200. tests/request_params_example.py +150 -150
  201. tests/response_improvements_example.py +144 -144
  202. tests/scrapy_comparison/ofweek_scrapy.py +138 -138
  203. tests/scrapy_comparison/scrapy_test.py +133 -133
  204. tests/simple_command_test.py +119 -119
  205. tests/simple_crawlo_test.py +127 -127
  206. tests/simple_log_test.py +57 -57
  207. tests/simple_log_test2.py +137 -137
  208. tests/simple_optimization_test.py +128 -128
  209. tests/simple_queue_type_test.py +41 -41
  210. tests/simple_spider_test.py +49 -49
  211. tests/simple_test.py +47 -47
  212. tests/spider_log_timing_test.py +177 -177
  213. tests/test_advanced_tools.py +148 -148
  214. tests/test_all_commands.py +230 -230
  215. tests/test_all_pipeline_fingerprints.py +133 -133
  216. tests/test_all_redis_key_configs.py +145 -145
  217. tests/test_authenticated_proxy.py +141 -141
  218. tests/test_batch_processor.py +178 -178
  219. tests/test_cleaners.py +54 -54
  220. tests/test_component_factory.py +174 -174
  221. tests/test_comprehensive.py +146 -146
  222. tests/test_config_consistency.py +80 -80
  223. tests/test_config_merge.py +152 -152
  224. tests/test_config_validator.py +182 -182
  225. tests/test_controlled_spider_mixin.py +79 -79
  226. tests/test_crawlo_proxy_integration.py +108 -108
  227. tests/test_date_tools.py +123 -123
  228. tests/test_dedup_fix.py +220 -220
  229. tests/test_dedup_pipeline_consistency.py +125 -0
  230. tests/test_default_header_middleware.py +313 -313
  231. tests/test_distributed.py +65 -65
  232. tests/test_double_crawlo_fix.py +204 -204
  233. tests/test_double_crawlo_fix_simple.py +124 -124
  234. tests/test_download_delay_middleware.py +221 -221
  235. tests/test_downloader_proxy_compatibility.py +268 -268
  236. tests/test_dynamic_downloaders_proxy.py +124 -124
  237. tests/test_dynamic_proxy.py +92 -92
  238. tests/test_dynamic_proxy_config.py +146 -146
  239. tests/test_dynamic_proxy_real.py +109 -109
  240. tests/test_edge_cases.py +303 -303
  241. tests/test_enhanced_error_handler.py +270 -270
  242. tests/test_enhanced_error_handler_comprehensive.py +245 -245
  243. tests/test_env_config.py +121 -121
  244. tests/test_error_handler_compatibility.py +112 -112
  245. tests/test_factories.py +252 -252
  246. tests/test_final_validation.py +153 -153
  247. tests/test_fingerprint_consistency.py +135 -135
  248. tests/test_fingerprint_simple.py +51 -51
  249. tests/test_framework_env_usage.py +103 -103
  250. tests/test_framework_logger.py +66 -66
  251. tests/test_framework_startup.py +64 -64
  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_config.py +112 -112
  257. tests/test_large_scale_helper.py +235 -235
  258. tests/test_logging_enhancements.py +375 -0
  259. tests/test_logging_final.py +185 -0
  260. tests/test_logging_integration.py +313 -0
  261. tests/test_logging_system.py +282 -282
  262. tests/test_middleware_debug.py +142 -0
  263. tests/test_mode_change.py +72 -72
  264. tests/test_mode_consistency.py +51 -51
  265. tests/test_offsite_middleware.py +244 -244
  266. tests/test_offsite_middleware_simple.py +203 -203
  267. tests/test_parsel.py +29 -29
  268. tests/test_performance.py +327 -327
  269. tests/test_performance_monitor.py +115 -115
  270. tests/test_pipeline_fingerprint_consistency.py +86 -86
  271. tests/test_priority_behavior.py +212 -0
  272. tests/test_priority_consistency.py +152 -0
  273. tests/test_priority_consistency_fixed.py +250 -0
  274. tests/test_proxy_api.py +264 -264
  275. tests/test_proxy_health_check.py +32 -32
  276. tests/test_proxy_middleware.py +121 -121
  277. tests/test_proxy_middleware_enhanced.py +216 -216
  278. tests/test_proxy_middleware_integration.py +136 -136
  279. tests/test_proxy_middleware_refactored.py +184 -184
  280. tests/test_proxy_providers.py +56 -56
  281. tests/test_proxy_stats.py +19 -19
  282. tests/test_proxy_strategies.py +59 -59
  283. tests/test_queue_empty_check.py +41 -41
  284. tests/test_queue_manager_double_crawlo.py +173 -173
  285. tests/test_queue_manager_redis_key.py +179 -179
  286. tests/test_queue_naming.py +154 -154
  287. tests/test_queue_type.py +106 -106
  288. tests/test_queue_type_redis_config_consistency.py +131 -0
  289. tests/test_random_headers_default.py +323 -0
  290. tests/test_random_headers_necessity.py +309 -0
  291. tests/test_random_user_agent.py +72 -72
  292. tests/test_real_scenario_proxy.py +195 -195
  293. tests/test_redis_config.py +28 -28
  294. tests/test_redis_connection_pool.py +294 -294
  295. tests/test_redis_key_naming.py +181 -181
  296. tests/test_redis_key_validator.py +123 -123
  297. tests/test_redis_queue.py +224 -224
  298. tests/test_redis_queue_name_fix.py +175 -175
  299. tests/test_redis_queue_type_fallback.py +130 -0
  300. tests/test_request_ignore_middleware.py +182 -182
  301. tests/test_request_params.py +111 -111
  302. tests/test_request_serialization.py +70 -70
  303. tests/test_response_code_middleware.py +349 -349
  304. tests/test_response_filter_middleware.py +427 -427
  305. tests/test_response_improvements.py +152 -152
  306. tests/test_retry_middleware.py +334 -242
  307. tests/test_retry_middleware_realistic.py +274 -0
  308. tests/test_scheduler.py +252 -252
  309. tests/test_scheduler_config_update.py +133 -133
  310. tests/test_simple_response.py +61 -61
  311. tests/test_telecom_spider_redis_key.py +205 -205
  312. tests/test_template_content.py +87 -87
  313. tests/test_template_redis_key.py +134 -134
  314. tests/test_tools.py +159 -159
  315. tests/test_user_agent_randomness.py +177 -0
  316. tests/test_user_agents.py +96 -96
  317. tests/tools_example.py +260 -260
  318. tests/untested_features_report.md +138 -138
  319. tests/verify_debug.py +51 -51
  320. tests/verify_distributed.py +117 -117
  321. tests/verify_log_fix.py +111 -111
  322. crawlo-1.4.1.dist-info/METADATA +0 -1199
  323. crawlo-1.4.1.dist-info/RECORD +0 -309
  324. {crawlo-1.4.1.dist-info → crawlo-1.4.3.dist-info}/WHEEL +0 -0
  325. {crawlo-1.4.1.dist-info → crawlo-1.4.3.dist-info}/entry_points.txt +0 -0
  326. {crawlo-1.4.1.dist-info → crawlo-1.4.3.dist-info}/top_level.txt +0 -0
@@ -1,181 +1,181 @@
1
- #!/usr/bin/python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- Crawlo框架日期工具使用示例
5
- """
6
- from crawlo.tools import (
7
- TimeUtils,
8
- parse_time,
9
- format_time,
10
- time_diff,
11
- to_timestamp,
12
- to_datetime,
13
- now,
14
- to_timezone,
15
- to_utc,
16
- to_local
17
- )
18
-
19
-
20
- def demo_date_parsing():
21
- """演示日期解析功能"""
22
- print("=== 日期解析演示 ===\n")
23
-
24
- # 解析各种格式的日期字符串
25
- date_strings = [
26
- "2025-09-10 14:30:00",
27
- "September 10, 2025 2:30 PM",
28
- "2025/09/10 14:30:00",
29
- "10-09-2025 14:30:00",
30
- "2025年9月10日 14时30分00秒"
31
- ]
32
-
33
- for date_str in date_strings:
34
- parsed = parse_time(date_str)
35
- print(f"解析 '{date_str}' -> {parsed}")
36
-
37
- print()
38
-
39
-
40
- def demo_date_formatting():
41
- """演示日期格式化功能"""
42
- print("=== 日期格式化演示 ===\n")
43
-
44
- # 获取当前时间
45
- current_time = now()
46
- print(f"当前时间: {current_time}")
47
-
48
- # 使用不同格式进行格式化
49
- formats = [
50
- "%Y-%m-%d",
51
- "%Y年%m月%d日",
52
- "%Y-%m-%d %H:%M:%S",
53
- "%B %d, %Y at %I:%M %p",
54
- "%A, %B %d, %Y"
55
- ]
56
-
57
- for fmt in formats:
58
- formatted = format_time(current_time, fmt)
59
- print(f"格式化为 '{fmt}' -> {formatted}")
60
-
61
- print()
62
-
63
-
64
- def demo_time_calculations():
65
- """演示时间计算功能"""
66
- print("=== 时间计算演示 ===\n")
67
-
68
- # 计算时间差
69
- start_time = "2025-09-10 10:00:00"
70
- end_time = "2025-09-10 14:30:45"
71
-
72
- diff_seconds = time_diff(start_time, end_time, "seconds")
73
- diff_minutes = time_diff(start_time, end_time, "minutes")
74
- diff_hours = time_diff(start_time, end_time, "hours")
75
-
76
- print(f"起始时间: {start_time}")
77
- print(f"结束时间: {end_time}")
78
- print(f"时间差 - 秒: {diff_seconds}")
79
- print(f"时间差 - 分钟: {diff_minutes}")
80
- print(f"时间差 - 小时: {diff_hours}")
81
-
82
- print()
83
-
84
- # 日期加减
85
- base_date = "2025-09-10"
86
- plus_30_days = TimeUtils.add_days(base_date, 30)
87
- minus_15_days = TimeUtils.add_days(base_date, -15)
88
- plus_3_months = TimeUtils.add_months(base_date, 3)
89
-
90
- print(f"基础日期: {base_date}")
91
- print(f"加30天: {plus_30_days}")
92
- print(f"减15天: {minus_15_days}")
93
- print(f"加3个月: {plus_3_months}")
94
-
95
- print()
96
-
97
-
98
- def demo_timezone_conversion():
99
- """演示时区转换功能"""
100
- print("=== 时区转换演示 ===\n")
101
-
102
- # 创建一个时间
103
- dt = parse_time("2025-09-10 14:30:00")
104
- print(f"原始时间: {dt}")
105
-
106
- # 转换为UTC时区
107
- utc_time = to_utc(dt)
108
- print(f"UTC时间: {utc_time}")
109
-
110
- # 转换为本地时区
111
- local_time = to_local(dt)
112
- print(f"本地时间: {local_time}")
113
-
114
- # 转换为纽约时区
115
- ny_time = to_timezone(dt, "America/New_York")
116
- print(f"纽约时间: {ny_time}")
117
-
118
- # 转换为伦敦时区
119
- london_time = to_timezone(dt, "Europe/London")
120
- print(f"伦敦时间: {london_time}")
121
-
122
- print()
123
-
124
-
125
- def demo_timestamp_conversion():
126
- """演示时间戳转换功能"""
127
- print("=== 时间戳转换演示 ===\n")
128
-
129
- # 获取当前时间戳
130
- current_timestamp = to_timestamp(now())
131
- print(f"当前时间戳: {current_timestamp}")
132
-
133
- # 从时间戳转换为datetime
134
- dt_from_timestamp = to_datetime(current_timestamp)
135
- print(f"从时间戳转换: {dt_from_timestamp}")
136
-
137
- # 从时间戳创建带时区的datetime
138
- dt_with_tz = to_timezone(to_datetime(current_timestamp), "Asia/Shanghai")
139
- print(f"带时区的时间: {dt_with_tz}")
140
-
141
- print()
142
-
143
-
144
- def demo_in_spider():
145
- """演示在爬虫中使用日期工具"""
146
- print("=== 在爬虫中使用日期工具 ===\n")
147
- print("在爬虫项目中,您可以这样使用日期工具:")
148
- print("""
149
- from crawlo import Spider
150
- from crawlo.tools import parse_time, format_time
151
-
152
- class NewsSpider(Spider):
153
- def parse(self, response):
154
- # 提取文章发布时间
155
- publish_time_str = response.css('.publish-time::text').get()
156
-
157
- # 解析发布时间
158
- publish_time = parse_time(publish_time_str)
159
-
160
- # 格式化时间为标准格式
161
- formatted_time = format_time(publish_time, "%Y-%m-%d %H:%M:%S")
162
-
163
- # 计算文章发布多久了
164
- current_time = self.tools.now()
165
- hours_since_publish = self.tools.time_diff(publish_time, current_time, "hours")
166
-
167
- # 根据发布时间决定是否继续处理
168
- if hours_since_publish < 24: # 只处理24小时内的文章
169
- # 处理文章...
170
- pass
171
- """)
172
-
173
-
174
- if __name__ == '__main__':
175
- # 运行演示
176
- demo_date_parsing()
177
- demo_date_formatting()
178
- demo_time_calculations()
179
- demo_timezone_conversion()
180
- demo_timestamp_conversion()
1
+ #!/usr/bin/python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ Crawlo框架日期工具使用示例
5
+ """
6
+ from crawlo.tools import (
7
+ TimeUtils,
8
+ parse_time,
9
+ format_time,
10
+ time_diff,
11
+ to_timestamp,
12
+ to_datetime,
13
+ now,
14
+ to_timezone,
15
+ to_utc,
16
+ to_local
17
+ )
18
+
19
+
20
+ def demo_date_parsing():
21
+ """演示日期解析功能"""
22
+ print("=== 日期解析演示 ===\n")
23
+
24
+ # 解析各种格式的日期字符串
25
+ date_strings = [
26
+ "2025-09-10 14:30:00",
27
+ "September 10, 2025 2:30 PM",
28
+ "2025/09/10 14:30:00",
29
+ "10-09-2025 14:30:00",
30
+ "2025年9月10日 14时30分00秒"
31
+ ]
32
+
33
+ for date_str in date_strings:
34
+ parsed = parse_time(date_str)
35
+ print(f"解析 '{date_str}' -> {parsed}")
36
+
37
+ print()
38
+
39
+
40
+ def demo_date_formatting():
41
+ """演示日期格式化功能"""
42
+ print("=== 日期格式化演示 ===\n")
43
+
44
+ # 获取当前时间
45
+ current_time = now()
46
+ print(f"当前时间: {current_time}")
47
+
48
+ # 使用不同格式进行格式化
49
+ formats = [
50
+ "%Y-%m-%d",
51
+ "%Y年%m月%d日",
52
+ "%Y-%m-%d %H:%M:%S",
53
+ "%B %d, %Y at %I:%M %p",
54
+ "%A, %B %d, %Y"
55
+ ]
56
+
57
+ for fmt in formats:
58
+ formatted = format_time(current_time, fmt)
59
+ print(f"格式化为 '{fmt}' -> {formatted}")
60
+
61
+ print()
62
+
63
+
64
+ def demo_time_calculations():
65
+ """演示时间计算功能"""
66
+ print("=== 时间计算演示 ===\n")
67
+
68
+ # 计算时间差
69
+ start_time = "2025-09-10 10:00:00"
70
+ end_time = "2025-09-10 14:30:45"
71
+
72
+ diff_seconds = time_diff(start_time, end_time, "seconds")
73
+ diff_minutes = time_diff(start_time, end_time, "minutes")
74
+ diff_hours = time_diff(start_time, end_time, "hours")
75
+
76
+ print(f"起始时间: {start_time}")
77
+ print(f"结束时间: {end_time}")
78
+ print(f"时间差 - 秒: {diff_seconds}")
79
+ print(f"时间差 - 分钟: {diff_minutes}")
80
+ print(f"时间差 - 小时: {diff_hours}")
81
+
82
+ print()
83
+
84
+ # 日期加减
85
+ base_date = "2025-09-10"
86
+ plus_30_days = TimeUtils.add_days(base_date, 30)
87
+ minus_15_days = TimeUtils.add_days(base_date, -15)
88
+ plus_3_months = TimeUtils.add_months(base_date, 3)
89
+
90
+ print(f"基础日期: {base_date}")
91
+ print(f"加30天: {plus_30_days}")
92
+ print(f"减15天: {minus_15_days}")
93
+ print(f"加3个月: {plus_3_months}")
94
+
95
+ print()
96
+
97
+
98
+ def demo_timezone_conversion():
99
+ """演示时区转换功能"""
100
+ print("=== 时区转换演示 ===\n")
101
+
102
+ # 创建一个时间
103
+ dt = parse_time("2025-09-10 14:30:00")
104
+ print(f"原始时间: {dt}")
105
+
106
+ # 转换为UTC时区
107
+ utc_time = to_utc(dt)
108
+ print(f"UTC时间: {utc_time}")
109
+
110
+ # 转换为本地时区
111
+ local_time = to_local(dt)
112
+ print(f"本地时间: {local_time}")
113
+
114
+ # 转换为纽约时区
115
+ ny_time = to_timezone(dt, "America/New_York")
116
+ print(f"纽约时间: {ny_time}")
117
+
118
+ # 转换为伦敦时区
119
+ london_time = to_timezone(dt, "Europe/London")
120
+ print(f"伦敦时间: {london_time}")
121
+
122
+ print()
123
+
124
+
125
+ def demo_timestamp_conversion():
126
+ """演示时间戳转换功能"""
127
+ print("=== 时间戳转换演示 ===\n")
128
+
129
+ # 获取当前时间戳
130
+ current_timestamp = to_timestamp(now())
131
+ print(f"当前时间戳: {current_timestamp}")
132
+
133
+ # 从时间戳转换为datetime
134
+ dt_from_timestamp = to_datetime(current_timestamp)
135
+ print(f"从时间戳转换: {dt_from_timestamp}")
136
+
137
+ # 从时间戳创建带时区的datetime
138
+ dt_with_tz = to_timezone(to_datetime(current_timestamp), "Asia/Shanghai")
139
+ print(f"带时区的时间: {dt_with_tz}")
140
+
141
+ print()
142
+
143
+
144
+ def demo_in_spider():
145
+ """演示在爬虫中使用日期工具"""
146
+ print("=== 在爬虫中使用日期工具 ===\n")
147
+ print("在爬虫项目中,您可以这样使用日期工具:")
148
+ print("""
149
+ from crawlo import Spider
150
+ from crawlo.tools import parse_time, format_time
151
+
152
+ class NewsSpider(Spider):
153
+ def parse(self, response):
154
+ # 提取文章发布时间
155
+ publish_time_str = response.css('.publish-time::text').get()
156
+
157
+ # 解析发布时间
158
+ publish_time = parse_time(publish_time_str)
159
+
160
+ # 格式化时间为标准格式
161
+ formatted_time = format_time(publish_time, "%Y-%m-%d %H:%M:%S")
162
+
163
+ # 计算文章发布多久了
164
+ current_time = self.tools.now()
165
+ hours_since_publish = self.tools.time_diff(publish_time, current_time, "hours")
166
+
167
+ # 根据发布时间决定是否继续处理
168
+ if hours_since_publish < 24: # 只处理24小时内的文章
169
+ # 处理文章...
170
+ pass
171
+ """)
172
+
173
+
174
+ if __name__ == '__main__':
175
+ # 运行演示
176
+ demo_date_parsing()
177
+ demo_date_formatting()
178
+ demo_time_calculations()
179
+ demo_timezone_conversion()
180
+ demo_timestamp_conversion()
181
181
  demo_in_spider()
tests/debug_configure.py CHANGED
@@ -1,70 +1,70 @@
1
- #!/usr/bin/env python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- 逐步调试LoggerManager.configure
5
- """
6
- import sys
7
- import os
8
- sys.path.insert(0, '/')
9
-
10
- from crawlo.utils.log import LoggerManager
11
-
12
- print("=== 逐步调试LoggerManager.configure ===")
13
-
14
- print("1. 检查初始状态")
15
- print(f" _early_initialized: {LoggerManager._early_initialized}")
16
- print(f" _configured: {LoggerManager._configured}")
17
-
18
- print("2. 调用early_initialize")
19
- LoggerManager.early_initialize()
20
- print(f" _early_initialized: {LoggerManager._early_initialized}")
21
-
22
- print("3. 进入configure - 开始")
23
- # 模拟configure方法的各个步骤
24
- with LoggerManager._config_lock:
25
- print(" 获得锁")
26
-
27
- if LoggerManager._configured:
28
- print(" 已配置,直接返回")
29
- else:
30
- print(" 开始配置...")
31
-
32
- # 更新状态
33
- print(" 设置_log_state")
34
- from crawlo.utils.log import _log_state
35
- _log_state['current_step'] = 'basic_setup'
36
-
37
- print(" 处理参数")
38
- kwargs = {'LOG_LEVEL': 'INFO', 'LOG_FILE': 'test.log'}
39
- get_val = lambda k, d=None: kwargs.get(k, d)
40
-
41
- filename = get_val('LOG_FILE')
42
- level = get_val('LOG_LEVEL', None)
43
- if level is None:
44
- level = 'INFO'
45
-
46
- print(f" filename: {filename}")
47
- print(f" level: {level}")
48
-
49
- print(" 设置默认值")
50
- LoggerManager._default_filename = filename
51
- LoggerManager._default_level = LoggerManager._to_level(level)
52
- LoggerManager._default_file_level = LoggerManager._to_level(level)
53
- LoggerManager._default_console_level = LoggerManager._default_level
54
-
55
- print(" 清空缓存")
56
- LoggerManager.logger_cache.clear()
57
-
58
- print(" 设置已配置状态")
59
- LoggerManager._configured = True
60
- _log_state['current_step'] = 'full_config'
61
-
62
- print(" 配置完成")
63
-
64
- print("4. 测试创建logger")
65
- from crawlo.utils.log import get_logger
66
- logger = get_logger('test')
67
- print(f" Logger: {logger}")
68
- print(f" Handlers: {len(logger.handlers)}")
69
-
1
+ #!/usr/bin/env python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ 逐步调试LoggerManager.configure
5
+ """
6
+ import sys
7
+ import os
8
+ sys.path.insert(0, '/')
9
+
10
+ from crawlo.utils.log import LoggerManager
11
+
12
+ print("=== 逐步调试LoggerManager.configure ===")
13
+
14
+ print("1. 检查初始状态")
15
+ print(f" _early_initialized: {LoggerManager._early_initialized}")
16
+ print(f" _configured: {LoggerManager._configured}")
17
+
18
+ print("2. 调用early_initialize")
19
+ LoggerManager.early_initialize()
20
+ print(f" _early_initialized: {LoggerManager._early_initialized}")
21
+
22
+ print("3. 进入configure - 开始")
23
+ # 模拟configure方法的各个步骤
24
+ with LoggerManager._config_lock:
25
+ print(" 获得锁")
26
+
27
+ if LoggerManager._configured:
28
+ print(" 已配置,直接返回")
29
+ else:
30
+ print(" 开始配置...")
31
+
32
+ # 更新状态
33
+ print(" 设置_log_state")
34
+ from crawlo.utils.log import _log_state
35
+ _log_state['current_step'] = 'basic_setup'
36
+
37
+ print(" 处理参数")
38
+ kwargs = {'LOG_LEVEL': 'INFO', 'LOG_FILE': 'test.log'}
39
+ get_val = lambda k, d=None: kwargs.get(k, d)
40
+
41
+ filename = get_val('LOG_FILE')
42
+ level = get_val('LOG_LEVEL', None)
43
+ if level is None:
44
+ level = 'INFO'
45
+
46
+ print(f" filename: {filename}")
47
+ print(f" level: {level}")
48
+
49
+ print(" 设置默认值")
50
+ LoggerManager._default_filename = filename
51
+ LoggerManager._default_level = LoggerManager._to_level(level)
52
+ LoggerManager._default_file_level = LoggerManager._to_level(level)
53
+ LoggerManager._default_console_level = LoggerManager._default_level
54
+
55
+ print(" 清空缓存")
56
+ LoggerManager.logger_cache.clear()
57
+
58
+ print(" 设置已配置状态")
59
+ LoggerManager._configured = True
60
+ _log_state['current_step'] = 'full_config'
61
+
62
+ print(" 配置完成")
63
+
64
+ print("4. 测试创建logger")
65
+ from crawlo.utils.log import get_logger
66
+ logger = get_logger('test')
67
+ print(f" Logger: {logger}")
68
+ print(f" Handlers: {len(logger.handlers)}")
69
+
70
70
  print("=== 调试完成 ===")
@@ -1,85 +1,85 @@
1
- #!/usr/bin/env python
2
- # -*- coding: UTF-8 -*-
3
- """
4
- 调试框架logger配置
5
- """
6
- import sys
7
- import os
8
- sys.path.insert(0, '/')
9
-
10
- from crawlo.initialization import initialize_framework, get_framework_initializer
11
- from crawlo.utils.log import get_logger, LoggerManager
12
- import logging
13
-
14
- def debug_framework_logger():
15
- print("=== 调试框架logger配置 ===")
16
-
17
- # 1. 初始化框架,模拟ofweek_standalone的配置
18
- print("1. 初始化框架...")
19
- custom_settings = {
20
- 'LOG_LEVEL': 'INFO',
21
- 'LOG_FILE': 'logs/debug_framework.log',
22
- 'PROJECT_NAME': 'debug_test',
23
- 'RUN_MODE': 'standalone'
24
- }
25
-
26
- # 确保日志目录存在
27
- os.makedirs('../logs', exist_ok=True)
28
-
29
- settings = initialize_framework(custom_settings)
30
- print(f" LOG_LEVEL: {settings.get('LOG_LEVEL')}")
31
- print(f" LOG_FILE: {settings.get('LOG_FILE')}")
32
-
33
- # 2. 获取框架初始化管理器
34
- init_manager = get_framework_initializer()
35
- print(f" 框架是否就绪: {init_manager.is_ready}")
36
- print(f" 初始化阶段: {init_manager.phase}")
37
-
38
- # 3. 测试框架logger
39
- framework_logger = init_manager.logger
40
- print(f" 框架logger: {framework_logger}")
41
- if framework_logger:
42
- print(f" 名称: {framework_logger.name}")
43
- print(f" 级别: {framework_logger.level} ({logging.getLevelName(framework_logger.level)})")
44
- print(f" 处理器数量: {len(framework_logger.handlers)}")
45
-
46
- for i, handler in enumerate(framework_logger.handlers):
47
- handler_type = type(handler).__name__
48
- handler_level = handler.level
49
- print(f" 处理器{i}: {handler_type}, 级别: {handler_level} ({logging.getLevelName(handler_level)})")
50
- if hasattr(handler, 'baseFilename'):
51
- print(f" 文件: {handler.baseFilename}")
52
-
53
- # 4. 手动创建一个crawlo.framework logger对比
54
- manual_logger = get_logger('crawlo.framework')
55
- print(f" 手动创建的logger: {manual_logger}")
56
- if manual_logger:
57
- print(f" 名称: {manual_logger.name}")
58
- print(f" 级别: {manual_logger.level} ({logging.getLevelName(manual_logger.level)})")
59
- print(f" 处理器数量: {len(manual_logger.handlers)}")
60
-
61
- for i, handler in enumerate(manual_logger.handlers):
62
- handler_type = type(handler).__name__
63
- handler_level = handler.level
64
- print(f" 处理器{i}: {handler_type}, 级别: {handler_level} ({logging.getLevelName(handler_level)})")
65
- if hasattr(handler, 'baseFilename'):
66
- print(f" 文件: {handler.baseFilename}")
67
-
68
- # 5. 测试日志输出
69
- print("2. 测试日志输出...")
70
-
71
- if framework_logger:
72
- framework_logger.info("这是框架logger测试消息 - INFO级别")
73
- framework_logger.debug("这是框架logger测试消息 - DEBUG级别")
74
-
75
- if manual_logger:
76
- manual_logger.info("这是手动logger测试消息 - INFO级别")
77
- manual_logger.debug("这是手动logger测试消息 - DEBUG级别")
78
-
79
- # 6. 检查是否同一个实例
80
- print(f"3. 是否同一实例: {framework_logger is manual_logger}")
81
-
82
- print("=== 调试完成 ===")
83
-
84
- if __name__ == "__main__":
1
+ #!/usr/bin/env python
2
+ # -*- coding: UTF-8 -*-
3
+ """
4
+ 调试框架logger配置
5
+ """
6
+ import sys
7
+ import os
8
+ sys.path.insert(0, '/')
9
+
10
+ from crawlo.initialization import initialize_framework, get_framework_initializer
11
+ from crawlo.utils.log import get_logger, LoggerManager
12
+ import logging
13
+
14
+ def debug_framework_logger():
15
+ print("=== 调试框架logger配置 ===")
16
+
17
+ # 1. 初始化框架,模拟ofweek_standalone的配置
18
+ print("1. 初始化框架...")
19
+ custom_settings = {
20
+ 'LOG_LEVEL': 'INFO',
21
+ 'LOG_FILE': 'logs/debug_framework.log',
22
+ 'PROJECT_NAME': 'debug_test',
23
+ 'RUN_MODE': 'standalone'
24
+ }
25
+
26
+ # 确保日志目录存在
27
+ os.makedirs('../logs', exist_ok=True)
28
+
29
+ settings = initialize_framework(custom_settings)
30
+ print(f" LOG_LEVEL: {settings.get('LOG_LEVEL')}")
31
+ print(f" LOG_FILE: {settings.get('LOG_FILE')}")
32
+
33
+ # 2. 获取框架初始化管理器
34
+ init_manager = get_framework_initializer()
35
+ print(f" 框架是否就绪: {init_manager.is_ready}")
36
+ print(f" 初始化阶段: {init_manager.phase}")
37
+
38
+ # 3. 测试框架logger
39
+ framework_logger = init_manager.logger
40
+ print(f" 框架logger: {framework_logger}")
41
+ if framework_logger:
42
+ print(f" 名称: {framework_logger.name}")
43
+ print(f" 级别: {framework_logger.level} ({logging.getLevelName(framework_logger.level)})")
44
+ print(f" 处理器数量: {len(framework_logger.handlers)}")
45
+
46
+ for i, handler in enumerate(framework_logger.handlers):
47
+ handler_type = type(handler).__name__
48
+ handler_level = handler.level
49
+ print(f" 处理器{i}: {handler_type}, 级别: {handler_level} ({logging.getLevelName(handler_level)})")
50
+ if hasattr(handler, 'baseFilename'):
51
+ print(f" 文件: {handler.baseFilename}")
52
+
53
+ # 4. 手动创建一个crawlo.framework logger对比
54
+ manual_logger = get_logger('crawlo.framework')
55
+ print(f" 手动创建的logger: {manual_logger}")
56
+ if manual_logger:
57
+ print(f" 名称: {manual_logger.name}")
58
+ print(f" 级别: {manual_logger.level} ({logging.getLevelName(manual_logger.level)})")
59
+ print(f" 处理器数量: {len(manual_logger.handlers)}")
60
+
61
+ for i, handler in enumerate(manual_logger.handlers):
62
+ handler_type = type(handler).__name__
63
+ handler_level = handler.level
64
+ print(f" 处理器{i}: {handler_type}, 级别: {handler_level} ({logging.getLevelName(handler_level)})")
65
+ if hasattr(handler, 'baseFilename'):
66
+ print(f" 文件: {handler.baseFilename}")
67
+
68
+ # 5. 测试日志输出
69
+ print("2. 测试日志输出...")
70
+
71
+ if framework_logger:
72
+ framework_logger.info("这是框架logger测试消息 - INFO级别")
73
+ framework_logger.debug("这是框架logger测试消息 - DEBUG级别")
74
+
75
+ if manual_logger:
76
+ manual_logger.info("这是手动logger测试消息 - INFO级别")
77
+ manual_logger.debug("这是手动logger测试消息 - DEBUG级别")
78
+
79
+ # 6. 检查是否同一个实例
80
+ print(f"3. 是否同一实例: {framework_logger is manual_logger}")
81
+
82
+ print("=== 调试完成 ===")
83
+
84
+ if __name__ == "__main__":
85
85
  debug_framework_logger()