kreuzberg 4.0.0.rc2 → 4.0.1

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.
Files changed (446) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +14 -14
  3. data/.rspec +3 -3
  4. data/.rubocop.yaml +1 -1
  5. data/.rubocop.yml +543 -538
  6. data/Gemfile +8 -8
  7. data/Gemfile.lock +194 -6
  8. data/README.md +391 -426
  9. data/Rakefile +34 -25
  10. data/Steepfile +51 -47
  11. data/examples/async_patterns.rb +283 -341
  12. data/ext/kreuzberg_rb/extconf.rb +65 -45
  13. data/ext/kreuzberg_rb/native/.cargo/config.toml +23 -0
  14. data/ext/kreuzberg_rb/native/Cargo.lock +7619 -6535
  15. data/ext/kreuzberg_rb/native/Cargo.toml +75 -44
  16. data/ext/kreuzberg_rb/native/README.md +425 -425
  17. data/ext/kreuzberg_rb/native/build.rs +15 -15
  18. data/ext/kreuzberg_rb/native/include/ieeefp.h +11 -11
  19. data/ext/kreuzberg_rb/native/include/msvc_compat/strings.h +14 -14
  20. data/ext/kreuzberg_rb/native/include/strings.h +20 -20
  21. data/ext/kreuzberg_rb/native/include/unistd.h +47 -47
  22. data/ext/kreuzberg_rb/native/src/lib.rs +3802 -2998
  23. data/extconf.rb +60 -28
  24. data/kreuzberg.gemspec +199 -148
  25. data/lib/kreuzberg/api_proxy.rb +126 -142
  26. data/lib/kreuzberg/cache_api.rb +67 -46
  27. data/lib/kreuzberg/cli.rb +47 -55
  28. data/lib/kreuzberg/cli_proxy.rb +117 -127
  29. data/lib/kreuzberg/config.rb +936 -691
  30. data/lib/kreuzberg/error_context.rb +136 -32
  31. data/lib/kreuzberg/errors.rb +116 -118
  32. data/lib/kreuzberg/extraction_api.rb +313 -85
  33. data/lib/kreuzberg/mcp_proxy.rb +177 -186
  34. data/lib/kreuzberg/ocr_backend_protocol.rb +40 -113
  35. data/lib/kreuzberg/post_processor_protocol.rb +15 -86
  36. data/lib/kreuzberg/result.rb +334 -216
  37. data/lib/kreuzberg/setup_lib_path.rb +99 -80
  38. data/lib/kreuzberg/types.rb +170 -0
  39. data/lib/kreuzberg/validator_protocol.rb +16 -89
  40. data/lib/kreuzberg/version.rb +5 -5
  41. data/lib/kreuzberg.rb +96 -103
  42. data/lib/libpdfium.so +0 -0
  43. data/sig/kreuzberg/internal.rbs +184 -184
  44. data/sig/kreuzberg.rbs +561 -520
  45. data/spec/binding/async_operations_spec.rb +473 -0
  46. data/spec/binding/batch_operations_spec.rb +595 -0
  47. data/spec/binding/batch_spec.rb +359 -0
  48. data/spec/binding/cache_spec.rb +227 -227
  49. data/spec/binding/cli_proxy_spec.rb +85 -85
  50. data/spec/binding/cli_spec.rb +55 -55
  51. data/spec/binding/config_result_spec.rb +377 -0
  52. data/spec/binding/config_spec.rb +419 -345
  53. data/spec/binding/config_validation_spec.rb +377 -283
  54. data/spec/binding/embeddings_spec.rb +816 -0
  55. data/spec/binding/error_handling_spec.rb +399 -213
  56. data/spec/binding/error_recovery_spec.rb +488 -0
  57. data/spec/binding/errors_spec.rb +66 -66
  58. data/spec/binding/font_config_spec.rb +220 -0
  59. data/spec/binding/images_spec.rb +738 -0
  60. data/spec/binding/keywords_extraction_spec.rb +600 -0
  61. data/spec/binding/metadata_types_spec.rb +1228 -0
  62. data/spec/binding/pages_extraction_spec.rb +471 -0
  63. data/spec/binding/plugins/ocr_backend_spec.rb +307 -307
  64. data/spec/binding/plugins/postprocessor_spec.rb +269 -269
  65. data/spec/binding/plugins/validator_spec.rb +273 -274
  66. data/spec/binding/tables_spec.rb +641 -0
  67. data/spec/fixtures/config.toml +38 -39
  68. data/spec/fixtures/config.yaml +41 -41
  69. data/spec/fixtures/invalid_config.toml +3 -4
  70. data/spec/smoke/package_spec.rb +177 -178
  71. data/spec/spec_helper.rb +40 -42
  72. data/spec/unit/config/chunking_config_spec.rb +213 -0
  73. data/spec/unit/config/embedding_config_spec.rb +343 -0
  74. data/spec/unit/config/extraction_config_spec.rb +438 -0
  75. data/spec/unit/config/font_config_spec.rb +285 -0
  76. data/spec/unit/config/hierarchy_config_spec.rb +314 -0
  77. data/spec/unit/config/image_extraction_config_spec.rb +209 -0
  78. data/spec/unit/config/image_preprocessing_config_spec.rb +249 -0
  79. data/spec/unit/config/keyword_config_spec.rb +229 -0
  80. data/spec/unit/config/language_detection_config_spec.rb +258 -0
  81. data/spec/unit/config/ocr_config_spec.rb +171 -0
  82. data/spec/unit/config/page_config_spec.rb +221 -0
  83. data/spec/unit/config/pdf_config_spec.rb +267 -0
  84. data/spec/unit/config/postprocessor_config_spec.rb +290 -0
  85. data/spec/unit/config/tesseract_config_spec.rb +181 -0
  86. data/spec/unit/config/token_reduction_config_spec.rb +251 -0
  87. data/test/metadata_types_test.rb +959 -0
  88. data/vendor/Cargo.toml +61 -0
  89. data/vendor/kreuzberg/Cargo.toml +259 -204
  90. data/vendor/kreuzberg/README.md +263 -175
  91. data/vendor/kreuzberg/build.rs +782 -474
  92. data/vendor/kreuzberg/examples/bench_fixes.rs +71 -0
  93. data/vendor/kreuzberg/examples/test_pdfium_fork.rs +62 -0
  94. data/vendor/kreuzberg/src/api/error.rs +81 -81
  95. data/vendor/kreuzberg/src/api/handlers.rs +320 -199
  96. data/vendor/kreuzberg/src/api/mod.rs +94 -79
  97. data/vendor/kreuzberg/src/api/server.rs +518 -353
  98. data/vendor/kreuzberg/src/api/types.rs +206 -170
  99. data/vendor/kreuzberg/src/cache/mod.rs +1167 -1167
  100. data/vendor/kreuzberg/src/chunking/mod.rs +2303 -677
  101. data/vendor/kreuzberg/src/chunking/processor.rs +219 -0
  102. data/vendor/kreuzberg/src/core/batch_mode.rs +95 -95
  103. data/vendor/kreuzberg/src/core/batch_optimizations.rs +385 -0
  104. data/vendor/kreuzberg/src/core/config.rs +1914 -1032
  105. data/vendor/kreuzberg/src/core/config_validation.rs +949 -0
  106. data/vendor/kreuzberg/src/core/extractor.rs +1200 -1024
  107. data/vendor/kreuzberg/src/core/formats.rs +235 -0
  108. data/vendor/kreuzberg/src/core/io.rs +329 -329
  109. data/vendor/kreuzberg/src/core/mime.rs +605 -605
  110. data/vendor/kreuzberg/src/core/mod.rs +61 -45
  111. data/vendor/kreuzberg/src/core/pipeline.rs +1223 -984
  112. data/vendor/kreuzberg/src/core/server_config.rs +1220 -0
  113. data/vendor/kreuzberg/src/embeddings.rs +471 -432
  114. data/vendor/kreuzberg/src/error.rs +431 -431
  115. data/vendor/kreuzberg/src/extraction/archive.rs +959 -954
  116. data/vendor/kreuzberg/src/extraction/capacity.rs +263 -0
  117. data/vendor/kreuzberg/src/extraction/docx.rs +404 -40
  118. data/vendor/kreuzberg/src/extraction/email.rs +855 -854
  119. data/vendor/kreuzberg/src/extraction/excel.rs +697 -688
  120. data/vendor/kreuzberg/src/extraction/html.rs +1830 -553
  121. data/vendor/kreuzberg/src/extraction/image.rs +492 -368
  122. data/vendor/kreuzberg/src/extraction/libreoffice.rs +574 -563
  123. data/vendor/kreuzberg/src/extraction/markdown.rs +216 -213
  124. data/vendor/kreuzberg/src/extraction/mod.rs +93 -81
  125. data/vendor/kreuzberg/src/extraction/office_metadata/app_properties.rs +398 -398
  126. data/vendor/kreuzberg/src/extraction/office_metadata/core_properties.rs +247 -247
  127. data/vendor/kreuzberg/src/extraction/office_metadata/custom_properties.rs +240 -240
  128. data/vendor/kreuzberg/src/extraction/office_metadata/mod.rs +130 -130
  129. data/vendor/kreuzberg/src/extraction/office_metadata/odt_properties.rs +284 -287
  130. data/vendor/kreuzberg/src/extraction/pptx.rs +3102 -3000
  131. data/vendor/kreuzberg/src/extraction/structured.rs +491 -490
  132. data/vendor/kreuzberg/src/extraction/table.rs +329 -328
  133. data/vendor/kreuzberg/src/extraction/text.rs +277 -269
  134. data/vendor/kreuzberg/src/extraction/xml.rs +333 -333
  135. data/vendor/kreuzberg/src/extractors/archive.rs +447 -446
  136. data/vendor/kreuzberg/src/extractors/bibtex.rs +470 -469
  137. data/vendor/kreuzberg/src/extractors/docbook.rs +504 -502
  138. data/vendor/kreuzberg/src/extractors/docx.rs +400 -367
  139. data/vendor/kreuzberg/src/extractors/email.rs +157 -143
  140. data/vendor/kreuzberg/src/extractors/epub.rs +696 -707
  141. data/vendor/kreuzberg/src/extractors/excel.rs +385 -343
  142. data/vendor/kreuzberg/src/extractors/fictionbook.rs +492 -491
  143. data/vendor/kreuzberg/src/extractors/html.rs +419 -393
  144. data/vendor/kreuzberg/src/extractors/image.rs +219 -198
  145. data/vendor/kreuzberg/src/extractors/jats.rs +1054 -1051
  146. data/vendor/kreuzberg/src/extractors/jupyter.rs +368 -367
  147. data/vendor/kreuzberg/src/extractors/latex.rs +653 -652
  148. data/vendor/kreuzberg/src/extractors/markdown.rs +701 -700
  149. data/vendor/kreuzberg/src/extractors/mod.rs +429 -365
  150. data/vendor/kreuzberg/src/extractors/odt.rs +628 -628
  151. data/vendor/kreuzberg/src/extractors/opml.rs +635 -634
  152. data/vendor/kreuzberg/src/extractors/orgmode.rs +529 -528
  153. data/vendor/kreuzberg/src/extractors/pdf.rs +761 -493
  154. data/vendor/kreuzberg/src/extractors/pptx.rs +279 -248
  155. data/vendor/kreuzberg/src/extractors/rst.rs +577 -576
  156. data/vendor/kreuzberg/src/extractors/rtf.rs +809 -810
  157. data/vendor/kreuzberg/src/extractors/security.rs +484 -484
  158. data/vendor/kreuzberg/src/extractors/security_tests.rs +367 -367
  159. data/vendor/kreuzberg/src/extractors/structured.rs +142 -140
  160. data/vendor/kreuzberg/src/extractors/text.rs +265 -260
  161. data/vendor/kreuzberg/src/extractors/typst.rs +651 -650
  162. data/vendor/kreuzberg/src/extractors/xml.rs +147 -135
  163. data/vendor/kreuzberg/src/image/dpi.rs +164 -164
  164. data/vendor/kreuzberg/src/image/mod.rs +6 -6
  165. data/vendor/kreuzberg/src/image/preprocessing.rs +417 -417
  166. data/vendor/kreuzberg/src/image/resize.rs +89 -89
  167. data/vendor/kreuzberg/src/keywords/config.rs +154 -154
  168. data/vendor/kreuzberg/src/keywords/mod.rs +237 -237
  169. data/vendor/kreuzberg/src/keywords/processor.rs +275 -267
  170. data/vendor/kreuzberg/src/keywords/rake.rs +293 -293
  171. data/vendor/kreuzberg/src/keywords/types.rs +68 -68
  172. data/vendor/kreuzberg/src/keywords/yake.rs +163 -163
  173. data/vendor/kreuzberg/src/language_detection/mod.rs +985 -942
  174. data/vendor/kreuzberg/src/language_detection/processor.rs +218 -0
  175. data/vendor/kreuzberg/src/lib.rs +114 -105
  176. data/vendor/kreuzberg/src/mcp/mod.rs +35 -32
  177. data/vendor/kreuzberg/src/mcp/server.rs +2090 -1968
  178. data/vendor/kreuzberg/src/ocr/cache.rs +469 -469
  179. data/vendor/kreuzberg/src/ocr/error.rs +37 -37
  180. data/vendor/kreuzberg/src/ocr/hocr.rs +216 -216
  181. data/vendor/kreuzberg/src/ocr/language_registry.rs +520 -0
  182. data/vendor/kreuzberg/src/ocr/mod.rs +60 -58
  183. data/vendor/kreuzberg/src/ocr/processor.rs +858 -863
  184. data/vendor/kreuzberg/src/ocr/table/mod.rs +4 -4
  185. data/vendor/kreuzberg/src/ocr/table/tsv_parser.rs +144 -144
  186. data/vendor/kreuzberg/src/ocr/tesseract_backend.rs +456 -450
  187. data/vendor/kreuzberg/src/ocr/types.rs +393 -393
  188. data/vendor/kreuzberg/src/ocr/utils.rs +47 -47
  189. data/vendor/kreuzberg/src/ocr/validation.rs +206 -206
  190. data/vendor/kreuzberg/src/panic_context.rs +154 -154
  191. data/vendor/kreuzberg/src/pdf/bindings.rs +306 -0
  192. data/vendor/kreuzberg/src/pdf/bundled.rs +408 -0
  193. data/vendor/kreuzberg/src/pdf/error.rs +214 -122
  194. data/vendor/kreuzberg/src/pdf/fonts.rs +358 -0
  195. data/vendor/kreuzberg/src/pdf/hierarchy.rs +903 -0
  196. data/vendor/kreuzberg/src/pdf/images.rs +139 -139
  197. data/vendor/kreuzberg/src/pdf/metadata.rs +509 -346
  198. data/vendor/kreuzberg/src/pdf/mod.rs +81 -50
  199. data/vendor/kreuzberg/src/pdf/rendering.rs +369 -369
  200. data/vendor/kreuzberg/src/pdf/table.rs +417 -393
  201. data/vendor/kreuzberg/src/pdf/text.rs +553 -158
  202. data/vendor/kreuzberg/src/plugins/extractor.rs +1042 -1013
  203. data/vendor/kreuzberg/src/plugins/mod.rs +212 -209
  204. data/vendor/kreuzberg/src/plugins/ocr.rs +637 -620
  205. data/vendor/kreuzberg/src/plugins/processor.rs +650 -642
  206. data/vendor/kreuzberg/src/plugins/registry.rs +1339 -1337
  207. data/vendor/kreuzberg/src/plugins/traits.rs +258 -258
  208. data/vendor/kreuzberg/src/plugins/validator.rs +967 -956
  209. data/vendor/kreuzberg/src/stopwords/mod.rs +1470 -1470
  210. data/vendor/kreuzberg/src/text/mod.rs +27 -19
  211. data/vendor/kreuzberg/src/text/quality.rs +710 -697
  212. data/vendor/kreuzberg/src/text/quality_processor.rs +231 -0
  213. data/vendor/kreuzberg/src/text/string_utils.rs +229 -217
  214. data/vendor/kreuzberg/src/text/token_reduction/cjk_utils.rs +164 -164
  215. data/vendor/kreuzberg/src/text/token_reduction/config.rs +100 -100
  216. data/vendor/kreuzberg/src/text/token_reduction/core.rs +832 -796
  217. data/vendor/kreuzberg/src/text/token_reduction/filters.rs +923 -902
  218. data/vendor/kreuzberg/src/text/token_reduction/mod.rs +160 -160
  219. data/vendor/kreuzberg/src/text/token_reduction/semantic.rs +619 -619
  220. data/vendor/kreuzberg/src/text/token_reduction/simd_text.rs +148 -147
  221. data/vendor/kreuzberg/src/text/utf8_validation.rs +193 -0
  222. data/vendor/kreuzberg/src/types.rs +1713 -903
  223. data/vendor/kreuzberg/src/utils/mod.rs +31 -17
  224. data/vendor/kreuzberg/src/utils/pool.rs +503 -0
  225. data/vendor/kreuzberg/src/utils/pool_sizing.rs +364 -0
  226. data/vendor/kreuzberg/src/utils/quality.rs +968 -959
  227. data/vendor/kreuzberg/src/utils/string_pool.rs +761 -0
  228. data/vendor/kreuzberg/src/utils/string_utils.rs +381 -381
  229. data/vendor/kreuzberg/stopwords/af_stopwords.json +53 -53
  230. data/vendor/kreuzberg/stopwords/ar_stopwords.json +482 -482
  231. data/vendor/kreuzberg/stopwords/bg_stopwords.json +261 -261
  232. data/vendor/kreuzberg/stopwords/bn_stopwords.json +400 -400
  233. data/vendor/kreuzberg/stopwords/br_stopwords.json +1205 -1205
  234. data/vendor/kreuzberg/stopwords/ca_stopwords.json +280 -280
  235. data/vendor/kreuzberg/stopwords/cs_stopwords.json +425 -425
  236. data/vendor/kreuzberg/stopwords/da_stopwords.json +172 -172
  237. data/vendor/kreuzberg/stopwords/de_stopwords.json +622 -622
  238. data/vendor/kreuzberg/stopwords/el_stopwords.json +849 -849
  239. data/vendor/kreuzberg/stopwords/en_stopwords.json +1300 -1300
  240. data/vendor/kreuzberg/stopwords/eo_stopwords.json +175 -175
  241. data/vendor/kreuzberg/stopwords/es_stopwords.json +734 -734
  242. data/vendor/kreuzberg/stopwords/et_stopwords.json +37 -37
  243. data/vendor/kreuzberg/stopwords/eu_stopwords.json +100 -100
  244. data/vendor/kreuzberg/stopwords/fa_stopwords.json +801 -801
  245. data/vendor/kreuzberg/stopwords/fi_stopwords.json +849 -849
  246. data/vendor/kreuzberg/stopwords/fr_stopwords.json +693 -693
  247. data/vendor/kreuzberg/stopwords/ga_stopwords.json +111 -111
  248. data/vendor/kreuzberg/stopwords/gl_stopwords.json +162 -162
  249. data/vendor/kreuzberg/stopwords/gu_stopwords.json +226 -226
  250. data/vendor/kreuzberg/stopwords/ha_stopwords.json +41 -41
  251. data/vendor/kreuzberg/stopwords/he_stopwords.json +196 -196
  252. data/vendor/kreuzberg/stopwords/hi_stopwords.json +227 -227
  253. data/vendor/kreuzberg/stopwords/hr_stopwords.json +181 -181
  254. data/vendor/kreuzberg/stopwords/hu_stopwords.json +791 -791
  255. data/vendor/kreuzberg/stopwords/hy_stopwords.json +47 -47
  256. data/vendor/kreuzberg/stopwords/id_stopwords.json +760 -760
  257. data/vendor/kreuzberg/stopwords/it_stopwords.json +634 -634
  258. data/vendor/kreuzberg/stopwords/ja_stopwords.json +136 -136
  259. data/vendor/kreuzberg/stopwords/kn_stopwords.json +84 -84
  260. data/vendor/kreuzberg/stopwords/ko_stopwords.json +681 -681
  261. data/vendor/kreuzberg/stopwords/ku_stopwords.json +64 -64
  262. data/vendor/kreuzberg/stopwords/la_stopwords.json +51 -51
  263. data/vendor/kreuzberg/stopwords/lt_stopwords.json +476 -476
  264. data/vendor/kreuzberg/stopwords/lv_stopwords.json +163 -163
  265. data/vendor/kreuzberg/stopwords/ml_stopwords.json +1 -1
  266. data/vendor/kreuzberg/stopwords/mr_stopwords.json +101 -101
  267. data/vendor/kreuzberg/stopwords/ms_stopwords.json +477 -477
  268. data/vendor/kreuzberg/stopwords/ne_stopwords.json +490 -490
  269. data/vendor/kreuzberg/stopwords/nl_stopwords.json +415 -415
  270. data/vendor/kreuzberg/stopwords/no_stopwords.json +223 -223
  271. data/vendor/kreuzberg/stopwords/pl_stopwords.json +331 -331
  272. data/vendor/kreuzberg/stopwords/pt_stopwords.json +562 -562
  273. data/vendor/kreuzberg/stopwords/ro_stopwords.json +436 -436
  274. data/vendor/kreuzberg/stopwords/ru_stopwords.json +561 -561
  275. data/vendor/kreuzberg/stopwords/si_stopwords.json +193 -193
  276. data/vendor/kreuzberg/stopwords/sk_stopwords.json +420 -420
  277. data/vendor/kreuzberg/stopwords/sl_stopwords.json +448 -448
  278. data/vendor/kreuzberg/stopwords/so_stopwords.json +32 -32
  279. data/vendor/kreuzberg/stopwords/st_stopwords.json +33 -33
  280. data/vendor/kreuzberg/stopwords/sv_stopwords.json +420 -420
  281. data/vendor/kreuzberg/stopwords/sw_stopwords.json +76 -76
  282. data/vendor/kreuzberg/stopwords/ta_stopwords.json +129 -129
  283. data/vendor/kreuzberg/stopwords/te_stopwords.json +54 -54
  284. data/vendor/kreuzberg/stopwords/th_stopwords.json +118 -118
  285. data/vendor/kreuzberg/stopwords/tl_stopwords.json +149 -149
  286. data/vendor/kreuzberg/stopwords/tr_stopwords.json +506 -506
  287. data/vendor/kreuzberg/stopwords/uk_stopwords.json +75 -75
  288. data/vendor/kreuzberg/stopwords/ur_stopwords.json +519 -519
  289. data/vendor/kreuzberg/stopwords/vi_stopwords.json +647 -647
  290. data/vendor/kreuzberg/stopwords/yo_stopwords.json +62 -62
  291. data/vendor/kreuzberg/stopwords/zh_stopwords.json +796 -796
  292. data/vendor/kreuzberg/stopwords/zu_stopwords.json +31 -31
  293. data/vendor/kreuzberg/tests/api_embed.rs +360 -0
  294. data/vendor/kreuzberg/tests/api_extract_multipart.rs +52 -52
  295. data/vendor/kreuzberg/tests/api_large_pdf_extraction.rs +471 -0
  296. data/vendor/kreuzberg/tests/api_large_pdf_extraction_diagnostics.rs +289 -0
  297. data/vendor/kreuzberg/tests/api_tests.rs +1472 -966
  298. data/vendor/kreuzberg/tests/archive_integration.rs +545 -543
  299. data/vendor/kreuzberg/tests/batch_orchestration.rs +587 -556
  300. data/vendor/kreuzberg/tests/batch_pooling_benchmark.rs +154 -0
  301. data/vendor/kreuzberg/tests/batch_processing.rs +328 -316
  302. data/vendor/kreuzberg/tests/bibtex_parity_test.rs +421 -421
  303. data/vendor/kreuzberg/tests/concurrency_stress.rs +541 -525
  304. data/vendor/kreuzberg/tests/config_features.rs +612 -598
  305. data/vendor/kreuzberg/tests/config_integration_test.rs +753 -0
  306. data/vendor/kreuzberg/tests/config_loading_tests.rs +416 -415
  307. data/vendor/kreuzberg/tests/core_integration.rs +519 -510
  308. data/vendor/kreuzberg/tests/csv_integration.rs +414 -414
  309. data/vendor/kreuzberg/tests/data/hierarchy_ground_truth.json +294 -0
  310. data/vendor/kreuzberg/tests/docbook_extractor_tests.rs +500 -498
  311. data/vendor/kreuzberg/tests/docx_metadata_extraction_test.rs +122 -122
  312. data/vendor/kreuzberg/tests/docx_vs_pandoc_comparison.rs +370 -370
  313. data/vendor/kreuzberg/tests/email_integration.rs +327 -325
  314. data/vendor/kreuzberg/tests/epub_native_extractor_tests.rs +275 -275
  315. data/vendor/kreuzberg/tests/error_handling.rs +402 -393
  316. data/vendor/kreuzberg/tests/fictionbook_extractor_tests.rs +228 -228
  317. data/vendor/kreuzberg/tests/format_integration.rs +165 -159
  318. data/vendor/kreuzberg/tests/helpers/mod.rs +202 -142
  319. data/vendor/kreuzberg/tests/html_table_test.rs +551 -551
  320. data/vendor/kreuzberg/tests/image_integration.rs +255 -253
  321. data/vendor/kreuzberg/tests/instrumentation_test.rs +139 -139
  322. data/vendor/kreuzberg/tests/jats_extractor_tests.rs +639 -639
  323. data/vendor/kreuzberg/tests/jupyter_extractor_tests.rs +704 -704
  324. data/vendor/kreuzberg/tests/keywords_integration.rs +479 -479
  325. data/vendor/kreuzberg/tests/keywords_quality.rs +509 -509
  326. data/vendor/kreuzberg/tests/latex_extractor_tests.rs +496 -496
  327. data/vendor/kreuzberg/tests/markdown_extractor_tests.rs +490 -490
  328. data/vendor/kreuzberg/tests/mime_detection.rs +429 -428
  329. data/vendor/kreuzberg/tests/ocr_configuration.rs +514 -510
  330. data/vendor/kreuzberg/tests/ocr_errors.rs +698 -676
  331. data/vendor/kreuzberg/tests/ocr_language_registry.rs +191 -0
  332. data/vendor/kreuzberg/tests/ocr_quality.rs +629 -627
  333. data/vendor/kreuzberg/tests/ocr_stress.rs +469 -469
  334. data/vendor/kreuzberg/tests/odt_extractor_tests.rs +674 -695
  335. data/vendor/kreuzberg/tests/opml_extractor_tests.rs +616 -616
  336. data/vendor/kreuzberg/tests/orgmode_extractor_tests.rs +822 -822
  337. data/vendor/kreuzberg/tests/page_markers.rs +297 -0
  338. data/vendor/kreuzberg/tests/pdf_hierarchy_detection.rs +301 -0
  339. data/vendor/kreuzberg/tests/pdf_hierarchy_quality.rs +589 -0
  340. data/vendor/kreuzberg/tests/pdf_integration.rs +45 -43
  341. data/vendor/kreuzberg/tests/pdf_ocr_triggering.rs +301 -0
  342. data/vendor/kreuzberg/tests/pdf_text_merging.rs +475 -0
  343. data/vendor/kreuzberg/tests/pdfium_linking.rs +340 -0
  344. data/vendor/kreuzberg/tests/pipeline_integration.rs +1446 -1411
  345. data/vendor/kreuzberg/tests/plugin_ocr_backend_test.rs +776 -771
  346. data/vendor/kreuzberg/tests/plugin_postprocessor_test.rs +577 -560
  347. data/vendor/kreuzberg/tests/plugin_system.rs +927 -921
  348. data/vendor/kreuzberg/tests/plugin_validator_test.rs +783 -783
  349. data/vendor/kreuzberg/tests/registry_integration_tests.rs +587 -586
  350. data/vendor/kreuzberg/tests/rst_extractor_tests.rs +694 -692
  351. data/vendor/kreuzberg/tests/rtf_extractor_tests.rs +775 -776
  352. data/vendor/kreuzberg/tests/security_validation.rs +416 -415
  353. data/vendor/kreuzberg/tests/stopwords_integration_test.rs +888 -888
  354. data/vendor/kreuzberg/tests/test_fastembed.rs +631 -609
  355. data/vendor/kreuzberg/tests/typst_behavioral_tests.rs +1260 -1259
  356. data/vendor/kreuzberg/tests/typst_extractor_tests.rs +648 -647
  357. data/vendor/kreuzberg/tests/xlsx_metadata_extraction_test.rs +87 -87
  358. data/vendor/kreuzberg-ffi/Cargo.toml +67 -0
  359. data/vendor/kreuzberg-ffi/README.md +851 -0
  360. data/vendor/kreuzberg-ffi/benches/result_view_benchmark.rs +227 -0
  361. data/vendor/kreuzberg-ffi/build.rs +168 -0
  362. data/vendor/kreuzberg-ffi/cbindgen.toml +37 -0
  363. data/vendor/kreuzberg-ffi/kreuzberg-ffi.pc.in +12 -0
  364. data/vendor/kreuzberg-ffi/kreuzberg.h +3012 -0
  365. data/vendor/kreuzberg-ffi/src/batch_streaming.rs +588 -0
  366. data/vendor/kreuzberg-ffi/src/config.rs +1341 -0
  367. data/vendor/kreuzberg-ffi/src/error.rs +901 -0
  368. data/vendor/kreuzberg-ffi/src/extraction.rs +555 -0
  369. data/vendor/kreuzberg-ffi/src/helpers.rs +879 -0
  370. data/vendor/kreuzberg-ffi/src/lib.rs +977 -0
  371. data/vendor/kreuzberg-ffi/src/memory.rs +493 -0
  372. data/vendor/kreuzberg-ffi/src/mime.rs +329 -0
  373. data/vendor/kreuzberg-ffi/src/panic_shield.rs +265 -0
  374. data/vendor/kreuzberg-ffi/src/plugins/document_extractor.rs +442 -0
  375. data/vendor/kreuzberg-ffi/src/plugins/mod.rs +14 -0
  376. data/vendor/kreuzberg-ffi/src/plugins/ocr_backend.rs +628 -0
  377. data/vendor/kreuzberg-ffi/src/plugins/post_processor.rs +438 -0
  378. data/vendor/kreuzberg-ffi/src/plugins/validator.rs +329 -0
  379. data/vendor/kreuzberg-ffi/src/result.rs +510 -0
  380. data/vendor/kreuzberg-ffi/src/result_pool.rs +639 -0
  381. data/vendor/kreuzberg-ffi/src/result_view.rs +773 -0
  382. data/vendor/kreuzberg-ffi/src/string_intern.rs +568 -0
  383. data/vendor/kreuzberg-ffi/src/types.rs +363 -0
  384. data/vendor/kreuzberg-ffi/src/util.rs +210 -0
  385. data/vendor/kreuzberg-ffi/src/validation.rs +848 -0
  386. data/vendor/kreuzberg-ffi/tests.disabled/README.md +48 -0
  387. data/vendor/kreuzberg-ffi/tests.disabled/config_loading_tests.rs +299 -0
  388. data/vendor/kreuzberg-ffi/tests.disabled/config_tests.rs +346 -0
  389. data/vendor/kreuzberg-ffi/tests.disabled/extractor_tests.rs +232 -0
  390. data/vendor/kreuzberg-ffi/tests.disabled/plugin_registration_tests.rs +470 -0
  391. data/vendor/kreuzberg-tesseract/.commitlintrc.json +13 -0
  392. data/vendor/kreuzberg-tesseract/.crate-ignore +2 -0
  393. data/vendor/kreuzberg-tesseract/Cargo.lock +2933 -0
  394. data/vendor/kreuzberg-tesseract/Cargo.toml +57 -0
  395. data/vendor/{rb-sys/LICENSE-MIT → kreuzberg-tesseract/LICENSE} +22 -21
  396. data/vendor/kreuzberg-tesseract/README.md +399 -0
  397. data/vendor/kreuzberg-tesseract/build.rs +1127 -0
  398. data/vendor/kreuzberg-tesseract/patches/README.md +71 -0
  399. data/vendor/kreuzberg-tesseract/patches/tesseract.diff +199 -0
  400. data/vendor/kreuzberg-tesseract/src/api.rs +1371 -0
  401. data/vendor/kreuzberg-tesseract/src/choice_iterator.rs +77 -0
  402. data/vendor/kreuzberg-tesseract/src/enums.rs +297 -0
  403. data/vendor/kreuzberg-tesseract/src/error.rs +81 -0
  404. data/vendor/kreuzberg-tesseract/src/lib.rs +145 -0
  405. data/vendor/kreuzberg-tesseract/src/monitor.rs +57 -0
  406. data/vendor/kreuzberg-tesseract/src/mutable_iterator.rs +197 -0
  407. data/vendor/kreuzberg-tesseract/src/page_iterator.rs +253 -0
  408. data/vendor/kreuzberg-tesseract/src/result_iterator.rs +286 -0
  409. data/vendor/kreuzberg-tesseract/src/result_renderer.rs +183 -0
  410. data/vendor/kreuzberg-tesseract/tests/integration_test.rs +211 -0
  411. metadata +196 -45
  412. data/vendor/kreuzberg/benches/otel_overhead.rs +0 -48
  413. data/vendor/kreuzberg/src/extractors/fictionbook.rs.backup2 +0 -738
  414. data/vendor/rb-sys/.cargo-ok +0 -1
  415. data/vendor/rb-sys/.cargo_vcs_info.json +0 -6
  416. data/vendor/rb-sys/Cargo.lock +0 -393
  417. data/vendor/rb-sys/Cargo.toml +0 -70
  418. data/vendor/rb-sys/Cargo.toml.orig +0 -57
  419. data/vendor/rb-sys/LICENSE-APACHE +0 -190
  420. data/vendor/rb-sys/bin/release.sh +0 -21
  421. data/vendor/rb-sys/build/features.rs +0 -108
  422. data/vendor/rb-sys/build/main.rs +0 -246
  423. data/vendor/rb-sys/build/stable_api_config.rs +0 -153
  424. data/vendor/rb-sys/build/version.rs +0 -48
  425. data/vendor/rb-sys/readme.md +0 -36
  426. data/vendor/rb-sys/src/bindings.rs +0 -21
  427. data/vendor/rb-sys/src/hidden.rs +0 -11
  428. data/vendor/rb-sys/src/lib.rs +0 -34
  429. data/vendor/rb-sys/src/macros.rs +0 -371
  430. data/vendor/rb-sys/src/memory.rs +0 -53
  431. data/vendor/rb-sys/src/ruby_abi_version.rs +0 -38
  432. data/vendor/rb-sys/src/special_consts.rs +0 -31
  433. data/vendor/rb-sys/src/stable_api/compiled.c +0 -179
  434. data/vendor/rb-sys/src/stable_api/compiled.rs +0 -257
  435. data/vendor/rb-sys/src/stable_api/ruby_2_6.rs +0 -316
  436. data/vendor/rb-sys/src/stable_api/ruby_2_7.rs +0 -316
  437. data/vendor/rb-sys/src/stable_api/ruby_3_0.rs +0 -324
  438. data/vendor/rb-sys/src/stable_api/ruby_3_1.rs +0 -317
  439. data/vendor/rb-sys/src/stable_api/ruby_3_2.rs +0 -315
  440. data/vendor/rb-sys/src/stable_api/ruby_3_3.rs +0 -326
  441. data/vendor/rb-sys/src/stable_api/ruby_3_4.rs +0 -327
  442. data/vendor/rb-sys/src/stable_api.rs +0 -261
  443. data/vendor/rb-sys/src/symbol.rs +0 -31
  444. data/vendor/rb-sys/src/tracking_allocator.rs +0 -332
  445. data/vendor/rb-sys/src/utils.rs +0 -89
  446. data/vendor/rb-sys/src/value_type.rs +0 -7
