decode 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d37f874bcef0dadaa82d665ae4f27ed182a0d45c55403a280c443dede81d1b97
-  data.tar.gz: a3394961b5285524ab07be9931aeb436cd78aa94286d6c65c81993389b162a28
+  metadata.gz: d1ca1745dcb76b54a61777388aba926d1262967dc51ca7ad633debc369f67d9f
+  data.tar.gz: 4164ca61971b6573b8604767cfdf35766605893f8d63cba44a516d705c0d5093
 SHA512:
-  metadata.gz: 7df83797d9844a6eb0e4f52f275527327ce7d81564865edcc70d5bce99a2be89b002fbe42cd1440bf666b4197c6dbb85775b4b4097675e525c1100aaf242571a
-  data.tar.gz: b2303685a56fa40ae3195a21a7a2cf613f5301f6c4520e4e6d8853e218b44363d33d704cd487710af40728f1926832b7bfc8bbd2a90db3555f6ed22c74ec7c45
+  metadata.gz: 7b247bcd2d6b0eaacf1bbaa444cd98df314251bca958914793ad455521c9f379233f737e6afeeb31197b76f0ce9876de1887304203eb5487fda113fa4b8eea11
+  data.tar.gz: 72b714cf3ad9b0f7969e23be899ca10186994661d6dbc0bb91bd27a200a6ce4ee18815bca5a7cc355316ea5f53b6ed2d818073b28f61a41caca0dbbf52196623

data/README.md

@@ -4,10 +4,12 @@ A Ruby code analysis tool and documentation generator.
 
 ## Usage
 
-Please see the documentation wiki.
+Please see the <a href="https://ioquatix.github.io/decode">project documentation</a> or run it locally using `bake utopia:project:serve`.
 
 ## Contributing
 
+We welcome contributions to this project.
+
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)

data/decode.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
 	# Specify which files should be added to the gem when it is released.
 	# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
 	spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
-		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(docs|test|spec|features)/}) }
 	end
 	
 	spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

data/examples/{index → decode-index}/extract.rb

@@ -1,7 +1,6 @@
 #!/usr/bin/env ruby
 
 # This example demonstrates how to extract symbols using the index. An instance of {Decode::Index} is used for loading symbols from source code files. These symbols are available as a flat list and as a trie structure. You can look up specific symbols using a reference using {Decode::Index:lookup}.
-
 require_relative '../../lib/decode/index'
 
 # Firstly, construct the index:

data/gems.rb

@@ -1,3 +1,5 @@
 source "https://rubygems.org"
 
 gemspec
+
+gem 'utopia-project', path: '../../socketry/utopia-project'

data/lib/decode/definition.rb

@@ -21,6 +21,7 @@
 require_relative 'symbol'
 
 module Decode
+	# A symbol with attached documentation.
 	class Definition < Symbol
 		def initialize(kind, name, comments, **options)
 			super(kind, name, **options)
@@ -29,44 +30,56 @@ module Decode
 			@documentation = nil
 		end
 		
+		# The comment lines which directly preceeded the definition.
+		# @attr [Array(String)]
 		attr :comments
 		
-		# A short form of the definition, e.g. `def short_form`.
+		# 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)`.
+		# A long form of the definition.
+		# e.g. `def initialize(kind, name, comments, **options)`.
+		#
 		# @return [String | nil]
 		def long_form
 			self.short_form
 		end
 		
-		# A long form which uses the qualified name if possible. Defaults to the {long_form}.
+		# A long form which uses the qualified name if possible.
+		# Defaults to {long_form}.
+		#
 		# @return  [String | nil]
 		def qualified_form
 			self.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.
+		# Structured access to the definitions comments.
+		#
+		# @return [Documentation | Nil] A `Documentation` if this definition has comments.
 		def documentation
 			if @comments&.any?
 				@documentation ||= Documentation.new(@comments)

data/lib/decode/documentation.rb

@@ -19,13 +19,26 @@
 # THE SOFTWARE.
 
 module Decode
+	# Structured access to a set of comment lines.
 	class Documentation
-		def initialize(comments)
+		# Initialize the documenation with an array of comments, within a specific language.
+		#
+		# @param comments [Array(String)] An array of comment lines.
+		# @param language [Language] The language in which the comments were extracted.
+		def initialize(comments, language = nil)
 			@comments = comments
+			@language = language
 		end
 		
+		# The language in which the documentation was extracted from.
+		attr :language
+		
 		DESCRIPTION = /\A\s*([^@\s].*)?\z/
 		
