decode 0.15.4 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e72d09d01f600b6c256246f13059690b23f49c0698b7b31e24421e928b73fcd
-  data.tar.gz: e582753a3e97b18d0a2ab7d5cde6998eb28f32c6128462bc869dc822bb5bd66d
+  metadata.gz: dae66e72979c078b311b91e8ad4ae7b6e3adbb0d3b03d0982db05b176d75d417
+  data.tar.gz: f42f00c8f685fa1ce6ae05336e4a41ade53b1cf40bc7002cb7f540327e5ec92c
 SHA512:
-  metadata.gz: 6fe459bba1a7675f1ce6e5bfa788765f2f0acc489e5b16d8b77896c62f5e7bb8a3ca08ca25fc579965613bb7cc38f0972a9b00b15d47a19a0df5a64d610e4f65
-  data.tar.gz: bbd9fc07585e0fdc5c7fab11ce2cb2b321b2ceb38e0c28e483347ac68547845e9b57d109bd4ff691a32372c14c556026ea42a7c5cf1e94537dae3e68633b954a
+  metadata.gz: 205d18a44b532e6951babfe9582e43d64c5a03d7dfec8cfccf9e3ed02adbef5e8f72121632d86f15096a30ad1e6559075959394b79b29c0570d7c395b381e87d
+  data.tar.gz: b6106e00e17c5d7680046f837c3eabbc8c939e705bae924687635a8dc3ba1ffdb9d182b1b35df9765069974034d7506e631ad6f42b3434e1842677d2f342606a

data/lib/decode/definition.rb

@@ -29,13 +29,13 @@ module Decode
 		def initialize(name, parent: nil, language: parent.language, comments: nil)
 			@name = name
 			
-			@comments = comments
-			@language = language
 			@parent = parent
+			@language = language
+			
+			@comments = comments
 			
 			@path = nil
 			@qualified_name = nil
-			@documentation = nil
 		end
 		
 		def to_s

data/lib/decode/documentation.rb

@@ -20,6 +20,7 @@
 
 require_relative 'comment/node'
 
+require_relative 'comment/tags'
 require_relative 'comment/attribute'
 require_relative 'comment/parameter'
 require_relative 'comment/pragma'

data/lib/decode/language/generic.rb

@@ -19,32 +19,75 @@
 # THE SOFTWARE.
 
 require_relative 'reference'
+require_relative '../documentation'
 
 module Decode
 	module Language
 		# The Ruby language.
 		class Generic
-			def initialize(name)
+			EXTENSIONS = []
+			
+			TAGS = Comment::Tags.build do |tags|
+				tags['attribute'] = Comment::Attribute
+				tags['parameter'] = Comment::Parameter
+				tags['yields'] = Comment::Yields
+				tags['returns'] = Comment::Returns
+				tags['raises'] = Comment::Raises
+				tags['throws'] = Comment::Throws
+				
+				tags['reentrant'] = Comment::Pragma
+				tags['deprecated'] = Comment::Pragma
+				tags['blocking'] = Comment::Pragma
+				tags['asynchronous'] = Comment::Pragma
+			end
+			
+			def initialize(name, extensions: self.class::EXTENSIONS, tags: self.class::TAGS)
 				@name = name
+				@extensions = extensions
+				@tags = tags
 			end
 			
 			attr :name
 			
-			# Generate a generic reference.
+			def names
+				[@name]
+			end
+			
+			attr :extensions
+			
+			attr :tags
+			
+			# Generate a language-specific reference.
+			# @parameter identifier [String] A valid identifier.
 			def reference_for(identifier)
 				Reference.new(identifier, self)
 			end
 			
+			def parser
+				nil
+			end
+			
 			# Parse the input yielding definitions.
-			# @block {|definition| ... }
-			# @yield definition [Definition]
+			# @parameter input [File] The input file which contains the source code.
+			# @yields {|definition| ...} Receives the definitions extracted from the source code.
+			# 	@parameter definition [Definition] The source code definition including methods, classes, etc.
+			# @returns [Enumerator(Segment)] If no block given.
 			def definitions_for(input, &block)
+				if parser = self.parser
+					parser.definitions_for(input, &block)
+				end
 			end
 			
