node_query 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c7363cd71167f293f046d95014611ceb1f695c6639036a3cc0e202ab0ae5b2b
-  data.tar.gz: 161c5784daae011699a1300b0cedc2f18bdc7235f71b7e89e1b1dce41caef71a
+  metadata.gz: 95dcf07d501c704e59bb792454be0bae1ddfafb915c77b6a062c6331d654564b
+  data.tar.gz: 7b835b8479ff5239ea77dcb5ed09f4868b1a09cbdf5edc2f4ab9413d352030be
 SHA512:
-  metadata.gz: 356e94651bf61cb5c244399bbfe0aa353aafe3a3506fc7e6b1efba9cc4c853a0b963850c9d64e9b9de26dd3986f10967b2752a3dc7ec627dfd7466ddcf9a70f8
-  data.tar.gz: 0fdacf2a86292f60968a02054ce43e02a131d3a1da7c528d1e6df2e8279afd5de19afe714a80bd1b9ab17143c433b4e219c7be2cf8b55e3f28e45ff82a25d274
+  metadata.gz: e2dbea64418363ad059ea2b6e9d93b3c2d010bdba59317327904b6a48411517a511ab6737fe40bdf4847b2833ec4d81eb5d474be7db7d831a6119c89fe904fea
+  data.tar.gz: c2cf0bfec6edfa28b644a38957dce1276cc287507c3c3034a39e0ce018f25e420faded6ad0c7c3c3838757df5107082c30d05fcf9f4323c5d5d3f32bc68337f1

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # CHANGELOG
 
+## 1.4.0 (2022-09-14)
+
+* Add options `including_self`, `stop_on_match` and `recursive`
+* Fix regex to match evaluated value
+
 ## 1.3.0 (2022-09-13)
 
 * Rename `NodeQuery#parse` to `NodeQuery#query_nodes`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    node_query (1.3.0)
+    node_query (1.4.0)
       activesupport (< 7.0.0)
 
 GEM

data/README.md

@@ -62,7 +62,7 @@ It provides two apis: `query_nodes` and `match_node?`
 
 ```ruby
 node_query = NodeQuery.new(nqlOrRules: String | Hash) # Initialize NodeQuery
-node_query.query_nodes(node: Node, including_self = true): Node[] # Get the matching nodes.
+node_query.query_nodes(node: Node, options = { including_self: true, stop_on_match: false, recursive: true }): Node[] # Get the matching nodes.
 node_query.match_node?(node: Node): boolean # Check if the node matches nql or rules.
 ```
 

data/lib/node_query/compiler/expression.rb

@@ -13,14 +13,17 @@ module NodeQuery::Compiler
 
     # Query nodes by the selector and the rest expression.
     # @param node [Node] node to match
-    # @params including_self [boolean] if query the current node.
+    # @param options [Hash] if query the current node
+    # @option options [boolean] :including_self if query the current node, default is ture
+    # @option options [boolean] :stop_on_match if stop on first match, default is false
+    # @option options [boolean] :recursive if stop on first match, default is true
     # @return [Array<Node>] matching nodes.
-    def query_nodes(node, including_self = true)
-      matching_nodes = @selector.query_nodes(node, including_self)
+    def query_nodes(node, options = {})
+      matching_nodes = @selector.query_nodes(node, options)
       return matching_nodes if @rest.nil?
 
       matching_nodes.flat_map do |matching_node|
-        @rest.query_nodes(matching_node, including_self)
+        @rest.query_nodes(matching_node, options)
       end
     end
 

data/lib/node_query/compiler/expression_list.rb

@@ -13,13 +13,16 @@ module NodeQuery::Compiler
 
     # Query nodes by the current and the rest expression.
     # @param node [Node] node to match
-    # @params including_self [boolean] if query the current node.
+    # @param options [Hash] if query the current node
+    # @option options [boolean] :including_self if query the current node, default is ture
+    # @option options [boolean] :stop_on_match if stop on first match, default is false
+    # @option options [boolean] :recursive if stop on first match, default is true
     # @return [Array<Node>] matching nodes.
-    def query_nodes(node, including_self = true)
-      matching_nodes = @expression.query_nodes(node, including_self)
+    def query_nodes(node, options = {})
+      matching_nodes = @expression.query_nodes(node, options)
       return matching_nodes if @rest.nil?
 
-      matching_nodes + @rest.query_nodes(node, including_self)
+      matching_nodes + @rest.query_nodes(node, options)
     end
 
     # Check if the node matches the expression list.

data/lib/node_query/compiler/selector.rb

@@ -33,9 +33,13 @@ module NodeQuery::Compiler
     # * If relationship is next sibling, it try to match next sibling node.
     # * If relationship is subsequent sibling, it will match in all sibling nodes.
     # @param node [Node] node to match
