parsanol 1.3.16-aarch64-linux → 1.3.18-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47f7be12e8a16ae18e07d621fc699bd49d55367c4e17a6f43c3ba1a00f12bfc7
-  data.tar.gz: 3877f2d6c8d48495efd798abf72bd96bbc7e6fc643cf6de78ca0a6b589445b37
+  metadata.gz: ec79b496ea0dd5cf94aeb9601343133f685c31782ad573ede40947f4c9ded214
+  data.tar.gz: 747502b04cf7510313812bde6e4606a741582a2489f2ad745482cf1f47b36a4e
 SHA512:
-  metadata.gz: d6e19f01bc6b7fdb3168fbe5ad272182e590e685c1a12d3fa97c7064791f825efdd72cca971aa385af6ecb443a6e28e3052168d7bf6aaccf458ae4cfaac37cd1
-  data.tar.gz: 66e2a1c85f1667ac98451fc943b25e9697ed7c227854ccf0e31ce214a68b56918a6f68cc1a21688a29b4bb360cafcc2711e12e493313c63c9e96908baff07e3e
+  metadata.gz: 5bb8a32f322259c12432d610bb1f526db17caf038be37819b089db8e9f9aad991fa2bac63141fe35edacb34841f24a609a0837152dfc1e6427baf53e13a0413c
+  data.tar.gz: e1feaa6b11461e52844d7d3152ca00a28e9ee939da21575536560bed7049500a70bb664062bc61416c0d86531735f9aac994e8f4fc8d004b4e20876d12263fc7

data/lib/parsanol/atoms/base.rb

@@ -148,6 +148,13 @@ module Parsanol
         to_s(TOP)
       end
 
+      # Finalizes result by flattening. Public: the native error
+      # fallback (both extension and ffi tiers) calls it cross-object to
+      # finalize a recovered tree.
+      def finalize_result(value)
+        flatten(value)
+      end
+
       protected
 
       # Pre-allocated constant result tuples
@@ -180,11 +187,6 @@ module Parsanol
       # Alias for ok (legacy compatibility)
       alias succ ok
 
-      # Finalizes result by flattening.
-      def finalize_result(value)
-        flatten(value)
-      end
-
       private
 
       # Converts raw input to Source if needed.

data/lib/parsanol/native/ffi.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Parsanol
+  module Native
+    # Rust engine for runtimes that cannot load C-API extensions
+    # (JRuby, TruffleRuby, or an MRI whose platform gem is absent and
+    # cannot build one). Binds the parsanol cdylib's C ABI through the
+    # `ffi` gem: grammars register once into Rust-side handles keyed by
+    # serialized structure; results cross the boundary as flat-u64 batch
+    # arrays decoded by the same BatchDecoder used elsewhere.
+    module Ffi
+      class Error < StandardError
+      end
+
+      class << self
+        @available = nil
+
+        def available?
+          return @available unless @available.nil?
+
+          @available = begin
+            require "ffi"
+            lib = locate_library
+            lib && bind_library(lib)
+          rescue LoadError, StandardError
+            false
+          end
+        end
+
+        # Registers (once, cached) and parses. +grammar+ is a grammar
+        # atom or a pre-serialized JSON string. Mirrors Native.parse's
+        # contract, including the single reporter-pass fallback to the
+        # pure-Ruby engine for parslet-compatible failure errors.
+        def parse(grammar, input)
+          unless available? && @binding
+            raise Error, "parsanol FFI library not available"
+          end
+
+          if grammar.is_a?(String)
+            json = grammar
+            atom = nil
+          else
+            json = ::Parsanol::Native::Parser.serialize_grammar(grammar)
+            atom = grammar
+          end
+          handle = ((@handles ||= {})[json] ||= @binding.c_register(json))
+          raise Error, "grammar registration failed" if handle.zero?
+
+          written = parse_into(handle, input)
+          if written.positive?
+            return ::Parsanol::Native::BatchDecoder.decode_and_flatten(
+              @buffer.read_array_of_uint64(written), input, ::Parsanol::Slice
+            )
+          end
+
+          message = @binding.c_last_error.to_s
+          if atom
+            return ::Parsanol::Native.raise_native_parse_error(
+              RuntimeError.new(message), atom, input
+            )
+          end
+
+          raise Error, "parse failed: #{message}"
+        end
+
+        private
+
+        # Search order: explicit override, gem-vendored cdylib next to
+        # this file, then the system linker path.
+        def locate_library
+          candidates = []
+          env = ENV.fetch("PARSANOL_FFI_LIB", nil)
+          candidates << env if env && !env.empty?
+          here = File.dirname(__FILE__)
+          %w[libparsanol.dylib libparsanol.so parsanol.dll].each do |name|
+            path = File.expand_path(name, here)
+            candidates << path if File.file?(path)
+          end
+          candidates << "parsanol"
+          candidates.each do |cand|
+            return cand if File.file?(cand)
+
+            begin
+              FFI::DynamicLibrary.open(cand, FFI::DynamicLibrary::RTLD_NOW)
+              return cand
+            rescue StandardError
+              next
+            end
+          end
+          nil
+        end
+
+        def bind_library(path) # rubocop:disable Naming/PredicateMethod -- binds and reports success
+          binding_mod = Module.new do
+            extend FFI::Library
+
+            ffi_lib path
+            attach_function :c_register, :parsanol_c_register,
+                            %i[string], :uint64
+            attach_function :c_parse, :parsanol_c_parse,
+                            %i[uint64 string pointer size_t], :long_long
+            attach_function :c_last_error, :parsanol_c_last_error,
+                            [], :string
+            attach_function :c_release, :parsanol_c_release,
+                            %i[uint64], :void
+          end
+          # Probe the symbols now so a mismatched library fails loudly
+          # at availability time, not at first parse.
+          probe = binding_mod.c_last_error
+          @binding = binding_mod
+          @buffer = nil
+          !probe.nil? || true
+        end
+
+        # Two-call buffer protocol: cap=0 asks for the needed size, then
+        # one allocation carries the whole batch.
+        def parse_into(handle, input)
+          needed = @binding.c_parse(handle, input, nil, 0)
+          return needed unless needed.negative?
+
+          @buffer = FFI::MemoryPointer.new(:uint64, -needed)
+          @binding.c_parse(handle, input, @buffer, -needed)
+        end
+      end
+    end
+  end
+end

