decode 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 519235a3a7f2db0117c0f725a101a602189d77d2a5be2154d925e7a76a7ade53
-  data.tar.gz: 82e6a4a252e12d01b82054011bfcec2c5fb0c2bad3996467e388c9b93370d4cb
+  metadata.gz: c0f1e26c4b0aad982ae69ec4240f058d101c92f15b125f12e17b0a59e7f1a8f2
+  data.tar.gz: 552744c2f9ab8477a01eafd7042f5332325a779d94a29d8a4ec03df387a9174b
 SHA512:
-  metadata.gz: 60c0fda6909175c3717d762aadccf3f7e8a7dd8582bc390fd1082c5b3d71d5e901224d9072700e7feb4e41052a7f45aa6619522e5a9e65cb7882fee26fef7081
-  data.tar.gz: 413727720678c4b956539331bed678d7d8e18ebc8a23a10f6e6f4cec3bfa9cb0a2b849c3a48af23efdafa32340ad179553bb8e82ded52cc15e4f858e11637af1
+  metadata.gz: fe2a85001a162ca96082bd05788d7b57bae41af6aed065c72db26ef2c1d10d0b7c7e76836cf236a640bb7fdba84c66977e387e0fab449536c6915e3ec2413262
+  data.tar.gz: a55480e4354fd41c4bb6e5197180289ab1b29671f65988b67935f001016fd731d083adfbd9edcd079fb2a50894ed2a5ba0b728722c54f66f378609009e20033a

data/lib/decode/definition.rb

@@ -0,0 +1,69 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'symbol'
+
+module Decode
+	class Definition < Symbol
+		def initialize(kind, name, comments, **options)
+			super(kind, name, **options)
+			
+			@comments = comments
+			@documentation = nil
+		end
+		
+		attr :comments
+		
+		# A short form of the definition, e.g. `def short_form`.
+		# @return [String | nil]
+		def short_form
+		end
+		
+		# A long form of the definition, e.g. `def initialize(kind, name, comments, **options)`.
+		# @return [String | nil]
+		def long_form
+		end
+		
+		# The full text of the definition.
+		# @return [String | nil]
+		def text
+		end
+		
+		# Whether this definition can contain nested definitions.
+		# @return [Boolean]
+		def container?
+			false
+		end
+		
+		# Whether this represents a single entity to be documented (along with it's contents).
+		# @return [Boolean]
+		def nested?
+			container?
+		end
+		
+		# An interface for accsssing the documentation of the definition.
+		# @return [Documentation | nil] A `Documentation` if this definition has comments.
+		def documentation
+			if @comments&.any?
+				@documentation ||= Documentation.new(@comments)
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/class.rb

@@ -0,0 +1,63 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'definition'
+
+module Decode
+	module Language
+		module Ruby
+			class Class < Definition
+				def container?
+					true
+				end
+				
+				def short_form
+					"class #{@name}"
+				end
+				
+				def long_form
+					if super_node = @node.children[1]
+						@node.location.keyword.join(
+							super_node.location.name
+						).source
+					else
+						self.short_form
+					end
+				end
+			end
+			
+			class Singleton < Definition
+				def container?
+					true
+				end
+				
+				def nested?
+					false
+				end
+				
+				def short_form
+					"class << #{@name}"
+				end
+				
+				alias long_form short_form
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/constant.rb

@@ -0,0 +1,45 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'definition'
+
+module Decode
+	module Language
+		module Ruby
+			class Constant < Definition
+				def short_form
+					@node.location.name.source
+				end
+				
+				def long_form
+					if @node.location.line == @node.location.last_line
+						@node.location.expression.source
+					elsif @node.children[2].type == :array
+						"#{@name} = [...]"
+					elsif @node.children[2].type == :hash
+						"#{@name} = {...}"
+					else
+						self.short_form
+					end
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/definition.rb

@@ -0,0 +1,41 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative '../../definition'
+
+module Decode
+	module Language
+		module Ruby
+			class Definition < Decode::Definition
+				def initialize(kind, name, comments, node, **options)
+					super(kind, name, comments, **options)
+					
+					@node = node
+				end
+				
+				attr :node
+				
+				def text
+					@node.location.expression.source
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/function.rb

@@ -0,0 +1,37 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'method'
+
+module Decode
+	module Language
+		module Ruby
+			class Function < Method
+				def arguments_node
+					if node = @node.children[2]
+						if node.location.expression
+							return node
+						end
+					end
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/method.rb

@@ -0,0 +1,51 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'definition'
+
+module Decode
+	module Language
+		module Ruby
+			class Method < Definition
+				def short_form
+					@node.location.keyword.join(@node.location.name).source
+				end
+				
+				def arguments_node
+					if node = @node.children[1]
+						if node.location.expression
+							return node
+						end
+					end
+				end
+				
+				def long_form
+					if arguments_node = self.arguments_node
+						@node.location.keyword.join(
+							arguments_node.location.expression
+						).source
+					else
+						self.short_form
+					end
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/module.rb