-    # @params including_self [boolean] if query the current node.
+    # @param options [Hash] if query the current node
+    # @option options [boolean] :including_self if query the current node, default is ture
+    # @option options [boolean] :stop_on_match if stop on first match, default is false
+    # @option options [boolean] :recursive if stop on first match, default is true
     # @return [Array<Node>] matching nodes.
-    def query_nodes(node, including_self = true)
+    def query_nodes(node, options = {})
+      options = { including_self: true, stop_on_match: false, recursive: true }.merge(options)
       return find_nodes_by_relationship(node) if @relationship
 
       if node.is_a?(::Array)
@@ -45,12 +49,25 @@ module NodeQuery::Compiler
       return find_nodes_by_goto_scope(node) if @goto_scope
 
       nodes = []
-      if including_self && match?(node)
+      if options[:including_self] && match?(node)
         nodes << node
+        return matching_nodes if options[:stop_on_match]
       end
       if @basic_selector
-        NodeQuery::Helper.handle_recursive_child(node) do |child_node|
-          nodes << child_node if match?(child_node)
+        if options[:recursive]
+          NodeQuery::Helper.handle_recursive_child(node) do |child_node|
+            if match?(child_node)
+              nodes << child_node
+              break if options[:stop_on_match]
+            end
+          end
+        else
+          NodeQuery.adapter.get_children(node).each do |child_node|
+            if match?(child_node)
+              nodes << child_node
+              break if options[:stop_on_match]
+            end
+          end
         end
       end
       nodes

data/lib/node_query/helper.rb

@@ -48,7 +48,7 @@ class NodeQuery::Helper
     # @param str [String] string to be evaluated
     # @return [String] evaluated string
     def evaluate_node_value(node, str)
-      str.scan(/{{(.*)}}/).each do |match_data|
+      str.scan(/{{(.*?)}}/).each do |match_data|
         target_node = NodeQuery::Helper.get_target_node(node, match_data.first)
         str = str.sub("{{#{match_data.first}}}", NodeQuery.adapter.get_source(target_node))
       end

data/lib/node_query/node_rules.rb

@@ -11,16 +11,31 @@ class NodeQuery::NodeRules
 
   # Query nodes by the rules.
   # @param node [Node] node to query
-  # @params including_self [boolean] if query the current node.
+  # @param options [Hash] if query the current node
+  # @option options [boolean] :including_self if query the current node, default is ture
+  # @option options [boolean] :stop_on_match if stop on first match, default is false
+  # @option options [boolean] :recursive if stop on first match, default is true
   # @return [Array<Node>] matching nodes.
-  def query_nodes(node, including_self = true)
+  def query_nodes(node, options = {})
+    options = { including_self: true, stop_on_match: false, recursive: true }.merge(options)
     matching_nodes  = []
-    if (including_self && match_node?(node))
+    if options[:including_self] && match_node?(node)
       matching_nodes.push(node)
+      return matching_nodes if options[:stop_on_match]
     end
-    NodeQuery::Helper.handle_recursive_child(node) do |child_node|
-      if (match_node?(child_node))
-        matching_nodes.push(child_node)
+    if options[:recursive]
+      NodeQuery::Helper.handle_recursive_child(node) do |child_node|
+        if match_node?(child_node)
+          matching_nodes.push(child_node)
+          break if options[:stop_on_match]
+        end
+      end
+    else
+      NodeQuery.adapter.get_children(node).each do |child_node|
+        if match_node?(child_node)
+          matching_nodes.push(child_node)
+          break if options[:stop_on_match]
+        end
       end
     end
     matching_nodes

data/lib/node_query/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class NodeQuery
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 end

data/lib/node_query.rb

@@ -38,13 +38,16 @@ class NodeQuery
 
   # Query matching nodes.
   # @param node [Node] ast node
-  # @param including_self [boolean] if check the node itself
+  # @param options [Hash] if query the current node
+  # @option options [boolean] :including_self if query the current node, default is ture
+  # @option options [boolean] :stop_on_match if stop on first match, default is false
+  # @option options [boolean] :recursive if stop on first match, default is true
   # @return [Array<Node>] matching child nodes
-  def query_nodes(node, including_self = true)
+  def query_nodes(node, options = {})
     if @expression
-      @expression.query_nodes(node, including_self)
+      @expression.query_nodes(node, options)
     elsif @rules
-      @rules.query_nodes(node, including_self)
+      @rules.query_nodes(node, options)
     else
       []
     end

data/sig/node_query.rbs

@@ -7,7 +7,7 @@ class NodeQuery[T]
 
   def initialize: (nqlOrRues: String | Hash) -> NodeQuery
 
-  def query_nodes: (node: T, including_self: boolean) -> Array[T]
+  def query_nodes: (node: T, options: Hash) -> Array[T]
 
   def match_node?: (node: T) -> boolean
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: node_query
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Richard Huang
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-09-13 00:00:00.000000000 Z
+date: 2022-09-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport