loose_erbs 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a199c48574375f7ba4180d6b80b2f5bac67ed8a9a7c77f12c57d5a2fb7f1d53a
-  data.tar.gz: cd693a62b42d1f2eec23ce25bec589b03586da8ae646d9d0a5a478a02e540e36
+  metadata.gz: ea8ec541c2125968aefd0a01e59febda8749e70a9a14b0ad4357167bd244fa02
+  data.tar.gz: 2c61f02374508721143bd510f840d2a87f3a928ec5b83df04e5eec54a005e228
 SHA512:
-  metadata.gz: 5678e042d65edac1b9868f7d2438860973f3830d6766f943e81e234af9dfcaf1065f9f0034be43221de7e72a3dc9037130cdac84a5c43406da91334cad52d71e
-  data.tar.gz: b96dda47a01a131505b6585fbc87f43cab4e93df845d096ee61983577f17b71919717ea3f3a0713f76bc994165bd9624c38797e1389f56d778d34e9a90092509
+  metadata.gz: 7a77cde39405160382448bc969e1ad9e8f9f1cbfd9e77d572f0e3f982d14ac3d860d6bd6f4b326b6ae1074ba9d09a91b053f632d2208c2f8109b08ef7e98958e
+  data.tar.gz: 9987b543cfcf9ea1c22e72ae59731753965da6213994762d4e8c311c139a3ce02d5fd4281c8de55e31e7df7062992e8e108d9cce45d8d938015605f71c0ba673

data/.rubocop.yml

@@ -0,0 +1,6 @@
+inherit_gem:
+  rubocop-rails_config:
+    - config/rails.yml
+
+Rails/RefuteMethods:
+  Enabled: false

data/README.md

@@ -1,35 +1,55 @@
-# LooseErbs
+# Loose ERBs
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/loose_erbs`. To experiment with that code, run `bin/console` for an interactive prompt.
+A tool to help find Loose ERBs in your app!
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
-
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ bundle add loose_erbs
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+    $ gem install loose_erbs
 
 ## Usage
 
-TODO: Write usage instructions here
+```shell
+$ loose_erbs --all
+/home/hartley/test/dm/app/views/layouts/application.html.erb
+
+/home/hartley/test/dm/app/views/posts/edit.html.erb
+└── /home/hartley/test/dm/app/views/posts/_form.html.erb
+
+/home/hartley/test/dm/app/views/posts/index.html.erb
+└── /home/hartley/test/dm/app/views/posts/_post.html.erb
+
+/home/hartley/test/dm/app/views/posts/new.html.erb
+└── /home/hartley/test/dm/app/views/posts/_form.html.erb
+
+/home/hartley/test/dm/app/views/posts/show.html.erb
+└── /home/hartley/test/dm/app/views/posts/_post.html.erb
+```
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake test` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and the created tag, and push the `.gem` file to
+[rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/loose_erbs.
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/skipkayhil/loose_erbs.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License][].
+
+[MIT License]: https://opensource.org/licenses/MIT

data/Rakefile

@@ -2,7 +2,9 @@
 
 require "bundler/gem_tasks"
 require "minitest/test_task"
+require "rubocop/rake_task"
 
 Minitest::TestTask.create
+RuboCop::RakeTask.new
 
-task default: :test
+task default: [:test, :rubocop]

data/exe/loose_erbs

@@ -1,5 +1,6 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require "loose_erbs"
 
-LooseErbs::Cli.new.run
+LooseErbs::Cli.new(ARGV).run

data/lib/loose_erbs/registry.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module LooseErbs
+  class Registry
+    def initialize(view_paths)
+      @map = {}
+      @view_paths = view_paths
+
+      @view_paths.each do |view_path|
+        Dir["#{view_path}/**/*.erb"].each { register _1 }
+      end
+    end
+
+    def dependencies_for(identifier)
+      template = @map.fetch(identifier)
+
+      LooseErbs.parser_class.call(identifier, template, @view_paths).uniq.map { lookup(_1) }
+    end
+
+    # this feels like a hack around not using view paths...
+    def lookup(pathish)
+      wrapper = Pathname.new(pathish)
+
+      if wrapper.absolute?
+        # /home/hartley/test/dm/app/views/posts/form
+        partial_path = wrapper.join("../_#{wrapper.basename}.html.erb").to_s
+
+        return partial_path if @map.key? partial_path
+
+        # The DependencyTracker always puts the partial under the parent's
+        # namespace even if it could be found under a controller's super's
+        # namespace.
+        @view_paths.each do |view_path|
+          partial_path = Pathname.new(view_path).join("application/_#{wrapper.basename}.html.erb").to_s
+
+          return partial_path if @map.key? partial_path
+        end
+      else
+        # posts/post
+        @view_paths.each do |view_path|
+          partial_path = Pathname.new(view_path).join(pathish).join("../_#{wrapper.basename}.html.erb").to_s
+
+          return partial_path if @map.key? partial_path
+        end
+      end
+
+      warn("Couldn't resolve pathish: #{pathish}")
+
+      "UNKNOWN TEMPLATE: #{pathish}"
+    end
+
+    def register(path)
+      @map[path] = ActionView::Template.new(
+        File.read(path),
+        path,
+        ActionView::Template::Handlers::ERB,
+        locals: nil,
+        format: :html,
+      )
+    end
+
+    def to_graph
+      Graph.new(@map.keys, self)
+    end
+  end
+end

