koto 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91a8cdd2c571cf39f6b9c6c41b8d90cf2f6730a9ae8d407dabf6647ba92706a9
-  data.tar.gz: 41f6d7446084e509d3a88c8b9ca0d9b6097cb946dbf27a4effc5c514bb03c40d
+  metadata.gz: 7d3523f6b174d584c4dca1e677ce6f22a36b24003ccff90274a0e47ce5fd5b4a
+  data.tar.gz: 1e8ddf910b85751130d90f93c9c38ec194e6eda9de41faa436641de880c6b880
 SHA512:
-  metadata.gz: c1738575d73950ab26c65caf2286477fbc6e990c57cbdbf28da9f6e1b4da4a28471c97841ee1b0f9345789aeac7b78936692718476173b46df7e7854ac8bcfed
-  data.tar.gz: 58de4b49a75a1ab0805c81cf00ef7620c0465cecb3ad4731c48bef2001f56fffba011182b209099f90508ae5b73bfb2d248fbced1f984542ceeea6d6d8b4b11f
+  metadata.gz: c462b081af926271e010d897c753a7a4f4c9d8e46120ae6a7c19691ce6dcf4caa806da9d88c25e0d1038ceed12631ab2c546e8e1bac8c4d6a65102313ed7ce4d
+  data.tar.gz: 2db23913916901f444add896d7090eff12f419cdd428b4883ef1d82d7c7e76feab168b580013702e61ba698e9e9632b8514e29af83eb1c76ff815224444a401b

data/README.md

@@ -22,33 +22,60 @@ Or install it yourself as:
 
 ## Usage
 
-Load *koto*.
+Loading *koto*.
 ```ruby
 require 'koto'
 ```
-A code example with `Koto::Parser::AST::Processor` which extends `Parser::AST::Processor`.
+Initializing the parser :
+```ruby
+builder = Koto::Parser::Builders::Default.new
+parser  = Parser::CurrentRuby.new(builder)
+```
+Setting a source buffer :
+```ruby
+code   = "class Context; private; def push; pass; end; end"
+buffer = Parser::Source::Buffer.new('(string)', source: code)
+```
+Processing data :
+```ruby
+ast = parser.parse(buffer)                                                                         
+
+processor = Koto::Parser::AST::Processor.new
+processor.process(ast)
+```
+Getting contextual information :
+```ruby
+context = processor.context                                                                                                  
+symbols = context.symbols
+
+klass  = symbols[:Context]                                                                                                   
+method = klass.symbols[:push]    
+    
+p klass.access == :public 
+# => true
+p klass.context.top_level? 
+# => true
+
+p method.access == :private 
+# => true
+p method.context.in_class? 
+# => true
+```
+Processing nested names :
 ```ruby                                                            
-node = Parser::CurrentRuby.parse("Koto::Parser::AST::Processor::Resolver")      
-                                     
+node = Parser::CurrentRuby.parse("Koto::Parser::AST::Processor::Resolver")
+
 p node                               
-# (const                        
-#   (const  
-#     (const   
-#       (const     
-#         (const     
-#           nil                                                                                                                                 
-#           :Koto)                                                                                                                                 
-#         :Parser)                                                                                                                              
-#       :AST)                                                                                                                              
-#     :Processor)                                                                                                                             
-#   :Resolver)                                                                                                                                
-                                                                                                                                              
-processor = Koto::Parser::AST::Processor.new                                                                                        
-                                                                                                                                              
+# => s(:const,
+#  s(:const,
+#    s(:const,
+#      s(:const,
+#        s(:const, nil, :Koto), :Parser), :AST), :Processor), :Resolver)
+
+processor = Koto::Parser::AST::Processor.new
+
 p processor.process(node)
-# (const
-#   nil 
-#   :Koto::Parser::Processor::Resolver)
+# => s(:const, nil, :"Koto::Parser::AST::Processor::Resolver")
 ```
 
 ## Development

data/lib/koto.rb

@@ -4,6 +4,7 @@ require 'parser/current'
 
 module Koto
   require "koto/version"
+  require "koto/core_ext/object"
 
   module Parser
 

data/lib/koto/core_ext/object.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+class Object
+  def deep_dup
+    copy = self.dup
+
+    copy.instance_variables.each do |attr|
+      value = instance_variable_get(attr).dup
+      copy.instance_variable_set attr, value
+    end
+
+    copy
+  end
+end

data/lib/koto/parser/ast/node.rb

@@ -24,12 +24,10 @@ module Koto
           end
 
           if (context = properties[:context])
-            context = context.deep_dup if context.frozen?
             @context = context
           end
 
           if (symbols = properties[:symbols])
-            symbols = symbols.dup if symbols.frozen?
             @symbols = symbols
           end
         end

data/lib/koto/parser/ast/processor.rb

@@ -6,7 +6,7 @@ module Koto
       class Processor < ::Parser::AST::Processor
 
         OBJECT_METHODS = [
-          *(Object.methods - [:class])
+          *(Object.methods - [:class, :hash, :send])
         ]
 
         KERNEL_METHODS = [

data/lib/koto/parser/ast/processor/context.rb

@@ -20,21 +20,21 @@ module Koto
 
           def get_in(node)
             copy = self.deep_dup
-            copy.get_in!(node)
+            copy.send :get_in!, node
           end
 
           def get_in!(node)
             @scopes << SymbolTable.new
             @stack << node
 
-            self
+            self.freeze
           end
 
-          protected :get_in!
+          private :get_in!
 
           def get_out
             copy = self.deep_dup
-            copy.get_out!
+            copy.send :get_out!
           end
 
           def get_out!
@@ -46,24 +46,24 @@ module Koto
               @stack.pop
             end
 
-            return symbol_table, self
+            return symbol_table, self.freeze
           end
 
-          protected :get_out!
+          private :get_out!
 
           def save(node)
             copy = self.deep_dup
-            copy.save! node
+            copy.send :save!, node
           end
 
           def save!(node)
             symbol_table = symbols.record(node)
             active_scope.update(symbol_table)
 
-            self
+            self.freeze
           end
 
-          protected :save!
+          private :save!
 
           def symbols
             active_scope.data
@@ -84,7 +84,7 @@ module Koto
             copy = self.dup
             copy.instance_variable_set(:@access, access)
 
-            copy
+            copy.freeze
           end
 
           def top_level?
@@ -124,17 +124,6 @@ module Koto
           def in_dynamic_block?
             in_block? || in_lambda?
           end
-
-          def deep_dup
-            copy = self.dup
-
-            copy.instance_variables.each do |attr|
-              value = instance_variable_get(attr).dup
-              copy.instance_variable_set attr, value
-            end
-
-            copy
-          end
         end
       end
     end

data/lib/koto/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Koto
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: koto
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - mansakondo
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-01-06 00:00:00.000000000 Z
+date: 2021-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -56,6 +56,7 @@ files:
 - bin/setup
 - koto.gemspec
 - lib/koto.rb
+- lib/koto/core_ext/object.rb
 - lib/koto/parser/ast/node.rb
 - lib/koto/parser/ast/processor.rb
 - lib/koto/parser/ast/processor/context.rb