dagger_ruby 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3236161fdcbdb34e426318363c0db9b1625fef0bfff6d83d021908ccaab26e69
-  data.tar.gz: d0510f01bd92c27f6f06ba2c2693007771ffb8d6fb8da663ef2aea8798bd09d6
+  metadata.gz: 4a4bcab9db019b25e782aab84ab1e3b154bda15f64cb7d1ffdd522d14cbfb729
+  data.tar.gz: 41e902336fe58545784c21e85a17cc55961a9aab6ad2c6370547ffb4d4779eb5
 SHA512:
-  metadata.gz: fb8c138bbf1c674ad47cffecb4d31c77348c83a4e83e6439f55240925587ba16035f53d21f49995d849807d6d1b9bd70edb0cabec3fe860c521efaade6307539
-  data.tar.gz: ad20b3fb027215a665fb58fbfde7ae125d791e7b596c449ac23f91e87e07e16de154d9775b19d070066855b26cb062e8d69ffe382f64d9c59feab438daa225d6
+  metadata.gz: 897cdcb244f34e704a70f2bb47fdeadeb946c2c29e0fff763cf0b487122657a11d2bee3d664593c0b268baf45eba0cbf9b8da1e889eb601e1f4ad6ed7056e1b2
+  data.tar.gz: c52a3cfff5a10a1ef6c8bc1e522c56bf423642dbfbc57bcc76c03e84a61e31e8f346a8157bffb53e112d2a77cdfd044b6d4c562784f9afa785f0460d02f98864

data/CHANGELOG.md

@@ -6,6 +6,19 @@ All notable changes are recorded here. The format follows
 
 ## [Unreleased]
 
+## [0.10.0] - 2026-08-25
+
+### Added
+
+- Explicit Apple Container and Docker runner selection.
+- Compatible Dagger CLI and engine verification before standalone sessions.
+- Container default-argument, Docker healthcheck, and host image-store export APIs.
+
+### Changed
+
+- Support Ruby 3.2 and newer so Ruby applications do not need Ruby 4 solely to
+  use the Dagger client.
+
 ## [0.9.0] - 2026-08-20
 
 ### Added
@@ -64,7 +77,8 @@ All notable changes are recorded here. The format follows
 
 - Initial container, directory, file, cache, secret, Git, and GraphQL client.
 
-[Unreleased]: https://github.com/boringcache/dagger_ruby/compare/v0.9.0...HEAD
+[Unreleased]: https://github.com/boringcache/dagger_ruby/compare/v0.10.0...HEAD
+[0.10.0]: https://github.com/boringcache/dagger_ruby/compare/v0.9.0...v0.10.0
 [0.9.0]: https://github.com/boringcache/dagger_ruby/compare/v0.8.0...v0.9.0
 [0.8.0]: https://github.com/boringcache/dagger_ruby/releases/tag/v0.8.0
 [0.6.0]: https://github.com/boringcache/dagger_ruby/releases/tag/v0.6.0

data/README.md

@@ -12,7 +12,7 @@ covers a practical subset of the API instead of Dagger module code generation.
 
 ## Requirements
 
-- Ruby 4.0 or newer
+- Ruby 3.2 or newer
 - Dagger 0.21.8
 - Docker, Colima, or another container runtime supported by Dagger
 
@@ -133,6 +133,7 @@ config = DaggerRuby::Config.new(
   timeout: 300,
   progress: "plain",
   log_output: $stderr,
+  runtime: :apple,
 )
 
 DaggerRuby.connection(config) do |client|
@@ -143,6 +144,13 @@ end
 `DAGGER_QUIET`, `DAGGER_SILENT`, and `DAGGER_PROGRESS` can provide the same CLI
 preferences through the environment.
 
+The client verifies the installed Dagger CLI before it starts a runner and then
+verifies the connected engine version. This matters for runtime drivers because
+the compatible CLI provisions the runner; merely pointing an older CLI at a
+newer engine image is not sufficient. Use `runtime: :apple` or `runtime: :docker`
+when more than one runtime is installed and automatic detection would be
+ambiguous. A custom runner can be selected with `runner_host:`.
+
 ## Errors
 
 Connection, transport, GraphQL, and invalid-query failures use dedicated error
