masamune-ast 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1131c8f9da2cb862e77f3840c9abc806443a7d4445d788fd3683cec41b1916e8
-  data.tar.gz: bb9025361d1063fd3f7776070830b4e41b7529d3ea04b11fbe9466890bca8d28
+  metadata.gz: 1ee5dca320a96035fcea4f73effbc3fceff2ee531808bf94d99aa21086186ce5
+  data.tar.gz: 3f170766c1e97a15e9c550e61fc5f2048b28b48a5f12e2b4841a31b0dad6ebbb
 SHA512:
-  metadata.gz: f6e571ac354ab0fae7e39fbf1d0030c1025738732d008b9c3afa9ade11c2cb41b88d67a08ac66d878dd913fae1a9cf08f79d4539f931b7a55fd43f563332d08b
-  data.tar.gz: 47065f76eebaab82601b9d577a738765e66d588f6ad300931223bd61824e0f290612a6341dd098d8bd78cdb90e5b44ce9513d6beb5280b9ebc5691b4044145ea
+  metadata.gz: 7650eff09ecb23034c236363ee70a971f003736a967f8efd5ae8f36e68d598f73a4239a38d839f478b4aa6b36662d7114834dedf501acfed6bd2adcb6494890e
+  data.tar.gz: fbd0fc4a505b03dc38304abdfadd9cb31fccf5f746bbb325056c63e9a790d7814bd7292d40c95da7441731cf3ab0613f2e9879c4c27f07f61445370a499665a2

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [1.0.0] - 2023-05-01
+
+- Change `MasamuneAst` module to `Masamune`.
+
 ## [0.1.0] - 2023-04-24
 
 - Initial release

data/Gemfile.lock

@@ -1,18 +1,29 @@
 PATH
   remote: .
   specs:
-    masamune-ast (0.1.0)
+    masamune-ast (1.1.0)
+      activesupport
 
 GEM
   remote: https://rubygems.org/
   specs:
+    activesupport (7.0.4.3)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
     coderay (1.1.3)
+    concurrent-ruby (1.2.2)
+    i18n (1.13.0)
+      concurrent-ruby (~> 1.0)
     method_source (1.0.0)
     minitest (5.18.0)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     rake (13.0.6)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
 
 PLATFORMS
   x86_64-linux

data/README.md

@@ -1,9 +1,14 @@
-# MasamuneAst
+# Masamune
 
 ## A Ruby source code analyzer based on Ripper’s Abstract Syntax Tree generator (`Ripper#sexp`).
 
 ## Installation
 
+```ruby
+sudo gem install "masamune-ast"
+```
+
+Or add the following to your Gemfile and run `bundle install`
 ```ruby
 gem "masamune-ast"
 ```
@@ -19,47 +24,80 @@ puts java + " is not " + javascript
 # java
 CODE
 
-msmn = MasamuneAst::AbstractSyntaxTree.new(code)
+msmn = Masamune::AbstractSyntaxTree.new(code)
 
 msmn.variables
-[[[1, 0], "java"], [[2, 0], "javascript"], [[2, 13], "java"]]
+#=> [{:position=>[1, 0], :token=>"java"},
+#=> {:position=>[2, 0], :token=>"javascript"},
+#=> {:position=>[2, 13], :token=>"java"},
+#=> {:position=>[3, 5], :token=>"java"},
+#=> {:position=>[3, 25], :token=>"javascript"}]
+
+msmn.strings
+#=> [{:position=>[1, 8], :token=>"java"},
+#=> {:position=>[2, 21], :token=>"script"},
+#=> {:position=>[3, 13], :token=>" is not "}]
+
+msmn.variables(name: "java")
+#=> [{position: [1, 0], token: "java"},
+#=> {position: [2, 13], token: "java"},
+#=> {position: [3, 5], token: "java"}]
+
+code = <<CODE
+ary = [1, 2, 3]
+ary.sum.times do |n|
+  puts n
+end
+
+def foo
+end
+foo
+foo # Call again
+CODE
 