+		# The text-only lines of the comment block.
+		#
+		# @yield [String]
+		# @return [Enumerable]
 		def description
 			return to_enum(:description) unless block_given?
 			
@@ -52,6 +65,11 @@ module Decode
 		
 		ATTRIBUTE = /\A\s*@(?<name>.*?)\s+(?<value>.*?)\z/
 		
+		# The attribute lines of the comment block.
+		# e.g. `@return [String]`.
+		#
+		# @yield [String]
+		# @return [Enumerable]
 		def attributes
 			return to_enum(:attributes) unless block_given?
 			
@@ -64,6 +82,11 @@ module Decode
 		
 		PARAMETER = /\A\s*@param\s+(?<name>.*?)\s+\[(?<type>.*?)\]\s+(?<details>.*?)\z/
 		
+		# The parameter lines of the comment block.
+		# e.g. `@param value [String] The value.`
+		#
+		# @yield [String]
+		# @return [Enumerable]
 		def parameters
 			return to_enum(:parameters) unless block_given?
 			

data/lib/decode/index.rb

@@ -22,7 +22,9 @@ require_relative 'source'
 require_relative 'trie'
 
 module Decode
+	# A list of symbols organised for quick lookup and lexical enumeration.
 	class Index
+		# Initialize an empty index.
 		def initialize
 			@sources = {}
 			@symbols = {}
@@ -31,11 +33,23 @@ module Decode
 			@trie = Trie.new
 		end
 		
+		# All source files that have been parsed.
+		# @attr [Array(Source)]
 		attr :sources
+		
+		# All symbols which have been parsed.
+		# @attr [Array(Symbol)]
 		attr :symbols
 		
+		# A (prefix) trie of lexically scoped symbols.
+		# @attr [Trie]
+		
 		attr :trie
 		
+		# Updates the index by parsing the specified files.
+		# All extracted symbols are merged into the existing index.
+		#
+		# @param paths [Array(String)] The source file paths.
 		def update(paths)
 			paths.each do |path|
 				source = Source.new(path)
@@ -49,6 +63,10 @@ module Decode
 			end
 		end
 		
+		# Lookup the specified reference and return matching symbols.
+		#
+		# @param reference [Reference] The reference to match.
+		# @param relative_to [Symbol] Lookup the reference relative to the scope of this symbol.
 		def lookup(reference, relative_to: nil)
 			if reference.absolute? || relative_to.nil?
 				lexical_path = []
@@ -59,7 +77,7 @@ module Decode
 			path = reference.path
 			
 			while true
-				node = @trie.match(lexical_path)
+				node = @trie.lookup(lexical_path)
 				
 				if node.children[path.first]
 					if target = node.lookup(path)

data/lib/decode/language.rb

@@ -21,13 +21,12 @@
 require_relative 'language/ruby'
 
 module Decode
+	# Language specific parsers and symbols.
 	module Language
 		def self.detect(path)
 			case File.extname(path)
-			when '.rb'
+			when '.rb', '.ru'
 				return Language::Ruby
-			else
-				raise ArgumentError, "Could not determine language for #{path}!"
 			end
 		end
 	end

data/lib/decode/language/ruby.rb

@@ -23,7 +23,10 @@ require_relative 'ruby/parser'
 
 module Decode
 	module Language
+		# The Ruby language.
 		module Ruby
+			# The canoical name of the language for use in output formatting.
+			# e.g. source code highlighting.
 			def self.name
 				"ruby"
 			end
@@ -37,6 +40,7 @@ module Decode
 				defs: '.',
 			}.freeze
 			
+			# Generate a language-specific fully qualified name.
 			def self.join(symbols, absolute = true)
 				buffer = String.new
 				
@@ -53,18 +57,21 @@ module Decode
 				return buffer
 			end
 			
+			# Generate a language-specific reference.
 			def self.reference(value)
 				Reference.new(value)
 			end
 			
 			# Parse the input yielding symbols.
-			# @yield [Definition]
+			# @block `{|definition| ...}`
+			# @yield definition [Definition]
 			def self.symbols_for(input, &block)
 				Parser.new.symbols_for(input, &block)
 			end
 			
 			# Parse the input yielding interleaved comments and code segments.
-			# @yield [Segment]
+			# @block `{|segment| ...}`
+			# @yield segment [Segment]
 			def self.segments_for(input, &block)
 				Parser.new.segments_for(input, &block)
 			end

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

@@ -23,11 +23,16 @@ require_relative 'definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific attribute.
 			class Attribute < Definition
