arpaka 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9c4d3fb152bbd9bb8a5c00037371b5387d8d72027dfe9aacef3032364fff434
-  data.tar.gz: 39037d6380101b5f89d24d2c397428377fe44180e77215c59c5967349a48256e
+  metadata.gz: 5a9e8ba3375a56453551778e540a98c57737d596ddd67d1121b040011d356c5c
+  data.tar.gz: af951a8d45255b4adb3531ccde464d0a20427fc58067bae9d9c2fb88595c0067
 SHA512:
-  metadata.gz: c0505eecc22775c6bb8f84932382d7274a80372541c0a68d65c6dc2c1203c37251ef91c063f94d38313d934b1d6e9143a27d34640413d5428344721d6449b209
-  data.tar.gz: 598e86005c31fbbd8cc98374c1c3dbedcb6feb1f97087dfaf3ab12461fc40b64e31c7b2f538eed382c726b19ab771f2edf2f1acfca25c1deef7f98fb74ef605c
+  metadata.gz: 84c9d1d486ce1dc6352c47f191396bd7d9b93d23c4938a0d62bdd0080583102ab13e2d7c363c99b72043607ef813c94a81fee842ea255c2ed6f2dc02f594e8ae
+  data.tar.gz: 86586ad0c9d3bba004a276c0691c4bb64c6d479f4a9330e7a1cd6bdf4bed17d7a545716fc5caf217e2497070ad6f7d0f5ecb4b23a9aa1cae88bcdbcd9d234939

data/README.md

@@ -150,6 +150,20 @@ preserved unless `--force` is supplied. A failed generation leaves the previous
 file intact. The output includes its source profile, generator version and
 copyright/license notices.
 
