parsanol 1.3.30-arm-linux → 1.3.32-arm-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4ac5d42ef4718a350220c0d138e4e976e8b636114eb3d1ac19f60813fb8cbed
-  data.tar.gz: 25829d9ffbf70bd209f518d480ec96949d72f326e437df69794e1339a2ddb0af
+  metadata.gz: bcc6dfae6ffa797eb5cf348321b8ba478685f164c87b9f6d5631ae5d4c875772
+  data.tar.gz: 49305e9b8acbf788ebcb7dab375a5e4343652d573b949b33442cad9945f1d028
 SHA512:
-  metadata.gz: 2f396be06ff1b3bc405badb6f30ca772e13429f2ea4bd686017843a3206c157eef91a6ac618e98e62729f23429596f59ce02d1caff7eacb63bdee2c2affed9cf
-  data.tar.gz: d535746fa5d0466276a3dc3f5502ecda5202ddea2d059e3f1bd5af93347745b3149f0369840bf64de8ae245614290c1350b878da605e03853e5e269bcf95af0f
+  metadata.gz: 60b8818a30dae829cdd46a49a7315b25c0e29471280c52f322539feb8e6ca5b62dfe90bc6e633faa13f6dc72e236775065ec458b98999015decf5b3c2df62243
+  data.tar.gz: cd69af0d55393572413d6378fa3e6992a1275f18b797fa45a0095bdfb38b028ab08e8c0dea3ddaea62fe8900e7c46eb3cfc8226d793ea745259be272a9d243f6

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: arm-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