state_machines 0.5.0 → 0.50.0

data/lib/state_machines/stdio_renderer.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module StateMachines
+  module STDIORenderer
+    module_function def draw_machine(machine, io: $stdout)
+      draw_class(machine: machine, io: io)
+      draw_states(machine: machine, io: io)
+      draw_events(machine: machine, io: io)
+    end
+
+    module_function def draw_class(machine:, io: $stdout)
+      io.puts "Class: #{machine.owner_class.name}"
+    end
+
+    module_function def draw_states(machine:, io: $stdout)
+      io.puts '  States:'
+      if machine.states.to_a.empty?
+        io.puts '    - None'
+      else
+        machine.states.each do |state|
+          io.puts "    - #{state.name}"
+        end
+      end
+    end
+
+    module_function def draw_event(event, _graph, options: {}, io: $stdout)
+      io = io || options[:io] || $stdout
+      io.puts "  Event: #{event.name}"
+    end
+
+    module_function def draw_branch(branch, _graph, _event, options: {}, io: $stdout)
+      io = io || options[:io] || $stdout
+      io.puts "  Branch: #{branch.inspect}"
+    end
+
+    module_function def draw_state(state, _graph, options: {}, io: $stdout)
+      io = io || options[:io] || $stdout
+      io.puts "  State: #{state.name}"
+    end
+
+    module_function def draw_events(machine:, io: $stdout)
+      io.puts '  Events:'
+      if machine.events.to_a.empty?
+        io.puts '    - None'
+      else
+        machine.events.each do |event|
+          io.puts "    - #{event.name}"
+          event.branches.each do |branch|
+            branch.state_requirements.each do |requirement|
+              out = +'      - '
+              out << "#{draw_requirement(requirement[:from])} => #{draw_requirement(requirement[:to])}"
+              out << " IF #{branch.if_condition}" if branch.if_condition
+              out << " UNLESS #{branch.unless_condition}" if branch.unless_condition
+              io.puts out
+            end
+          end
+        end
+      end
+    end
+
+    module_function def draw_requirement(requirement)
+      case requirement
+      when StateMachines::BlacklistMatcher
+        "ALL EXCEPT #{requirement.values.join(', ')}"
+      when StateMachines::AllMatcher
+        'ALL'
+      when StateMachines::LoopbackMatcher
+        'SAME'
+      else
+        requirement.values.join(', ')
+      end
+    end
+  end
+end

data/lib/state_machines/syntax_validator.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'ripper'
+
+module StateMachines
+  # Cross-platform syntax validation for eval strings
+  # Supports CRuby, JRuby, TruffleRuby via pluggable backends
+  module SyntaxValidator
+    # Public API: raises SyntaxError if code is invalid
+    def validate!(code, filename = '(eval)')
+      backend.validate!(code, filename)
+    end
+    module_function :validate!
+
+    private
+
+    # Lazily pick the best backend for this platform
+    # Prefer RubyVM for performance on CRuby, fallback to Ripper for compatibility
+    def backend
+      @backend ||= if RubyVmBackend.available?
+                     RubyVmBackend
+                   else
+                     RipperBackend
+                   end
+    end
+    module_function :backend
+
+    # MRI backend using RubyVM::InstructionSequence
+    module RubyVmBackend
+      def available?
+        RUBY_ENGINE == 'ruby'
+      end
+      module_function :available?
+
+      def validate!(code, filename)
+        # compile will raise a SyntaxError on bad syntax
+        RubyVM::InstructionSequence.compile(code, filename)
+        true
+      end
+      module_function :validate!
+    end
+
+    # Universal Ruby backend via Ripper
+    module RipperBackend
+      def validate!(code, filename)
+        sexp = Ripper.sexp(code)
+        if sexp.nil?
+          # Ripper.sexp returns nil on a parse error, but no exception
+          raise SyntaxError, "syntax error in #{filename}"
+        end
+
+        true
+      end
+      module_function :validate!
+    end
+  end
+end