data/lib/loose_erbs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LooseErbs
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/loose_erbs.rb

@@ -2,6 +2,7 @@
 
 require "action_view"
 require "action_view/dependency_tracker"
+require "optparse"
 
 require_relative "loose_erbs/version"
 
@@ -14,70 +15,129 @@ module LooseErbs
     ActionView::DependencyTracker::RipperTracker
   end
 
-  class Template
-    class << self
-      def from(path)
-        new(path, File.read(path))
-      end
-    end
+  NoParentFilter = ->(node) { node.parents.empty? }
+  PartialFilter = ->(node) { Pathname.new(node.identifier).basename.to_s.start_with?("_") }
 
-    attr_reader :path, :source
+  RegexpIncludeFactory = ->(regexp) {
+    ->(node) { node.identifier.match?(regexp) }
+  }
+  RegexpExcludeFactory = ->(regexp) {
+    ->(node) { !node.identifier.match?(regexp) }
+  }
 
-    def initialize(path, source)
-      @path = path
-      @source = source
-    end
+  class Cli
+    def initialize(argv)
+      @options = {}
 
-    def dependencies
-      LooseErbs.parser_class.call(path, self)
+      option_parser.parse!(into: @options)
     end
 
-    def handler
-      ActionView::Template::Handlers::ERB
-    end
+    def run
+      require File.expand_path("./config/environment")
 
-    def type
-      ["text/html"]
+      Registry.new(ActionController::Base.view_paths).to_graph.print(filters)
     end
 
-    def inspect
-      path
-    end
+    private
+      attr_reader :options
+
+      def filters
+        [
+          NoParentFilter,
+          (RegexpIncludeFactory.call(options[:include]) if options[:include]),
+          (RegexpExcludeFactory.call(options[:exclude]) if options[:exclude]),
+          (PartialFilter unless options[:all]),
+        ].compact
+      end
+
+      def option_parser
+        OptionParser.new do |parser|
+          parser.on("--all", "Print all files with no parents (defaults to only partials)")
+          parser.on("--include [REGEXP]", Regexp, "Only print files that match [REGEXP]")
+          parser.on("--exclude [REGEXP]", Regexp, "Do not print files that match [REGEXP]")
+        end
+      end
   end
 
-  class Registry
-    def initialize
-      @map = {}
-    end
+  class Graph
+    class Printer
+      def initialize(root)
+        @node_stack = [[root, -1]]
+        @seen_nodes = Set.new
+      end
 
-    def print
-      @map.values.each do |template|
-        puts template.inspect
+      def print
+        while !@node_stack.empty?
+          node, depth = @node_stack.pop
 
-        template.dependencies.each do |dependency|
-          puts "└── #{dependency}"
+          puts "#{("    " * depth) + "└── " if depth >= 0}#{node.identifier}"
+
+          if @seen_nodes.include?(node) && !node.children.empty?
+            puts ("    " * (depth + 1)) + "└── ..."
+          else
+            @seen_nodes << node
+
+            node.children.each do |child|
+              @node_stack << [child, depth + 1]
+            end
+          end
         end
+        puts
+      end
+    end
+
+    class Node
+      attr_reader :children, :identifier, :parents
+
+      def initialize(identifier)
+        @identifier = identifier
+        @children = []
+        @parents = []
       end
     end
 
-    def register(path)
-      @map[path] = Template.from(path)
+    def initialize(keys, registry)
+      @node_map = keys.to_h { [_1, Node.new(_1)] }
+      @registry = registry
+
+      nodes.each { process(_1) }
     end
-  end
 
-  class Cli
-    def run
-      registry = Registry.new
+    def print(filters)
+      nodes_to_print = nodes
 
-      views.each { registry.register(_1) }
+      filters.each do |filter|
+        nodes_to_print.filter!(&filter)
+      end
 
-      registry.print
+      nodes_to_print.each { Printer.new(_1).print }
     end
 
     private
+      attr_reader :registry
 
-    def views
-      Dir["#{Dir.pwd}/app/views/**/*.html.erb"]
-    end
+      def nodes
+        @node_map.values
+      end
+
+      def process(node)
+        assign_children!(node)
+        assign_parents!(node)
+      end
+
+      def assign_children!(node)
+        registry.dependencies_for(node.identifier).each do |identifier|
+          # warn("No template registered for path: #{template.identifier}")
+          node.children << @node_map.fetch(identifier) { Node.new(identifier) }
+        end
+      end
+
+      def assign_parents!(node)
+        node.children.each do |child_node|
+          child_node.parents << node
+        end
+      end
   end
 end
+
+require_relative "loose_erbs/registry"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loose_erbs
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Hartley McGuire
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-01-31 00:00:00.000000000 Z
+date: 2024-02-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -32,11 +32,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rubocop.yml"
 - LICENSE.txt
 - README.md
 - Rakefile
 - exe/loose_erbs
 - lib/loose_erbs.rb
+- lib/loose_erbs/registry.rb
 - lib/loose_erbs/version.rb
 homepage: https://github.com/skipkayhil/loose_erbs
 licenses: