decode 0.14.1 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b10527900f968f995dfb80150dbe8773f92857f190fe5ae3981af28363473530
-  data.tar.gz: c58a678e66c1416ebc3c7a19dae19789644c937e990343ec4ea3bc565ee991a7
+  metadata.gz: 46819e1068182148b9179638359c81fe75b3276f3ae07285f962fbeda31f3a48
+  data.tar.gz: 24e0acf13ec561c1bb28be8700302302c2027c314d5c951613e3734260b1e995
 SHA512:
-  metadata.gz: 2a5110378a537c6ee3ddb571a9d376af274e45ddf9835b347ac538a858eea5f140610e3cd04fa2e14c9c4c2e46a75f32adc7dbd10c39ac7de438ae2955336e7c
-  data.tar.gz: fd1b0e0bbc3912cd3eedfab8bf0b0e8c2bdcda930783f08305a7de9e92f2629e0b500f727dfd92a52958b283e429636ca8a3b83f1345de98bf59257bd17fc415
+  metadata.gz: 8b07a7bb594c53d26e81903b54cf640b766318eba6365a90a6b443fa2036ab4b4b5ac2145aadf44aca5fff8b4f373ff4379f7301c1658ffc25bce693ab49a268
+  data.tar.gz: a23772085b48311f6f4596f1215dd3b2a0e1974a5ca3d78c4bd207118c3c6b048beb342fd3dd04accdd39ed531ebcd29d8b73e9733bcff532f90b8203ba7f746

data/lib/decode/definition.rb

@@ -77,6 +77,8 @@ module Decode
 			"::#{@name}"
 		end
 		
+		# Does the definition name match the specified prefix?
+		# @returns [Boolean]
 		def start_with?(prefix)
 			self.nested_name.start_with?(prefix)
 		end

data/lib/decode/language/reference.rb

@@ -24,11 +24,11 @@ module Decode
 		class Reference
 			# Initialize the reference.
 			# @parameter identifier [String] The identifier part of the reference.
-			def initialize(identifier, language)
+			def initialize(identifier, language, lexical_path = nil)
 				@identifier = identifier
 				@language = language
 				
-				@lexical_path = nil
+				@lexical_path = lexical_path
 				@path = nil
 			end
 			
@@ -67,14 +67,35 @@ module Decode
 				@lexical_path ||= self.split(@identifier)
 			end
 			
+			def priority(definition, prefix)
+				if prefix.nil?
+					return 1
+				elsif definition.start_with?(prefix)
+					return 0
+				else
+					return 2
+				end
+			end
+			
 			def best(definitions)
 				prefix, name = lexical_path.last
 				
-				definitions.select do |definition|
-					definition.language == @language && (
-						prefix.nil? || definition.start_with?(prefix)
-					)
+				first = nil
+				without_prefix = nil
+				
+				definitions.each do |definition|
+					first ||= definition
+					
+					next unless definition.language == @language
+					
+					if prefix.nil?
+						without_prefix ||= definition
+					elsif definition.start_with?(prefix)
+						return definition
+					end
 				end
+				
+				return without_prefix || first
 			end
 			
 			# The lexical path of the reference.

data/lib/decode/language/ruby.rb

@@ -20,6 +20,7 @@
 
 require_relative 'ruby/reference'
 require_relative 'ruby/parser'
+require_relative 'ruby/code'
 
 require_relative '../comment/tags'
 require_relative '../comment/parameter'
@@ -86,6 +87,10 @@ module Decode
 			def self.segments_for(input, &block)
 				Parser.new.segments_for(input, &block)
 			end
+			
+			def self.code_for(text, index, relative_to: nil)
+				Code.new(text, index, relative_to: relative_to, language: self)
+			end
 		end
 	end
 end

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

@@ -0,0 +1,85 @@
+# 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'
+require_relative '../../syntax/link'
+
+require 'parser/current'
+
+module Decode
+	module Language
+		module Ruby
+			# A Ruby-specific block of code.
+			class Code
+				def initialize(text, index, relative_to: nil, language: relative_to&.language)
+					@text = text
+					@root = ::Parser::CurrentRuby.parse(text)
+					@index = index
+					@relative_to = relative_to
+					@language = language
+				end
+				
+				attr :text
+				
+				attr :language
+				
+				def extract(into = [])
+					if @index
+						self.traverse(@root, into)
+					end
+					
+					return into
+				end
+				
+				private
+				
+				def traverse(node, into)
+					case node&.type
+					when :send
+						if reference = Reference.from_const(node, @language)
+							if definition = @index.lookup(reference, relative_to: @relative_to)
+								expression = node.location.selector
+								range = expression.begin_pos...expression.end_pos
+								into << Syntax::Link.new(range, definition)
+							end
+						end
+						
+						# Extract constants from arguments:
+						children = node.children[2..].each do |node|
+							traverse(node, into)
+						end
+					when :const
+						if reference = Reference.from_const(node, @language)
+							if definition = @index.lookup(reference, relative_to: @relative_to)
+								expression = node.location.name
+								range = expression.begin_pos...expression.end_pos
+								into << Syntax::Link.new(range, definition)
+							end
+						end
+					when :begin
+						node.children.each do |child|
+							traverse(child, into)
+						end
+					end
+				end
+			end
+		end
+	end
+end

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

@@ -40,7 +40,7 @@ module Decode
 			class Parser
 				# Extract definitions from the given input file.
 				def definitions_for(input, &block)
-					top, comments = ::Parser::CurrentRuby.parse_with_comments(input.read)
+					top, comments = ::Parser::CurrentRuby.parse_with_comments(input)
 					
 					if top
 						walk_definitions(top, comments, &block)
