parsanol 1.3.41 → 1.3.42

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c9049430db0627e08eae3d0a32e89bb2364268fd83e31f6fd3f21b1bc5220c6
-  data.tar.gz: 99b8022bd3e5764179e7b472127c60a9993b1b396826ca28961a07b9ee6165d5
+  metadata.gz: 33fefbd372a900edbe186fa42f8400ad033f65263f6e06dbf5f751c4ab5b2ec2
+  data.tar.gz: 41dd91ecda47d9efeca8cdbe8a12a4231b44b5bdbf8c263da5d855c216ecc660
 SHA512:
-  metadata.gz: 3c89e0a3e5236a2e89615bd309a70d0ca9874264dbae32b8a97fdb31a1cc8cc366fb79c4e2db5f4debb86b06654db0a3a893b2d0d7006b7a97675322bfa7eadf
-  data.tar.gz: b390bd5b792f3c3f4d13217af4aed84d0714295aa14bb311acac68a5eb280ca7dacd36d3a40647477d2c12e68f7d596e632c29600df42ecc7772956472682b7e
+  metadata.gz: 56c477c1a26fd62974793a7ad354f9ce0a7cc7036ccc2ff2179a720b4be81c5c45cd6e1a96c0d97d189250e2f1ae7fc4d34ba2e1bd16e531e72c0c081cb959e0
+  data.tar.gz: d3f341956f358e26251fc7487ef30fbb8325848166b30c0f6805f3cc705bf1f9a7f3124c454c50f57a008d1885a31c4fa8bd48c2131be11a7756632a9ee102e6

data/Cargo.lock

@@ -252,9 +252,9 @@ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
 [[package]]
 name = "parsanol"
-version = "0.7.5"
+version = "0.7.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "47ab9e91431525c26a63d5e567bb40b408de5d5bd3e628abdb3d751551808b7a"
+checksum = "d188dfa10e70efb88ef81d209414cdbceec89bf411b612b67335ca7a5deaa199"
 dependencies = [
  "ahash",
  "getrandom 0.3.4",
@@ -270,9 +270,9 @@ dependencies = [
 
 [[package]]
 name = "parsanol-derive"
-version = "0.7.5"
+version = "0.7.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "073410de90b64094c71aceaa8ca80a0260f3a61e0a8d907b74a6a36d741dc4c5"
+checksum = "93f5d33a040f1f99c30274764db11bbe84b2dbd5170fc2f6c2574da2dc42c8db"
 dependencies = [
  "proc-macro2",
  "quote",

data/ext/parsanol_native/Cargo.toml

@@ -28,7 +28,7 @@ rb-sys = { version = "0.9.124", features = ["global-allocator"] }
 magnus = { version = "0.9" }
 
 # parsanol parser library (from git for latest features)
-parsanol = { version = "0.7.5", features = ["ruby"] }
+parsanol = { version = "0.7.7", features = ["ruby"] }
 
 # Logging
 log = "0.4"

data/lib/parsanol/incremental.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Parsanol
+  # Incremental parsing over a persistent Rust-side session
+  # (TODO.perf/4): the memo window that an edit provably did not
+  # touch is retained across parses, so a keystroke re-parse costs
+  # the edit's neighborhood instead of the whole document.
+  #
+  # Grammars with Dynamic atoms are not eligible (no Ruby re-entry
+  # while the input is borrowed); build sessions from plain grammars.
+  #
+  # @example
+  #   session = Parsanol::IncrementalSession.new(parser.root_atom)
+  #   session.parse(doc)                                    # full parse
+  #   session.parse_with_edit(doc, offset: 42, old_length: 1, new_length: 3)
+  #   session.release
+  #
+  class IncrementalSession
+    # @param root_atom [Object] a grammar root atom (the same object
+    #   a Parsanol::Parser rule produces)
+    def initialize(root_atom)
+      unless Native.available?
+        raise NativeUnavailable, "parsanol native extension not loaded"
+      end
+
+      @session = Native._incremental_session(Native::Parser.serialize_grammar(root_atom))
+    end
+
+    # Full parse (also the session's first call).
+    #
+    # @param input [String]
+    # @return [Object] the parslet-shaped tree
+    def parse(input)
+      Native._incremental_parse(@session, input, -1, 0, 0)
+    end
+
+    # Re-parse after a single edit described by its span.
+    #
+    # @param input [String] the document AFTER the edit
+    # @param offset [Integer] byte offset of the edit
+    # @param old_length [Integer] bytes removed
+    # @param new_length [Integer] bytes inserted
+    # @return [Object] the parslet-shaped tree
+    def parse_with_edit(input, offset:, old_length:, new_length:)
+      Native._incremental_parse(@session, input, offset, old_length, new_length)
+    end
+
+    # Session cache counters: [hits, misses].
+    #
+    # @return [Array(Integer, Integer)]
+    def stats
+      Native._incremental_stats(@session)
+    end
+
+    # Free the Rust-side session. The session becomes unusable.
+    #
+    # @return [Boolean] true when a session was freed
+    def release
+      released = Native._incremental_release(@session)
+      @session = nil
+      released
+    end
+  end
+end

data/lib/parsanol/version.rb

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

data/lib/parsanol.rb

@@ -265,6 +265,7 @@ module Parsanol
   module_function :exp
 
   autoload :Expression, "parsanol/expression"
+  autoload :IncrementalSession, "parsanol/incremental"
 end
 
 require "parsanol/version"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parsanol
 version: !ruby/object:Gem::Version
-  version: 1.3.41
+  version: 1.3.42
 platform: ruby
 authors:
 - Ribose Inc.
@@ -82,6 +82,7 @@ files:
 - lib/parsanol/fast_mode.rb
 - lib/parsanol/first_set.rb
 - lib/parsanol/grammar_builder.rb
+- lib/parsanol/incremental.rb
 - lib/parsanol/incremental_parser.rb
 - lib/parsanol/interval_tree.rb
 - lib/parsanol/lazy_result.rb