bake 0.14.1 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5791d094c972d0cec6fa96e65bb0727703a08cde7cf669e82391d5e5783b5dd
-  data.tar.gz: 3f096c089469cb615756a3748f8150e504a39f7910eca170de5d2f39323af796
+  metadata.gz: 492a3039647b5dfb430f1d22b0c2bc691531e3bd06fa8adbb87f04cf53f06e49
+  data.tar.gz: f9c4aa8b76fc5dec8dd23ca65fa62123e24b37edc5bac909f7e4f3021f4a174f
 SHA512:
-  metadata.gz: 8bfa10d9641df00861b68593c4e65731e9e5083550fce23e4e4f3996161ff563fafd9d5de6b19be69a64b33dab986afcd0e89caad07edfe9a3006bfb63a41df8
-  data.tar.gz: e4e3b5fb27bb7bccc0b4f0c2aa3fa4befdedb76a177a2350cf192c77d82b46e192eec9ee62829f01775acfde392ba43bbca6a00d4b01ac83172687595b459a81
+  metadata.gz: 91146cbe9150339a51041896ac55b27c0d0791b0a1ebb20b6c3b0220c69f651f359d9e0f2f09c04db870f1e2501c773f7a6e25155550e0b3957eea3e8cd54825
+  data.tar.gz: 5df776825366bd19352085a97b5eba5eba6e5c18da9aa24bbe15dc5387789f20cf40836e4f3664c76e0911c458f274c5eccb02502ebb23650b9b97771f1a0e46

data/lib/bake.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -18,4 +20,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require "bake/version"
+require_relative 'bake/version'
+require_relative 'bake/loaders'
+require_relative 'bake/loader'
+require_relative 'bake/context'

data/lib/bake/arguments.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# 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 'types'
+require_relative 'documentation'
+
+module Bake
+	# Structured access to arguments.
+	class Arguments
+		def self.extract(recipe, arguments)
+			self.new(recipe).extract(arguments)
+		end
+		
+		def initialize(recipe)
+			@recipe = recipe
+			
+			@types = recipe.types
+			@parameters = recipe.parameters
+			@arity = recipe.arity
+			
+			@ordered = []
+			@options = {}
+		end
+		
+		attr :ordered
+		attr :options
+		
+		def extract(arguments)
+			while argument = arguments.first
+				if /^--(?<name>.*)$/ =~ argument
+					# Consume the argument:
+					arguments.shift
+					
+					if name.empty?
+						break
+					end
+					
+					name = normalize(name)
+					
+					# Extract the trailing arguments:
+					@options[name] = extract_arguments(name, arguments)
+				elsif /^(?<name>.*?)=(?<value>.*)$/ =~ argument
+					# Consume the argument:
+					arguments.shift
+					
+					name = name.to_sym
+					
+					# Extract the single argument:
+					@options[name] = extract_argument(name, value)
+				elsif @ordered.size < @arity
+					_, name = @parameters.shift
+					value = arguments.shift
+					
+					# Consume it:
+					@ordered << extract_argument(name, value)
+				else
+					break
+				end
+			end
+			
+			return @ordered, @options
+		end
+		
+		private
+		
+		def normalize(name)
+			name.tr('-', '_').to_sym
+		end
+		
+		def delimiter_index(arguments)
+			arguments.index{|argument| argument =~ /\A(--|;\z)/}
+		end
+		
+		def extract_arguments(name, arguments)
+			value = nil
+			type = @types[name]
+			
+			# Can this named parameter accept more than one input argument?
+			if type&.composite?
+				if count = delimiter_index(arguments)
+					value = arguments.shift(count)
+					arguments.shift if arguments.first == ';'
+				else
+					value = arguments.dup
+					arguments.clear
+				end
+			else
+				# Otherwise we just take one item:
+				value = arguments.shift
+			end
+			
+			if type
+				value = type.parse(value)
+			end
+			
+			return value
+		end
+		
+		def extract_argument(name, value)
+			if type = @types[name]
+				value = type.parse(value)
+			end
+			
+			return value
+		end
+	end
+end