+When only `parse.y` is available, Arpaka can replace its `RUBY_TOKEN(NAME)`
+declarations with token names and generate a frontend without the rest of the
+Ruby source tree:
+
+```sh
+RUBY_BOX=1 bundle exec arpaka generate \
+  --parse-y /path/to/parse.y \
+  --class-name MyRubyParser \
+  --output lib/my_library/ruby_parser.rb
+```
+
+This mode embeds Arpaka's own license notices. The `--ruby-source` mode remains
+the compatibility-preserving path when the Ruby source tree is available.
+
 The consumer only needs the generated file and Ruby 4.0 or later:
 
 ```ruby

data/lib/arpaka/cli.rb

@@ -11,8 +11,9 @@ module Arpaka
       force = false
       help = false
       parser = OptionParser.new do |opts|
-        opts.banner = "Usage: arpaka generate --ruby-source DIR --output FILE [--class-name NAME] [--force]"
+        opts.banner = "Usage: arpaka generate (--ruby-source DIR | --parse-y FILE) --output FILE [--class-name NAME] [--force]"
         opts.on("--ruby-source DIR", "Ruby source tree (provided by the user)") { |v| options[:ruby_source] = v }
+        opts.on("--parse-y FILE", "parse.y file (use Arpaka's token definitions)") { |v| options[:parse_y] = v }
         opts.on("--output FILE", "Write a standalone Ruby frontend") { |v| options[:output] = v }
         opts.on("--class-name NAME", "Generated class name (default: RubyParser)") { |v| options[:class_name] = v }
         opts.on("--force", "Replace an existing output file") { force = true }
@@ -31,7 +32,9 @@ module Arpaka
         return 0
       end
       raise OptionParser::InvalidArgument, args.join(" ") unless args.empty?
-      %i[ruby_source output].each do |key|
+      raise OptionParser::InvalidArgument, "specify exactly one of --ruby-source or --parse-y" if options[:ruby_source] == options[:parse_y]
+      raise OptionParser::MissingArgument, "--output" unless options[:output]
+      %i[output].each do |key|
         raise OptionParser::MissingArgument, "--#{key.to_s.tr('_', '-')}" unless options[key]
       end
       output = File.expand_path(options.delete(:output))

data/lib/arpaka/generator.rb

@@ -6,28 +6,36 @@ require_relative "ruby_grammar"
 
 module Arpaka
   class Generator
-    def generate(ruby_source:, class_name:)
+    def generate(ruby_source: nil, parse_y: nil, class_name:)
+      if ruby_source.nil? == parse_y.nil?
+        raise Error, "specify exactly one of ruby_source or parse_y"
+      end
       unless /\A[A-Z][a-zA-Z0-9_]*\z/.match?(class_name)
         raise Error, "class_name must be a single Ruby constant name"
       end
       unless ::Ruby::Box.enabled?
         raise Error, "Ruby Box is required for generation. Start Ruby with RUBY_BOX=1."
       end
-      artifacts = RubyGrammar.artifacts(ruby_source: ruby_source)
+      artifacts = RubyGrammar.artifacts(ruby_source: ruby_source, parse_y: parse_y)
+      grammar_filename = parse_y || File.join(ruby_source, "parse.y")
       parser = Lrama::Ruby.generate(artifacts.fetch("parse.y"),
-        filename: File.join(ruby_source, "parse.y"), class_name: "Parser", allow_error_rules: true)
+        filename: grammar_filename, class_name: "Parser", allow_error_rules: true)
       parser = parser.delete_prefix("# frozen_string_literal: true\n")
       rules = JSON.parse(artifacts.fetch("rules.json"))
+      runtime_options = artifacts.fetch("runtime", {})
       runtime = %w[frontend ast builder lexer].map do |name|
         template = File.read(File.join(__dir__, "runtime", "#{name}.rb.erb"))
-        name == "builder" ? ERB.new(template).result_with_hash(rules: rules) : template
+        ERB.new(template, trim_mode: "-").result_with_hash(rules: rules, runtime: runtime_options)
       end.join("\n")
       notices = [File.read(File.expand_path("../../LICENSE.txt", __dir__))]
-      %w[COPYING BSDL].each { |name| notices << File.read(File.join(ruby_source, name)) }
+      %w[COPYING BSDL].each do |name|
+        path = ruby_source ? File.join(ruby_source, name) : File.join(__dir__, name)
+        notices << File.read(path)
+      end
       source = "# frozen_string_literal: true\n" \
         "# Generated by Arpaka #{Lrama::Ruby::VERSION}. Do not edit.\n" \
-        "# Ruby source profile: #{RubyGrammar::REVISION}\n" \
-        "# parse.y SHA256: #{Digest::SHA256.file(File.join(ruby_source, 'parse.y')).hexdigest}\n" \
+        "# Ruby source profile: #{ruby_source ? artifacts.fetch('source_profile') : 'parse.y only'}\n" \
+        "# parse.y SHA256: #{Digest::SHA256.file(grammar_filename).hexdigest}\n" \
         "#{notices.join("\n").lines.map { |line| "# #{line}" }.join}\n" \
         "class #{class_name}\n#{parser}\n#{runtime}\nend\n"
       # Compile in an isolated box to validate syntax without executing actions.

data/lib/arpaka/profile/ruby.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Arpaka
+  module Profile
+    module RUBY
+      CURRENT = {
+        "name" => "ruby-4.0",
+        "actions" => ::Arpaka::RubyGrammarActions::ACTIONS,
+        "additional_expected_conflicts" => 0,
+        "runtime" => {}.freeze
+      }.freeze
+
+      def self.select(grammar)
+        if grammar.rules.any? { |rule| rule.lhs.id.s_value == "value_expr_command" }
+          CURRENT
+        elsif grammar.rules.any? { |rule| rule.lhs.id.s_value == "top_compstmt" &&
+          rule.rhs.any? { |symbol| symbol.id.s_value == "option_terms" } }
+          legacy
+        elsif grammar.rules.any? { |rule| rule.lhs.id.s_value == "top_compstmt" &&
+          rule.rhs.any? { |symbol| symbol.id.s_value == "opt_terms" } }
+          legacy_3_3
+        else
+          raise ::Arpaka::Error, "Unsupported Ruby parse.y profile"
+        end
+      end
+
+      def self.legacy
+        @legacy ||= load("ruby_3_4.rb", "ruby-3.4")
+      end
+
+      def self.legacy_3_3
+        @legacy_3_3 ||= load("ruby_3_3.rb", "ruby-3.3")
+      end
+
+      def self.load(filename, name)
+        box = ::Ruby::Box.new
+        profile = box.eval(File.read(File.join(__dir__, filename)))
+        unless profile.is_a?(Hash) && profile["name"] == name
+          raise ::Arpaka::Error, "Invalid #{name} profile"
+        end
+        profile.freeze
+      rescue SyntaxError, TypeError => error
+        raise ::Arpaka::Error, "Ruby profile loading failed: #{error.message}"
+      end
+    end
+  end
+end