@@ -158,7 +166,7 @@ end
 
 ## Compatibility
 
-The current branch is tested against Ruby 4.0 and Dagger 0.21.8. Dagger's
+The current branch is tested against maintained Ruby releases and Dagger 0.21.8. Dagger's
 GraphQL schema can change between releases, so each supported engine update is
 validated by the live integration suite before release. Earlier Ruby and Dagger
 versions are not covered by the current compatibility contract.

data/dagger_ruby.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
                      "services, caches, secrets, and filesystem operations with the Dagger engine."
   spec.homepage = "https://github.com/boringcache/dagger_ruby"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 4.0.0"
+  spec.required_ruby_version = ">= 3.2.0"
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
 

data/lib/dagger_ruby/config.rb

@@ -1,8 +1,13 @@
 require "logger"
+require_relative "version"
 
 module DaggerRuby
   class Config
-    attr_reader :log_output, :workdir, :timeout, :quiet, :silent, :progress
+    ENGINE_IMAGE = "registry.dagger.io/engine".freeze
+    RUNTIMES = %i[auto apple docker].freeze
+
+    attr_reader :log_output, :workdir, :timeout, :quiet, :silent, :progress,
+                :runtime, :runner_host, :dagger_version, :verify_version
 
     def initialize(options = {})
       @log_output = options[:log_output]
@@ -11,6 +16,38 @@ module DaggerRuby
       @quiet = options[:quiet] || ENV["DAGGER_QUIET"]&.to_i
       @silent = options[:silent] || ENV["DAGGER_SILENT"] == "true"
       @progress = options[:progress] || ENV.fetch("DAGGER_PROGRESS", nil)
+      @runtime = normalize_runtime(options.fetch(:runtime, ENV.fetch("DAGGER_RUBY_RUNTIME", "auto")))
+      @runner_host = options[:runner_host]
+      @dagger_version = options.fetch(:dagger_version, DAGGER_VERSION).to_s.delete_prefix("v")
+      @verify_version = options.fetch(:verify_version, true)
+
+      raise ArgumentError, "runner_host and runtime cannot both be configured" if @runner_host && @runtime != :auto
+    end
+
+    def environment
+      environment = {}
+      environment["_EXPERIMENTAL_DAGGER_RUNNER_HOST"] = resolved_runner_host if resolved_runner_host
+      environment
+    end
+
+    def expected_engine_version
+      "v#{dagger_version}"
+    end
+
+    private
+
+    def normalize_runtime(value)
+      runtime = value.to_s.downcase.to_sym
+      return runtime if RUNTIMES.include?(runtime)
+
+      raise ArgumentError, "Unknown Dagger runtime '#{value}'. Use auto, apple, or docker."
+    end
+
+    def resolved_runner_host
+      return runner_host if runner_host
+      return if runtime == :auto
+
+      "image+#{runtime}://#{ENGINE_IMAGE}:#{expected_engine_version}"
     end
   end
 end

data/lib/dagger_ruby/container.rb

@@ -98,6 +98,26 @@ module DaggerRuby
       chain_operation("withEntrypoint", entrypoint_args)
     end
 
+    def with_default_args(args)
+      chain_operation("withDefaultArgs", { "args" => args })
+    end
+
+    def with_docker_healthcheck(args, opts = {})
+      healthcheck_args = { "args" => args }
+      healthcheck_args["shell"] = opts[:shell] if opts.key?(:shell)
+      healthcheck_args["interval"] = opts[:interval] if opts[:interval]
+      healthcheck_args["timeout"] = opts[:timeout] if opts[:timeout]
+      healthcheck_args["startPeriod"] = opts[:start_period] if opts[:start_period]
+      healthcheck_args["startInterval"] = opts[:start_interval] if opts[:start_interval]
+      healthcheck_args["retries"] = opts[:retries] if opts[:retries]
+
+      chain_operation("withDockerHealthcheck", healthcheck_args)
+    end
+
+    def without_docker_healthcheck
+      chain_operation("withoutDockerHealthcheck")
+    end
+
     def with_user(name)
       chain_operation("withUser", { "name" => name })
     end
@@ -259,6 +279,17 @@ module DaggerRuby
       get_scalar("entrypoint")
     end
 
