ffast 0.1.9 → 0.2.2

data/lib/fast.rb

@@ -67,24 +67,103 @@ module Fast
     %\d                   # bind extra arguments to the expression
   /x.freeze
 
+  # Set some convention methods from file.
+  class Node < Astrolabe::Node
+    # @return [String] with path of the file or simply buffer name.
+    def buffer_name
+      expression.source_buffer.name
+    end
+
+    # @return [Parser::Source::Range] from the expression
+    def expression
+      location.expression
+    end
+
+    # @return [String] with the content of the #expression
+    def source
+      expression.source
+    end
+
+    # @return [Boolean] true if a file exists with the #buffer_name
+    def from_file?
+      File.exist?(buffer_name)
+    end
+
+    # @return [Array<String>] with authors from the current expression range
+    def blame_authors
+      `git blame -L #{expression.first_line},#{expression.last_line} #{buffer_name}`.lines.map do |line|
+        line.split('(')[1].split(/\d+/).first.strip
+      end
+    end
+
+    # @return [String] with the first element from #blame_authors
+    def author
+      blame_authors.first
+    end
+
+    # Search recursively into a node and its children using a pattern.
+    # @param [String] pattern
+    # @param [Array] *args extra arguments to interpolate in the pattern.
+    # @return [Array<Fast::Node>>] with files and results
+    def search(pattern, *args)
+      Fast.search(pattern, self, *args)
+    end
+
+    # Captures elements from search recursively
+    # @param [String] pattern
+    # @param [Array] *args extra arguments to interpolate in the pattern.
+    # @return [Array<Fast::Node>>] with files and results
+    def capture(pattern, *args)
+      Fast.capture(pattern, self, *args)
+    end
+  end
+
+  # Custom builder allow us to set a buffer name for each Node
+  class Builder < Astrolabe::Builder
+    attr_writer :buffer_name
+    # Generates {Node} from the given information.
+    #
+    # @return [Node] the generated node
+    def n(type, children, source_map)
+      Node.new(type, children, location: source_map, buffer_name: @buffer_name)
+    end
+  end
+
   class << self
-    # @return [Astrolabe::Node] from the parsed content
+    # @return [Fast::Node] from the parsed content
     # @example
     #   Fast.ast("1") # => s(:int, 1)
     #   Fast.ast("a.b") # => s(:send, s(:send, nil, :a), :b)
     def ast(content, buffer_name: '(string)')
       buffer = Parser::Source::Buffer.new(buffer_name)
       buffer.source = content
-      Parser::CurrentRuby.new(Astrolabe::Builder.new).parse(buffer)
+      Parser::CurrentRuby.new(builder_for(buffer_name)).parse(buffer)
+    end
+
+    def builder_for(buffer_name)
+      builder = Builder.new
+      builder.buffer_name = buffer_name
+      builder
     end
 
-    # @return [Astrolabe::Node] parsed from file content
+    # @return [Fast::Node] parsed from file content
     # caches the content based on the filename.
+    # Also, it can parse SQL files.
     # @example
     #   Fast.ast_from_file("example.rb") # => s(...)
     def ast_from_file(file)
       @cache ||= {}
-      @cache[file] ||= ast(IO.read(file), buffer_name: file)
+      @cache[file] ||=
+        begin
+          method =
+            if file.end_with?('.sql')
+              require_relative 'fast/sql' unless respond_to?(:parse_sql)
+              :parse_sql
+            else
+              :ast
+            end
+          Fast.public_send(method, IO.read(file), buffer_name: file)
+        end
     end
 
     # Verify if a given AST matches with a specific pattern
@@ -96,18 +175,23 @@ module Fast
     end
 
     # Search with pattern directly on file
-    # @return [Array<Astrolabe::Node>] that matches the pattern
+    # @return [Array<Fast::Node>] that matches the pattern
     def search_file(pattern, file)
       node = ast_from_file(file)
       return [] unless node
 
-      search pattern, node
+      case node
+      when Array
+        node.map { |n| search(pattern, n) }.flatten.compact
+      else
+        search pattern, node
+      end
     end
 
     # Search with pattern on a directory or multiple files
     # @param [String] pattern
     # @param [Array<String>] *locations where to search. Default is '.'
-    # @return [Hash<String,Array<Astrolabe::Node>>] with files and results
+    # @return [Hash<String,Array<Fast::Node>>] with files and results
     def search_all(pattern, locations = ['.'], parallel: true, on_result: nil)
       group_results(build_grouped_search(:search_file, pattern, on_result),
                     locations, parallel: parallel)
@@ -160,8 +244,12 @@ module Fast
     def capture_file(pattern, file)
       node = ast_from_file(file)
       return [] unless node
-
-      capture pattern, node
+      case node
+      when Array
+        node.map { |n| capture(pattern, n) }.flatten.compact
+      else
+        capture pattern, node
+      end
     end
 
     # Search recursively into a node and its children.
@@ -173,9 +261,14 @@ module Fast
         yield node, match if block_given?
         match != true ? [node, match] : [node]
       else
-        node.each_child_node
-          .flat_map { |child| search(pattern, child, *args) }
-          .compact.flatten
+        case node
+        when Array
+          node.flat_map { |child| search(pattern, child, *args) }
+        else
+          node.each_child_node
+            .flat_map { |child| search(pattern, child, *args) }
+            .compact.flatten
+        end
       end
     end
 