-msmn.search(:variable, "java")
-#=> [[[1, 0], "java"], [[2, 13], "java"]]
+msmn = Masamune::AbstractSyntaxTree.new(code)
+
+msmn.all_methods
+#=> [{:position=>[6, 4], :token=>"foo"},
+#=> {:position=>[2, 4], :token=>"sum"},
+#=> {:position=>[2, 8], :token=>"times"},
+#=> {:position=>[8, 0], :token=>"foo"},
+#=> {:position=>[9, 0], :token=>"foo"}]
+
+msmn.method_calls
+#=> [{:position=>[2, 4], :token=>"sum"},
+#=> {:position=>[2, 8], :token=>"times"},
+#=> {:position=>[8, 0], :token=>"foo"},
+#=> {:position=>[9, 0], :token=>"foo"}]
+
+msmn.method_definitions
+#=> [{:position=>[6, 4], :token=>"foo"}]
 ```
 
-In some cases, it can be easier to look at the given lex nodes to analyze your source code:
+In some cases, it can be easier to look at the given lex nodes to analyze your source code since you can easily see the index and the line position it's on:
 ```ruby
 msmn.lex_nodes
 => [#<Masamune::LexNode:0x00007fd61810cac0 @ast_id=1200, @index=0, @position=[1, 0], @state=CMDARG, @token="java", @type=:ident>,
  #<Masamune::LexNode:0x00007fd61810c930 @ast_id=1200, @index=1, @position=[1, 4], @state=CMDARG, @token=" ", @type=:sp>,
  #<Masamune::LexNode:0x00007fd61810c7c8 @ast_id=1200, @index=2, @position=[1, 5], @state=BEG, @token="=", @type=:op>,
- #<Masamune::LexNode:0x00007fd61810c638 @ast_id=1200, @index=3, @position=[1, 6], @state=BEG, @token=" ", @type=:sp>,
- #<Masamune::LexNode:0x00007fd61810c480 @ast_id=1200, @index=4, @position=[1, 7], @state=BEG, @token="\"", @type=:tstring_beg>,
- #<Masamune::LexNode:0x00007fd61810c318 @ast_id=1200, @index=5, @position=[1, 8], @state=BEG, @token="java", @type=:tstring_content>,
- #<Masamune::LexNode:0x00007fd61810c188 @ast_id=1200, @index=6, @position=[1, 12], @state=END, @token="\"", @type=:tstring_end>,
- #<Masamune::LexNode:0x00007fd61810c020 @ast_id=1200, @index=7, @position=[1, 13], @state=BEG, @token="\n", @type=:nl>,
- #<Masamune::LexNode:0x00007fd618113e88 @ast_id=1200, @index=8, @position=[2, 0], @state=CMDARG, @token="javascript", @type=:ident>,
- #<Masamune::LexNode:0x00007fd618113cf8 @ast_id=1200, @index=9, @position=[2, 10], @state=CMDARG, @token=" ", @type=:sp>,
- #<Masamune::LexNode:0x00007fd618113b68 @ast_id=1200, @index=10, @position=[2, 11], @state=BEG, @token="=", @type=:op>,
 …
 ]
 
-msmn.lex_nodes[8].is_variable?
+lex_node = msmn.lex_nodes.first
+
+lex_node.variable?
 #=> true
 
-msmn.lex_nodes[8].is_string?
+lex_node.string?
 #=> false
 
-msmn.lex_nodes[8].is_method_definition?
+lex_node.method_definition?
 #=> false
