curlybars 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ee481734b28469381f2b97ae1bdfd7bea4f53fd2d8cebef0ca7cd1630bc61d2
-  data.tar.gz: 5444467d66e9991ebb7b43c8cbb71b4b066e3d5c032d5a7fe305a1bd7e9a8cfc
+  metadata.gz: 2ef985c46340022e337318774e4fcf8f36a1f0f7fc6d87788d70ffa3b214f16f
+  data.tar.gz: 1bd1f9195be76418bc0b416f6466aa73809f39037d93ccdde901d90ffca14baa
 SHA512:
-  metadata.gz: 7998d467492215867831a81d15f94b4b0748e02e007711e9772c2c632bfc40554d997e9b6762690ff39b04e7f6a56efcb2dee8ab2be88107f5e8e47735ddc09b
-  data.tar.gz: b647184f3f5466d4278193aa675295a27aca3f90cc3137a0782562192aed7ec2f7a00170f5479426e551e0571f7592ba16262ada7005e980881359d492624d45
+  metadata.gz: 443143ccfb796e5cc14f4cb4bf2f5c1958b8de9b271c95f8fdfccc07caa169d520e4563e70b5111109f6d914388d18c8c6bd519f837524371f235cb375b10389
+  data.tar.gz: fc72c19b12e2084f7e9dab5a01c51d6c6f7ab1614dde449f635356f40fc0841ef3305fd2fb6169763c6333e66324e3486d38f396516325794597b8184801e84a

data/lib/curlybars/error/lex.rb

@@ -9,7 +9,7 @@ module Curlybars
 
         error_line = source.split("\n")[line_number - 1]
         before_error = error_line.first(line_offset).last(10)
-        after_error = error_line[line_offset + 1..].first(10)
+        after_error = error_line[(line_offset + 1)..].first(10)
         error = error_line[line_offset]
 
         details = [before_error, error, after_error]

data/lib/curlybars/error/parse.rb

@@ -16,7 +16,7 @@ module Curlybars
 
           error_line = source.split("\n")[line_number - 1]
           before_error = error_line.first(line_offset).last(10)
-          after_error = error_line[line_offset + length..].first(10)
+          after_error = error_line[(line_offset + length)..].first(10)
           error = error_line.slice(line_offset, length)
 
           details = [before_error, error, after_error]

data/lib/curlybars/lexer.rb

@@ -51,10 +51,10 @@ module Curlybars
     r(/'(.*?)'/, :curly) { [:LITERAL, match[1].inspect] }
     r(/"(.*?)"/, :curly) { [:LITERAL, match[1].inspect] }
 
