decode 0.14.1 → 0.15.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b10527900f968f995dfb80150dbe8773f92857f190fe5ae3981af28363473530
-  data.tar.gz: c58a678e66c1416ebc3c7a19dae19789644c937e990343ec4ea3bc565ee991a7
+  metadata.gz: 3e72d09d01f600b6c256246f13059690b23f49c0698b7b31e24421e928b73fcd
+  data.tar.gz: e582753a3e97b18d0a2ab7d5cde6998eb28f32c6128462bc869dc822bb5bd66d
 SHA512:
-  metadata.gz: 2a5110378a537c6ee3ddb571a9d376af274e45ddf9835b347ac538a858eea5f140610e3cd04fa2e14c9c4c2e46a75f32adc7dbd10c39ac7de438ae2955336e7c
-  data.tar.gz: fd1b0e0bbc3912cd3eedfab8bf0b0e8c2bdcda930783f08305a7de9e92f2629e0b500f727dfd92a52958b283e429636ca8a3b83f1345de98bf59257bd17fc415
+  metadata.gz: 6fe459bba1a7675f1ce6e5bfa788765f2f0acc489e5b16d8b77896c62f5e7bb8a3ca08ca25fc579965613bb7cc38f0972a9b00b15d47a19a0df5a64d610e4f65
+  data.tar.gz: bbd9fc07585e0fdc5c7fab11ce2cb2b321b2ceb38e0c28e483347ac68547845e9b57d109bd4ff691a32372c14c556026ea42a7c5cf1e94537dae3e68633b954a

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
+						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..-1].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/definition.rb

@@ -51,10 +51,10 @@ module Decode
 					if lines.count == 1
 						return lines.first
 					else
-						indentation = expression.source_line[/\A\s+/]
-						
-						# Remove all the indentation:
-						lines.each{|line| line.sub!(indentation, '')}
+						if indentation = expression.source_line[/\A\s+/]
+							# Remove all the indentation:
+							lines.each{|line| line.sub!(indentation, '')}
+						end
 						
 						return lines.join
 					end

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

@@ -42,6 +42,12 @@ module Decode
 				
 				# The long form is the same as the short form.
 				alias long_form short_form
+				
+				# The fully qualified name of the class.
+				# e.g. `module ::Barnyard::Dog`.
+				def qualified_form
+					"module #{self.qualified_name}"
+				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.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.15.4
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-05-10 00:00:00.000000000 Z
+date: 2020-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -39,21 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bake-bundler
-  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: utopia-project
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -80,20 +66,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  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: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -108,9 +80,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -139,6 +110,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,19 +123,23 @@ 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
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  funding_uri: https://github.com/sponsors/ioquatix/
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -172,8 +148,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Code analysis for documentation generation.
 test_files: []