decode 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46819e1068182148b9179638359c81fe75b3276f3ae07285f962fbeda31f3a48
-  data.tar.gz: 24e0acf13ec561c1bb28be8700302302c2027c314d5c951613e3734260b1e995
+  metadata.gz: dae66e72979c078b311b91e8ad4ae7b6e3adbb0d3b03d0982db05b176d75d417
+  data.tar.gz: f42f00c8f685fa1ce6ae05336e4a41ade53b1cf40bc7002cb7f540327e5ec92c
 SHA512:
-  metadata.gz: 8b07a7bb594c53d26e81903b54cf640b766318eba6365a90a6b443fa2036ab4b4b5ac2145aadf44aca5fff8b4f373ff4379f7301c1658ffc25bce693ab49a268
-  data.tar.gz: a23772085b48311f6f4596f1215dd3b2a0e1974a5ca3d78c4bd207118c3c6b048beb342fd3dd04accdd39ed531ebcd29d8b73e9733bcff532f90b8203ba7f746
+  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/code.rb

@@ -42,7 +42,7 @@ module Decode
 				
 				def extract(into = [])
 					if @index
-						self.traverse(@root, into)
+						traverse(@root, into)
 					end
 					
 					return into
@@ -62,7 +62,7 @@ module Decode
 						end
 						
 						# Extract constants from arguments:
-						children = node.children[2..].each do |node|
+						children = node.children[2..-1].each do |node|
 							traverse(node, into)
 						end
 					when :const

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/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/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

@@ -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.0"
+	VERSION = "0.16.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-05-18 00:00:00.000000000 Z
+date: 2021-05-10 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: []
@@ -143,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
@@ -160,14 +132,15 @@ files:
 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
@@ -177,7 +150,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.2
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Code analysis for documentation generation.
 test_files: []