-
-# etc...
 ```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/gazayas/masamune.
+Bug reports and pull requests are welcome on GitHub at https://github.com/gazayas/masamune-ast.
 
 ## License
 

data/lib/masamune/abstract_syntax_tree/assign.rb

@@ -0,0 +1,11 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Assign < Node
+      def initialize(contents, ast_id)
+        super
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/block_var.rb

@@ -0,0 +1,22 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class BlockVar < Node
+      attr_accessor :ast_id
+
+      def initialize(contents, ast_id)
+        super
+      end
+
+      # :block_var has a lot of nil values within in.
+      # I'm not sure what this represents, but it would be
+      # nice to find out and implement it document/implement it somewhere.
+      def extract_data_nodes
+        @contents[1][1].map do |content|
+          Masamune::AbstractSyntaxTree::DataNode.new(content, @ast_id)
+        end
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/brace_block.rb

@@ -0,0 +1,19 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class BraceBlock < Node
+      attr_accessor :ast_id
+
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def params
+        # This node should exist already, so we search for it in the ast object.
+        block_var = Masamune::AbstractSyntaxTree::BlockVar.new(contents[1], ast_id)
+        ast.node_list.find {|node| node.contents == block_var.contents}
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/call.rb

@@ -0,0 +1,17 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Call < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents.last, @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/data_node.rb

@@ -0,0 +1,62 @@
+# A data node represents an abstraction in the AST which has details about a specific type.
+# i.e. - [:@ident, "variable_name", [4, 7]]
+# These values are the `type`, `token`, and `position`, respectively.
+# It is simliar to what you see in `Ripper.lex(code)` and `Masamune::AbstractSyntaxTree's @lex_nodes`.
+
+# We break this down into a simpler structure, `position_and_token`,
+# which looks like this: {position: [4, 7], token: "ruby"}
+
+module Masamune
+  class AbstractSyntaxTree
+    class DataNode < Node
+      attr_reader :type, :token, :line_position
+
+      def initialize(contents, ast_id)
+        @type, @token, @line_position = contents
+        super(contents, ast_id)
+      end
+
+      # Results here represent the position and token of the
+      # data we're searching in the form of a Hash like the following:
+      # [
+      #   {position: [4, 7], token: "ruby"},
+      #   {position: [7, 7], token: "rails"}
+      # ]
+      # TODO: Worry about using a faster sorting algorithm later.
+      def self.order_results_by_position(position_and_token_ary)
+        # Extract the line numbers first, i.e - 4 from [4, 7]
+        line_numbers = position_and_token_ary.map do |position_and_token|
+          line_number = position_and_token[:position].first
+        end.uniq.sort
+
+        final_result = []
+        line_numbers.each do |line_number|
+          # Group data together in an array if they're on the same line.
+          shared_line_data = position_and_token_ary.select do |position_and_token|
+            position_and_token[:position].first == line_number
+          end
+
+          # Sort the positions on each line number respectively.
+          positions_on_line = shared_line_data.map do |position_and_token|
+            position_and_token[:position].last
+          end.sort
+
+          # Apply to the final result.
+          positions_on_line.each do |position_on_line|
+            shared_line_data.each do |position_and_token|
+              if position_and_token[:position].last == position_on_line
+                final_result << position_and_token
+              end
+            end
+          end
+        end
+
+        final_result
+      end
+
+      def position_and_token
+        {position: @line_position, token: @token}
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/def.rb

@@ -0,0 +1,17 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Def < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents[1], @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/do_block.rb

@@ -0,0 +1,19 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class DoBlock < Node
+      attr_accessor :ast_id
+
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def params
+        # This node should exist already, so we search for it in the ast object.
+        block_var = Masamune::AbstractSyntaxTree::BlockVar.new(contents[1], ast_id)
+        ast.node_list.find {|node| node.contents == block_var.contents}
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/node.rb

@@ -0,0 +1,41 @@
+# TODO: Add description
+
+module Masamune
+  class AbstractSyntaxTree
+    class Node
+      attr_reader :ast_id, :contents, :index_stack, :data_nodes
+
+      def initialize(contents, ast_id)
+        @ast_id = ast_id
+        @contents = contents
+        @data_nodes = extract_data_nodes
+      end
+
+      def ast
+        ObjectSpace._id2ref(@ast_id)
+      end
+
+      # TODO: Consider removing the :type and :typeless methods.
+
+      # Ripper's abstract syntax tree nodes are either typed or typeless.
+      # Types consist of values such as :def, :do_block, :var_ref, etc.
+      # Typed nodes house one of these types as its first element,
+      # whereas typeless nodes simply have arrays as top-level elements.
+      # Example of a typed node: [:@tstring_content, "ruby", [4, 7]]
+      def typed?
+        @contents.is_a?(Array) && @contents.first.is_a?(Symbol)
+      end
+
+      def typeless?
+        !typed?
+      end
+
+      # By default, we assume a node has no data nodes to extract.
+      # Because the structure for each node is different, we handle
+      # extraction separately for each node within its respective class.
+      def extract_data_nodes
+        # TODO: Might want to make this [] instead of nil.
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/params.rb