@@ -1,810 +1,809 @@
1
- //! RTF (Rich Text Format) extractor.
2
- //!
3
- //! Supports: Rich Text Format (.rtf)
4
- //!
5
- //! This native Rust extractor provides text extraction from RTF documents with:
6
- //! - Character encoding support (Windows-1252 for 0x80-0x9F range)
7
- //! - Common RTF control words (paragraph breaks, tabs, bullets, quotes, dashes)
8
- //! - Unicode escape sequences
9
- //! - Image metadata extraction
10
- //! - Whitespace normalization
11
-
12
- use crate::Result;
13
- use crate::core::config::ExtractionConfig;
14
- use crate::extraction::cells_to_markdown;
15
- use crate::plugins::{DocumentExtractor, Plugin};
16
- use crate::types::{ExtractionResult, Metadata, Table};
17
- use async_trait::async_trait;
18
- use serde_json::Value;
19
- use std::collections::HashMap;
20
-
21
- /// Native Rust RTF extractor.
22
- ///
23
- /// Extracts text content, metadata, and structure from RTF documents
24
- pub struct RtfExtractor;
25
-
26
- impl RtfExtractor {
27
- /// Create a new RTF extractor.
28
- pub fn new() -> Self {
29
- Self
30
- }
31
- }
32
-
33
- impl Default for RtfExtractor {
34
- fn default() -> Self {
35
- Self::new()
36
- }
37
- }
38
-
39
- impl Plugin for RtfExtractor {
40
- fn name(&self) -> &str {
41
- "rtf-extractor"
42
- }
43
-
44
- fn version(&self) -> String {
45
- env!("CARGO_PKG_VERSION").to_string()
46
- }
47
-
48
- fn initialize(&self) -> Result<()> {
49
- Ok(())
50
- }
51
-
52
- fn shutdown(&self) -> Result<()> {
53
- Ok(())
54
- }
55
-
56
- fn description(&self) -> &str {
57
- "Extracts content from RTF (Rich Text Format) files with native Rust parsing"
58
- }
59
-
60
- fn author(&self) -> &str {
61
- "Kreuzberg Team"
62
- }
63
- }
64
-
65
- /// Convert a hex digit character to its numeric value.
66
- ///
67
- /// Returns None if the character is not a valid hex digit.
68
- #[inline]
69
- fn hex_digit_to_u8(c: char) -> Option<u8> {
70
- match c {
71
- '0'..='9' => Some((c as u8) - b'0'),
72
- 'a'..='f' => Some((c as u8) - b'a' + 10),
73
- 'A'..='F' => Some((c as u8) - b'A' + 10),
74
- _ => None,
75
- }
76
- }
77
-
78
- /// Parse a hex-encoded byte from two characters.
79
- ///
80
- /// Returns the decoded byte if both characters are valid hex digits.
81
- #[inline]
82
- fn parse_hex_byte(h1: char, h2: char) -> Option<u8> {
83
- let high = hex_digit_to_u8(h1)?;
84
- let low = hex_digit_to_u8(h2)?;
85
- Some((high << 4) | low)
86
- }
87
-
88
- /// Parse an RTF control word and extract its value.
89
- ///
90
- /// Returns a tuple of (control_word, optional_numeric_value)
91
- fn parse_rtf_control_word(chars: &mut std::iter::Peekable<std::str::Chars>) -> (String, Option<i32>) {
92
- let mut word = String::new();
93
- let mut num_str = String::new();
94
- let mut is_negative = false;
95
-
96
- while let Some(&c) = chars.peek() {
97
- if c.is_alphabetic() {
98
- word.push(c);
99
- chars.next();
100
- } else {
101
- break;
102
- }
103
- }
104
-
105
- if let Some(&c) = chars.peek()
106
- && c == '-'
107
- {
108
- is_negative = true;
109
- chars.next();
110
- }
111
-
112
- while let Some(&c) = chars.peek() {
113
- if c.is_ascii_digit() {
114
- num_str.push(c);
115
- chars.next();
116
- } else {
117
- break;
118
- }
119
- }
120
-
121
- let num_value = if !num_str.is_empty() {
122
- let val = num_str.parse::<i32>().unwrap_or(0);
123
- Some(if is_negative { -val } else { val })
124
- } else {
125
- None
126
- };
127
-
128
- (word, num_value)
129
- }
130
-
131
- /// Extract text and image metadata from RTF document.
132
- ///
133
- /// This function extracts plain text from an RTF document by:
134
- /// 1. Tokenizing control sequences and text
135
- /// 2. Converting encoded characters to Unicode
136
- /// 3. Extracting text while skipping formatting groups
137
- /// 4. Detecting and extracting image metadata (\pict sections)
138
- /// 5. Normalizing whitespace
139
- fn extract_text_from_rtf(content: &str) -> (String, Vec<Table>) {
140
- struct TableState {
141
- rows: Vec<Vec<String>>,
142
- current_row: Vec<String>,
143
- current_cell: String,
144
- in_row: bool,
145
- }
146
-
147
- fn push_cell(state: &mut TableState) {
148
- let cell = state.current_cell.trim().to_string();
149
- state.current_row.push(cell);
150
- state.current_cell.clear();
151
- }
152
-
153
- fn push_row(state: &mut TableState) {
154
- if state.in_row || !state.current_cell.is_empty() {
155
- push_cell(state);
156
- state.in_row = false;
157
- }
158
- if !state.current_row.is_empty() {
159
- state.rows.push(state.current_row.clone());
160
- state.current_row.clear();
161
- }
162
- }
163
-
164
- fn finalize_table(state_opt: &mut Option<TableState>, tables: &mut Vec<Table>) {
165
- if let Some(mut state) = state_opt.take() {
166
- if state.in_row || !state.current_cell.is_empty() || !state.current_row.is_empty() {
167
- push_row(&mut state);
168
- }
169
- if !state.rows.is_empty() {
170
- let markdown = cells_to_markdown(&state.rows);
171
- tables.push(Table {
172
- cells: state.rows,
173
- markdown,
174
- page_number: 1,
175
- });
176
- }
177
- }
178
- }
179
-
180
- let mut result = String::new();
181
- let mut chars = content.chars().peekable();
182
- let mut tables: Vec<Table> = Vec::new();
183
- let mut table_state: Option<TableState> = None;
184
-
185
- let ensure_table = |table_state: &mut Option<TableState>| {
186
- if table_state.is_none() {
187
- *table_state = Some(TableState {
188
- rows: Vec::new(),
189
- current_row: Vec::new(),
190
- current_cell: String::new(),
191
- in_row: false,
192
- });
193
- }
194
- };
195
-
196
- while let Some(ch) = chars.next() {
197
- match ch {
198
- '\\' => {
199
- if let Some(&next_ch) = chars.peek() {
200
- match next_ch {
201
- '\\' | '{' | '}' => {
202
- chars.next();
203
- result.push(next_ch);
204
- }
205
- '\'' => {
206
- chars.next();
207
- let hex1 = chars.next();
208
- let hex2 = chars.next();
209
- if let (Some(h1), Some(h2)) = (hex1, hex2)
210
- && let Some(byte) = parse_hex_byte(h1, h2)
211
- {
212
- let decoded = match byte {
213
- 0x80 => '\u{20AC}',
214
- 0x81 => '?',
215
- 0x82 => '\u{201A}',
216
- 0x83 => '\u{0192}',
217
- 0x84 => '\u{201E}',
218
- 0x85 => '\u{2026}',
219
- 0x86 => '\u{2020}',
220
- 0x87 => '\u{2021}',
221
- 0x88 => '\u{02C6}',
222
- 0x89 => '\u{2030}',
223
- 0x8A => '\u{0160}',
224
- 0x8B => '\u{2039}',
225
- 0x8C => '\u{0152}',
226
- 0x8D => '?',
227
- 0x8E => '\u{017D}',
228
- 0x8F => '?',
229
- 0x90 => '?',
230
- 0x91 => '\u{2018}',
231
- 0x92 => '\u{2019}',
232
- 0x93 => '\u{201C}',
233
- 0x94 => '\u{201D}',
234
- 0x95 => '\u{2022}',
235
- 0x96 => '\u{2013}',
236
- 0x97 => '\u{2014}',
237
- 0x98 => '\u{02DC}',
238
- 0x99 => '\u{2122}',
239
- 0x9A => '\u{0161}',
240
- 0x9B => '\u{203A}',
241
- 0x9C => '\u{0153}',
242
- 0x9D => '?',
243
- 0x9E => '\u{017E}',
244
- 0x9F => '\u{0178}',
245
- _ => byte as char,
246
- };
247
- result.push(decoded);
248
- if let Some(state) = table_state.as_mut()
249
- && state.in_row
250
- {
251
- state.current_cell.push(decoded);
252
- }
253
- }
254
- }
255
- 'u' => {
256
- chars.next();
257
- let mut num_str = String::new();
258
- while let Some(&c) = chars.peek() {
259
- if c.is_ascii_digit() || c == '-' {
260
- num_str.push(c);
261
- chars.next();
262
- } else {
263
- break;
264
- }
265
- }
266
- if let Ok(code_num) = num_str.parse::<i32>() {
267
- let code_u = if code_num < 0 {
268
- (code_num + 65536) as u32
269
- } else {
270
- code_num as u32
271
- };
272
- if let Some(c) = char::from_u32(code_u) {
273
- result.push(c);
274
- if let Some(state) = table_state.as_mut()
275
- && state.in_row
276
- {
277
- state.current_cell.push(c);
278
- }
279
- }
280
- }
281
- }
282
- _ => {
283
- let (control_word, _) = parse_rtf_control_word(&mut chars);
284
-
285
- match control_word.as_str() {
286
- "pict" => {
287
- let image_metadata = extract_image_metadata(&mut chars);
288
- if !image_metadata.is_empty() {
289
- result.push('!');
290
- result.push('[');
291
- result.push_str("image");
292
- result.push(']');
293
- result.push('(');
294
- result.push_str(&image_metadata);
295
- result.push(')');
296
- result.push(' ');
297
- if let Some(state) = table_state.as_mut()
298
- && state.in_row
299
- {
300
- state.current_cell.push('!');
301
- state.current_cell.push('[');
302
- state.current_cell.push_str("image");
303
- state.current_cell.push(']');
304
- state.current_cell.push('(');
305
- state.current_cell.push_str(&image_metadata);
306
- state.current_cell.push(')');
307
- state.current_cell.push(' ');
308
- }
309
- }
310
- }
311
- "par" => {
312
- if table_state.is_some() {
313
- finalize_table(&mut table_state, &mut tables);
314
- }
315
- if !result.is_empty() && !result.ends_with('\n') {
316
- result.push('\n');
317
- result.push('\n');
318
- }
319
- }
320
- "tab" => {
321
- result.push('\t');
322
- if let Some(state) = table_state.as_mut()
323
- && state.in_row
324
- {
325
- state.current_cell.push('\t');
326
- }
327
- }
328
- "bullet" => {
329
- result.push('•');
330
- }
331
- "lquote" => {
332
- result.push('\u{2018}');
333
- }
334
- "rquote" => {
335
- result.push('\u{2019}');
336
- }
337
- "ldblquote" => {
338
- result.push('\u{201C}');
339
- }
340
- "rdblquote" => {
341
- result.push('\u{201D}');
342
- }
343
- "endash" => {
344
- result.push('\u{2013}');
345
- }
346
- "emdash" => {
347
- result.push('\u{2014}');
348
- }
349
- "trowd" => {
350
- ensure_table(&mut table_state);
351
- if let Some(state) = table_state.as_mut() {
352
- if state.in_row {
353
- push_row(state);
354
- }
355
- state.in_row = true;
356
- state.current_cell.clear();
357
- state.current_row.clear();
358
- }
359
- if !result.is_empty() && !result.ends_with('\n') {
360
- result.push('\n');
361
- }
362
- if !result.ends_with('|') {
363
- result.push('|');
364
- result.push(' ');
365
- }
366
- }
367
- "cell" => {
368
- if !result.ends_with('|') {
369
- if !result.ends_with(' ') && !result.is_empty() {
370
- result.push(' ');
371
- }
372
- result.push('|');
373
- }
374
- if !result.ends_with(' ') {
375
- result.push(' ');
376
- }
377
- }
378
- "row" => {
379
- ensure_table(&mut table_state);
380
- if let Some(state) = table_state.as_mut()
381
- && (state.in_row || !state.current_cell.is_empty())
382
- {
383
- push_row(state);
384
- }
385
- if !result.ends_with('|') {
386
- result.push('|');
387
- }
388
- if !result.ends_with('\n') {
389
- result.push('\n');
390
- }
391
- if let Some(state) = table_state.as_ref()
392
- && !state.in_row
393
- && !state.rows.is_empty()
394
- {
395
- // We'll finalize once we see content outside the table
396
- }
397
- }
398
- _ => {}
399
- }
400
- }
401
- }
402
- }
403
- }
404
- '{' | '}' => {
405
- if !result.is_empty() && !result.ends_with(' ') {
406
- result.push(' ');
407
- }
408
- }
409
- ' ' | '\t' | '\n' | '\r' => {
410
- if !result.is_empty() && !result.ends_with(' ') {
411
- result.push(' ');
412
- }
413
- if let Some(state) = table_state.as_mut()
414
- && state.in_row
415
- && !state.current_cell.ends_with(' ')
416
- {
417
- state.current_cell.push(' ');
418
- }
419
- }
420
- _ => {
421
- if let Some(state) = table_state.as_ref()
422
- && !state.in_row
423
- && !state.rows.is_empty()
424
- {
425
- finalize_table(&mut table_state, &mut tables);
426
- }
427
- result.push(ch);
428
- if let Some(state) = table_state.as_mut()
429
- && state.in_row
430
- {
431
- state.current_cell.push(ch);
432
- }
433
- }
434
- }
435
- }
436
-
437
- if table_state.is_some() {
438
- finalize_table(&mut table_state, &mut tables);
439
- }
440
-
441
- (normalize_whitespace(&result), tables)
442
- }
443
-
444
- /// Normalize whitespace in a string using a single-pass algorithm.
445
- ///
446
- /// Collapses multiple consecutive whitespace characters into single spaces
447
- /// and trims leading/trailing whitespace.
448
- fn normalize_whitespace(s: &str) -> String {
449
- let mut result = String::with_capacity(s.len());
450
- let mut last_was_space = false;
451
-
452
- for ch in s.chars() {
453
- if ch.is_whitespace() {
454
- if !last_was_space {
455
- result.push(' ');
456
- last_was_space = true;
457
- }
458
- } else {
459
- result.push(ch);
460
- last_was_space = false;
461
- }
462
- }
463
-
464
- result.trim().to_string()
465
- }
466
-
467
- /// Parse a `{\\creatim ...}` or `{\\revtim ...}` RTF info block into ISO 8601 format.
468
- fn parse_rtf_datetime(segment: &str) -> Option<String> {
469
- let mut year: Option<i32> = None;
470
- let mut month: Option<i32> = None;
471
- let mut day: Option<i32> = None;
472
- let mut hour: Option<i32> = None;
473
- let mut minute: Option<i32> = None;
474
-
475
- let mut chars = segment.chars().peekable();
476
- while let Some(&ch) = chars.peek() {
477
- if ch != '\\' {
478
- chars.next();
479
- continue;
480
- }
481
- chars.next();
482
- let (word, value) = parse_rtf_control_word(&mut chars);
483
- if let Some(v) = value {
484
- match word.as_str() {
485
- "yr" => year = Some(v),
486
- "mo" => month = Some(v),
487
- "dy" => day = Some(v),
488
- "hr" => hour = Some(v),
489
- "min" => minute = Some(v),
490
- _ => {}
491
- }
492
- }
493
- }
494
-
495
- let year = year?;
496
- let month = month.unwrap_or(1).max(1) as u32;
497
- let day = day.unwrap_or(1).max(1) as u32;
498
- let hour = hour.unwrap_or(0).max(0) as u32;
499
- let minute = minute.unwrap_or(0).max(0) as u32;
500
-
501
- Some(format!(
502
- "{:04}-{:02}-{:02}T{:02}:{:02}:00Z",
503
- year, month, day, hour, minute
504
- ))
505
- }
506
-
507
- /// Extract metadata from the RTF `\\info` block and augment with computed statistics.
508
- fn extract_rtf_metadata(rtf_content: &str, extracted_text: &str) -> HashMap<String, Value> {
509
- let mut metadata: HashMap<String, Value> = HashMap::new();
510
-
511
- if let Some(start) = rtf_content.find("{\\info") {
512
- let slice = &rtf_content[start..];
513
- let mut depth = 0usize;
514
- let mut end_offset: Option<usize> = None;
515
-
516
- for (idx, ch) in slice.char_indices() {
517
- match ch {
518
- '{' => depth += 1,
519
- '}' => {
520
- if depth == 0 {
521
- break;
522
- }
523
- depth -= 1;
524
- if depth == 0 {
525
- end_offset = Some(idx + 1);
526
- break;
527
- }
528
- }
529
- _ => {}
530
- }
531
- }
532
-
533
- let info_block = end_offset.map(|end| &slice[..end]).unwrap_or(slice);
534
-
535
- let mut segments: Vec<String> = Vec::new();
536
- let mut seg_depth = 0usize;
537
- let mut current = String::new();
538
- let mut in_segment = false;
539
-
540
- for ch in info_block.chars() {
541
- if ch == '{' {
542
- seg_depth += 1;
543
- if seg_depth == 2 {
544
- in_segment = true;
545
- current.clear();
546
- continue;
547
- }
548
- } else if ch == '}' {
549
- if seg_depth == 2 && in_segment {
550
- segments.push(current.clone());
551
- in_segment = false;
552
- }
553
- seg_depth = seg_depth.saturating_sub(1);
554
- continue;
555
- }
556
-
557
- if in_segment {
558
- current.push(ch);
559
- }
560
- }
561
-
562
- for segment in segments {
563
- if !segment.starts_with('\\') {
564
- continue;
565
- }
566
-
567
- let cleaned_segment = if segment.starts_with("\\*\\") {
568
- segment.replacen("\\*\\", "\\", 1)
569
- } else {
570
- segment.clone()
571
- };
572
-
573
- let mut chars = cleaned_segment.chars().peekable();
574
- chars.next(); // consume the leading backslash
575
- let (keyword, numeric) = parse_rtf_control_word(&mut chars);
576
- let remaining: String = chars.collect();
577
- let trimmed = remaining.trim();
578
-
579
- match keyword.as_str() {
580
- "author" => {
581
- if !trimmed.is_empty() {
582
- let author = trimmed.to_string();
583
- metadata.insert("created_by".to_string(), Value::String(author.clone()));
584
- metadata.insert("authors".to_string(), Value::Array(vec![Value::String(author)]));
585
- }
586
- }
587
- "operator" => {
588
- if !trimmed.is_empty() {
589
- metadata.insert("modified_by".to_string(), Value::String(trimmed.to_string()));
590
- }
591
- }
592
- "title" => {
593
- if !trimmed.is_empty() {
594
- metadata.insert("title".to_string(), Value::String(trimmed.to_string()));
595
- }
596
- }
597
- "subject" => {
598
- if !trimmed.is_empty() {
599
- metadata.insert("subject".to_string(), Value::String(trimmed.to_string()));
600
- }
601
- }
602
- "generator" => {
603
- if !trimmed.is_empty() {
604
- metadata.insert("generator".to_string(), Value::String(trimmed.to_string()));
605
- }
606
- }
607
- "creatim" => {
608
- if let Some(dt) = parse_rtf_datetime(trimmed) {
609
- metadata.insert("created_at".to_string(), Value::String(dt));
610
- }
611
- }
612
- "revtim" => {
613
- if let Some(dt) = parse_rtf_datetime(trimmed) {
614
- metadata.insert("modified_at".to_string(), Value::String(dt));
615
- }
616
- }
617
- "version" => {
618
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
619
- metadata.insert("revision".to_string(), Value::String(val.to_string()));
620
- }
621
- }
622
- "nofpages" => {
623
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
624
- metadata.insert("page_count".to_string(), Value::Number(val.into()));
625
- }
626
- }
627
- "nofwords" => {
628
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
629
- metadata.insert("word_count".to_string(), Value::Number(val.into()));
630
- }
631
- }
632
- "nofchars" => {
633
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
634
- metadata.insert("character_count".to_string(), Value::Number(val.into()));
635
- }
636
- }
637
- "lines" => {
638
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
639
- metadata.insert("line_count".to_string(), Value::Number(val.into()));
640
- }
641
- }
642
- "paragraphs" => {
643
- if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
644
- metadata.insert("paragraph_count".to_string(), Value::Number(val.into()));
645
- }
646
- }
647
- _ => {}
648
- }
649
- }
650
- }
651
-
652
- let cleaned_text = extracted_text.trim();
653
- if !cleaned_text.is_empty() {
654
- let word_count = cleaned_text.split_whitespace().count() as i64;
655
- metadata
656
- .entry("word_count".to_string())
657
- .or_insert(Value::Number(word_count.into()));
658
-
659
- let character_count = cleaned_text.chars().count() as i64;
660
- metadata
661
- .entry("character_count".to_string())
662
- .or_insert(Value::Number(character_count.into()));
663
-
664
- let line_count = cleaned_text.lines().count() as i64;
665
- metadata
666
- .entry("line_count".to_string())
667
- .or_insert(Value::Number(line_count.into()));
668
-
669
- let paragraph_count = cleaned_text.split("\n\n").filter(|p| !p.trim().is_empty()).count() as i64;
670
- metadata
671
- .entry("paragraph_count".to_string())
672
- .or_insert(Value::Number(paragraph_count.into()));
673
- }
674
-
675
- metadata
676
- }
677
-
678
- /// Extract image metadata from within a \pict group.
679
- ///
680
- /// Looks for image type (jpegblip, pngblip, etc.) and dimensions.
681
- fn extract_image_metadata(chars: &mut std::iter::Peekable<std::str::Chars>) -> String {
682
- let mut metadata = String::new();
683
- let mut image_type: Option<&str> = None;
684
- let mut width_goal: Option<i32> = None;
685
- let mut height_goal: Option<i32> = None;
686
- let mut depth = 0;
687
-
688
- while let Some(&ch) = chars.peek() {
689
- match ch {
690
- '{' => {
691
- depth += 1;
692
- chars.next();
693
- }
694
- '}' => {
695
- if depth == 0 {
696
- break;
697
- }
698
- depth -= 1;
699
- chars.next();
700
- }
701
- '\\' => {
702
- chars.next();
703
- let (control_word, value) = parse_rtf_control_word(chars);
704
-
705
- match control_word.as_str() {
706
- "jpegblip" => image_type = Some("jpg"),
707
- "pngblip" => image_type = Some("png"),
708
- "wmetafile" => image_type = Some("wmf"),
709
- "dibitmap" => image_type = Some("bmp"),
710
- "picwgoal" => width_goal = value,
711
- "pichgoal" => height_goal = value,
712
- "bin" => break,
713
- _ => {}
714
- }
715
- }
716
- ' ' => {
717
- chars.next();
718
- }
719
- _ => {
720
- chars.next();
721
- }
722
- }
723
- }
724
-
725
- if let Some(itype) = image_type {
726
- metadata.push_str("image.");
727
- metadata.push_str(itype);
728
- }
729
-
730
- if let Some(width) = width_goal {
731
- let width_inches = f64::from(width) / 1440.0;
732
- metadata.push_str(&format!(" width=\"{:.1}in\"", width_inches));
733
- }
734
-
735
- if let Some(height) = height_goal {
736
- let height_inches = f64::from(height) / 1440.0;
737
- metadata.push_str(&format!(" height=\"{:.1}in\"", height_inches));
738
- }
739
-
740
- if metadata.is_empty() {
741
- metadata.push_str("image.jpg");
742
- }
743
-
744
- metadata
745
- }
746
-
747
- #[async_trait]
748
- impl DocumentExtractor for RtfExtractor {
749
- #[cfg_attr(feature = "otel", tracing::instrument(
750
- skip(self, content, _config),
751
- fields(
752
- extractor.name = self.name(),
753
- content.size_bytes = content.len(),
754
- )
755
- ))]
756
- async fn extract_bytes(
757
- &self,
758
- content: &[u8],
759
- mime_type: &str,
760
- _config: &ExtractionConfig,
761
- ) -> Result<ExtractionResult> {
762
- let rtf_content = String::from_utf8_lossy(content);
763
-
764
- let (extracted_text, tables) = extract_text_from_rtf(&rtf_content);
765
- let metadata_map = extract_rtf_metadata(&rtf_content, &extracted_text);
766
-
767
- Ok(ExtractionResult {
768
- content: extracted_text,
769
- mime_type: mime_type.to_string(),
770
- metadata: Metadata {
771
- additional: metadata_map,
772
- ..Default::default()
773
- },
774
- tables,
775
- detected_languages: None,
776
- chunks: None,
777
- images: None,
778
- })
779
- }
780
-
781
- fn supported_mime_types(&self) -> &[&str] {
782
- &["application/rtf", "text/rtf"]
783
- }
784
-
785
- fn priority(&self) -> i32 {
786
- 50
787
- }
788
- }
789
-
790
- #[cfg(test)]
791
- mod tests {
792
- use super::*;
793
-
794
- #[tokio::test]
795
- async fn test_rtf_extractor_plugin_interface() {
796
- let extractor = RtfExtractor::new();
797
- assert_eq!(extractor.name(), "rtf-extractor");
798
- assert_eq!(extractor.version(), env!("CARGO_PKG_VERSION"));
799
- assert!(extractor.supported_mime_types().contains(&"application/rtf"));
800
- assert_eq!(extractor.priority(), 50);
801
- }
802
-
803
- #[test]
804
- fn test_simple_rtf_extraction() {
805
- let _extractor = RtfExtractor;
806
- let rtf_content = r#"{\rtf1 Hello World}"#;
807
- let (extracted, _) = extract_text_from_rtf(rtf_content);
808
- assert!(extracted.contains("Hello") || extracted.contains("World"));
809
- }
810
- }
1
+ //! RTF (Rich Text Format) extractor.
2
+ //!
3
+ //! Supports: Rich Text Format (.rtf)
4
+ //!
5
+ //! This native Rust extractor provides text extraction from RTF documents with:
6
+ //! - Character encoding support (Windows-1252 for 0x80-0x9F range)
7
+ //! - Common RTF control words (paragraph breaks, tabs, bullets, quotes, dashes)
8
+ //! - Unicode escape sequences
9
+ //! - Image metadata extraction
10
+ //! - Whitespace normalization
11
+
12
+ use crate::Result;
13
+ use crate::core::config::ExtractionConfig;
14
+ use crate::extraction::cells_to_markdown;
15
+ use crate::plugins::{DocumentExtractor, Plugin};
16
+ use crate::types::{ExtractionResult, Metadata, Table};
17
+ use async_trait::async_trait;
18
+ use serde_json::Value;
19
+ use std::collections::HashMap;
20
+
21
+ /// Native Rust RTF extractor.
22
+ ///
23
+ /// Extracts text content, metadata, and structure from RTF documents
24
+ pub struct RtfExtractor;
25
+
26
+ impl RtfExtractor {
27
+ /// Create a new RTF extractor.
28
+ pub fn new() -> Self {
29
+ Self
30
+ }
31
+ }
32
+
33
+ impl Default for RtfExtractor {
34
+ fn default() -> Self {
35
+ Self::new()
36
+ }
37
+ }
38
+
39
+ impl Plugin for RtfExtractor {
40
+ fn name(&self) -> &str {
41
+ "rtf-extractor"
42
+ }
43
+
44
+ fn version(&self) -> String {
45
+ env!("CARGO_PKG_VERSION").to_string()
46
+ }
47
+
48
+ fn initialize(&self) -> Result<()> {
49
+ Ok(())
50
+ }
51
+
52
+ fn shutdown(&self) -> Result<()> {
53
+ Ok(())
54
+ }
55
+
56
+ fn description(&self) -> &str {
57
+ "Extracts content from RTF (Rich Text Format) files with native Rust parsing"
58
+ }
59
+
60
+ fn author(&self) -> &str {
61
+ "Kreuzberg Team"
62
+ }
63
+ }
64
+
65
+ /// Convert a hex digit character to its numeric value.
66
+ ///
67
+ /// Returns None if the character is not a valid hex digit.
68
+ #[inline]
69
+ fn hex_digit_to_u8(c: char) -> Option<u8> {
70
+ match c {
71
+ '0'..='9' => Some((c as u8) - b'0'),
72
+ 'a'..='f' => Some((c as u8) - b'a' + 10),
73
+ 'A'..='F' => Some((c as u8) - b'A' + 10),
74
+ _ => None,
75
+ }
76
+ }
77
+
78
+ /// Parse a hex-encoded byte from two characters.
79
+ ///
80
+ /// Returns the decoded byte if both characters are valid hex digits.
81
+ #[inline]
82
+ fn parse_hex_byte(h1: char, h2: char) -> Option<u8> {
83
+ let high = hex_digit_to_u8(h1)?;
84
+ let low = hex_digit_to_u8(h2)?;
85
+ Some((high << 4) | low)
86
+ }
87
+
88
+ /// Parse an RTF control word and extract its value.
89
+ ///
90
+ /// Returns a tuple of (control_word, optional_numeric_value)
91
+ fn parse_rtf_control_word(chars: &mut std::iter::Peekable<std::str::Chars>) -> (String, Option<i32>) {
92
+ let mut word = String::new();
93
+ let mut num_str = String::new();
94
+ let mut is_negative = false;
95
+
96
+ while let Some(&c) = chars.peek() {
97
+ if c.is_alphabetic() {
98
+ word.push(c);
99
+ chars.next();
100
+ } else {
101
+ break;
102
+ }
103
+ }
104
+
105
+ if let Some(&c) = chars.peek()
106
+ && c == '-'
107
+ {
108
+ is_negative = true;
109
+ chars.next();
110
+ }
111
+
112
+ while let Some(&c) = chars.peek() {
113
+ if c.is_ascii_digit() {
114
+ num_str.push(c);
115
+ chars.next();
116
+ } else {
117
+ break;
118
+ }
119
+ }
120
+
121
+ let num_value = if !num_str.is_empty() {
122
+ let val = num_str.parse::<i32>().unwrap_or(0);
123
+ Some(if is_negative { -val } else { val })
124
+ } else {
125
+ None
126
+ };
127
+
128
+ (word, num_value)
129
+ }
130
+
131
+ /// Extract text and image metadata from RTF document.
132
+ ///
133
+ /// This function extracts plain text from an RTF document by:
134
+ /// 1. Tokenizing control sequences and text
135
+ /// 2. Converting encoded characters to Unicode
136
+ /// 3. Extracting text while skipping formatting groups
137
+ /// 4. Detecting and extracting image metadata (\pict sections)
138
+ /// 5. Normalizing whitespace
139
+ fn extract_text_from_rtf(content: &str) -> (String, Vec<Table>) {
140
+ struct TableState {
141
+ rows: Vec<Vec<String>>,
142
+ current_row: Vec<String>,
143
+ current_cell: String,
144
+ in_row: bool,
145
+ }
146
+
147
+ fn push_cell(state: &mut TableState) {
148
+ let cell = state.current_cell.trim().to_string();
149
+ state.current_row.push(cell);
150
+ state.current_cell.clear();
151
+ }
152
+
153
+ fn push_row(state: &mut TableState) {
154
+ if state.in_row || !state.current_cell.is_empty() {
155
+ push_cell(state);
156
+ state.in_row = false;
157
+ }
158
+ if !state.current_row.is_empty() {
159
+ state.rows.push(state.current_row.clone());
160
+ state.current_row.clear();
161
+ }
162
+ }
163
+
164
+ fn finalize_table(state_opt: &mut Option<TableState>, tables: &mut Vec<Table>) {
165
+ if let Some(mut state) = state_opt.take() {
166
+ if state.in_row || !state.current_cell.is_empty() || !state.current_row.is_empty() {
167
+ push_row(&mut state);
168
+ }
169
+ if !state.rows.is_empty() {
170
+ let markdown = cells_to_markdown(&state.rows);
171
+ tables.push(Table {
172
+ cells: state.rows,
173
+ markdown,
174
+ page_number: 1,
175
+ });
176
+ }
177
+ }
178
+ }
179
+
180
+ let mut result = String::new();
181
+ let mut chars = content.chars().peekable();
182
+ let mut tables: Vec<Table> = Vec::new();
183
+ let mut table_state: Option<TableState> = None;
184
+
185
+ let ensure_table = |table_state: &mut Option<TableState>| {
186
+ if table_state.is_none() {
187
+ *table_state = Some(TableState {
188
+ rows: Vec::new(),
189
+ current_row: Vec::new(),
190
+ current_cell: String::new(),
191
+ in_row: false,
192
+ });
193
+ }
194
+ };
195
+
196
+ while let Some(ch) = chars.next() {
197
+ match ch {
198
+ '\\' => {
199
+ if let Some(&next_ch) = chars.peek() {
200
+ match next_ch {
201
+ '\\' | '{' | '}' => {
202
+ chars.next();
203
+ result.push(next_ch);
204
+ }
205
+ '\'' => {
206
+ chars.next();
207
+ let hex1 = chars.next();
208
+ let hex2 = chars.next();
209
+ if let (Some(h1), Some(h2)) = (hex1, hex2)
210
+ && let Some(byte) = parse_hex_byte(h1, h2)
211
+ {
212
+ let decoded = match byte {
213
+ 0x80 => '\u{20AC}',
214
+ 0x81 => '?',
215
+ 0x82 => '\u{201A}',
216
+ 0x83 => '\u{0192}',
217
+ 0x84 => '\u{201E}',
218
+ 0x85 => '\u{2026}',
219
+ 0x86 => '\u{2020}',
220
+ 0x87 => '\u{2021}',
221
+ 0x88 => '\u{02C6}',
222
+ 0x89 => '\u{2030}',
223
+ 0x8A => '\u{0160}',
224
+ 0x8B => '\u{2039}',
225
+ 0x8C => '\u{0152}',
226
+ 0x8D => '?',
227
+ 0x8E => '\u{017D}',
228
+ 0x8F => '?',
229
+ 0x90 => '?',
230
+ 0x91 => '\u{2018}',
231
+ 0x92 => '\u{2019}',
232
+ 0x93 => '\u{201C}',
233
+ 0x94 => '\u{201D}',
234
+ 0x95 => '\u{2022}',
235
+ 0x96 => '\u{2013}',
236
+ 0x97 => '\u{2014}',
237
+ 0x98 => '\u{02DC}',
238
+ 0x99 => '\u{2122}',
239
+ 0x9A => '\u{0161}',
240
+ 0x9B => '\u{203A}',
241
+ 0x9C => '\u{0153}',
242
+ 0x9D => '?',
243
+ 0x9E => '\u{017E}',
244
+ 0x9F => '\u{0178}',
245
+ _ => byte as char,
246
+ };
247
+ result.push(decoded);
248
+ if let Some(state) = table_state.as_mut()
249
+ && state.in_row
250
+ {
251
+ state.current_cell.push(decoded);
252
+ }
253
+ }
254
+ }
255
+ 'u' => {
256
+ chars.next();
257
+ let mut num_str = String::new();
258
+ while let Some(&c) = chars.peek() {
259
+ if c.is_ascii_digit() || c == '-' {
260
+ num_str.push(c);
261
+ chars.next();
262
+ } else {
263
+ break;
264
+ }
265
+ }
266
+ if let Ok(code_num) = num_str.parse::<i32>() {
267
+ let code_u = if code_num < 0 {
268
+ (code_num + 65536) as u32
269
+ } else {
270
+ code_num as u32
271
+ };
272
+ if let Some(c) = char::from_u32(code_u) {
273
+ result.push(c);
274
+ if let Some(state) = table_state.as_mut()
275
+ && state.in_row
276
+ {
277
+ state.current_cell.push(c);
278
+ }
279
+ }
280
+ }
281
+ }
282
+ _ => {
283
+ let (control_word, _) = parse_rtf_control_word(&mut chars);
284
+
285
+ match control_word.as_str() {
286
+ "pict" => {
287
+ let image_metadata = extract_image_metadata(&mut chars);
288
+ if !image_metadata.is_empty() {
289
+ result.push('!');
290
+ result.push('[');
291
+ result.push_str("image");
292
+ result.push(']');
293
+ result.push('(');
294
+ result.push_str(&image_metadata);
295
+ result.push(')');
296
+ result.push(' ');
297
+ if let Some(state) = table_state.as_mut()
298
+ && state.in_row
299
+ {
300
+ state.current_cell.push('!');
301
+ state.current_cell.push('[');
302
+ state.current_cell.push_str("image");
303
+ state.current_cell.push(']');
304
+ state.current_cell.push('(');
305
+ state.current_cell.push_str(&image_metadata);
306
+ state.current_cell.push(')');
307
+ state.current_cell.push(' ');
308
+ }
309
+ }
310
+ }
311
+ "par" => {
312
+ if table_state.is_some() {
313
+ finalize_table(&mut table_state, &mut tables);
314
+ }
315
+ if !result.is_empty() && !result.ends_with('\n') {
316
+ result.push('\n');
317
+ result.push('\n');
318
+ }
319
+ }
320
+ "tab" => {
321
+ result.push('\t');
322
+ if let Some(state) = table_state.as_mut()
323
+ && state.in_row
324
+ {
325
+ state.current_cell.push('\t');
326
+ }
327
+ }
328
+ "bullet" => {
329
+ result.push('•');
330
+ }
331
+ "lquote" => {
332
+ result.push('\u{2018}');
333
+ }
334
+ "rquote" => {
335
+ result.push('\u{2019}');
336
+ }
337
+ "ldblquote" => {
338
+ result.push('\u{201C}');
339
+ }
340
+ "rdblquote" => {
341
+ result.push('\u{201D}');
342
+ }
343
+ "endash" => {
344
+ result.push('\u{2013}');
345
+ }
346
+ "emdash" => {
347
+ result.push('\u{2014}');
348
+ }
349
+ "trowd" => {
350
+ ensure_table(&mut table_state);
351
+ if let Some(state) = table_state.as_mut() {
352
+ if state.in_row {
353
+ push_row(state);
354
+ }
355
+ state.in_row = true;
356
+ state.current_cell.clear();
357
+ state.current_row.clear();
358
+ }
359
+ if !result.is_empty() && !result.ends_with('\n') {
360
+ result.push('\n');
361
+ }
362
+ if !result.ends_with('|') {
363
+ result.push('|');
364
+ result.push(' ');
365
+ }
366
+ }
367
+ "cell" => {
368
+ if !result.ends_with('|') {
369
+ if !result.ends_with(' ') && !result.is_empty() {
370
+ result.push(' ');
371
+ }
372
+ result.push('|');
373
+ }
374
+ if !result.ends_with(' ') {
375
+ result.push(' ');
376
+ }
377
+ }
378
+ "row" => {
379
+ ensure_table(&mut table_state);
380
+ if let Some(state) = table_state.as_mut()
381
+ && (state.in_row || !state.current_cell.is_empty())
382
+ {
383
+ push_row(state);
384
+ }
385
+ if !result.ends_with('|') {
386
+ result.push('|');
387
+ }
388
+ if !result.ends_with('\n') {
389
+ result.push('\n');
390
+ }
391
+ if let Some(state) = table_state.as_ref()
392
+ && !state.in_row
393
+ && !state.rows.is_empty()
394
+ {}
395
+ }
396
+ _ => {}
397
+ }
398
+ }
399
+ }
400
+ }
401
+ }
402
+ '{' | '}' => {
403
+ if !result.is_empty() && !result.ends_with(' ') {
404
+ result.push(' ');
405
+ }
406
+ }
407
+ ' ' | '\t' | '\n' | '\r' => {
408
+ if !result.is_empty() && !result.ends_with(' ') {
409
+ result.push(' ');
410
+ }
411
+ if let Some(state) = table_state.as_mut()
412
+ && state.in_row
413
+ && !state.current_cell.ends_with(' ')
414
+ {
415
+ state.current_cell.push(' ');
416
+ }
417
+ }
418
+ _ => {
419
+ if let Some(state) = table_state.as_ref()
420
+ && !state.in_row
421
+ && !state.rows.is_empty()
422
+ {
423
+ finalize_table(&mut table_state, &mut tables);
424
+ }
425
+ result.push(ch);
426
+ if let Some(state) = table_state.as_mut()
427
+ && state.in_row
428
+ {
429
+ state.current_cell.push(ch);
430
+ }
431
+ }
432
+ }
433
+ }
434
+
435
+ if table_state.is_some() {
436
+ finalize_table(&mut table_state, &mut tables);
437
+ }
438
+
439
+ (normalize_whitespace(&result), tables)
440
+ }
441
+
442
+ /// Normalize whitespace in a string using a single-pass algorithm.
443
+ ///
444
+ /// Collapses multiple consecutive whitespace characters into single spaces
445
+ /// and trims leading/trailing whitespace.
446
+ fn normalize_whitespace(s: &str) -> String {
447
+ let mut result = String::with_capacity(s.len());
448
+ let mut last_was_space = false;
449
+
450
+ for ch in s.chars() {
451
+ if ch.is_whitespace() {
452
+ if !last_was_space {
453
+ result.push(' ');
454
+ last_was_space = true;
455
+ }
456
+ } else {
457
+ result.push(ch);
458
+ last_was_space = false;
459
+ }
460
+ }
461
+
462
+ result.trim().to_string()
463
+ }
464
+
465
+ /// Parse a `{\\creatim ...}` or `{\\revtim ...}` RTF info block into ISO 8601 format.
466
+ fn parse_rtf_datetime(segment: &str) -> Option<String> {
467
+ let mut year: Option<i32> = None;
468
+ let mut month: Option<i32> = None;
469
+ let mut day: Option<i32> = None;
470
+ let mut hour: Option<i32> = None;
471
+ let mut minute: Option<i32> = None;
472
+
473
+ let mut chars = segment.chars().peekable();
474
+ while let Some(&ch) = chars.peek() {
475
+ if ch != '\\' {
476
+ chars.next();
477
+ continue;
478
+ }
479
+ chars.next();
480
+ let (word, value) = parse_rtf_control_word(&mut chars);
481
+ if let Some(v) = value {
482
+ match word.as_str() {
483
+ "yr" => year = Some(v),
484
+ "mo" => month = Some(v),
485
+ "dy" => day = Some(v),
486
+ "hr" => hour = Some(v),
487
+ "min" => minute = Some(v),
488
+ _ => {}
489
+ }
490
+ }
491
+ }
492
+
493
+ let year = year?;
494
+ let month = month.unwrap_or(1).max(1) as u32;
495
+ let day = day.unwrap_or(1).max(1) as u32;
496
+ let hour = hour.unwrap_or(0).max(0) as u32;
497
+ let minute = minute.unwrap_or(0).max(0) as u32;
498
+
499
+ Some(format!(
500
+ "{:04}-{:02}-{:02}T{:02}:{:02}:00Z",
501
+ year, month, day, hour, minute
502
+ ))
503
+ }
504
+
505
+ /// Extract metadata from the RTF `\\info` block and augment with computed statistics.
506
+ fn extract_rtf_metadata(rtf_content: &str, extracted_text: &str) -> HashMap<String, Value> {
507
+ let mut metadata: HashMap<String, Value> = HashMap::new();
508
+
509
+ if let Some(start) = rtf_content.find("{\\info") {
510
+ let slice = &rtf_content[start..];
511
+ let mut depth = 0usize;
512
+ let mut end_offset: Option<usize> = None;
513
+
514
+ for (idx, ch) in slice.char_indices() {
515
+ match ch {
516
+ '{' => depth += 1,
517
+ '}' => {
518
+ if depth == 0 {
519
+ break;
520
+ }
521
+ depth -= 1;
522
+ if depth == 0 {
523
+ end_offset = Some(idx + 1);
524
+ break;
525
+ }
526
+ }
527
+ _ => {}
528
+ }
529
+ }
530
+
531
+ let info_block = end_offset.map(|end| &slice[..end]).unwrap_or(slice);
532
+
533
+ let mut segments: Vec<String> = Vec::new();
534
+ let mut seg_depth = 0usize;
535
+ let mut current = String::new();
536
+ let mut in_segment = false;
537
+
538
+ for ch in info_block.chars() {
539
+ if ch == '{' {
540
+ seg_depth += 1;
541
+ if seg_depth == 2 {
542
+ in_segment = true;
543
+ current.clear();
544
+ continue;
545
+ }
546
+ } else if ch == '}' {
547
+ if seg_depth == 2 && in_segment {
548
+ segments.push(current.clone());
549
+ in_segment = false;
550
+ }
551
+ seg_depth = seg_depth.saturating_sub(1);
552
+ continue;
553
+ }
554
+
555
+ if in_segment {
556
+ current.push(ch);
557
+ }
558
+ }
559
+
560
+ for segment in segments {
561
+ if !segment.starts_with('\\') {
562
+ continue;
563
+ }
564
+
565
+ let cleaned_segment = if segment.starts_with("\\*\\") {
566
+ segment.replacen("\\*\\", "\\", 1)
567
+ } else {
568
+ segment.clone()
569
+ };
570
+
571
+ let mut chars = cleaned_segment.chars().peekable();
572
+ chars.next();
573
+ let (keyword, numeric) = parse_rtf_control_word(&mut chars);
574
+ let remaining: String = chars.collect();
575
+ let trimmed = remaining.trim();
576
+
577
+ match keyword.as_str() {
578
+ "author" => {
579
+ if !trimmed.is_empty() {
580
+ let author = trimmed.to_string();
581
+ metadata.insert("created_by".to_string(), Value::String(author.clone()));
582
+ metadata.insert("authors".to_string(), Value::Array(vec![Value::String(author)]));
583
+ }
584
+ }
585
+ "operator" => {
586
+ if !trimmed.is_empty() {
587
+ metadata.insert("modified_by".to_string(), Value::String(trimmed.to_string()));
588
+ }
589
+ }
590
+ "title" => {
591
+ if !trimmed.is_empty() {
592
+ metadata.insert("title".to_string(), Value::String(trimmed.to_string()));
593
+ }
594
+ }
595
+ "subject" => {
596
+ if !trimmed.is_empty() {
597
+ metadata.insert("subject".to_string(), Value::String(trimmed.to_string()));
598
+ }
599
+ }
600
+ "generator" => {
601
+ if !trimmed.is_empty() {
602
+ metadata.insert("generator".to_string(), Value::String(trimmed.to_string()));
603
+ }
604
+ }
605
+ "creatim" => {
606
+ if let Some(dt) = parse_rtf_datetime(trimmed) {
607
+ metadata.insert("created_at".to_string(), Value::String(dt));
608
+ }
609
+ }
610
+ "revtim" => {
611
+ if let Some(dt) = parse_rtf_datetime(trimmed) {
612
+ metadata.insert("modified_at".to_string(), Value::String(dt));
613
+ }
614
+ }
615
+ "version" => {
616
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
617
+ metadata.insert("revision".to_string(), Value::String(val.to_string()));
618
+ }
619
+ }
620
+ "nofpages" => {
621
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
622
+ metadata.insert("page_count".to_string(), Value::Number(val.into()));
623
+ }
624
+ }
625
+ "nofwords" => {
626
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
627
+ metadata.insert("word_count".to_string(), Value::Number(val.into()));
628
+ }
629
+ }
630
+ "nofchars" => {
631
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
632
+ metadata.insert("character_count".to_string(), Value::Number(val.into()));
633
+ }
634
+ }
635
+ "lines" => {
636
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
637
+ metadata.insert("line_count".to_string(), Value::Number(val.into()));
638
+ }
639
+ }
640
+ "paragraphs" => {
641
+ if let Some(val) = numeric.or_else(|| trimmed.parse::<i32>().ok()) {
642
+ metadata.insert("paragraph_count".to_string(), Value::Number(val.into()));
643
+ }
644
+ }
645
+ _ => {}
646
+ }
647
+ }
648
+ }
649
+
650
+ let cleaned_text = extracted_text.trim();
651
+ if !cleaned_text.is_empty() {
652
+ let word_count = cleaned_text.split_whitespace().count() as i64;
653
+ metadata
654
+ .entry("word_count".to_string())
655
+ .or_insert(Value::Number(word_count.into()));
656
+
657
+ let character_count = cleaned_text.chars().count() as i64;
658
+ metadata
659
+ .entry("character_count".to_string())
660
+ .or_insert(Value::Number(character_count.into()));
661
+
662
+ let line_count = cleaned_text.lines().count() as i64;
663
+ metadata
664
+ .entry("line_count".to_string())
665
+ .or_insert(Value::Number(line_count.into()));
666
+
667
+ let paragraph_count = cleaned_text.split("\n\n").filter(|p| !p.trim().is_empty()).count() as i64;
668
+ metadata
669
+ .entry("paragraph_count".to_string())
670
+ .or_insert(Value::Number(paragraph_count.into()));
671
+ }
672
+
673
+ metadata
674
+ }
675
+
676
+ /// Extract image metadata from within a \pict group.
677
+ ///
678
+ /// Looks for image type (jpegblip, pngblip, etc.) and dimensions.
679
+ fn extract_image_metadata(chars: &mut std::iter::Peekable<std::str::Chars>) -> String {
680
+ let mut metadata = String::new();
681
+ let mut image_type: Option<&str> = None;
682
+ let mut width_goal: Option<i32> = None;
683
+ let mut height_goal: Option<i32> = None;
684
+ let mut depth = 0;
685
+
686
+ while let Some(&ch) = chars.peek() {
687
+ match ch {
688
+ '{' => {
689
+ depth += 1;
690
+ chars.next();
691
+ }
692
+ '}' => {
693
+ if depth == 0 {
694
+ break;
695
+ }
696
+ depth -= 1;
697
+ chars.next();
698
+ }
699
+ '\\' => {
700
+ chars.next();
701
+ let (control_word, value) = parse_rtf_control_word(chars);
702
+
703
+ match control_word.as_str() {
704
+ "jpegblip" => image_type = Some("jpg"),
705
+ "pngblip" => image_type = Some("png"),
706
+ "wmetafile" => image_type = Some("wmf"),
707
+ "dibitmap" => image_type = Some("bmp"),
708
+ "picwgoal" => width_goal = value,
709
+ "pichgoal" => height_goal = value,
710
+ "bin" => break,
711
+ _ => {}
712
+ }
713
+ }
714
+ ' ' => {
715
+ chars.next();
716
+ }
717
+ _ => {
718
+ chars.next();
719
+ }
720
+ }
721
+ }
722
+
723
+ if let Some(itype) = image_type {
724
+ metadata.push_str("image.");
725
+ metadata.push_str(itype);
726
+ }
727
+
728
+ if let Some(width) = width_goal {
729
+ let width_inches = f64::from(width) / 1440.0;
730
+ metadata.push_str(&format!(" width=\"{:.1}in\"", width_inches));
731
+ }
732
+
733
+ if let Some(height) = height_goal {
734
+ let height_inches = f64::from(height) / 1440.0;
735
+ metadata.push_str(&format!(" height=\"{:.1}in\"", height_inches));
736
+ }
737
+
738
+ if metadata.is_empty() {
739
+ metadata.push_str("image.jpg");
740
+ }
741
+
742
+ metadata
743
+ }
744
+
745
+ #[async_trait]
746
+ impl DocumentExtractor for RtfExtractor {
747
+ #[cfg_attr(feature = "otel", tracing::instrument(
748
+ skip(self, content, _config),
749
+ fields(
750
+ extractor.name = self.name(),
751
+ content.size_bytes = content.len(),
752
+ )
753
+ ))]
754
+ async fn extract_bytes(
755
+ &self,
756
+ content: &[u8],
757
+ mime_type: &str,
758
+ _config: &ExtractionConfig,
759
+ ) -> Result<ExtractionResult> {
760
+ let rtf_content = String::from_utf8_lossy(content);
761
+
762
+ let (extracted_text, tables) = extract_text_from_rtf(&rtf_content);
763
+ let metadata_map = extract_rtf_metadata(&rtf_content, &extracted_text);
764
+
765
+ Ok(ExtractionResult {
766
+ content: extracted_text,
767
+ mime_type: mime_type.to_string(),
768
+ metadata: Metadata {
769
+ additional: metadata_map,
770
+ ..Default::default()
771
+ },
772
+ pages: None,
773
+ tables,
774
+ detected_languages: None,
775
+ chunks: None,
776
+ images: None,
777
+ })
778
+ }
779
+
780
+ fn supported_mime_types(&self) -> &[&str] {
781
+ &["application/rtf", "text/rtf"]
782
+ }
783
+
784
+ fn priority(&self) -> i32 {
785
+ 50
786
+ }
787
+ }
788
+
789
+ #[cfg(test)]
790
+ mod tests {
791
+ use super::*;
792
+
793
+ #[tokio::test]
794
+ async fn test_rtf_extractor_plugin_interface() {
795
+ let extractor = RtfExtractor::new();
796
+ assert_eq!(extractor.name(), "rtf-extractor");
797
+ assert_eq!(extractor.version(), env!("CARGO_PKG_VERSION"));
798
+ assert!(extractor.supported_mime_types().contains(&"application/rtf"));
799
+ assert_eq!(extractor.priority(), 50);
800
+ }
801
+
802
+ #[test]
803
+ fn test_simple_rtf_extraction() {
804
+ let _extractor = RtfExtractor;
805
+ let rtf_content = r#"{\rtf1 Hello World}"#;
806
+ let (extracted, _) = extract_text_from_rtf(rtf_content);
807
+ assert!(extracted.contains("Hello") || extracted.contains("World"));
808
+ }
809
+ }