@@ -241,7 +241,7 @@ module Decode
 				
 				# Extract segments from the given input file.
 				def segments_for(input, &block)
-					top, comments = ::Parser::CurrentRuby.parse_with_comments(input.read)
+					top, comments = ::Parser::CurrentRuby.parse_with_comments(input)
 					
 					# We delete any leading comments:
 					line = 0

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

@@ -25,6 +25,37 @@ module Decode
 		module Ruby
 			# An Ruby-specific reference which can be resolved to zero or more definitions.
 			class Reference < Language::Reference
+				def self.from_const(node, language)
+					lexical_path = append_const(node)
+					
+					return self.new(node.location.expression.source, language, lexical_path)
+				end
+				
+				def self.append_const(node, path = [])
+					parent, name = node.children
+					
+					if parent and parent.type != :cbase
+						append_const(parent, path)
+					end
+					
+					case node.type
+					when :const
+						if parent && parent.type != :cbase
+							path << ['::', name]
+						else
+							path << [nil, name]
+						end
+					when :send
+						path << ['#', name]
+					when :cbase
+						# Ignore.
+					else
+						raise ArgumentError, "Could not determine reference for #{node}!"
+					end
+					
+					return path
+				end
+				
 				def split(text)
 					text.scan(/(::|\.|#|:)?([^:.#]+)/)
 				end

data/lib/decode/source.rb

@@ -25,6 +25,7 @@ module Decode
 	class Source
 		def initialize(path, language)
 			@path = path
+			@buffer = nil
 			@language = language
 		end
 		
@@ -36,11 +37,10 @@ module Decode
 		# @attribute [Language::Generic]
 		attr :language
 		
-		# Open the source file for reading.
-		# @yields {|file| ...} The opened {File} instance.
-		# 	@parameter file [File]
-		def open(&block)
-			File.open(@path, &block)
+		# Read the source file into an internal buffer/cache.
+		# @returns [String]
+		def read
+			@buffer ||= File.read(@path).freeze
 		end
 		
 		# Open the source file and read all definitions.
@@ -50,9 +50,7 @@ module Decode
 		def definitions(&block)
 			return to_enum(:definitions) unless block_given?
 			
-			self.open do |file|
-				@language.definitions_for(file, &block)
-			end
+			@language.definitions_for(self.read, &block)
 		end
 		
 		# Open the source file and read all segments.
@@ -62,9 +60,11 @@ module Decode
 		def segments(&block)
 			return to_enum(:segments) unless block_given?
 			
-			self.open do |file|
-				@language.segments_for(file, &block)
-			end
+			@language.segments_for(self.read, &block)
+		end
+		
+		def code(index = nil, relative_to: nil)
+			@language.code_for(self.read, index, relative_to: relative_to)
 		end
 	end
 end

data/lib/decode/syntax/link.rb

@@ -0,0 +1,44 @@
+# 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 'match'
+
+module Decode
+	module Syntax
+		class Link < Match
+			def initialize(range, definition)
+				@definition = definition
+				
+				super(range)
+			end
+			
+			attr :definition
+			
+			def apply(output, rewriter)
+				output << rewriter.link_to(
+					@definition,
+					rewriter.text_for(@range)
+				)
+				
+				return self.size
+			end
+		end
+	end
+end

data/lib/decode/syntax/match.rb

@@ -0,0 +1,53 @@
+# 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 Syntax
+		class Match
+			def initialize(range)
+				@range = range
+			end
+			
+			attr :range
+			
+			def apply(source)
+				return source[range]
+			end
+			
+			def <=> other
+				@range.min <=> other.range.min
+			end
+			
+			def offset
+				@range.min
+			end
+			
+			def size
+				@range.size
+			end
+			
+			def apply(output, rewriter)
+				output << rewriter.text_for(@range)
+				
+				return self.size
+			end
+		end
+	end
+end

data/lib/decode/syntax/rewriter.rb

@@ -0,0 +1,70 @@
+# 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 Syntax
+		class Rewriter
+			def initialize(text)
+				@text = text
+				@matches = []
+			end
+			
+			attr :text
+			
+			attr :matches
+			
+			def << match
+				@matches << match
+			end
+			
+			# Returns a chunk of raw text with no formatting.
+			def text_for(range)
+				@text[range]
+			end
+			
+			def apply(output = [])
+				offset = 0
+				
+				@matches.sort.each do |match|
+					if match.offset > offset
+						output << text_for(offset...match.offset)
+						
+						offset = match.offset
+					elsif match.offset < offset
+						# Match intersects last output buffer.
+						next
+					end
+					
+					offset += match.apply(output, self)
+				end
+				
+				if offset < @text.size
+					output << text_for(offset...@text.size)
+				end
+				
+				return output
+			end
+			
+			def link_to(definition, text)
+				"[#{text}]"
+			end
+		end
+	end
+end

data/lib/decode/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.15.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-10 00:00:00.000000000 Z
+date: 2020-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -139,6 +139,7 @@ files:
 - lib/decode/language/ruby/block.rb
 - lib/decode/language/ruby/call.rb
 - lib/decode/language/ruby/class.rb
+- lib/decode/language/ruby/code.rb
 - lib/decode/language/ruby/constant.rb
 - lib/decode/language/ruby/definition.rb
 - lib/decode/language/ruby/function.rb
@@ -151,6 +152,9 @@ files:
 - lib/decode/scope.rb
 - lib/decode/segment.rb
 - lib/decode/source.rb
+- lib/decode/syntax/link.rb
+- lib/decode/syntax/match.rb
+- lib/decode/syntax/rewriter.rb
 - lib/decode/trie.rb
 - lib/decode/version.rb
 homepage: https://github.com/ioquatix/decode