parsanol 1.3.41-x86_64-linux → 1.3.42-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 461c98e52da3422c9d778dfd43323ccf6e920f751135d879c7454b2132034ef2
-  data.tar.gz: e02a2403f3435da4d69618d6e1386631ecd811467446fd80961de4bce4adb456
+  metadata.gz: 921de9d0ca0156e3e82f9f7ff4799e36c5be2a18b18cd287867e7942106e100e
+  data.tar.gz: da850b7385934eb63bcb245efb3fc0d44ad9757fd9fe37bc53a76d3da8574ccb
 SHA512:
-  metadata.gz: 3f63d22e2cfd3c12106ae7a19002224a1497ac8bd3566cac81ff3a46d0f6947352032c4c8e926bf32ff61e46fd705dbeeb9683f379cd92356dfc17c840403e91
-  data.tar.gz: 1b17f4d57debb2765578754ad0664759bf307e308e179b5c3f863d429eda4b70db374ec3086481bf9ab594d2eec42004095d44fd0b4622ed4d6145c617bc4d9e
+  metadata.gz: 9a295616f8ecf188f7fd1f2e0b6b5e0cdb8342c3fdd1abb59d7a4072e4998b3e727aca48fa777b07f2e1cdfb37ea3ead7790962745ae3a3380066ce91faaea54
+  data.tar.gz: a3413d8a70e0592af59217372daf826ca115a0e726a7a24dc80d4f97c9a116693a23575da057952588463025b211d928f2bfb42eab5a7cc29bd06405a3e522d1

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: x86_64-linux
 authors:
 - Ribose Inc.
@@ -67,6 +67,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