@@ -0,0 +1,23 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Params < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        # TODO: Sometimes the params node looks like this:
+        # [:params, nil, nil, nil, nil, nil, nil, nil]
+        # Add a description for this, and review this portion
+        # to ensure that it's being handled properly.
+        unless @contents[1].nil?
+          @contents[1].map do |content|
+            Masamune::AbstractSyntaxTree::DataNode.new(content, @ast_id)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/program.rb

@@ -0,0 +1,16 @@
+# Program represents the top layer of the AST,
+# and the second element of the array houses the entire program.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Program < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        # No data nodes to extract.
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/string_content.rb

@@ -0,0 +1,17 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class StringContent < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents[1], @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/var_field.rb

@@ -0,0 +1,17 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class VarField < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents[1], @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/var_ref.rb

@@ -0,0 +1,19 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class VarRef < Node
+      attr_accessor :ast_id
+
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents[1], @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree/vcall.rb

@@ -0,0 +1,17 @@
+# TODO: Add description.
+
+module Masamune
+  class AbstractSyntaxTree
+    class Vcall < Node
+      def initialize(contents, ast_id)
+        super
+      end
+
+      def extract_data_nodes
+        [
+          Masamune::AbstractSyntaxTree::DataNode.new(@contents[1], @ast_id)
+        ]
+      end
+    end
+  end
+end

data/lib/masamune/abstract_syntax_tree.rb

@@ -0,0 +1,120 @@
+module Masamune
+  class AbstractSyntaxTree
+    attr_reader :tree
+    attr_accessor :node_list, :data_node_list, :lex_nodes
+
+    def initialize(code)
+      @tree = Ripper.sexp(code)
+      raw_lex_nodes = Ripper.lex(code)
+      @lex_nodes = raw_lex_nodes.map do |lex_node|
+        Masamune::LexNode.new(raw_lex_nodes.index(lex_node), lex_node, self.__id__)
+      end
+
+      @node_list = []
+      @data_node_list = []
+      register_nodes(@tree)
+    end
+
+    def register_nodes(tree_node = self.tree)
+      if tree_node.is_a?(Array)
+        klass = get_node_class(tree_node.first)
+        msmn_node = klass.new(tree_node, self.__id__)
+      else
+        # Create a general node if the node is a single value.
+        msmn_node = Masamune::AbstractSyntaxTree::Node.new(tree_node, self.__id__)
+      end
+
+      # Register nodes and any data nodes housed within it.
+      # See Masamune::AbstractSyntaxTree::DataNode for more details on what a data node is.
+      @node_list << msmn_node
+      msmn_node.data_nodes.each { |dn| @data_node_list << dn } if msmn_node.data_nodes
+
+      # Continue down the tree until base case is reached.
+      if !msmn_node.nil? && msmn_node.contents.is_a?(Array)
+        msmn_node.contents.each { |node| register_nodes(node) }
+      end
+    end
+
+    # TODO: Add block_params: true to the arguments.
+    def variables(name: nil)
+      var_classes = [
+        :var_field,
+        :var_ref,
+        :params
+      ].map {|type| get_node_class(type)}
+      find_nodes(var_classes, token: name)
+    end
+
+    def strings(content: nil)
+      find_nodes(get_node_class(:string_content), token: content)
+    end
+
+    def method_definitions(name: nil)
+      find_nodes(get_node_class(:def), token: name)
+    end
+
+    def method_calls(name: nil)
+      method_classes = [
+        :vcall,
+        :call
+      ].map {|type| get_node_class(type)}
+      find_nodes(method_classes, token: name)
+    end
+
+    # TODO
+    def do_block_params
+    end
+
+    # TODO
+    def brace_block_params
+    end
+
+    def all_methods
+      method_definitions + method_calls
+    end
+
+    def block_params
+      # TODO: do_block_params + brace_block_params
+      find_nodes(get_node_class(:params))
+    end
+
+    # TODO: Create an option to return a list of DataNode class instances.
+    def find_nodes(token_classes, token: nil)
+      # Ensure the classes are in an array
+      token_classes = [token_classes].flatten
+
+      var_nodes = []
+      token_classes.each do |klass|
+        var_nodes << @node_list.select {|node| node.class == klass}
+      end
+
+      # Searching for multiple classes will yield multi-dimensional arrays,
+      # so we ensure everything is flattened out before moving forward.
+      var_nodes.flatten!
+
+      if token
+        var_nodes = var_nodes.select {|node| node.data_nodes.first.token == token}.flatten
+      end
+
+      final_result = []
+      var_nodes.each do |node|
+        node.data_nodes.each {|dn| final_result << dn.position_and_token}
+      end
+
+      Masamune::AbstractSyntaxTree::DataNode.order_results_by_position(final_result)
+    end
+
+    private
+
+    def get_node_class(type)
+      begin
+        class_name = "Masamune::AbstractSyntaxTree::#{type.to_s.camelize}"
+        klass = class_name.constantize
+      rescue NameError
+        # For all other nodes that we haven't covered yet, we just make a general class.
+        # We can worry about adding the classes for other nodes as we go.
+        msmn_node = Masamune::AbstractSyntaxTree::Node
+      end
+    end
+  end
+end