+				# The keyword that defined the attribute.
+				# @return [String]
 				def keyword
 					@node.children[1]
 				end
 				
+				# The short form of the attribute.
+				# e.g. `attr :value`.
 				def short_form
 					"#{self.keyword} #{@name.inspect}"
 				end

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

@@ -23,15 +23,21 @@ require_relative 'definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific class.
 			class Class < Definition
+				# A class is a container for other definitions.
 				def container?
 					true
 				end
 				
+				# The short form of the class.
+				# e.g. `class Animal`.
 				def short_form
 					"class #{@name}"
 				end
 				
+				# The long form of the class.
+				# e.g. `class Dog < Animal`.
 				def long_form
 					if super_node = @node.children[1]
 						@node.location.keyword.join(
@@ -42,24 +48,34 @@ module Decode
 					end
 				end
 				
+				# The fully qualified name of the class.
+				# e.g. `class ::Barnyard::Dog`.
 				def qualified_form
 					"class #{self.qualified_name}"
 				end
 			end
 			
+			# A Ruby-specific singleton class.
 			class Singleton < Definition
+				# A singleton class is a container for other definitions.
+				# @return [Boolean]
 				def container?
 					true
 				end
 				
+				# Typically, a singleton class does not contain other definitions.
+				# @return [Boolean]
 				def nested?
 					false
 				end
 				
+				# The short form of the class.
+				# e.g. `class << (self)`.
 				def short_form
 					"class << #{@name}"
 				end
 				
+				# The long form is the same as the short form.
 				alias long_form short_form
 			end
 		end

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

@@ -23,11 +23,16 @@ require_relative 'definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific constant.
 			class Constant < Definition
+				# The short form of the constant.
+				# e.g. `NAME`.
 				def short_form
 					@node.location.name.source
 				end
 				
+				# The long form of the constant.
+				# e.g. `NAME = "Alice"`.
 				def long_form
 					if @node.location.line == @node.location.last_line
 						@node.location.expression.source

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

@@ -23,15 +23,20 @@ require_relative '../../definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific definition.
 			class Definition < Decode::Definition
+				# Initialize the definition from the syntax tree node.
 				def initialize(kind, name, comments, node, **options)
 					super(kind, name, comments, **options)
 					
 					@node = node
 				end
 				
+				# The parser syntax tree node.
 				attr :node
 				
+				# The source code associated with the definition.
+				# @return [String]
 				def text
 					@node.location.expression.source
 				end

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

@@ -23,7 +23,9 @@ require_relative 'method'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific function.
 			class Function < Method
+				# The node which contains the function arguments.
 				def arguments_node
 					if node = @node.children[2]
 						if node.location.expression

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

@@ -23,11 +23,15 @@ require_relative 'definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific method.
 			class Method < Definition
+				# The short form of the method.
+				# e.g. `def puts`.
 				def short_form
 					@node.location.keyword.join(@node.location.name).source
 				end
 				
+				# The node which contains the function arguments.
 				def arguments_node
 					if node = @node.children[1]
 						if node.location.expression
@@ -36,6 +40,8 @@ module Decode
 					end
 				end
 				
+				# The long form of the method.
+				# e.g. `def puts(*lines, separator: "\n")`.
 				def long_form
 					if arguments_node = self.arguments_node
 						@node.location.keyword.join(

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

@@ -23,15 +23,20 @@ require_relative 'definition'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby-specific module.
 			class Module < Definition
+				# A module is a container for other definitions.
 				def container?
 					true
 				end
 				
+				# The short form of the module.
+				# e.g. `module Barnyard`.
 				def short_form
 					"module #{@name}"
 				end
 				
+				# The long form is the same as the short form.
 				alias long_form short_form
 			end
 		end

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

@@ -32,16 +32,11 @@ require_relative 'segment'
 module Decode
 	module Language
 		module Ruby
+			# The Ruby source code parser.
 			class Parser
-				def initialize(parser = ::Parser::CurrentRuby.new)
-					@parser = parser
-				end
-				
+				# Extract symbols from the given input file.
 				def symbols_for(input, &block)
-					buffer = ::Parser::Source::Buffer.new('(input)')
-					buffer.source = input.read
-					
-					top, comments = @parser.parse_with_comments(buffer)
+					top, comments = ::Parser::CurrentRuby.parse_with_comments(input.read)
 					
 					if top
 						walk_symbols(top, comments, &block)
@@ -162,11 +157,9 @@ module Decode
 					end
 				end
 				
+				# Extract segments from the given input file.
 				def segments_for(input, &block)
-					buffer = ::Parser::Source::Buffer.new('(input)')
-					buffer.source = input.read
-					
-					top, comments = @parser.parse_with_comments(buffer)
+					top, comments = ::Parser::CurrentRuby.parse_with_comments(input.read)
 					
 					# We delete any leading comments:
 					line = 0
@@ -193,11 +186,11 @@ module Decode
 							if segment.nil?
 								segment = Segment.new(
 									extract_comments_for(child, comments),
-									child
+									Ruby,	child
 								)
 							elsif next_comments = extract_comments_for(child, comments)
 								yield segment if segment
-								segment = Segment.new(next_comments, child)
+								segment = Segment.new(next_comments, Ruby, child)
 							else
 								segment.expand(child)
 							end

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

@@ -21,12 +21,15 @@
 module Decode
 	module Language
 		module Ruby
+			# An Ruby-specific reference which can be resolved to zero or more symbols.
 			class Reference
 				KIND =  {
 					':' => :def,
 					'.' => :defs,
 				}.freeze
 				
+				# Initialize the reference.
+				# @param value [String] The string value of the reference.
 				def initialize(value)
 					@value = value
 					
@@ -34,12 +37,15 @@ module Decode
 					@kind = nil
 				end
 				
+				# Whether the reference starts at the base of the lexical tree.
 				def absolute?
 					@value.start_with?('::')
 				end
 				
 				METHOD = /\A(?<scope>.*?)?(?<kind>:|\.)(?<name>.+?)\z/
 				
+				# The lexical path of the reference.
+				# @return [Array(String)]
 				def path
 					if @path.nil?
 						@path = @value.split(/::/)
@@ -65,6 +71,7 @@ module Decode
 					return @path
 				end
 				
+				# The kind of symbol to match.
 				def kind
 					self.path
 					

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

@@ -23,20 +23,24 @@ require_relative '../../segment'
 module Decode
 	module Language
 		module Ruby
+			# A Ruby specific code segment.
 			class Segment < Decode::Segment
-				def initialize(comments, node, **options)
-					super(comments, **options)
+				def initialize(comments, language, node, **options)
+					super(comments, language, **options)
 					
 					@node = node
 					@expression = node.location.expression
 				end
 				
+				# The parser syntax tree node.
 				attr :node
 				
 				def expand(node)
 					@expression = @expression.join(node.location.expression)
 				end
 				
+				# The source code trailing the comments.
+				# @return [String | nil]
 				def code
 					@expression.source
 				end

data/lib/decode/segment.rb

@@ -21,18 +21,32 @@
 require_relative 'documentation'
 
 module Decode
+	# A chunk of code with an optional preceeding comment block.
+	#
+	#	~~~ ruby
+	#	# Get the first segment from a source file:
+	#	segment = source.segments.first
+	#	~~~
+	#
 	class Segment
-		def initialize(comments)
+		def initialize(comments, language)
 			@comments = comments
+			@language = language
 		end
 		
+		# The preceeding comments.
+		# @attr [Array(String)]
 		attr :comments
 		
+		# The language of the code attached to this segment.
+		# @attr [Language]
+		attr :language
+		
 		# 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)
+				@documentation ||= Documentation.new(@comments, @language)
 			end
 		end
 		

data/lib/decode/source.rb

@@ -22,11 +22,21 @@ require_relative 'language'
 
 module Decode
 	class Source
+		def self.for?(path)
+			if language = Language.detect(path)
+				self.new(path, language)
+			end
+		end
+		
 		def initialize(path, language = nil)
 			@path = path
 			@language = language || Language.detect(path)
 		end
 		
+		attr :path
+		
+		attr :language
+		
 		def open(&block)
 			File.open(@path, &block)
 		end

data/lib/decode/symbol.rb

@@ -21,10 +21,16 @@
 require_relative 'documentation'
 
 module Decode
+	# A language agnostic lexical scope.
 	Key = Struct.new(:kind, :name)
 	
 	# A named element which represents some significant element of some kind in a computer program.
 	class Symbol
+		# Initialize the symbol.
+		# @param kind [Symbol] The kind of symbol.
+		# @param name [Symbol] The name of the symbol.
+		# @param parent [Symbol] The parent lexical scope.
+		# @param language [Language] The language in which the symbol is defined in.
 		def initialize(kind, name, parent: nil, language: parent.language)
 			@kind = kind
 			@name = name
@@ -45,10 +51,12 @@ module Decode
 			"\#<#{self.class} #{@kind} #{qualified_name}>"
 		end
 		
-		# The kind of symbol, e.g. `:module`.
+		# The kind of symbol.
+		# e.g. `:module`.
 		attr :kind
 		
-		# The symbol name, e.g. `:Decode`.
+		# The symbol name.
+		# e.g. `:Decode`.
 		attr :name
 		
 		# The parent symbol, defining lexical scope.
@@ -62,7 +70,7 @@ module Decode
 			@qualified_name ||= @language.join(self.path).freeze
 		end
 		
-		# The lexical scope as defined by the {key}.
+		# The lexical scope which is an array of lexical {Key} instances as generated by {key}.
 		# @return [Array]
 		def path
 			if @path

data/lib/decode/trie.rb

@@ -21,16 +21,27 @@
 require_relative 'source'
 
 module Decode
+	# A prefix-trie data structure for fast lexical lookups.
 	class Trie
+		# A single node in the trie.
 		class Node
 			def initialize
 				@values = nil
 				@children = Hash.new
 			end
 			
+			# A mutable array of all values that terminate at this node.
+			# @attr [Array]
 			attr_accessor :values
+			
+			# A hash table of all children nodes, indexed by name.
+			# @attr [Hash(String, Node)]
 			attr :children
 			
+			# Look up a lexical path starting at this node.
+			#
+			# @param path [Array(String)] The path to resolve.
+			# @return [Node | Nil]
 			def lookup(path, index = 0)
 				if index < path.size
 					if child = @children[path[index]]
@@ -41,6 +52,15 @@ module Decode
 				end
 			end
 			
+			# Traverse the trie from this node.
+			# Invoke `descend.call` to traverse the children of the current node.
+			#
+			# @param path [Array(String)] The current lexical path.
+			#
+			# @block `{|path, node, descend| descend.call}`
+			# @yield path [Array(String)] The current lexical path.
+			# @yield node [Node] The current node which is being traversed.
+			# @yield descend [Proc] The recursive method for traversing children.
 			def traverse(path = [], &block)
 				yield(path, self, ->{
 					@children.each do |name, node|
@@ -50,14 +70,18 @@ module Decode
 			end
 		end
 		
-		attr_accessor :value
-		
+		# Initialize an empty trie.
 		def initialize
 			@root = Node.new
 		end
 		
+		# The root of the trie.
+		# @attr [Node]
 		attr :root
 		
+		# Insert the specified value at the given path into the trie.
+		# @param path [Array(String)] The lexical path where the value will be inserted.
+		# @param value [Object] The value to insert.
 		def insert(path, value)
 			node = @root
 			
@@ -68,26 +92,35 @@ module Decode
 			(node.values ||= []) << value
 		end
 		
+		# Lookup the values at the specified path.
+		#
+		# @param path [Array(String)] The lexical path which contains the values.
+		# @return [Array(Object) | Nil] The values that existed (or not) at the specified path.
 		def lookup(path)
 			@root.lookup(path)
 		end
 		
-		# Given a base path, enumerate all paths under that.
-		# @yield (path, values) pairs
+		# Enumerate all lexical scopes under the specified path.
+		#
+		# @block `{|path, values| ...}`
+		# @yield path [Array(String)] The lexical path.
+		# @yield values [Array(Object)] The values that exist at the given path.
 		def each(path = [], &block)
 			if node = @root.lookup(path)
-				node.traverse(&block)
+				node.traverse do |path, node, descend|
+					yield path, node.values
+					
+					descend.call
+				end
 			end
 		end
 		
+		# Traverse the trie.
+		# See {Node:traverse} for details.
 		def traverse(path = [], &block)
 			if node = @root.lookup(path)
 				node.traverse(&block)
 			end
 		end
-		
-		def match(path, &block)
-			@root.lookup(path)
-		end
 	end
 end

data/lib/decode/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: decode
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-03 00:00:00.000000000 Z
+date: 2020-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser
@@ -120,10 +120,7 @@ files:
 - ".rspec"
 - README.md
 - decode.gemspec
-- docs/config.ru
-- docs/gems.locked
-- docs/gems.rb
-- examples/index/extract.rb
+- examples/decode-index/extract.rb
 - gems.rb
 - lib/decode.rb
 - lib/decode/definition.rb

data/docs/config.ru

@@ -1,6 +0,0 @@
-
-require 'utopia/setup'
-UTOPIA ||= Utopia.setup
-
-require 'utopia/project'
-Utopia::Project.call(self)

data/docs/gems.locked

@@ -1,137 +0,0 @@
-PATH
-  remote: ../../../socketry/utopia-project
-  specs:
-    utopia-project (0.1.0)
-      decode
-      falcon
-      kramdown
-      kramdown-parser-gfm
-      rackula
-      thread-local
-      utopia (~> 2.14)
-      utopia-gallery
-
-PATH
-  remote: ..
-  specs:
-    decode (0.6.0)
-      parser
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    ast (2.4.0)
-    async (1.25.2)
-      console (~> 1.0)
-      nio4r (~> 2.3)
-      timers (~> 4.1)
-    async-container (0.16.4)
-      async (~> 1.0)
-      async-io (~> 1.26)
-      process-group
-    async-http (0.52.0)
-      async (~> 1.25)
-      async-io (~> 1.28)
-      async-pool (~> 0.2)
-      protocol-http (~> 0.18.0)
-      protocol-http1 (~> 0.12.0)
-      protocol-http2 (~> 0.14.0)
-    async-http-cache (0.2.0)
-      async-http (~> 0.51)
-    async-io (1.29.0)
-      async (~> 1.14)
-    async-pool (0.3.0)
-      async (~> 1.25)
-    build-environment (1.13.0)
-    concurrent-ruby (1.1.6)
-    console (1.8.2)
-    falcon (0.36.4)
-      async (~> 1.13)
-      async-container (~> 0.16.0)
-      async-http (~> 0.52.0)
-      async-http-cache (~> 0.2.0)
-      async-io (~> 1.22)
-      build-environment (~> 1.13)
-      localhost (~> 1.1)
-      process-metrics (~> 0.2.0)
-      rack (>= 1.0)
-      samovar (~> 2.1)
-    ffi (1.12.2)
-    http-accept (2.1.1)
-    kramdown (2.2.1)
-      rexml
-    kramdown-parser-gfm (1.1.0)
-      kramdown (~> 2.0)
-    localhost (1.1.6)
-    mail (2.7.1)
-      mini_mime (>= 0.1.1)
-    mapping (1.1.1)
-    mime-types (3.3.1)
-      mime-types-data (~> 3.2015)
-    mime-types-data (3.2020.0425)
-    mini_mime (1.0.2)
-    msgpack (1.3.3)
-    nio4r (2.5.2)
-    parser (2.7.1.2)
-      ast (~> 2.4.0)
-    process-group (1.2.1)
-      process-terminal (~> 0.2.0)
-    process-metrics (0.2.1)
-      console (~> 1.8)
-      samovar (~> 2.1)
-    process-terminal (0.2.0)
-      ffi
-    protocol-hpack (1.4.2)
-    protocol-http (0.18.0)
-    protocol-http1 (0.12.0)
-      protocol-http (~> 0.18)
-    protocol-http2 (0.14.0)
-      protocol-hpack (~> 1.4)
-      protocol-http (~> 0.18)
-    rack (2.2.2)
-    rackula (1.1.0)
-      falcon (~> 0.34)
-      samovar (~> 2.1)
-      variant
-    rake (13.0.1)
-    rake-compiler (1.1.0)
-      rake
-    rexml (3.2.4)
-    samovar (2.1.4)
-      console (~> 1.0)
-      mapping (~> 1.0)
-    thread-local (1.0.0)
-    timers (4.3.0)
-    trenni (3.9.0)
-      rake-compiler
-    utopia (2.15.1)
-      concurrent-ruby (~> 1.0)
-      console (~> 1.0)
-      http-accept (~> 2.1)
-      mail (~> 2.6)
-      mime-types (~> 3.0)
-      msgpack
-      rack (~> 2.2)
-      samovar (~> 2.1)
-      trenni (~> 3.0)
-      variant (~> 0.1)
-    utopia-gallery (2.5.0)
-      trenni (~> 3.9)
-      utopia (~> 2.0)
-      vips-thumbnail (~> 1.6)
-    variant (0.1.1)
-      thread-local
-    vips (8.9.1)
-      ffi (~> 1.9)
-    vips-thumbnail (1.6.0)
-      vips (~> 8.9)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  decode!
-  utopia-project!
-
-BUNDLED WITH
-   2.1.4

data/docs/gems.rb

@@ -1,7 +0,0 @@
-
-source "https://rubygems.org"
-
-group :preload do
-	gem "utopia-project", path: "../../../socketry/utopia-project"
-	gem "decode", path: "../"
-end