data/lib/bake/base.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/command.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/command/call.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -34,7 +36,7 @@ module Bake
 				@parent.bakefile
 			end
 			
-			many :commands, "The commands & arguments to invoke.", default: ["default"]
+			many :commands, "The commands & arguments to invoke.", default: ["default"], stop: false
 			
 			def call
 				context = @parent.context

data/lib/bake/command/list.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/command/top.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -33,6 +35,10 @@ module Bake
 			options do
 				option '-h/--help', 'Show help.'
 				option '-b/--bakefile <path>', 'Override the path to the bakefile to use.'
+				
+				option '-g/--gem <name>', 'Load the specified gem, e.g. "bake ~> 1.0".' do |value|
+					gem(*value.split(/\s+/))
+				end
 			end
 			
 			nested :command, {

data/lib/bake/context.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -140,6 +142,10 @@ module Bake
 			end
 		end
 		
+		def inspect
+			"\#<#{self.class} #{@root}>"
+		end
+		
 		private
 		
 		def recipe_for(command)

data/lib/bake/documentation.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/loader.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/loaders.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/recipe.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -19,6 +21,7 @@
 # THE SOFTWARE.
 
 require_relative 'types'
+require_relative 'arguments'
 require_relative 'documentation'
 
 module Bake
@@ -105,40 +108,7 @@ module Bake
 		# @returns ordered [Array]
 		# @returns options [Hash]
 		def prepare(arguments)
-			offset = 0
-			ordered = []
-			options = {}
-			parameters = method.parameters.dup
-			types = self.types
-			
-			while argument = arguments.first
-				name, value = argument.split('=', 2)
-				
-				if name and value
-					# Consume it:
-					arguments.shift
-					
-					if type = types[name.to_sym]
-						value = type.parse(value)
-					end
-					
-					options[name.to_sym] = value
-				elsif ordered.size < self.arity
-					_, name = parameters.shift
-					value = arguments.shift
-					
-					if type = types[name]
-						value = type.parse(value)
-					end
-					
-					# Consume it:
-					ordered << value
-				else
-					break
-				end
-			end
-			
-			return ordered, options
+			Arguments.extract(self, arguments)
 		end
 		
 		# Call the recipe with the specified arguments and options.
@@ -171,6 +141,19 @@ module Bake
 		
 		private
 		
+		def parse(name, value, arguments, types)
+			if count = arguments.index(';')
+				value = arguments.shift(count)
+				arguments.shift
+			end
+			
+			if type = types[name]
+				value = type.parse(value)
+			end
+			
+			return value
+		end
+		
 		def compute_command
 			path = @instance.path
 			

data/lib/bake/scope.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/any.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/array.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -33,8 +35,19 @@ module Bake
 				true
 			end
 			
+			def map(values)
+				values.map{|value| @item_type.parse(value)}
+			end
+			
 			def parse(input)
-				input.split(',').map{|value| @item_type.parse(value)}
+				case input
+				when ::String
+					return input.split(',').map{|value| @item_type.parse(value)}
+				when ::Array
+					return input.map{|value| @item_type.parse(value)}
+				else
+					raise ArgumentError, "Cannot coerce #{input.inspect} into array!"
+				end
 			end
 			
 			def to_s

data/lib/bake/types/boolean.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/decimal.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/float.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/hash.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/input.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/integer.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/nil.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/output.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/string.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/symbol.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy

data/lib/bake/types/tuple.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -34,7 +36,14 @@ module Bake
 			end
 			
 			def parse(input)
-				input.split(',').map{|value| @item_type.parse(value)}
+				case input
+				when ::String
+					return input.split(',').map{|value| @item_type.parse(value)}
+				when ::Array
+					return input.map{|value| @item_type.parse(value)}
+				else
+					raise ArgumentError, "Cannot coerce #{input.inspect} into tuple!"
+				end
 			end
 			
 			def to_s

data/lib/bake/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright, 2020, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -19,5 +21,5 @@
 # THE SOFTWARE.
 
 module Bake
-	VERSION = "0.14.1"
+	VERSION = "0.16.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bake
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.16.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-16 00:00:00.000000000 Z
+date: 2021-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: samovar
@@ -25,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.1'
 - !ruby/object:Gem::Dependency
-  name: covered
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -39,7 +39,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -68,26 +68,14 @@ dependencies:
         version: '0'
 description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables:
 - bake
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/development.yml"
-- ".gitignore"
-- ".rspec"
-- README.md
-- bake.gemspec
-- bake.rb
 - bin/bake
-- gems.rb
-- guides/command-line-interface/README.md
-- guides/gem-integration/README.md
-- guides/getting-started/README.md
-- guides/links.yaml
-- guides/project-integration/README.md
 - lib/bake.rb
+- lib/bake/arguments.rb
 - lib/bake/base.rb
 - lib/bake/command.rb
 - lib/bake/command/call.rb
@@ -118,7 +106,7 @@ homepage: https://github.com/ioquatix/bake
 licenses:
 - MIT
 metadata:
-  donation_uri: https://github.com/sponsors/ioquatix
+  funding_uri: https://github.com/sponsors/ioquatix/
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -134,7 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
 summary: A replacement for rake with a simpler syntax.

data/.github/workflows/development.yml

@@ -1,35 +0,0 @@
-name: Development
-
-on: [push]
-
-jobs:
-  test:
-    strategy:
-      matrix:
-        os:
-          - ubuntu
-          - macos
-        
-        ruby:
-          - 2.5
-          - 2.6
-          - 2.7
-        
-        include:
-          - os: 'ubuntu'
-            ruby: '2.6'
-            env: COVERAGE=PartialSummary,Coveralls
-    
-    runs-on: ${{matrix.os}}-latest
-    
-    steps:
-    - uses: actions/checkout@v1
-    - uses: actions/setup-ruby@v1
-      with:
-        ruby-version: ${{matrix.ruby}}
-    - name: Install dependencies
-      run: |
-        command -v bundler || gem install bundler
-        bundle install
-    - name: Run tests
-      run: ${{matrix.env}} bundle exec rspec

data/.gitignore

@@ -1,13 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-gems.locked
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/README.md

@@ -1,61 +0,0 @@
-# Bake
-
-Bake is a task execution tool, inspired by Rake, but codifying many of the use cases which are typically implemented in an ad-hoc manner.
-
-[![Development](https://github.com/ioquatix/bake/workflows/Development/badge.svg)](https://github.com/ioquatix/bake/actions?workflow=Development)
-
-## Features
-
-Rake is an awesome tool and loved by the community. So, why reinvent it? Bake provides the following features that Rake does not:
-
-- On demand loading of files following a standard convention. This avoid loading all your rake tasks just to execute a single command.
-- Better argument handling including support for positional and optional arguments.
-- Focused on task execution not dependency resolution. Implementation is simpler and a bit more predictable.
-- Canonical structure for integration with gems.
-
-That being said, Rake and Bake can exist side by side in the same project.
-
-## Usage
-
-Please see the [project documentation](https://ioquatix.github.io/bake/).
-
-## 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'`).
-4.  Push to the branch (`git push origin my-new-feature`).
-5.  Create new Pull Request.
-
-
-## See Also
-
-- [Console](https://github.com/socketry/console) — A logging framework which integrates with bake.
-- [Variant](https://github.com/socketry/variant) — A framework for selecting different environments, including bake tasks.
-- [Utopia](https://github.com/socketry/utopia) — A website framework which uses bake for maintenance tasks.
-
-## License
-
-Released under the MIT license.
-
-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.

data/bake.gemspec

@@ -1,29 +0,0 @@
-require_relative 'lib/bake/version'
-
-Gem::Specification.new do |spec|
-	spec.name = "bake"
-	spec.version = Bake::VERSION
-	spec.authors = ["Samuel Williams"]
-	spec.email = ["samuel.williams@oriontransfer.co.nz"]
-	
-	spec.summary = "A replacement for rake with a simpler syntax."
-	spec.homepage = "https://github.com/ioquatix/bake"
-	spec.license = "MIT"
-	spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
-	
-	spec.metadata["donation_uri"] = "https://github.com/sponsors/ioquatix"
-	
-	spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(docs|test|spec|features)/}) }
-	end
-	
-	spec.bindir = "bin"
-	spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-	spec.require_paths = ["lib"]
-	
-	spec.add_dependency 'samovar', '~> 2.1'
-	
-	spec.add_development_dependency 'covered'
-	spec.add_development_dependency 'bundler'
-	spec.add_development_dependency 'rspec'
-end

data/gems.rb

@@ -1,11 +0,0 @@
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in bake.gemspec
-gemspec
-
-group :maintenance, optional: true do
-	gem 'bake-modernize'
-	gem 'bake-bundler'
-	
-	gem 'utopia-project'
-end

data/guides/command-line-interface/README.md

@@ -1,55 +0,0 @@
-# Command Line Interface
-
-The `bake` command is broken up into two main functions: `list` and `call`.
-
-<pre>% bake --help
-<b>bake [-h/--help] [-b/--bakefile &lt;path&gt;] &lt;command&gt;</b>
-	<font color="#638FFF">Execute tasks using Ruby.</font>
-
-	[-h/--help]             Show help.                               
-	[-b/--bakefile &lt;path&gt;]  Override the path to the bakefile to use.
-	&lt;command&gt;               One of: call, list.                        (default: call)
-
-	<b>call &lt;commands...&gt;</b>
-		<font color="#638FFF">Execute one or more commands.</font>
-
-		&lt;commands...&gt;  The commands &amp; arguments to invoke.  (default: [&quot;default&quot;])
-
-	<b>list &lt;pattern&gt;</b>
-		&lt;pattern&gt;  The pattern to filter tasks by.
-</pre>
-
-## List
-
-The `bake list` command allows you to list all available recipes. By proving a pattern you will only see recipes that have a matching command name.
-
-<pre>$ bake list console
-<b>Bake::Loader console-1.8.2</b>
-
-	<b>console:info</b>
-		<font color="#638FFF">Increase the verbosity of the logger to info.</font>
-
-	<b>console:debug</b>
-		<font color="#638FFF">Increase the verbosity of the logger to debug.</font>
-</pre>
-
-The listing documents positional and optional arguments. The documentation is generated from the comments in the bakefiles.
-
-## Call
-
-The `bake call` (the default, so `call` can be omitted) allows you to execute one or more recipes. You must provide the name of the command, followed by any arguments.
-
-<pre>$ bake async:http:head https://www.codeotaku.com/index
-<font color="#638FFF"><b>                HEAD</b></font>: https://www.codeotaku.com/index
-<font color="#00AA00"><b>             version</b></font>: h2
-<font color="#00AA00"><b>              status</b></font>: 200
-<font color="#00AA00"><b>                body</b></font>: body with length <b>7879B</b>
-<b>        content-type</b>: &quot;text/html; charset=utf-8&quot;
-<b>       cache-control</b>: &quot;public, max-age=3600&quot;
-<b>             expires</b>: &quot;Mon, 04 May 2020 13:23:47 GMT&quot;
-<b>              server</b>: &quot;falcon/0.36.4&quot;
-<b>                date</b>: &quot;Mon, 04 May 2020 12:23:47 GMT&quot;
-<b>                vary</b>: &quot;accept-encoding&quot;
-</pre>
-
-You can specify multiple commands and they will be executed sequentially.

data/guides/gem-integration/README.md

@@ -1,69 +0,0 @@
-# Gem Integration
-
-This guide explains how to add `bake` to a Ruby gem and export standardised tasks for use by other gems and projects.
-
-## Exporting Tasks
-
-Adding a `bake/` directory to your gem will allow other gems and projects to consume those recipes. In order to prevent collisions, you *should* prefix your commands with the name of the gem, e.g. in `mygem/bake/mygem.rb`:
-
-~~~ ruby
-def setup
-	# ...
-end
-~~~
-
-Then, in a different project which depends on `mygem`, you can run tasks from `mygem` by invoking them using `bake`:
-
-~~~ bash
-$ bake mygem:setup
-~~~
-
-## Examples
-
-There are many gems which export tasks in this way. Here are some notable examples:
-
-### Variant
-
-The [variant gem](https://github.com/socketry/variant) exposes bake tasks for setting the environment e.g. `development`, `testing`, or `production`.
-
-<pre class="terminal">$ bake list variant
-<b>Bake::Loader variant-0.1.1</b>
-
-	<b>variant:production</b> <font color="#00AA00">**overrides</font>
-		<font color="#638FFF">Select the production variant.</font>
-		<font color="#00AA00">overrides</font> [Hash] <font color="#638FFF">any specific variant overrides.</font>
-
-	<b>variant:staging</b> <font color="#00AA00">**overrides</font>
-		<font color="#638FFF">Select the staging variant.</font>
-		<font color="#00AA00">overrides</font> [Hash] <font color="#638FFF">any specific variant overrides.</font>
-
-	<b>variant:development</b> <font color="#00AA00">**overrides</font>
-		<font color="#638FFF">Select the development variant.</font>
-		<font color="#00AA00">overrides</font> [Hash] <font color="#638FFF">any specific variant overrides.</font>
-
-	<b>variant:testing</b> <font color="#00AA00">**overrides</font>
-		<font color="#638FFF">Select the testing variant.</font>
-		<font color="#00AA00">overrides</font> [Hash] <font color="#638FFF">any specific variant overrides.</font>
-
-	<b>variant:force</b> <font color="#AA0000">name</font> <font color="#00AA00">**overrides</font>
-		<font color="#638FFF">Force a specific variant.</font>
-		<font color="#00AA00">name</font> [Symbol] <font color="#638FFF">the default variant.</font>
-		<font color="#00AA00">overrides</font> [Hash] <font color="#638FFF">any specific variant overrides.</font>
-
-	<b>variant:show</b>
-		<font color="#638FFF">Show variant-related environment variables.</font>
-</pre>
-
-### Console
-
-The [console gem](https://github.com/socketry/console) exposes bake tasks to change the log level.
-
-<pre class="terminal">$ bake list console
-<b>Bake::Loader console-1.8.2</b>
-
-	<b>console:info</b>
-		<font color="#638FFF">Increase the verbosity of the logger to info.</font>
-
-	<b>console:debug</b>
-		<font color="#638FFF">Increase the verbosity of the logger to debug.</font>
-</pre>

data/guides/getting-started/README.md

@@ -1,109 +0,0 @@
-# Getting Started
-
-This guide gives a general overview of `bake` and how to use it.
-
-## Installation
-
-Add the gem to your project:
-
-~~~ bash
-$ bundle add bake
-~~~
-
-## Core Concepts
-
-`bake` has several core concepts:
-
-- A `bake` executable used for invoking one or more tasks.
-- A {ruby Bake::Context} instance which is bound to a project or gem and exposes a hierarchy of runnable tasks.
-- A {ruby Bake::Loaders} instance which is used for on-demand loading of bake files from the current project and all available gems.
-
-## Executing Tasks
-
-The `bake` executable can be used to execute tasks in a `bake.rb` file in the same directory.
-
-``` ruby
-# bake.rb
-
-def add(x, y)
-	puts Integer(x) + Integer(y)
-end
-```
-
-You can execute this task from the command line:
-
-``` shell
-% bake add 10 20
-30
-```
-
-### Using Types
-
-You can annotate your task with a type signature and `bake` will coerce your arguments to these types:
-
-``` ruby
-# bake.rb
-
-# @parameter x [Integer]
-# @parameter y [Integer]
-def add(x, y)
-	puts x + y
-end
-```
-
-You can execute this task from the command line:
-
-``` shell
-% bake add 10 20
-30
-```
-
-The values are automatically coerced to `Integer`.
-
-### Extending With Documentation
-
-You can add documentation to your tasks and parameters (using Markdown formatting).
-
-``` ruby
-# bake.rb
-
-# Add the x and y coordinate together and print the result.
-# @parameter x [Integer] The x offset.
-# @parameter y [Integer] The y offset.
-def add(x, y)
-	puts x + y
-end
-```
-
-You can see this documentation in the task listing:
-
-``` shell
-% bake list add
-Bake::Context getting-started
-
-	add x y
-		Add the x and y coordinate together and print the result.
-		x [Integer] The x offset.
-		y [Integer] The y offset.
-```
-
-### Private Methods
-
-If you want to add helper methods which don't show up as tasks, define them as `protected` or `private`.
-
-``` ruby
-# bake.rb
-
-# Add the x and y coordinate together and print the result.
-# @parameter x [Integer] The x offset.
-# @parameter y [Integer] The y offset.
-def add(x, y)
-	puts x + y
-end
-
-private
-
-def puts(*arguments)
-	$stdout.puts arguments.inspect
-end
-```

data/guides/links.yaml

@@ -1,8 +0,0 @@
-getting-started:
-  order: 1
-command-line-interface:
-  order: 2
-project-integration:
-  order: 3
-gem-integration:
-  order: 4

data/guides/project-integration/README.md

@@ -1,64 +0,0 @@
-# Project Integration
-
-This guide explains how to add `bake` to a Ruby project.
-
-## Bakefile
-
-At the top level of your project, you can create a `bake.rb` file, which contains top level tasks which are private to your project.
-
-~~~ ruby
-def cake
-	ingredients = call 'supermarket:shop', 'flour,sugar,cocoa'
-	lookup('mixer:add').call(ingredients)
-end
-~~~
-
-This file is project specific and is the only file which can expose top level tasks (i.e. without a defined namespace). When used in a gem, these tasks are not exposed to other gems/projects.
-
-## Recipes
-
-Alongside the `bake.rb`, there is a `bake/` directory which contains files like `supermarket.rb`. These files contain recipes, e.g.:
-
-~~~ ruby
-# @param ingredients [Array(Any)] the ingredients to purchase.
-def shop(ingredients)
-	supermarket = Supermarket.best
-	
-	return supermarket.purchase(ingredients)
-end
-~~~
-
-These methods are automatically scoped according to the file name, e.g. `bake/supermarket.rb` will define `supermarket:shop`.
-
-
-## Arguments
-
-Arguments work as normal. Documented types are used to parse strings from the command line. Both positional and optional parameters are supported.
-
-### Positional Parameters
-
-Positional parameters are non-keyword parameters which may have a default value. However, because of the limits of the command line, all positional arguments must be specified.
-
-~~~ ruby
-# @param x [Integer]
-# @param y [Integer]
-def add(x, y)
-	puts x + y
-end
-~~~
-
-Which is invoked by `bake add 1 2`.
-
-### Optional Parameters
-
-Optional parameters are keyword parameters which may have a default value. The parameter is set on the command line using the name of the parameter followed by an equals sign, followed by the value.
-
-~~~ ruby
-# @param x [Integer]
-# @param y [Integer]
-def add(x:, y: 2)
-	puts x + y
-end
-~~~
-
-Which is invoked by `bake add x=1`. Because `y` is not specified, it will default to `2` as per the method definition.