-			# Parse the input yielding interleaved comments and code segments.
-			# @block {|segment| ... }
-			# @yield segment [Segment]
+			# Parse the input yielding segments.
+			# Segments are constructed from a block of top level comments followed by a block of code.
+			# @parameter input [File] The input file which contains the source code.
+			# @yields {|segment| ...}
+			# 	@parameter segment [Segment]
+			# @returns [Enumerator(Segment)] If no block given.
 			def segments_for(input, &block)
+				if parser = self.parser
+					parser.segments_for(input, &block)
+				end
 			end
 		end
 	end

data/lib/decode/language/ruby.rb

@@ -18,78 +18,14 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require_relative 'ruby/reference'
-require_relative 'ruby/parser'
-require_relative 'ruby/code'
-
-require_relative '../comment/tags'
-require_relative '../comment/parameter'
-require_relative '../comment/yields'
-require_relative '../comment/returns'
+require_relative 'ruby/generic'
 
 module Decode
 	module Language
 		# An interface for extracting information from Ruby source code.
 		module Ruby
-			# The canoical name of the language for use in output formatting.
-			# e.g. source code highlighting.
-			def self.name
-				"ruby"
-			end
-			
-			def self.names
-				[self.name]
-			end
-			
-			def self.extensions
-				['.rb', '.ru']
-			end
-			
-			TAGS = Comment::Tags.build do |tags|
-				tags['attribute'] = Comment::Attribute
-				tags['parameter'] = Comment::Parameter
-				tags['yields'] = Comment::Yields
-				tags['returns'] = Comment::Returns
-				tags['raises'] = Comment::Raises
-				tags['throws'] = Comment::Throws
-				
-				tags['reentrant'] = Comment::Pragma
-				tags['deprecated'] = Comment::Pragma
-				tags['blocking'] = Comment::Pragma
-				tags['asynchronous'] = Comment::Pragma
-			end
-			
-			def self.tags
-				TAGS
-			end
-			
-			# Generate a language-specific reference.
-			# @parameter identifier [String] A valid identifier.
-			def self.reference_for(identifier)
-				Reference.new(identifier, self)
-			end
-			
-			# Parse the input yielding definitions.
-			# @parameter input [File] The input file which contains the source code.
-			# @yields {|definition| ...} Receives the definitions extracted from the source code.
-			# 	@parameter definition [Definition] The source code definition including methods, classes, etc.
-			# @returns [Enumerator(Segment)] If no block given.
-			def self.definitions_for(input, &block)
-				Parser.new.definitions_for(input, &block)
-			end
-			
-			# Parse the input yielding segments.
-			# Segments are constructed from a block of top level comments followed by a block of code.
-			# @parameter input [File] The input file which contains the source code.
-			# @yields {|segment| ...}
-			# 	@parameter segment [Segment]
-			# @returns [Enumerator(Segment)] If no block given.
-			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)
+			def self.new
+				Generic.new("ruby")
 			end
 		end
 	end

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

@@ -0,0 +1,48 @@
+# 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 'reference'
+require_relative 'parser'
+require_relative 'code'
+
+module Decode
+	module Language
+		module Ruby
+			# The Ruby language.
+			class Generic < Language::Generic
+				EXTENSIONS = ['.rb', '.ru']
+				
+				def parser
+					@parser ||= Parser.new(self)
+				end
+				
+				# Generate a language-specific reference.
+				# @parameter identifier [String] A valid identifier.
+				def reference_for(identifier)
+					Reference.new(identifier, self)
+				end
+				
+				def code_for(text, index, relative_to: nil)
+					Code.new(text, index, relative_to: relative_to, language: self)
+				end
+			end
+		end
+	end
+end

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

@@ -38,6 +38,10 @@ module Decode
 		module Ruby
 			# The Ruby source code parser.
 			class Parser
+				def initialize(language)
+					@language = language
+				end
+				
 				# Extract definitions from the given input file.
 				def definitions_for(input, &block)
 					top, comments = ::Parser::CurrentRuby.parse_with_comments(input)
@@ -84,7 +88,7 @@ module Decode
 							node, node.children[0].children[1],
 							comments: extract_comments_for(node, comments),
 							parent: parent,
-							language: Ruby
+							language: @language
 						)
 						
 						yield definition