-    r(/@((?:\.\.\/)*#{IDENTIFIER})/, :curly) { |variable| [:VARIABLE, match[1]] }
+    r(/@((?:\.\.\/)*#{IDENTIFIER})/o, :curly) { |variable| [:VARIABLE, match[1]] }
 
-    r(/(#{IDENTIFIER})\s*=/, :curly) { [:KEY, match[1]] }
-    r(/(?:\.\.\/)*(?:#{IDENTIFIER}\.)*#{IDENTIFIER}/, :curly) { |name| [:PATH, name] }
+    r(/(#{IDENTIFIER})\s*=/o, :curly) { [:KEY, match[1]] }
+    r(/(?:\.\.\/)*(?:#{IDENTIFIER}\.)*#{IDENTIFIER}/o, :curly) { |name| [:PATH, name] }
 
     r(/\s/, :curly)
 

data/lib/curlybars/node/path.rb

@@ -87,15 +87,12 @@ module Curlybars
       end
 
       def resolve(branches)
-        @value ||= begin
-          if Curlybars.global_helpers_dependency_tree.key?(path.to_sym)
-            dep_node = Curlybars.global_helpers_dependency_tree[path.to_sym]
-
-            return :helper if dep_node.nil?
-
-            return [:helper, dep_node]
-          end
+        if !defined?(@value) && Curlybars.global_helpers_dependency_tree.key?(path.to_sym)
+          dep_node = Curlybars.global_helpers_dependency_tree[path.to_sym]
+          @value = dep_node.nil? ? :helper : [:helper, dep_node]
+        end
 
+        @value ||= begin
           path_split_by_slashes = path.split('/')
           backward_steps_on_branches = path_split_by_slashes.count - 1
           base_tree_position = branches.length - backward_steps_on_branches
@@ -108,10 +105,10 @@ module Curlybars
           dotted_path_side = path_split_by_slashes.last
 
           offset_adjustment = 0
-          dotted_path_side.split(/\./).map(&:to_sym).inject(base_tree) do |sub_tree, step|
+          dotted_path_side.split(".").map(&:to_sym).inject(base_tree) do |sub_tree, step|
             if step == :this
               next sub_tree
-            elsif step == :length && (sub_tree.is_a?(Array) && sub_tree.first.is_a?(Hash))
+            elsif step == :length && sub_tree.is_a?(Array) && sub_tree.first.is_a?(Hash)
               next nil # :length is synthesised leaf
             elsif !(sub_tree.is_a?(Hash) && sub_tree.key?(step))
               message = step.to_s == path ? "'#{path}' does not exist" : "not possible to access `#{step}` in `#{path}`"

data/lib/curlybars/path_finder.rb

@@ -0,0 +1,112 @@
+module Curlybars
+  class PathFinder
+    def initialize(ast)
+      @ast = ast
+      @matches = []
+    end
+
+    def find(target_path)
+      @matches = []
+      @target_segments = normalize_path(target_path)
+      traverse(@ast.template, [])
+      @matches
+    end
+
+    private
+
+    def normalize_path(path)
+      return path if path.is_a?(Array)
+
+      path.to_s.split('.')
+    end
+
+    def traverse(node, context_stack)
+      return unless node
+
+      case node
+      when Curlybars::Node::Template
+        node.items.each { |item| traverse(item, context_stack) }
+      when Curlybars::Node::Item
+        traverse(node.item, context_stack)
+      when Curlybars::Node::Path
+        check_path_match(node, context_stack)
+      when Curlybars::Node::Output
+        traverse(node.value, context_stack)
+      when Curlybars::Node::Partial
+        traverse(node.path, context_stack)
+      when Curlybars::Node::SubExpression
+        traverse(node.helper, context_stack)
+        node.arguments&.each { |arg| traverse(arg, context_stack) }
+        node.options&.each { |opt| traverse(opt.expression, context_stack) }
+      when Curlybars::Node::BlockHelperElse
+        handle_block_helper(node, context_stack)
+      when Curlybars::Node::IfElse, Curlybars::Node::UnlessElse
+        handle_conditional(node, context_stack)
+      when Curlybars::Node::EachElse
+        handle_each(node, context_stack)
+      when Curlybars::Node::WithElse
+        handle_with(node, context_stack)
+      end
+    end
+
+    def check_path_match(path_node, context_stack)
+      path_segments = path_node.path.split('.')
+      resolved_segments = resolve_path(path_segments, context_stack)
+
+      @matches << path_node if resolved_segments == @target_segments
+    end
+
+    def resolve_path(path_segments, context_stack)
+      full_path = path_segments.join('.')
+      stack = context_stack.dup
+
+      # Handle ../ parent navigation
+      while full_path.start_with?('../')
+        full_path = full_path[3..]
+        stack.pop unless stack.empty?
+      end
+
+      remaining_segments = full_path.empty? ? [] : full_path.split('.')
+      stack + remaining_segments
+    end
+
+    def handle_block_helper(node, context_stack)
+      traverse(node.helper, context_stack)
+      traverse(node.helper_template, context_stack)
+      traverse(node.else_template, context_stack) if node.else_template
+      node.arguments&.each { |arg| traverse(arg, context_stack) }
+      node.options&.each { |opt| traverse(opt.expression, context_stack) }
+    end
+
+    def handle_conditional(node, context_stack)
+      traverse(node.expression, context_stack)
+
+      if node.is_a?(Curlybars::Node::IfElse)
+        traverse(node.if_template, context_stack)
+      elsif node.is_a?(Curlybars::Node::UnlessElse)
+        traverse(node.unless_template, context_stack)
+      end
+      traverse(node.else_template, context_stack) if node.else_template
+    end
+
+    def handle_each(node, context_stack)
+      traverse(node.path, context_stack)
+
+      # EachElse changes context to the item being iterated
+      collection_path = node.path.respond_to?(:subexpression?) && node.path.subexpression? ? node.path.helper : node.path
+      new_context = context_stack + collection_path.path.split('.')
+      traverse(node.each_template, new_context)
+      traverse(node.else_template, context_stack) if node.else_template
+    end
+
+    def handle_with(node, context_stack)
+      traverse(node.path, context_stack)
+
+      # WithElse changes context to the specified path
+      presenter_path = node.path.respond_to?(:subexpression?) && node.path.subexpression? ? node.path.helper : node.path
+      new_context = context_stack + presenter_path.path.split('.')
+      traverse(node.with_template, new_context)
+      traverse(node.else_template, context_stack) if node.else_template
+    end
+  end
+end

data/lib/curlybars/presenter.rb

@@ -60,7 +60,7 @@ module Curlybars
           end
         end
 
-        instance_variable_set("@#{name}", value)
+        instance_variable_set(:"@#{name}", value)
       end
     end
 
@@ -276,8 +276,8 @@ module Curlybars
     # Delegates private method calls to the current view context.
     #
     # The view context, an instance of ActionView::Base, is set by Rails.
-    def method_missing(method, *args, **kwargs, &block)
-      @_context.public_send(method, *args, **kwargs, &block)
+    def method_missing(method, ...)
+      @_context.public_send(method, ...)
     end
 
     # Tells ruby (and developers) what methods we can accept.

data/lib/curlybars/rendering_support.rb

@@ -140,15 +140,15 @@ module Curlybars
       check_context_is_hash_or_enum_of_presenters(collection, path, position)
       if collection.is_a?(Hash)
         collection
-      elsif collection.respond_to? :each_with_index
-        collection.each_with_index.map { |value, index| [index, value] }.to_h
+      elsif collection.respond_to?(:each_with_index)
+        collection.each_with_index.to_h { |value, index| [index, value] }
       else
         raise "Collection is not coerceable to hash"
       end
     end
 
     def presenter?(context)
-      context.respond_to? :allows_method?
+      context.respond_to?(:allows_method?)
     end
 
     def presenter_collection?(collection)
@@ -180,12 +180,12 @@ module Curlybars
 
     attr_reader :contexts, :variables, :cached_calls, :file_name, :global_helpers, :start_time, :timeout, :cache
 
-    def instrument(meth, &block)
+    def instrument(meth, &)
       # Instruments only callables that give enough details (eg. methods)
       return yield unless meth.respond_to?(:name) && meth.respond_to?(:owner)
 
       payload = { presenter: meth.owner, method: meth.name }
-      ActiveSupport::Notifications.instrument("call_to_presenter.curlybars", payload, &block)
+      ActiveSupport::Notifications.instrument("call_to_presenter.curlybars", payload, &)
     end
 
     def arguments_for_signature(helper, arguments, options)

data/lib/curlybars/template_handler.rb

@@ -43,6 +43,9 @@ module Curlybars
 
       private
 
+      LEADING_ENCODING_REGEXP = /\A#{ActionView::ENCODING_FLAG}/
+      private_constant :LEADING_ENCODING_REGEXP
+
       def compile(template, source)
         # Template is empty, so there's no need to initialize a presenter.
         return %("") if source.empty?
@@ -55,7 +58,7 @@ module Curlybars
         # For security reason, we strip the encoding directive in order to avoid
         # potential issues when rendering the template in another character
         # encoding.
-        safe_source = source.gsub(/\A#{ActionView::ENCODING_FLAG}/, '')
+        safe_source = source.sub(LEADING_ENCODING_REGEXP, '')
 
         source = Curlybars.compile(safe_source, template.identifier)
 
@@ -84,9 +87,9 @@ module Curlybars
         RUBY
       end
 
-      def instrument(template, &block)
+      def instrument(template, &)
         payload = { path: template.virtual_path }
-        ActiveSupport::Notifications.instrument("compile.curlybars", payload, &block)
+        ActiveSupport::Notifications.instrument("compile.curlybars", payload, &)
       end
     end
   end

data/lib/curlybars/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Curlybars
-  VERSION = '1.12.0'
+  VERSION = '1.13.0'
 end

data/lib/curlybars/visitor.rb

@@ -20,7 +20,7 @@ module Curlybars
       return unless class_name.start_with?('Curlybars::Node')
 
       method_name = class_name.demodulize.underscore
-      send("visit_#{method_name}", node)
+      send(:"visit_#{method_name}", node)
     end
 
     def visit_block_helper_else(node)

data/lib/curlybars.rb

@@ -63,8 +63,8 @@ module Curlybars
     # identifier - The the file name of the template being checked (defaults to `nil`).
     #
     # Returns true if the template is valid, false otherwise.
-    def valid?(presenter_class, source, identifier = nil, **options)
-      errors = validate(presenter_class, source, identifier, **options)
+    def valid?(presenter_class, source, identifier = nil, **)
+      errors = validate(presenter_class, source, identifier, **)
       errors.empty?
     end
 
@@ -78,6 +78,20 @@ module Curlybars
       visitor.accept(tree)
     end
 
+    # Find all path nodes in the AST that resolve to a given path.
+    # Takes into account contextual scope from block helpers like #with, #each, etc.
+    #
+    # target_path - The path String to search for (e.g., "user.name" or "user.organizations.id").
+    # source - The source HBS String used to generate an AST.
+    # identifier - The the file name of the template being checked (defaults to `nil`).
+    #
+    # Returns an Array of Curlybars::Node::Path instances that match the target path.
+    def find(target_path, source, identifier = nil)
+      tree = ast(transformed_source(source), identifier, run_processors: true)
+      finder = Curlybars::PathFinder.new(tree)
+      finder.find(target_path)
+    end
+
     def global_helpers_dependency_tree
       @global_helpers_dependency_tree ||= begin
         classes = Curlybars.configuration.global_helpers_provider_classes
@@ -139,3 +153,4 @@ require 'curlybars/railtie' if defined?(Rails)
 require 'curlybars/presenter'
 require 'curlybars/method_whitelist'
 require 'curlybars/visitor'
+require 'curlybars/path_finder'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: curlybars
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Libo Cannici
@@ -12,10 +12,9 @@ authors:
 - Andreas Garnæs
 - Augusto Silva
 - Attila Večerek
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -23,28 +22,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '6.0'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement
@@ -73,132 +72,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: byebug
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: railties
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec-rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.57'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.57'
-- !ruby/object:Gem::Dependency
-  name: rubocop-performance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.19'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.19'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.6'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.25'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.25'
 description: |-
   A view layer for your Rails apps that separates structure and logic, using Handlebars templates.
   Strongly inspired by Curly Template gem by Daniel Schierbeck.
@@ -239,6 +112,7 @@ files:
 - lib/curlybars/node/variable.rb
 - lib/curlybars/node/with_else.rb
 - lib/curlybars/parser.rb
+- lib/curlybars/path_finder.rb
 - lib/curlybars/position.rb
 - lib/curlybars/presenter.rb
 - lib/curlybars/processor/tilde.rb
@@ -253,7 +127,6 @@ homepage: https://github.com/zendesk/curlybars
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options:
 - "--charset=UTF-8"
 require_paths:
@@ -262,15 +135,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Create your views using Handlebars templates!
 test_files: []