Class: ActionView::DependencyTracker::ERBTracker

Do not use. This class is for internal use only.

Relationships & Source Files
Inherits:	Object
Defined in:	actionview/lib/action_view/dependency_tracker/erb_tracker.rb

Constant Summary

EXPLICIT_DEPENDENCY =
# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 6
```
/# Template Dependency: (\S+)/
```
IDENTIFIER =

A valid ruby identifier - suitable for class, method and specially variable names

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 9
```
/
  [[:alpha:]_] # at least one uppercase letter, lowercase letter or underscore
  [[:word:]]*  # followed by optional letters, numbers or underscores
/x
```

LAYOUT_DEPENDENCY =
# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 58

/\A
  (?:\s*\(?\s*)                                  # optional opening paren surrounded by spaces
  (?:.*?#{LAYOUT_HASH_KEY})                      # check if the line has layout key declaration
  (?:#{STRING}|#{VARIABLE_OR_METHOD_CHAIN})      # finally, the dependency name of interest
/xm

LAYOUT_HASH_KEY =

Part of any hash containing the :layout key

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 36

/
  (?:\blayout:|:layout\s*=>)   # layout key in either old or new style hash syntax
  \s*                          # followed by optional spaces
/x

PARTIAL_HASH_KEY =

Part of any hash containing the :partial key

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 30

/
  (?:\bpartial:|:partial\s*=>) # partial key in either old or new style hash syntax
  \s*                          # followed by optional spaces
/x

RENDER_ARGUMENTS =

Matches:

partial: "comments/comment", collection: @all_comments => "comments/comment"
(object: @single_comment, partial: "comments/comment") => "comments/comment"

"comments/comments"
'comments/comments'
('comments/comments')

(@topic)         => "topics/topic"
 topics          => "topics/topic"
(message.topics) => "topics/topic"

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 52

/\A
  (?:\s*\(?\s*)                                  # optional opening paren surrounded by spaces
  (?:.*?#{PARTIAL_HASH_KEY}|#{LAYOUT_HASH_KEY})? # optional hash, up to the partial or layout key declaration
  (?:#{STRING}|#{VARIABLE_OR_METHOD_CHAIN})      # finally, the dependency name of interest
/xm

STRING =

A simple string literal. e.g. “School’s out!”

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 23

/
  (?<quote>['"]) # an opening quote
  (?<static>.*?) # with anything inside, captured as STATIC
  \k<quote>      # and a matching closing quote
/x

VARIABLE_OR_METHOD_CHAIN =

Any kind of variable name. e.g. @instance, @@class, $global or local. Possibly following a method call chain

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 16

/
  (?:\$|@{1,2})?            # optional global, instance or class variable indicator
  (?:#{IDENTIFIER}\.)*      # followed by an optional chain of zero-argument method calls
  (?<dynamic>#{IDENTIFIER}) # and a final valid identifier, captured as DYNAMIC
/x

Class Attribute Summary

.supports_view_paths? ⇒ Boolean readonly

Class Method Summary

.call(name, template, view_paths = nil)
.new(name, template, view_paths = nil) ⇒ ERBTracker constructor

Instance Attribute Summary

#name readonly private
#template readonly private

Instance Method Summary

#dependencies
#add_dependencies(render_dependencies, arguments, pattern) private
#add_dynamic_dependency(dependencies, dependency) private
#add_static_dependency(dependencies, dependency, quote_type) private
#directory private
#explicit_dependencies private
#render_dependencies private
#resolve_directories(wildcard_dependencies) private
#source private

Constructor Details

.new(name, template, view_paths = nil) ⇒ `ERBTracker`

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 72


def initialize(name, template, view_paths = nil)
  @name, @template, @view_paths = name, template, view_paths
end

Class Attribute Details

.supports_view_paths? ⇒ `Boolean` (readonly)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 64


def self.supports_view_paths? # :nodoc:
  true
end

Class Method Details

.call(name, template, view_paths = nil)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 68


def self.call(name, template, view_paths = nil)
  new(name, template, view_paths).dependencies
end

Instance Attribute Details

#name (readonly, private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 80


attr_reader :name, :template

#template (readonly, private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 80


attr_reader :name, :template

Instance Method Details

#add_dependencies(render_dependencies, arguments, pattern) (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 104


def add_dependencies(render_dependencies, arguments, pattern)
  arguments.scan(pattern) do
    match = Regexp.last_match
    add_dynamic_dependency(render_dependencies, match[:dynamic])
    add_static_dependency(render_dependencies, match[:static], match[:quote])
  end
end

#add_dynamic_dependency(dependencies, dependency) (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 112


def add_dynamic_dependency(dependencies, dependency)
  if dependency
    dependencies << "#{dependency.pluralize}/#{dependency.singularize}"
  end
end

#add_static_dependency(dependencies, dependency, quote_type) (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 118


def add_static_dependency(dependencies, dependency, quote_type)
  if quote_type == '"'
    # Ignore if there is interpolation
    return if dependency.include?('#{')
  end

  if dependency
    if dependency.include?("/")
      dependencies << dependency
    else
      dependencies << "#{directory}/#{dependency}"
    end
  end
end

#dependencies

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 76


def dependencies
  render_dependencies + explicit_dependencies
end

#directory (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 88


def directory
  name.split("/")[0..-2].join("/")
end

#explicit_dependencies (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 145


def explicit_dependencies
  dependencies = source.scan(EXPLICIT_DEPENDENCY).flatten.uniq

  wildcards, explicits = dependencies.partition { |dependency| dependency.end_with?("/*") }

  (explicits + resolve_directories(wildcards)).uniq
end

#render_dependencies (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 92


def render_dependencies
  render_dependencies = []
  render_calls = source.split(/\brender\b/).drop(1)

  render_calls.each do |arguments|
    add_dependencies(render_dependencies, arguments, LAYOUT_DEPENDENCY)
    add_dependencies(render_dependencies, arguments, RENDER_ARGUMENTS)
  end

  render_dependencies.uniq
end

#resolve_directories(wildcard_dependencies) (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 133


def resolve_directories(wildcard_dependencies)
  return [] unless @view_paths
  return [] if wildcard_dependencies.empty?

  # Remove trailing "/*"
  prefixes = wildcard_dependencies.map { |query| query[0..-3] }

  @view_paths.flat_map(&:all_template_paths).uniq.filter_map { |path|
    path.to_s if prefixes.include?(path.prefix)
  }.sort
end

#source (private)

[ GitHub ]

# File 'actionview/lib/action_view/dependency_tracker/erb_tracker.rb', line 84


def source
  template.source
end

Class: ActionView::DependencyTracker::ERBTracker

Constant Summary

Class Attribute Summary

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(name, template, view_paths = nil) ⇒ ERBTracker

Class Attribute Details

.supports_view_paths? ⇒ Boolean (readonly)

Class Method Details

.call(name, template, view_paths = nil)

Instance Attribute Details

#name (readonly, private)

#template (readonly, private)

Instance Method Details

#add_dependencies(render_dependencies, arguments, pattern) (private)

#add_dynamic_dependency(dependencies, dependency) (private)

#add_static_dependency(dependencies, dependency, quote_type) (private)

#dependencies

#directory (private)

#explicit_dependencies (private)

#render_dependencies (private)

#resolve_directories(wildcard_dependencies) (private)

#source (private)

.new(name, template, view_paths = nil) ⇒ `ERBTracker`

.supports_view_paths? ⇒ `Boolean` (readonly)