parsanol 1.3.30 → 1.3.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21f56a5196775ab90fe91a82e7b71240bc1f48b64ed90886b947285bf760c0b7
-  data.tar.gz: 1463e0eb3af171d61f8e09f30deec7d15bc679341d129197cdb5845efd3357b3
+  metadata.gz: 41651c6d4901c45b1b2d8973eb221d28ea31412a832a88a6c24e6e765bd7617e
+  data.tar.gz: 92260b260487280d55c561e49ef9342ce2a752bd12ead9dd3cedca190f260946
 SHA512:
-  metadata.gz: e552a716aa3cf2facea589d2310db16e14664ceefd6d1412d97fb945314dadb0ef31dbe2d835414d6d05c8dd1420386a244ce7ff7c1fba42e97ac26180d2db14
-  data.tar.gz: 16cf21e24b996b1f1a314e36c29b81c7ba3f16a303d9538886b823c94db1759b662e732fdb68a019e5adfb264e2c381de4aa7be3cc7907538173ef260c173a69
+  metadata.gz: d47ce37751cc457c2e0f878fed50c3b0d337cf663843f821b1aeb792325371862f951f4b3b324983408def926959bd7487ff0c3879b3603a93f8c5fc8a806d94
+  data.tar.gz: bd256709d110df1092d60ef05939c9d8a2d3fe6db6714987eb60ad67ce47407c1f9b37701245f5745e940d712cdbff766ae3f7dfe11bc72764f0e1f08fdcf3c4

data/Cargo.lock

@@ -252,8 +252,8 @@ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
 [[package]]
 name = "parsanol"
-version = "0.5.1"
-source = "git+https://github.com/parsanol/parsanol-rs?branch=main#32cdbb1d3c04c9280f6fb4d2cf13f1c5befbd00f"
+version = "0.5.3"
+source = "git+https://github.com/parsanol/parsanol-rs?branch=main#3a441c45ce089cae40ed69260bf00c4ed6de635a"
 dependencies = [
  "ahash",
  "getrandom 0.3.4",
@@ -269,8 +269,8 @@ dependencies = [
 
 [[package]]
 name = "parsanol-derive"
-version = "0.5.1"
-source = "git+https://github.com/parsanol/parsanol-rs?branch=main#32cdbb1d3c04c9280f6fb4d2cf13f1c5befbd00f"
+version = "0.5.3"
+source = "git+https://github.com/parsanol/parsanol-rs?branch=main#3a441c45ce089cae40ed69260bf00c4ed6de635a"
 dependencies = [
  "proc-macro2",
  "quote",

data/README.adoc

@@ -156,6 +156,24 @@ Run your own benchmarks with:
 bundle exec ruby examples/benchmark_examples.rb
 ----
 
+[[engine-posture]]
+==== Engine roles
+
+Parsanol ships two engines with one semantic contract (identical parse
+trees and error messages):
+
+* **Native (default)** — the Rust extension. It handles every parsing
+  mode, including error cause trees, `prefix:` and `reporter:`, with no
+  Ruby fallback during parsing. Prebuilt platform gems cover the common
+  triples; `bundle exec rake compile` builds it locally otherwise.
+* **Ruby (`mode: :ruby`)** — the pure-Ruby engine. Its role is
+  portability (no prebuilt gem, no Rust toolchain, non-MRI rubies) and
+  serving as the semantic reference implementation for differential
+  testing against Parslet.
+
+When both are available, the native engine is always used unless
+`mode: :ruby` is requested explicitly.
+
 [[slice-support]]
 === Slice Support
 

data/ext/parsanol_native/extconf.rb

@@ -1,6 +1,18 @@
 # frozen_string_literal: true
 
 require "mkmf"
+
+# The Rust extension only builds against MRI's C API. Other engines
+# (TruffleRuby, JRuby) resolve the ruby-platform gem and must install
+# cleanly on the pure-Ruby backend instead of failing the whole install
+# (parsanol-ruby#23). An explicit opt-out works on MRI too.
+if RUBY_ENGINE != "ruby" || ENV["PARSANOL_NATIVE"] == "0"
+  File.write("Makefile", dummy_makefile("").to_s)
+  warn "parsanol: skipping the Rust extension on #{RUBY_ENGINE} " \
+       "(pure-Ruby backend will be used)"
+  exit 0
+end
+
 require "rb_sys/mkmf"
 
 create_rust_makefile("parsanol/parsanol_native") do |r|

data/lib/parsanol/version.rb

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

data/lib/parsanol.rb

@@ -129,10 +129,60 @@ module Parsanol
   def match(pattern = nil)
     return CharacterClassBuilder.new unless pattern
 
+    match_quantifier_warning(pattern)
     Atoms::Re.new(pattern)
   end
   module_function :match
 
+  # `match` consumes exactly one character (Parslet parity), so a regex
+  # quantifier is silently truncated: match(/[0-9]+/) matches a single
+  # digit. Warn once per offending pattern — the intended spelling is
+  # `match("[0-9]").repeat(1)`.
+  # Deliberately mutable: it accumulates warned patterns per process.
+  QUANTIFIER_WARNED = {} # rubocop:disable Style/MutableConstant
+  private_constant :QUANTIFIER_WARNED
+
+  def match_quantifier_warning(pattern)
+    return if QUANTIFIER_WARNED.key?(pattern)
+    return unless pattern.is_a?(String)
+    return unless quantified_pattern?(pattern)
+
+    QUANTIFIER_WARNED[pattern] = true
+    warn "Parsanol: match(#{pattern.inspect}) matches exactly one character " \
+         "(Parslet parity); the quantifier is ignored. " \
+         "Use match(...).repeat(1) to match repeatedly."
+  end
+  module_function :match_quantifier_warning
+
+  # True when the pattern carries a top-level quantifier (+, *, ?, or
+  # {n,m}) outside a character class.
+  def quantified_pattern?(pattern)
+    in_class = false
+    escaped = false
+    previous = nil
+
+    pattern.each_char.with_index do |ch, idx|
+      if escaped
+        escaped = false
+      elsif ch == "\\"
+        escaped = true
+      elsif in_class
+        in_class = false if ch == "]"
+      elsif ch == "["
+        in_class = true
+      elsif %w[+ * ?].include?(ch) || (ch == "{" && idx + 1 < pattern.length && pattern[idx + 1] =~ /\d/)
+        # A leading quantifier applies to nothing and cannot truncate a
+        # character match; any other quantifier does.
+        return true if idx.positive? && !previous.nil? && previous != "("
+      end
+
+      previous = ch
+    end
+
+    false
+  end
+  module_function :quantified_pattern?
+
   # Creates a literal string matcher.
   #
   # @param literal [String] the string to match

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parsanol
 version: !ruby/object:Gem::Version
-  version: 1.3.30
+  version: 1.3.32
 platform: ruby
 authors:
 - Ribose Inc.