Re:VIEW AST/Rendererアーキテクチャーの追加提案

Gemfile

@@ -4,3 +4,10 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in review.gemspec
 gemspec
+
+# Development dependencies
+group :development do
+  # markly gem (for Markdown support) requires Ruby >= 3.1
+  # On Ruby 3.0, tests will be skipped but Re:VIEW will work with .re files
+  gem 'markly', '~> 0.13' if Gem.ruby_version >= Gem::Version.new('3.1.0')
+end

bin/review-ast-compile

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.realpath('../lib', __dir__))
+
+require 'review/ast/command/compile'
+
+exit ReVIEW::AST::Command::Compile.new.run(ARGV)

bin/review-ast-dump

@@ -0,0 +1,106 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/init'
+require 'review/ast/dumper'
+require 'review/ast/json_serializer'
+require 'optparse'
+
+def parse_options
+  config = ReVIEW::Configure.values
+  output_file = nil
+  serializer_options = ReVIEW::AST::JSONSerializer::Options.new
+
+  opts = OptionParser.new
+  opts.version = ReVIEW::VERSION
+  opts.banner = "Usage: #{File.basename($PROGRAM_NAME, '.*')} [options] CHAPTER.re\n" \
+                'Dump Re:VIEW document as AST in JSON format'
+
+  opts.on('-c', '--config=FILE', 'specify config file') do |file|
+    config.deep_merge!(ReVIEW::Configure.create(yamlfile: file).values)
+  end
+
+  opts.on('-o', '--output=FILE', 'output to FILE instead of stdout') do |file|
+    output_file = file
+  end
+
+  opts.on('--[no-]pretty', 'pretty print JSON (default: true)') do |v|
+    serializer_options.pretty = v
+  end
+
+  opts.on('--[no-]location', 'include location information (default: true)') do |v|
+    serializer_options.include_location = v
+  end
+
+  opts.on('--indent=INDENT', 'indentation for pretty print (default: "  ")') do |v|
+    serializer_options.indent = v
+  end
+
+  opts.on('--compact', 'compact output (no location, no pretty print)') do
+    serializer_options.pretty = false
+    serializer_options.include_location = false
+  end
+
+  opts.on('--help', 'print help and exit') do
+    puts opts.help
+    exit 0
+  end
+
+  begin
+    opts.parse!
+  rescue OptionParser::InvalidOption => e
+    $stderr.puts e.message
+    $stderr.puts opts.help
+    exit 1
+  end
+
+  if ARGV.empty?
+    $stderr.puts 'No input files.'
+    $stderr.puts opts.help
+    exit 1
+  end
+
+  [config, output_file, serializer_options]
+end
+
+def dump_files(dumper, output_file)
+  ARGV.each do |path|
+    output = dumper.dump_file(path)
+
+    if output_file
+      File.write(output_file, output)
+      $stderr.puts "Output written to: #{output_file}"
+    else
+      puts output
+    end
+  end
+end
+
+def main
+  config, output_file, serializer_options = parse_options
+  dumper = ReVIEW::AST::Dumper.new(config: config, serializer_options: serializer_options)
+
+  begin
+    dump_files(dumper, output_file)
+  rescue ReVIEW::ApplicationError, ReVIEW::FileNotFound => e
+    $stderr.puts "Error: #{e.message}"
+    exit 1
+  rescue StandardError => e
+    $stderr.puts "Fatal error: #{e.class}: #{e.message}"
+    $stderr.puts e.backtrace if $DEBUG
+    exit 1
+  end
+end
+
+main

bin/review-ast-dump2re

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/init'
+require 'review/ast'
+require 'review/ast/json_serializer'
+require 'review/ast/review_generator'
+require 'optparse'
+require 'json'
+
+def main
+  options = {
+    output: nil
+  }
+
+  parser = OptionParser.new do |opts|
+    opts.banner = 'Usage: review-ast2re [options] FILE'
+    opts.version = ReVIEW::VERSION
+
+    opts.on('-o', '--output FILE', 'Output file (default: stdout)') do |file|
+      options[:output] = file
+    end
+
+    opts.on_tail('-h', '--help', 'Show this message') do
+      puts opts
+      exit
+    end
+  end
+
+  begin
+    parser.parse!
+  rescue OptionParser::InvalidOption => e
+    $stderr.puts "Error: #{e.message}"
+    puts parser
+    exit 1
+  end
+
+  if ARGV.empty? && $stdin.tty?
+    $stderr.puts 'Error: No input file specified'
+    puts parser
+    exit 1
+  end
+
+  input_file = ARGV[0] || '-'
+
+  # Read JSON AST
+  begin
+    if input_file == '-'
+      json_data = $stdin.read
+    else
+      unless File.exist?(input_file)
+        $stderr.puts "Error: Input file not found: #{input_file}"
+        exit 1
+      end
+      json_data = File.read(input_file)
+    end
+  rescue StandardError => e
+    $stderr.puts "Error reading input file: #{e.message}"
+    exit 1
+  end
+
+  # Deserialize JSON to AST
+  begin
+    ast_root = ReVIEW::AST::JSONSerializer.deserialize(json_data)
+  rescue JSON::ParserError => e
+    $stderr.puts "Error parsing JSON: #{e.message}"
+    exit 1
+  rescue StandardError => e
+    $stderr.puts "Error deserializing AST: #{e.message}"
+    exit 1
+  end
+
+  # Generate Re:VIEW text
+  begin
+    generator = ReVIEW::AST::ReVIEWGenerator.new
+    review_text = generator.generate(ast_root)
+  rescue StandardError => e
+    $stderr.puts "Error generating Re:VIEW text: #{e.message}"
+    $stderr.puts e.backtrace if ENV['DEBUG']
+    exit 1
+  end
+
+  # Output result
+  begin
+    if options[:output]
+      File.write(options[:output], review_text)
+    else
+      puts review_text
+    end
+  rescue StandardError => e
+    $stderr.puts "Error writing output: #{e.message}"
+    exit 1
+  end
+end
+
+main

bin/review-ast-epubmaker

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/ast/command/epub_maker'
+
+ReVIEW::AST::Command::EpubMaker.execute(*ARGV)

bin/review-ast-idgxmlmaker

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/ast/command/idgxml_maker'
+
+ReVIEW::AST::Command::IdgxmlMaker.execute(*ARGV)

bin/review-ast-pdfmaker

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/ast/command/pdf_maker'
+
+ReVIEW::AST::Command::PdfMaker.execute(*ARGV)

bin/review-ast-textmaker

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+# Copyright (c) 2025 Kenshi Muto, Masayoshi Takahashi
+#
+# This program is free software.
+# You can distribute or modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+
+require 'pathname'
+
+bindir = Pathname.new(__FILE__).realpath.dirname
+$LOAD_PATH.unshift((bindir + '../lib').realpath)
+
+require 'review/ast/command/text_maker'
+
+ReVIEW::AST::Command::TextMaker.execute(*ARGV)