query-stream 1.2.2 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3f3bc788221f5c37fb1327f132501ec5fe4607e97f3e673ddbc2a32dfeeb188
-  data.tar.gz: 9111b6651c0596097399b9ffb46f8acea17928dd572f3a7af38ef167ddd6a037
+  metadata.gz: 4535df4515bcf03c03c770986f6d62b62e475b6cac1803fdd15c3b5885f1d393
+  data.tar.gz: 442dedf0baacf24a92f95a22fb5bab4de2086aebcf0b26d6affc724577fb7140
 SHA512:
-  metadata.gz: 792bbe4684efb730c7d1f122ecdf6cff9dfbaa484254f7bf9830b47790978cba0a5150939845975e07fdd2ac9d24e464a66b2f17ee7085e4e8097f041fecb105
-  data.tar.gz: e3de3485e7fdb0f5bdb9d8f728ee2742387540c342f82a27765b80282d9dff1b337a680f419467440fdfbf9b201dfc27414d43110f0f37864e097de36d4f1c04
+  metadata.gz: 0c5ae30a471b7b3c8921ff20fa3e764cb3852f1385a74679cd3c52ace1f3ffe0ee89a43b55fc915123757dee0fe55f0bfa960b49edf5f6d0605db4b49b6f2350
+  data.tar.gz: 7295c55fb86e7fc8dd344a615e0f87f554e23808e05060368af37579380262c394fd7fa413074e23468d268e9049082bbc31b95f3d3d9d2f206a13e89bfea483

data/lib/query_stream/configuration.rb

@@ -25,11 +25,17 @@ module QueryStream
     # @return [Logger] ログ出力先
     attr_accessor :logger
 
+    # 1 記法の展開結果を、コンテキスト付きで呼び出し元へ通す後段フィルタ。
+    # gem 自身は用途を規定しない（画像パス解決など呼び出し元固有の後処理を担わせる）。
+    # @return [Proc, nil] (text, context) -> String。String 以外を返した場合は元の展開結果を採用する
+    attr_accessor :post_render
+
     def initialize
       @data_dir       = 'data'
       @templates_dir  = 'templates'
       @default_format = :md
       @logger         = Logger.new($stdout)
+      @post_render    = nil
     end
   end
 end

data/lib/query_stream/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module QueryStream
-  VERSION = '1.2.2'
+  VERSION = '1.3.0'
 end

data/lib/query_stream.rb

@@ -57,10 +57,13 @@ module QueryStream
     # @param templates_dir [String, nil] テンプレートディレクトリ（nil時はconfigを使用）
     # @param on_error [Proc, nil] エラー時コールバック。|exception| を受け取る。省略時は何もしない。
     # @param on_warning [Proc, nil] 警告時コールバック。|warning| を受け取る。省略時は何もしない。
+    # @param post_render [Proc, nil] 展開結果の後段フィルタ。(text, context) -> String。省略時は configuration.post_render を使う。
     # @return [String] 展開後のテキストコンテンツ
-    def render(content, source_filename: nil, data_dir: nil, templates_dir: nil, on_error: nil, on_warning: nil)
+    def render(content, source_filename: nil, data_dir: nil, templates_dir: nil, on_error: nil, on_warning: nil,
+               post_render: nil)
       data_dir      ||= configuration.data_dir
       templates_dir ||= configuration.templates_dir
+      post_render   ||= configuration.post_render
 
       lines = content.lines
       result = []
@@ -85,7 +88,7 @@ module QueryStream
         if line.match?(QUERY_STREAM_PATTERN)
           begin
             expanded = render_query(
-              line.chomp, line_number:, source_filename:, data_dir:, templates_dir:, on_warning:
+              line.chomp, line_number:, source_filename:, data_dir:, templates_dir:, on_warning:, post_render:
             )
             result << expanded << "\n"
           rescue Error => e
@@ -107,8 +110,10 @@ module QueryStream
     # @param source_filename [String, nil] ソースファイル名
     # @param data_dir [String, nil] データディレクトリ
     # @param templates_dir [String, nil] テンプレートディレクトリ
+    # @param post_render [Proc, nil] 展開結果の後段フィルタ。(text, context) -> String
     # @return [String] 展開後のテキスト
-    def render_query(query, line_number: nil, source_filename: nil, data_dir: nil, templates_dir: nil, on_warning: nil)
+    def render_query(query, line_number: nil, source_filename: nil, data_dir: nil, templates_dir: nil, on_warning: nil,
+                     post_render: nil)
       data_dir      ||= configuration.data_dir
       templates_dir ||= configuration.templates_dir
       location = source_filename ? "#{source_filename}:#{line_number}" : "行#{line_number}"
@@ -178,7 +183,23 @@ module QueryStream
       template_content = File.read(template_path, encoding: 'utf-8')
 
       # --- Phase: Render ---
-      TemplateCompiler.render(template_content, records, source_filename:, line_number:)
+      rendered = TemplateCompiler.render(template_content, records, source_filename:, line_number:)
+
+      # --- Phase: Post-render filter ---
+      # 展開結果を呼び出し元の後段フィルタへ通す（画像パス解決など gem 外の後処理）。
+      # コールバックが String 以外を返した場合は安全側に倒して元の展開結果を採用する。
+      return rendered unless post_render
+
+      context = {
+        source:        parsed[:source],   # 記法に書かれた論理名（例: "physics_book"）
+        data_file:     data_file,          # 単複解決後の実パス（例: "data/physics_books.yml"）
+        data_dir:      data_dir,
+        template_path: template_path,
+        query:         query,
+        location:      location            # "filename:line" 形式
+      }
+      result = post_render.call(rendered, context)
+      result.is_a?(String) ? result : rendered
     end
 
     # テキスト内の QueryStream 記法を検出してリストを返す

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: query-stream
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.3.0
 platform: ruby
 authors:
 - Atelier Mirai
@@ -124,7 +124,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: QueryStream - YAML/JSON data renderer with template expansion
 test_files: []