data/lib/parsanol/native/parser.rb

@@ -18,7 +18,7 @@ module Parsanol
         def available?
           return @cached_available unless @cached_available.nil?
 
-          @cached_available = begin
+          @ext_loaded = begin
             # Try versioned path first (released gem), then non-versioned (local dev)
             ruby_version = RUBY_VERSION.split(".").take(2).join(".")
             begin
@@ -30,6 +30,13 @@ module Parsanol
           rescue LoadError
             false
           end
+          @cached_available = @ext_loaded || Ffi.available?
+        end
+
+        # True when the MRI C-API extension is loaded; false when the
+        # engine runs through the ffi-gem cdylib tier instead.
+        def extension_loaded?
+          @ext_loaded ? true : false
         end
 
         # Parse input with a Ruby grammar, returning clean AST.

data/lib/parsanol/native.rb

@@ -10,6 +10,8 @@ require "parsanol/native/batch_decoder"
 
 module Parsanol
   module Native
+    # ffi-gem cdylib tier: lazy — only loaded when the MRI extension is absent.
+    autoload :Ffi, "parsanol/native/ffi"
     class << self
       # Check if native extension is available
       def available?
@@ -38,6 +40,10 @@ module Parsanol
       def parse(grammar, input)
         raise LoadError, "Native parser not available" unless available?
 
+        # ffi-gem tier (JRuby/TruffleRuby/no-binary MRI): same contract,
+        # batch-decoded results, single reporter-pass error fallback.
+        return Ffi.parse(grammar, input) unless Parser.extension_loaded?
+
         # Both sub-methods return the final decoded tree; on native failure
         # they fall back to the pure-Ruby parser, whose result is already
         # final and must not be transformed again.

data/lib/parsanol/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Parsanol
-  VERSION = "1.3.16"
+  VERSION = "1.3.18"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parsanol
 version: !ruby/object:Gem::Version
-  version: 1.3.16
+  version: 1.3.18
 platform: aarch64-linux
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-15 00:00:00.000000000 Z
+date: 2026-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -200,6 +200,7 @@ files:
 - lib/parsanol/native.rb
 - lib/parsanol/native/batch_decoder.rb
 - lib/parsanol/native/dynamic.rb
+- lib/parsanol/native/ffi.rb
 - lib/parsanol/native/parser.rb
 - lib/parsanol/native/serializer.rb
 - lib/parsanol/native/transformer.rb