data/lib/{masamune-ast → masamune}/lex_node.rb

@@ -1,4 +1,4 @@
-module MasamuneAst
+module Masamune
   # https://docs.ruby-lang.org/en/3.0/Ripper.html#method-c-lex
   #
   # @position: Line number and starting point on the line. i.e. - [4, 7].
@@ -23,30 +23,31 @@ module MasamuneAst
       ObjectSpace._id2ref(@ast_id)
     end
 
-    def is_variable?
-      return false unless is_identifier?
-      ast.search(:variable, @token).any?
+    def variable?
+      return false unless identifier?
+      ast.variables(name: @token).any?
     end
 
-    def is_method?
-      return false unless is_identifier?
-      is_method_definition? || is_method_call?
+    def method_definition?
+      ast.method_definitions(name: @token).any?
     end
 
-    def is_method_definition?
-      ast.search(:def, @token).any?
+    def method_call?
+      ast.method_calls(name: @token).any?
     end
 
-    def is_method_call?
-      ast.search(:method_call, @token).any?
+    def method?
+      return false unless identifier?
+      method_definition? || method_call?
     end
 
-    def is_identifier?
-      type == :ident
+    # TODO: I'm not sure how I feel about checking @type against the symbol directly.
+    def identifier?
+      @type == :ident
     end
 
-    def is_string?
-      type == :tstring_content
+    def string?
+      @type == :tstring_content
     end
   end
 end

data/lib/{masamune-ast → masamune}/slicer.rb

@@ -1,4 +1,4 @@
-module MasamuneAst
+module Masamune
   module Slicer
     def initialize(ast)
       @ast = ast

data/lib/masamune/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Masamune
+  VERSION = "1.1.0"
+end

data/lib/masamune.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "masamune/version"
+require "ripper"
+require "active_support/core_ext/string/inflections"
+require "masamune/lex_node"
+require "masamune/abstract_syntax_tree"
+require "masamune/abstract_syntax_tree/node"
+require "masamune/abstract_syntax_tree/data_node"
+
+# Node Types
+require "masamune/abstract_syntax_tree/assign"
+require "masamune/abstract_syntax_tree/block_var"
+require "masamune/abstract_syntax_tree/brace_block"
+require "masamune/abstract_syntax_tree/call"
+require "masamune/abstract_syntax_tree/def"
+require "masamune/abstract_syntax_tree/do_block"
+require "masamune/abstract_syntax_tree/params"
+require "masamune/abstract_syntax_tree/program"
+require "masamune/abstract_syntax_tree/string_content"
+require "masamune/abstract_syntax_tree/var_field"
+require "masamune/abstract_syntax_tree/var_ref"
+require "masamune/abstract_syntax_tree/vcall"
+
+require "pp"
+require "pry"
+
+module Masamune
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: masamune-ast
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Gabriel Zayas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-04-29 00:00:00.000000000 Z
-dependencies: []
+date: 2023-06-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  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'
 description: A layer of abstraction on top of Ripper for handling Abstract Syntax
   Trees in Ruby.
 email:
@@ -24,21 +38,33 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- lib/masamune-ast.rb
-- lib/masamune-ast/abstract_syntax_tree.rb
-- lib/masamune-ast/abstract_syntax_tree/data_node.rb
-- lib/masamune-ast/abstract_syntax_tree/node.rb
-- lib/masamune-ast/lex_node.rb
-- lib/masamune-ast/slicer.rb
-- lib/masamune-ast/version.rb
+- lib/masamune.rb
+- lib/masamune/abstract_syntax_tree.rb
+- lib/masamune/abstract_syntax_tree/assign.rb
+- lib/masamune/abstract_syntax_tree/block_var.rb
+- lib/masamune/abstract_syntax_tree/brace_block.rb
+- lib/masamune/abstract_syntax_tree/call.rb
+- lib/masamune/abstract_syntax_tree/data_node.rb
+- lib/masamune/abstract_syntax_tree/def.rb
+- lib/masamune/abstract_syntax_tree/do_block.rb
+- lib/masamune/abstract_syntax_tree/node.rb
+- lib/masamune/abstract_syntax_tree/params.rb
+- lib/masamune/abstract_syntax_tree/program.rb
+- lib/masamune/abstract_syntax_tree/string_content.rb
+- lib/masamune/abstract_syntax_tree/var_field.rb
+- lib/masamune/abstract_syntax_tree/var_ref.rb
+- lib/masamune/abstract_syntax_tree/vcall.rb
+- lib/masamune/lex_node.rb
+- lib/masamune/slicer.rb
+- lib/masamune/version.rb
 - sig/masamune.rbs
-homepage: https://www.github.com/gazayas/masamune
+homepage: https://www.github.com/gazayas/masamune-ast
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://www.github.com/gazayas/masamune
-  source_code_uri: https://www.github.com/gazayas/masamune
-  changelog_uri: https://www.github.com/gazayas/masamune
+  homepage_uri: https://www.github.com/gazayas/masamune-ast
+  source_code_uri: https://www.github.com/gazayas/masamune-ast
+  changelog_uri: https://www.github.com/gazayas/masamune-ast
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -57,5 +83,5 @@ requirements: []
 rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
-summary: MasamuneAst
+summary: Masamune
 test_files: []

data/lib/masamune-ast/abstract_syntax_tree/data_node.rb

@@ -1,11 +0,0 @@
-# TODO: Not sure if I'll implement this yet.
-
-module MasamuneAst
-  class AbstractSyntaxTree
-    class DataNode << MasamuneAst::AbstractSyntaxTree::Node
-      def initialize(tree_node)
-        @parent, @contents, _ = tree_node
-      end
-    end
-  end
-end

data/lib/masamune-ast/abstract_syntax_tree/node.rb

@@ -1,16 +0,0 @@
-# TODO: Not sure if I'll implement this yet.
-
-module MasamuneAst
-  class AbstractSyntaxTree
-    class Node
-      def initialize(tree_node)
-        @contents = tree_node
-      end
-
-      # i.e. - [:@ident, "variable_name", [4, 7]]
-      def is_data_node?
-        @contents[0].is_a?(Symbol) && @contents[1].is_a?(String) && (@contents[2][0].is_a?(Integer) && @contents[2][1].is_a?(Integer))
-      end
-    end
-  end
-end

data/lib/masamune-ast/abstract_syntax_tree.rb

