build 2.8.0 → 2.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9be6ae7b6f18b932ee30e00ac9951d3095215722bc8ff479a58a5c51cd7f81e5
-  data.tar.gz: 3afcfb408bb6b50028db3454fa457d35e54a5fa28e1caec6761d32eed2c9f16f
+  metadata.gz: b92547e352a87437f672b77a83666f9295deebb585c8949969e377dc2325cbb5
+  data.tar.gz: 364a58f6aa86c31a039b7cd5b39e6706128ad46bd84912df2d48098833c260bc
 SHA512:
-  metadata.gz: b8d546ed317a43d2f41bf5c356c84b7fcd05040993041367b3c7197334a003f5dace3866fb3133033fa0e18c0ca814c98675c7a16f82726396fd30ca587a4eb8
-  data.tar.gz: c77c91809ebe9132923e383f618fef77e49a8571cdbd670b538625bb003cff57dd1dc0a60da5c344bb3a344326fcea7b5c4a8e35e9f92c5529ca6c8f2600ea9c
+  metadata.gz: 1c3583294056a16e3042a3d6ece645f326669bb5c13c0fad8507b5198d6a29e20fe82f266f8aba55787964ae1730d2e7ca021e0f9eba4d6c19666bb6594631f7
+  data.tar.gz: 91637b6d29d74cff4246741955d8a8b2a082510fd1a0b48ebc8228f60c48987f5a44e06718a452db3dbd4b9cadebbb04e7b0e2e628caadbbd97ee79f32a2d86d

data/lib/build/controller.rb

@@ -20,15 +20,43 @@ require "console"
 module Build
 	# Represents the top-level build controller that manages the walker and process group.
 	class Controller
+		# A builder class for constructing the controller.
+		class Builder
+			# Initialize the builder with an empty list of nodes.
+			def initialize
+				@nodes = []
+			end
+			
+			# @attribute [Array(Graph::Node)] The list of nodes to build.
+			attr :nodes
+			
+			# Add a build environment to the controller.
+			def add_chain(chain, arguments = [], environment)
+				@nodes << ChainNode.new(chain, arguments, environment)
+			end
+		end
+		
+		# Create a new controller using a builder.
+		def self.build(**options)
+			builder = Builder.new
+			
+			yield builder
+			
+			new(builder.nodes, **options)
+		end
+		
 		# Initialize the controller, yielding self to allow adding chain nodes.
 		# @parameter limit [Integer | Nil] Maximum number of concurrent processes.
-		def initialize(limit: nil)
-			@module = Module.new
-			
-			# Top level nodes, for sanity this is a static list.
-			@nodes = []
-			yield self
-			@nodes.freeze
+		def initialize(nodes = [], limit: nil)
+			if block_given?
+				warn "Passing a block to Build::Controller.new is deprecated, use Build::Controller.build instead."
+				
+				builder = Builder.new
+				yield builder
+				@nodes = builder.nodes.freeze
+			else
+				@nodes = nodes.freeze
+			end
 			
 			@group = Process::Group.new(limit: limit)
 			
@@ -41,6 +69,15 @@ module Build
 		attr :nodes
 		attr :walker
 		
+		# Visit a task, executing its update method within the context of the task's visit method.
+		#
+		# @parameter task [Build::Task] The task to visit.
+		def visit(task)
+			task.visit do
+				task.update
+			end
+		end
+		
 		# Execute a single step of the build graph for the given node.
 		# @parameter walker [Build::Graph::Walker] The graph walker.
 		# @parameter node [Build::Graph::Node] The node to process.
@@ -49,9 +86,7 @@ module Build
 			task_class = node.task_class(parent_task) || Task
 			task = task_class.new(walker, node, @group)
 			
-			task.visit do
-				task.update
-			end
+			self.visit(task)
 		end
 		
 		# @returns [Boolean] Whether the build has failed.
@@ -59,11 +94,6 @@ module Build
 			@walker.failed?
 		end
 		
-		# Add a build environment to the controller.
-		def add_chain(chain, arguments = [], environment)
-			@nodes << ChainNode.new(chain, arguments, environment)
-		end
-		
 		# Execute all top-level nodes, waiting for each to complete.
 		def update
 			@nodes.each do |node|

data/lib/build/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Build
-	VERSION = "2.8.0"
+	VERSION = "2.9.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: build
 version: !ruby/object:Gem::Version
-  version: 2.8.0
+  version: 2.9.0
 platform: ruby
 authors:
 - Samuel Williams