@@ -96,7 +100,7 @@ module Decode
 						definition = Class.new(
 							node, node.children[0].children[1],
 							comments: extract_comments_for(node, comments),
-							parent: parent, language: Ruby
+							parent: parent, language: @language
 						)
 						
 						yield definition
@@ -108,7 +112,7 @@ module Decode
 						definition = Singleton.new(
 							node, node.children[0],
 							comments: extract_comments_for(node, comments),
-							parent: parent, language: Ruby
+							parent: parent, language: @language
 						)
 						
 						yield definition
@@ -120,7 +124,7 @@ module Decode
 						definition = Method.new(
 							node, node.children[0],
 							comments: extract_comments_for(node, comments),
-							parent: parent, language: Ruby
+							parent: parent, language: @language
 						)
 						
 						yield definition
@@ -128,7 +132,7 @@ module Decode
 						definition = Function.new(
 							node, node.children[1],
 							comments: extract_comments_for(node, comments),
-							parent: parent, language: Ruby
+							parent: parent, language: @language
 						)
 						
 						yield definition
@@ -136,18 +140,19 @@ module Decode
 						definition = Constant.new(
 							node, node.children[1],
 							comments: extract_comments_for(node, comments),
-							parent: parent, language: Ruby
+							parent: parent, language: @language
 						)
 						
 						yield definition
 					when :send
 						name = node.children[1]
+						
 						case name
 						when :attr, :attr_reader, :attr_writer, :attr_accessor
 							definition = Attribute.new(
 								node, name_for(node.children[2]),
 								comments: extract_comments_for(node, comments),
-								parent: parent, language: Ruby
+								parent: parent, language: @language
 							)
 							
 							yield definition
@@ -157,7 +162,7 @@ module Decode
 								definition = Call.new(
 									node, name_for(node, extracted_comments),
 									comments: extracted_comments,
-									parent: parent, language: Ruby
+									parent: parent, language: @language
 								)
 								
 								yield definition
@@ -171,7 +176,7 @@ module Decode
 								node, name,
 								comments: extracted_comments,
 								parent: scope_for(extracted_comments, parent, &block),
-								language: Ruby
+								language: @language
 							)
 							
 							if kind = kind_for(node, extracted_comments)
@@ -229,7 +234,7 @@ module Decode
 					comments&.each do |comment|
 						if match = comment.match(SCOPE_ATTRIBUTE)
 							return match[:names].split(/\s+/).map(&:to_sym).inject(nil) do |memo, name|
-								scope = Scope.new(name, parent: memo, language: Ruby)
+								scope = Scope.new(name, parent: memo, language: @language)
 								yield scope
 								scope
 							end
@@ -268,11 +273,11 @@ module Decode
 							if segment.nil?
 								segment = Segment.new(
 									extract_comments_for(child, comments),
-									Ruby,	child
+									@language,	child
 								)
 							elsif next_comments = extract_comments_for(child, comments)
 								yield segment if segment
-								segment = Segment.new(next_comments, Ruby, child)
+								segment = Segment.new(next_comments, @language, child)
 							else
 								segment.expand(child)
 							end
@@ -283,7 +288,7 @@ module Decode
 						# One top level segment:
 						segment = Segment.new(
 							extract_comments_for(node, comments),
-							Ruby,	node
+							@language, node
 						)
 						
 						yield segment

data/lib/decode/languages.rb

@@ -26,7 +26,7 @@ module Decode
 	class Languages
 		def self.all
 			self.new.tap do |languages|
-				languages.add(Language::Ruby)
+				languages.add(Language::Ruby.new)
 			end
 		end
 		

data/lib/decode/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.15.4
+  version: 0.16.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-09-19 00:00:00.000000000 Z
+date: 2021-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -114,6 +114,7 @@ files:
 - lib/decode/language/ruby/constant.rb
 - lib/decode/language/ruby/definition.rb
 - lib/decode/language/ruby/function.rb
+- lib/decode/language/ruby/generic.rb
 - lib/decode/language/ruby/method.rb
 - lib/decode/language/ruby/module.rb
 - lib/decode/language/ruby/parser.rb
@@ -148,7 +149,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
 summary: Code analysis for documentation generation.