@@ -1,121 +0,0 @@
-module MasamuneAst
-  class AbstractSyntaxTree
-    attr_reader :data
-    attr_accessor :lex_nodes, :debug
-
-    def initialize(code)
-      @data = Ripper.sexp(code)
-      raw_lex_nodes = Ripper.lex(code)
-      @lex_nodes = raw_lex_nodes.map do |lex_node|
-        MasamuneAst::LexNode.new(raw_lex_nodes.index(lex_node), lex_node, self.__id__)
-      end
-      @debug = false
-    end
-
-    def tree_nodes
-      raise "Set `debug` to `true` to display the tree nodes" unless @debug
-      search # Perform search with no conditions.
-    end
-
-    def variables
-      search(:variable)
-    end
-
-    def all_methods
-      method_definitions + method_calls
-    end
-
-    def method_definitions
-      search(:def)
-    end
-
-    def method_calls
-      search(:method_call)
-    end
-
-    def strings
-      search(:string)
-    end
-
-    def data_nodes
-      search(:data_node)
-    end
-
-    def search(type = nil, token = nil, tree_node = self.data, result = [])
-      return unless tree_node.is_a?(Array) || (tree_node.is_a?(Array) && tree_node.empty?)
-      debug_output(tree_node) if @debug
-
-      # If the first element is an array, then we're getting all arrays so we just continue the search.
-      if tree_node.first.is_a?(Array)
-        tree_node.each { |node| search(type, token, node, result) }
-      elsif tree_node.first.is_a?(Symbol)
-        # TODO: These two if statements bother me a lot.
-        # There should be a more effiecient/smart way to do this.
-        if has_data_node?(tree_node)
-          if (type == :variable && (tree_node.first == :var_field || tree_node.first == :var_ref)) ||
-             (type == :string && tree_node.first == :string_content) ||
-             (type == :def && tree_node.first == :def) ||
-             (type == :method_call && tree_node.first == :vcall)
-
-            # TODO: AbstractSyntaxTree::DataNode.new(tree_node)
-            # For most tree nodes, the data_node is housed in the second element.
-            position, data_node_token = data_node_parts(tree_node[1])
-
-            # Gather all results if token isn't specified.
-            result << [position, data_node_token] if token == data_node_token || token.nil?
-          end
-
-          # Continue search for all necessary elements.
-          case tree_node.first
-          when :def, :command
-            tree_node.each { |node| search(type, token, node, result) }
-          end
-
-        # The data nodes in :call nodes are in a different place within the array, so we handle that here.
-        # These :call nodes represent methods and chained methods like `[1, 2, 3].sum.times`.
-        elsif (type == :method_call && tree_node.first == :call)
-          # The method inside the [:call, ...] data node is the last element in the array.
-          position, data_node_token = data_node_parts(tree_node.last)
-          result << [position, data_node_token] if token == data_node_token || token.nil?
-          # The second element is where more :call nodes are nested, so we search it.
-          search(type, token, tree_node[1], result)
-        else
-          # Simply continue the search for all other nodes.
-          tree_node.each { |node| search(type, token, node, result) }
-        end
-      end
-
-      result
-    end
-
-    private
-
-    # A data node represents an abstraction in the AST which has details about a specific command.
-    # i.e. - [:@ident, "variable_name", [4, 7]]
-    # These values are the `type`, `token`, and `position`, respectively.
-    # It is simliar to what you see in `Ripper.lex(code)` and `Masamune::Base's @lex_nodes`.
-    # Data nodes serve as a base case when recursively searching the AST.
-    #
-    # The parent node's first element houses the type of action being performed:
-    # i.e. - [:assign, [:@ident, "variable_name", [4, 7]]]
-    # `has_data_node?` is performed on a parent node.
-    def has_data_node?(node)
-      node[1].is_a?(Array) && node[1][1].is_a?(String)
-    end
-
-    def data_node_parts(tree_node)
-      _, token, position = tree_node
-      [position, token]
-    end
-
-    def is_line_position?(tree_node)
-      tree_node.size == 2 && tree_node.first.is_a?(Integer) && tree_node.last.is_a?(Integer)
-    end
-
-    def debug_output(tree_node)
-      puts "==================================" # TODO: Track the array depth and output the number here.
-      puts "=================================="
-      p tree_node
-    end
-  end
-end

data/lib/masamune-ast/version.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-module MasamuneAst
-  VERSION = "0.1.0"
-end

data/lib/masamune-ast.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "masamune-ast/version"
-require "ripper"
-require "masamune-ast/lex_node"
-require "masamune-ast/abstract_syntax_tree"
-
-require "pp"
-require "pry"
-
-module MasamuneAst
-end