+    def default_args
+      get_scalar("defaultArgs")
+    end
+
+    def docker_healthcheck
+      get_selection(
+        "dockerHealthcheck",
+        "args shell interval timeout startPeriod startInterval retries",
+      )
+    end
+
     def env_variables
       get_selection("envVariables", "name value")
     end
@@ -305,6 +336,16 @@ module DaggerRuby
       export(path, opts)
     end
 
+    def export_image(name, opts = {})
+      args = { "name" => name }
+      args["platformVariants"] = graphql_ids(opts[:platform_variants]) if opts[:platform_variants]
+      args["forcedCompression"] = QueryBuilder.enum_value(opts[:forced_compression]) if opts[:forced_compression]
+      args["mediaTypes"] = QueryBuilder.enum_value(opts[:media_types]) if opts[:media_types]
+
+      get_scalar("exportImage", args)
+      name
+    end
+
     def publish(address, opts = {})
       args = { "address" => address }
       args["platformVariants"] = graphql_ids(opts[:platform_variants]) if opts[:platform_variants]

data/lib/dagger_ruby/errors.rb

@@ -6,4 +6,5 @@ module DaggerRuby
   class HTTPError < DaggerError; end
   class InvalidQueryError < DaggerError; end
   class ConnectionError < DaggerError; end
+  class VersionMismatchError < ConnectionError; end
 end

data/lib/dagger_ruby/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module DaggerRuby
-  VERSION = "0.9.0"
+  VERSION = "0.10.0"
   DAGGER_VERSION = "0.21.8"
 end

data/lib/dagger_ruby.rb

@@ -4,13 +4,16 @@ require_relative "dagger_ruby/version"
 require_relative "dagger_ruby/client"
 require_relative "dagger_ruby/config"
 require_relative "dagger_ruby/errors"
+require "open3"
 
 module DaggerRuby
   class << self
     def connection(config = nil, &)
+      config ||= Config.new
       return connection_in_current_session(config, &) if dagger_session?
 
-      exec(*dagger_run_command(config))
+      verify_cli_version!(config) if config.verify_version
+      exec(config.environment, *dagger_run_command(config))
     end
 
     private
@@ -21,6 +24,12 @@ module DaggerRuby
 
     def connection_in_current_session(config)
       client = Client.new(config: config)
+      begin
+        verify_engine_version!(client, config) if config.verify_version
+      rescue StandardError
+        client.close
+        raise
+      end
       return client unless block_given?
 
       begin
@@ -30,6 +39,14 @@ module DaggerRuby
       end
     end
 
+    def verify_engine_version!(client, config)
+      actual = client.execute_query("query { version }").fetch("version")
+      return if actual == config.expected_engine_version
+
+      raise VersionMismatchError,
+            "Dagger engine #{actual} is incompatible with this client; expected #{config.expected_engine_version}"
+    end
+
     def dagger_run_command(config)
       [
         "dagger",
@@ -44,6 +61,19 @@ module DaggerRuby
       ]
     end
 
+    def verify_cli_version!(config)
+      stdout, stderr, status = Open3.capture3("dagger", "version")
+      output = [stdout, stderr].join(" ").strip
+      actual = output[/\bv\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?\b/]
+      return if status.success? && actual == config.expected_engine_version
+
+      found = actual || (output.empty? ? "an unreadable version" : output)
+      raise VersionMismatchError,
+            "Dagger CLI #{found} is incompatible with this client; install #{config.expected_engine_version}"
+    rescue Errno::ENOENT
+      raise VersionMismatchError, "Dagger CLI is not installed; install #{config.expected_engine_version}"
+    end
+
     def quiet_flags(config)
       quiet = config&.quiet || ENV["DAGGER_QUIET"]&.to_i
       quiet&.positive? ? ["-q"] * quiet : []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dagger_ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - BoringCache
@@ -85,7 +85,7 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/boringcache/dagger_ruby
-  source_code_uri: https://github.com/boringcache/dagger_ruby/tree/v0.9.0
+  source_code_uri: https://github.com/boringcache/dagger_ruby/tree/v0.10.0
   changelog_uri: https://github.com/boringcache/dagger_ruby/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/boringcache/dagger_ruby/issues
   documentation_uri: https://github.com/boringcache/dagger_ruby#readme
@@ -98,7 +98,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 4.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="