buildkite-builder 4.18.0 → 4.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b35cda668c919aa133b9789085de5ecb4c285336b14613251b019df092a88cff
-  data.tar.gz: 6a4a74637c721e677072e656872265c086d5f2dd969dd5396df57f5a7ac2f9dd
+  metadata.gz: 766b0ac1d07fc726b376e905fbfaa30864055c458bd0f3190247ec56a853768c
+  data.tar.gz: 4e79fe7cc6b1913afcd311ea96349242653f45ce0b541e7cb452dcb9e5366460
 SHA512:
-  metadata.gz: 6e44c665a44cde92d9cf26cfc0735d95bedaa0c2acb547e48a39b17aaf4e5a941935013079fe15e239af084d183af1723841bcfe56b432b0acce6be2f02b9b53
-  data.tar.gz: 54dd9bc5ce7e1d383e0f1223469e0a22a0418c0e8e74af3face8e1ac3fe386cabad78b3fec1bb01bbe7d66b3a3713e775562cb43f55b3697805ca2b85dbe017a
+  metadata.gz: 7313796c22a45884e1120ef293279f3473eb17da52e5c93bd71c5cc8c5514725fe0428ebe25a74b2adc728634bbeb256afc81e2625e2f4ae90d4f4ae4b7d92fc
+  data.tar.gz: 521ce5fdfeace7b5f23049cbf5e15df6a195f31d8aa7f71bbd856a2daa22a31ed9b5de405c5c330d1bb4b2696111c572d9bf3281dee72de403ee9ca7c365f51b

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+### 4.19.0
+* Support build matrix.
+
 ### 4.18.0
 * Support template definition within extensions.
 

data/README.md

@@ -143,6 +143,61 @@ Buildkite::Builder.pipeline do
 end
 ```
 
+### Extensions
+
+Extensions provide additional flexibility to run code and encapsulate reusable patterns in your pipelines. Think of extensions as Ruby modules that let you define custom DSL, step templates, and shared logic that can be used across multiple pipelines.
+
+Extensions are useful when you want to standardize how certain steps are defined, or when you want to use or share complex logic (like deployment, notifications, or test orchestration).
+
+`.buildkite/pipelines/foobar-widget/extensions/deploy_extension.rb`
+
+```ruby
+class DeployExtension < Buildkite::Builder::Extension
+  dsl do
+    def deploy_step(&block)
+      command(:deploy, &block)
+    end
+  end
+end
+```
+
+`.buildkite/pipelines/foobar-widget/pipeline.rb`
+
+```ruby
+Buildkite::Builder.pipeline do
+  deploy_step do
+    label "Deploy to production (EU)"
+    command "bundle exec deploy --env production --region eu"
+  end
+end
+```
+
+#### Extension Templates
+
+Extensions can also provide multiple templates for different scenarios:
+
+```ruby
+class TestExtension < Buildkite::Builder::Extension
+  template :default do
+    command "bundle exec rspec"
+  end
+
+  template :rubocop do
+    command "bundle exec rubocop"
+  end
+end
+```
+
+And used like this in the pipeline file:
+
+```ruby
+command(TestExtension) # Uses the default template
+
+command(TestExtension.template(:rubocop)) do
+  label "Custom Rubocop label"
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/VERSION

@@ -1 +1 @@
-4.18.0
+4.19.0

data/lib/buildkite/pipelines/helpers/matrix.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Buildkite
+  module Pipelines
+    module Helpers
+      module Matrix
+        def matrix(value = nil, setup: nil)
+          if value.nil? && setup.nil?
+            get(:matrix)
+          elsif setup
+            set(:matrix, { setup: setup })
+          else
+            set(:matrix, value)
+          end
+        end
+      end
+    end
+  end
+end 

data/lib/buildkite/pipelines/helpers.rb

@@ -9,6 +9,7 @@ module Buildkite
         depends_on: :DependsOn,
         key: :Key,
         label: :Label,
+        matrix: :Matrix,
         plugins: :Plugins,
         retry: :Retry,
         skip: :Skip,

data/lib/buildkite/pipelines/steps/command.rb

@@ -14,6 +14,7 @@ module Buildkite
         attribute :depends_on, append: true
         attribute :allow_dependency_failure
         attribute :parallelism
+        attribute :matrix
         attribute :branches
         attribute :artifact_paths
         attribute :agents

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: buildkite-builder
 version: !ruby/object:Gem::Version
-  version: 4.18.0
+  version: 4.19.0
 platform: ruby
 authors:
 - Ngan Pham
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-05-21 00:00:00.000000000 Z
+date: 2025-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -154,6 +154,7 @@ files:
 - lib/buildkite/pipelines/helpers/depends_on.rb
 - lib/buildkite/pipelines/helpers/key.rb
 - lib/buildkite/pipelines/helpers/label.rb
+- lib/buildkite/pipelines/helpers/matrix.rb
 - lib/buildkite/pipelines/helpers/plugins.rb
 - lib/buildkite/pipelines/helpers/retry.rb
 - lib/buildkite/pipelines/helpers/skip.rb