parsanol 1.3.30-aarch64-linux → 1.3.32-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ed7c53cc9ff8168c9a6a08bbc33f2f6aaa007302eac69e9739b593431714841
-  data.tar.gz: ba708d8cbc56bf73854fb1d7477779d7d38fce07e1195cebb65bf614a35bf97a
+  metadata.gz: 376b3aefed6052988b85cd2f404078eaacca3165844da1be040512fa923aaca7
+  data.tar.gz: 4bd78d928a42920ae6c1463711cc33723693acf423eaa9ed239a50a5f884abad
 SHA512:
-  metadata.gz: be07b715e5c3cd4b23d05be9b6e17bb5f6fc9f9d8b1972af660b49aec037760e3f1e03ec0068427dda89bb40d546200b4a2c43eec1583c3fe9869e616410a075
-  data.tar.gz: 77a109bbf72496a646975bd9b421ed35a319dfa130acfce05d1ffd22df22045832082d5fb9d04b87ebf285a144bd5a1a89cadb9919102e225144860c73a9e444
+  metadata.gz: 1cceac3f060e40e7b09f8cf838b129b3bdd7116454ff223c648ac49f2258a8231de23afb8f1041924c767ba3157aa7764d2b794c135c6c50225ea0c8af63be2e
+  data.tar.gz: 3b1a447ff4f97a46fc1c0976da40e82242508aea75b733163ddb9f124bd2af7b7880bb5b349279c828e2c47ce957ed5bb5d3bf6cfce58389979755a88194055c

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/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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parsanol
 version: !ruby/object:Gem::Version
-  version: 1.3.30
+  version: 1.3.32
 platform: aarch64-linux
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-09-17 00:00:00.000000000 Z
+date: 2026-09-18 00:00:00.000000000 Z
 dependencies: []
 description: A small Ruby library for constructing parsers in the PEG (Parsing Expression
   Grammar) fashion. Parsanol provides Parslet-compatible API with additional features