@@ -0,0 +1,39 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'definition'
+
+module Decode
+	module Language
+		module Ruby
+			class Module < Definition
+				def container?
+					true
+				end
+				
+				def short_form
+					"module #{@name}"
+				end
+				
+				alias long_form short_form
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/parser.rb

@@ -0,0 +1,143 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'parser/current'
+
+require_relative 'class'
+require_relative 'constant'
+require_relative 'function'
+require_relative 'method'
+require_relative 'module'
+
+module Decode
+	module Language
+		module Ruby
+			class Parser
+				def initialize(parser = ::Parser::CurrentRuby.new)
+					@parser = parser
+				end
+				
+				def parse(input, &block)
+					buffer = ::Parser::Source::Buffer.new('(input)')
+					buffer.source = input.read
+					
+					top, comments = @parser.parse_with_comments(buffer)
+					
+					walk(top, comments, &block)
+				end
+				
+				def extract_comments_for(node, comments)
+					prefix = []
+					
+					while comment = comments.first
+						break if comment.location.line >= node.location.line
+						
+						if last_comment = prefix.last
+							if last_comment.location.line != (comment.location.line - 1)
+								prefix.clear
+							end
+						end
+						
+						prefix << comments.shift
+					end
+					
+					# The last comment must butt up against the node:
+					if comment = prefix.last
+						if comment.location.line == (node.location.line - 1)
+							return prefix.map do |comment|
+								comment.text.sub(/\A\#\s?/, '')
+							end
+						end
+					end
+				end
+				
+				# Walk over the syntax tree and extract relevant definitions with their associated comments.
+				def walk(node, comments, parent = nil, &block)
+					case node.type
+					when :begin
+						node.children.each do |child|
+							walk(child, comments, parent, &block)
+						end
+					when :module
+						definition = Module.new(
+							:module, node.children[0].children[1],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+						
+						if children = node.children[1]
+							walk(children, comments, definition, &block)
+						end
+					when :class
+						definition = Class.new(
+							:class, node.children[0].children[1],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+						
+						if children = node.children[2]
+							walk(children, comments, definition, &block)
+						end
+					when :sclass
+						definition = Singleton.new(
+							:class, node.children[0],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+						
+						if children = node.children[1]
+							walk(children, comments, definition, &block)
+						end
+					when :def
+						definition = Method.new(
+							:def, node.children[0],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+					when :defs
+						definition = Function.new(
+							:defs, node.children[1],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+					when :casgn
+						definition = Constant.new(
+							:constant, node.children[1],
+							extract_comments_for(node, comments), node,
+							parent: parent, language: Ruby
+						)
+						
+						yield definition
+					end
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby/reference.rb

@@ -0,0 +1,76 @@
+# Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Decode
+	module Language
+		module Ruby
+			class Reference
+				KIND =  {
+					':' => :def,
+					'.' => :defs,
+				}.freeze
+				
+				def initialize(value)
+					@value = value
+					
+					@path = nil
+					@kind = nil
+				end
+				
+				def absolute?
+					@value.start_with?('::')
+				end
+				
+				METHOD = /\A(?<scope>.*?)?(?<kind>:|\.)(?<name>.+?)\z/
+				
+				def path
+					if @path.nil?
+						@path = @value.split(/::/)
+						
+						if last = @path.pop
+							if match = last.match(METHOD)
+								@kind = KIND[match[:kind]]
+								
+								if scope = match[:scope]
+									@path << scope
+								end
+								
+								@path << match[:name]
+							else
+								@path << last
+							end
+						end
+						
+						@path = @path.map(&:to_sym)
+						@path.freeze
+					end
+					
+					return @path
+				end
+				
+				def kind
+					self.path
+					
+					return @kind
+				end
+			end
+		end
+	end
+end

data/lib/decode/language/ruby.rb

@@ -18,13 +18,16 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require_relative '../symbol'
-
-require 'parser/current'
+require_relative 'ruby/reference'
+require_relative 'ruby/parser'
 
 module Decode
 	module Language
-		class Ruby
+		module Ruby
+			def self.parse(input, &block)
+				Parser.new.parse(input, &block)
+			end
+			
 			# The symbol which is used to separate the specified definition from the parent scope.
 			PREFIX = {
 				class: '::',
@@ -34,58 +37,7 @@ module Decode
 				defs: '.',
 			}.freeze
 			
-			KIND =  {
-				':' => :def,
-				'.' => :defs,
-			}.freeze
-			
-			class Reference
-				def initialize(value)
-					@value = value
-					
-					@path = nil
-					@kind = nil
-				end
-				
-				def absolute?
-					@value.start_with?('::')
-				end
-				
-				METHOD = /\A(?<scope>.*?)?(?<kind>:|\.)(?<name>.+?)\z/
-				
-				def path
-					if @path.nil?
-						@path = @value.split(/::/)
-						
-						if last = @path.pop
-							if match = last.match(METHOD)
-								@kind = KIND[match[:kind]]
-								
-								if scope = match[:scope]
-									@path << scope
-								end
-								
-								@path << match[:name]
-							else
-								@path << last
-							end
-						end
-						
-						@path = @path.map(&:to_sym)
-						@path.freeze
-					end
-					
-					return @path
-				end
-				
-				def kind
-					self.path
-					
-					return @kind
-				end
-			end
-			
-			def join(symbols, absolute = true)
+			def self.join(symbols, absolute = true)
 				buffer = String.new
 				
 				symbols.each do |symbol|
@@ -100,104 +52,6 @@ module Decode
 				
 				return buffer
 			end
-			
-			def parse(input, &block)
-				parser = ::Parser::CurrentRuby.new
-				
-				buffer = ::Parser::Source::Buffer.new('(input)')
-				buffer.source = input.read
-				
-				top, comments = parser.parse_with_comments(buffer)
-				
-				walk(top, comments, &block)
-			end
-			
-			def extract_comments_for(node, comments)
-				prefix = []
-				
-				while comment = comments.first
-					break if comment.location.line >= node.location.line
-					
-					if last_comment = prefix.last
-						if last_comment.location.line != (comment.location.line - 1)
-							prefix.clear
-						end
-					end
-					
-					prefix << comments.shift
-				end
-				
-				# The last comment must butt up against the node:
-				if comment = prefix.last
-					if comment.location.line == (node.location.line - 1)
-						return prefix.map do |comment|
-							comment.text.sub(/\A\#\s?/, '')
-						end
-					end
-				end
-			end
-			
-			# Walk over the syntax tree and extract relevant definitions with their associated comments.
-			def walk(node, comments, parent = nil, &block)
-				case node.type
-				when :begin
-					node.children.each do |child|
-						walk(child, comments, parent, &block)
-					end
-				when :class
-					definition = Definition.new(
-						:class, node.children[0].children[1],
-						node, extract_comments_for(node, comments),
-						parent: parent, language: self
-					)
-					
-					yield definition
-					
-					walk(node.children[2], comments, definition, &block)
-				when :module
-					definition = Definition.new(
-						:module, node.children[0].children[1],
-						node, extract_comments_for(node, comments),
-						parent: parent, language: self
-					)
-					
-					yield definition
-					
-					walk(node.children[1], comments, definition, &block)
-				when :def
-					definition = Definition.new(
-						:def, node.children[0],
-						node, extract_comments_for(node, comments),
-						parent: parent, language: self
-					)
-					
-					yield definition
-					
-					# if body = node.children[2]
-					# 	walk(body, comments, definition, &block)
-					# end
-				when :defs
-					definition = Definition.new(
-						:defs, node.children[1],
-						node, extract_comments_for(node, comments),
-						parent: parent, language: self
-					)
-					
-					yield definition
-					
-					# if body = node.children[2]
-					# 	walk(body, comments, definition, &block)
-					# end
-				when :casgn
-					definition = Definition.new(
-						:constant, node.children[1],
-						node, extract_comments_for(node, comments),
-						parent: parent, language: self
-					)
-					
-					yield definition
-				end
-			end
 		end
 	end
 end

data/lib/decode/source.rb

@@ -24,7 +24,7 @@ module Decode
 	class Source
 		def initialize(path, language = nil)
 			@path = path
-			@language = language || Language.detect(path).new
+			@language = language || Language.detect(path)
 		end
 		
 		def parse(&block)

data/lib/decode/symbol.rb

@@ -65,26 +65,4 @@ module Decode
 			self.path.map(&:name)
 		end
 	end
-	
-	class Definition < Symbol
-		def initialize(kind, name, node, comments, **options)
-			super(kind, name, **options)
-			
-			@node = node
-			@comments = comments
-			@documentation = nil
-		end
-		
-		def text
-			@node.location.expression.source
-		end
-		
-		attr :comments
-		
-		def documentation
-			if @comments&.any?
-				@documentation ||= Documentation.new(@comments)
-			end
-		end
-	end
 end

data/lib/decode/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Decode
-	VERSION = "0.4.0"
+	VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-30 00:00:00.000000000 Z
+date: 2020-05-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -122,10 +122,19 @@ files:
 - decode.gemspec
 - gems.rb
 - lib/decode.rb
+- lib/decode/definition.rb
 - lib/decode/documentation.rb
 - lib/decode/index.rb
 - lib/decode/language.rb
 - lib/decode/language/ruby.rb
+- lib/decode/language/ruby/class.rb
+- lib/decode/language/ruby/constant.rb
+- lib/decode/language/ruby/definition.rb
+- lib/decode/language/ruby/function.rb
+- lib/decode/language/ruby/method.rb
+- lib/decode/language/ruby/module.rb
+- lib/decode/language/ruby/parser.rb
+- lib/decode/language/ruby/reference.rb
 - lib/decode/source.rb
 - lib/decode/symbol.rb
 - lib/decode/trie.rb