@@ -241,7 +334,7 @@ module Fast
     # Useful to index abstract patterns or similar code structure.
     # @see https://jonatas.github.io/fast/similarity_tutorial/
     # @return [String] with an pattern to search from it.
-    # @param node [Astrolabe::Node]
+    # @param node [Fast::Node]
     # @example
     #   Fast.expression_from(Fast.ast('1')) # => '(int _)'
     #   Fast.expression_from(Fast.ast('a = 1')) # => '(lvasgn _ (int _))'
@@ -250,7 +343,7 @@ module Fast
       case node
       when Parser::AST::Node
         children_expression = node.children.map(&method(:expression_from)).join(' ')
-        "(#{node.type}#{' ' + children_expression if node.children.any?})"
+        "(#{node.type}#{" #{children_expression}" if node.children.any?})"
       when nil, 'nil'
         'nil'
       when Symbol, String, Numeric
@@ -305,14 +398,14 @@ module Fast
       when '{' then Any.new(parse_until_peek('}'))
       when '[' then All.new(parse_until_peek(']'))
       when /^"/ then FindString.new(token[1..-2])
-      when /^#\w/ then MethodCall.new(token[1..-1])
-      when /^\.\w[\w\d_]+\?/ then InstanceMethodCall.new(token[1..-1])
+      when /^#\w/ then MethodCall.new(token[1..])
+      when /^\.\w[\w\d_]+\?/ then InstanceMethodCall.new(token[1..])
       when '$' then Capture.new(parse)
       when '!' then (@tokens.any? ? Not.new(parse) : Find.new(token))
       when '?' then Maybe.new(parse)
       when '^' then Parent.new(parse)
       when '\\' then FindWithCapture.new(parse)
-      when /^%\d/ then FindFromArgument.new(token[1..-1])
+      when /^%\d/ then FindFromArgument.new(token[1..])
       else Find.new(token)
       end
     end
@@ -367,6 +460,10 @@ module Fast
         node.type == expression.to_sym
       when String
         node == expression.to_s
+      when TrueClass
+        expression == :true
+      when FalseClass
+        expression == :false
       else
         node == expression
       end

data/mkdocs.yml

@@ -1,12 +1,18 @@
 site_name: Fast
 repo_url: https://github.com/jonatas/fast
 edit_uri: edit/master/docs/
-google_analytics: ['UA-125089529-1', 'auto']
+google_analytics: ['G-YKZDZDNRG2', 'auto']
+
 theme:
   name: material
   palette:
     primary: indigo
     accent: pink
+  logo: assets/logo.png
+  favicon: assets/favicon.png
+extra_css:
+  - stylesheets/custom.css
+
 markdown_extensions:
   - admonition
   - codehilite:
@@ -15,13 +21,16 @@ markdown_extensions:
       permalink: true
 nav:
   - Introduction: index.md
+  - Walkthrough: walkthrough.md
   - Syntax: syntax.md
   - Command Line: command_line.md
   - Experiments: experiments.md
   - Shortcuts: shortcuts.md
+  - Git Integration: git.md
   - Code Similarity: similarity_tutorial.md
   - Pry Integration: pry-integration.md
   - Editors' Integration: editors-integration.md
   - Research: research.md
   - Ideas: ideas.md
   - Videos: videos.md
+  - SQL Support: sql-support.md

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ffast
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.2.2
 platform: ruby
 authors:
 - Jônatas Davi Paganini
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-05-13 00:00:00.000000000 Z
+date: 2023-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: astrolabe
@@ -66,6 +66,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: pg_query
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: git
+  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: guard
   requirement: !ruby/object:Gem::Requirement
@@ -154,30 +182,30 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -247,6 +275,7 @@ files:
 - ".projections.json"
 - ".rspec"
 - ".rubocop.yml"
+- ".sourcelevel.yml"
 - ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Fastfile
@@ -263,14 +292,17 @@ files:
 - docs/command_line.md
 - docs/editors-integration.md
 - docs/experiments.md
+- docs/git.md
 - docs/ideas.md
 - docs/index.md
 - docs/pry-integration.md
 - docs/research.md
 - docs/shortcuts.md
 - docs/similarity_tutorial.md
+- docs/sql-support.md
 - docs/syntax.md
 - docs/videos.md
+- docs/walkthrough.md
 - examples/build_stubbed_and_let_it_be_experiment.rb
 - examples/experimental_replacement.rb
 - examples/find_usage.rb
@@ -286,15 +318,33 @@ files:
 - lib/fast.rb
 - lib/fast/cli.rb
 - lib/fast/experiment.rb
+- lib/fast/git.rb
 - lib/fast/rewriter.rb
 - lib/fast/shortcut.rb
+- lib/fast/sql.rb
+- lib/fast/sql/rewriter.rb
 - lib/fast/version.rb
 - mkdocs.yml
 homepage: https://jonatas.github.io/fast/
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message: |2+
+
+  ==========================================================
+  Yay! Thanks for installing
+
+     ___       __  ___
+    |__   /  /__`  |
+    |    /~~ .__/  |
+
+  To interactive learn about the gem in the terminal use:
+
+  fast .intro
+
+  More docs at: https://jonatas.github.io/fast/
+  ==========================================================
+
 rdoc_options: []
 require_paths:
 - lib
@@ -303,15 +353,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.4.22
+signing_key:
 specification_version: 4
 summary: 'FAST: Find by AST.'
 test_files: []
+...