parsanol 1.3.25-x86_64-linux → 1.3.26-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82d711217af3f7b64a8507f1a23757c3fa356af7eff8b4a2be3e4e2d8f7c3bc9
-  data.tar.gz: 422015e3bf2451f6fc9f0472337f7034acafcedc36e1b74ef7f7a1e4539fb5d1
+  metadata.gz: 79343c7e73fa4e23d8a16ea8190019ec27c073490a1a792a1647a65febd13ca7
+  data.tar.gz: 076b417c7e07f7cb6cd6f546068ba6e55c613d61964aba483920c24f32530872
 SHA512:
-  metadata.gz: ee2f9b6944734239897c91b40e18ae5b54b500a881aee51a7635273c8583e7bd04e16a7cd33ab44729eb1e11f22947bc6fa40d269b51d0f1e5ddfcaee67585f9
-  data.tar.gz: e6075383b069b41761aa2a92fae4cd0bb8aedb6d4326838c67787d37d64b67b6a112030ce1ca4c5f1a7c8a7003888b12f0956c80be9fd44c0be0d590b50bc765
+  metadata.gz: d1597921c528f108680b56b5515516e64d706f727c3749541fa8891eb02ba6e63955e4bbafbc45fa53b4eef83b55ef4683efde184d8df48dc71d65b748a8aa85
+  data.tar.gz: 4d65d65e226ba3ec09470cd887d847fed844d9f415c22cb206e98fb0412fc84abbfb277b71177b18328c0460d0e01ac21fe7cb71815a7916633d8dccfac655ce

data/lib/parsanol/native/serializer.rb

@@ -63,6 +63,8 @@ module Parsanol
                      serialize_scope(atom)
                    when Parsanol::Atoms::Dynamic
                      serialize_dynamic(atom)
+                   when Parsanol::Atoms::Ignored
+                     serialize_ignored(atom)
                    else
                      # Fallback for unknown atom types
                      serialize_unknown(atom)
@@ -239,12 +241,20 @@ module Parsanol
       }
     end
 
-    def serialize_unknown(_atom)
-      # For unsupported atom types, create a placeholder
-      # This will cause a parse error at runtime
+    def serialize_unknown(atom)
+      # Fail fast at registration (TODO.perf/8 item 4): a never-matching
+      # placeholder here used to turn into a parse-time failure that the
+      # native tier silently recovered from with a full Ruby reparse.
+      raise Parsanol::Native::UnsupportedGrammar,
+            "the native backend cannot express #{atom.class} atoms; " \
+            "parse this grammar with mode: :ruby"
+    end
+
+    def serialize_ignored(atom)
+      inner_id = serialize_atom(atom.wrapped_atom)
       {
-        "Str" => {
-          "pattern" => "", # Empty pattern that will never match
+        "Ignore" => {
+          "atom" => inner_id,
         },
       }
     end

data/lib/parsanol/native.rb

@@ -10,6 +10,11 @@ require "parsanol/native/batch_decoder"
 
 module Parsanol
   module Native
+    # Raised when a grammar uses atoms the Rust backend cannot express.
+    # Failing at registration (TODO.perf/8 item 4) instead of planting a
+    # never-matching placeholder that explodes mid-parse.
+    class UnsupportedGrammar < ArgumentError; end
+
     # ffi-gem cdylib tier: lazy — only loaded when the MRI extension is absent.
     autoload :Ffi, "parsanol/native/ffi"
     # Dynamic-atom callbacks: autoloaded so the serializer's reference

data/lib/parsanol/parser.rb

@@ -123,7 +123,7 @@ module Parsanol
       # forwarding options via super produces; :mode must be honored
       # wherever it appears, or those callers silently get the native path.
       mode = opts.delete(:mode) ||
-        (Parsanol::Native.available? ? :native : :ruby)
+        (Parsanol::Native.available? && native_expressible? ? :native : :ruby)
       case mode
       when :ruby
         super(input, opts)
@@ -230,6 +230,23 @@ module Parsanol
       raise
     end
 
+    # Engine selection for the default mode, decided at registration
+    # time (never mid-parse): grammars the Rust backend cannot express
+    # run on the Ruby engine, announced once per grammar — loud, not a
+    # silent parse-time fallback. An explicit mode: :native still raises
+    # UnsupportedGrammar from registration.
+    def native_expressible?
+      Parsanol::Native::Parser.grammar_handle(root)
+      true
+    rescue Parsanol::Native::UnsupportedGrammar => e
+      warned = (@@unsupported_warned ||= {}.compare_by_identity)
+      unless warned.key?(root)
+        warned[root] = true
+        warn "parsanol: parsing with the Ruby engine (#{e.message})"
+      end
+      false
+    end
+
     # Feed the native deepest-failure diagnostics to a user-supplied
     # reporter: one err_at event carrying the cause the native engine
     # already produced. The full per-atom event stream of the Ruby

data/lib/parsanol/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parsanol
 version: !ruby/object:Gem::Version
-  version: 1.3.25
+  version: 1.3.26
 platform: x86_64-linux
 authors:
 - Ribose Inc.