Merge pull request #8 from Hexlet/release-please--branches--main--changes--next

release: 0.5.0

Author: mokevnin

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0"
+  ".": "0.5.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 102
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hexlet%2Fdocker-31f80d10d31a27ca7945346411d6914e4b67a36769e006cb922d2cd7214c6ecc.yml
-openapi_spec_hash: f79f7bd46f2d82f5f60481696d782b7c
-config_hash: 5e86cccf228162276328f1b5ced3b7d0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/hexlet%2Fdocker-7dbd508c79cf09803a2a05ee36b55ae9219a6218f0637891b33e1ac25db10b5d.yml
+openapi_spec_hash: 16948cc9b83def4e333889ca4e0497f3
+config_hash: a6764d7382ab85291261b00542e66610

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0 (2026-02-14)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/Hexlet/docker-ruby/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** api update ([a44163c](https://github.com/Hexlet/docker-ruby/commit/a44163cdccd707282795ba0dfccc5c8647bb42ce))
+
 ## 0.4.0 (2026-02-14)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/Hexlet/docker-ruby/compare/v0.3.0...v0.4.0)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    docker-engine-ruby (0.4.0)
+    docker-engine-ruby (0.5.0)
       cgi
       connection_pool
 

README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "docker-engine-ruby", "~> 0.4.0"
+gem "docker-engine-ruby", "~> 0.5.0"
 ```
 
 <!-- x-release-please-end -->
@@ -28,7 +28,9 @@ gem "docker-engine-ruby", "~> 0.4.0"
 require "bundler/setup"
 require "docker_engine_ruby"
 
-docker = DockerEngineRuby::Client.new
+docker = DockerEngineRuby::Client.new(
+  environment: "production_tls" # defaults to "production"
+)
 
 create_response = docker.containers.create(name: "sample-container")
 

lib/docker_engine_ruby/client.rb

@@ -15,6 +15,11 @@ class Client < DockerEngineRuby::Internal::Transport::BaseClient
     # Default max retry delay in seconds.
     DEFAULT_MAX_RETRY_DELAY = 8.0
 
+    # rubocop:disable Style/MutableConstant
+    # @type [Hash{Symbol=>String}]
+    ENVIRONMENTS = {production: "http://localhost:2375", production_tls: "https://localhost:2376"}
+    # rubocop:enable Style/MutableConstant
+
     # @return [DockerEngineRuby::Resources::Auth]
     attr_reader :auth
 
@@ -62,6 +67,13 @@ class Client < DockerEngineRuby::Internal::Transport::BaseClient
 
     # Creates and returns a new client for interacting with the API.
     #
+    # @param environment [:production, :production_tls, nil] Specifies the environment to use for the API.
+    #
+    # Each environment maps to a different base URL:
+    #
+    # - `production` corresponds to `http://localhost:2375`
+    # - `production_tls` corresponds to `https://localhost:2376`
+    #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     # `"https://api.example.com/v2/"`. Defaults to `ENV["DOCKER_BASE_URL"]`
     #
@@ -73,13 +85,17 @@ class Client < DockerEngineRuby::Internal::Transport::BaseClient
     #
     # @param max_retry_delay [Float]
     def initialize(
+      environment: nil,
       base_url: ENV["DOCKER_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
       max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
     )
-      base_url ||= "http://localhost:2375"
+      base_url ||= DockerEngineRuby::Client::ENVIRONMENTS.fetch(environment&.to_sym || :production) do
+        message = "environment must be one of #{DockerEngineRuby::Client::ENVIRONMENTS.keys}, got #{environment}"
+        raise ArgumentError.new(message)
+      end
 
       super(
         base_url: base_url,

lib/docker_engine_ruby/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DockerEngineRuby
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

rbi/docker_engine_ruby/client.rbi

@@ -10,6 +10,15 @@ module DockerEngineRuby
 
     DEFAULT_MAX_RETRY_DELAY = T.let(8.0, Float)
 
+    ENVIRONMENTS =
+      T.let(
+        {
+          production: "http://localhost:2375",
+          production_tls: "https://localhost:2376"
+        },
+        T::Hash[Symbol, String]
+      )
+
     sig { returns(DockerEngineRuby::Resources::Auth) }
     attr_reader :auth
 
@@ -58,6 +67,7 @@ module DockerEngineRuby
     # Creates and returns a new client for interacting with the API.
     sig do
       params(
+        environment: T.nilable(T.any(Symbol, String)),
         base_url: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
@@ -66,6 +76,13 @@ module DockerEngineRuby
       ).returns(T.attached_class)
     end
     def self.new(
+      # Specifies the environment to use for the API.
+      #
+      # Each environment maps to a different base URL:
+      #
+      # - `production` corresponds to `http://localhost:2375`
+      # - `production_tls` corresponds to `https://localhost:2376`
+      environment: nil,
       # Override the default base URL for the API, e.g.,
       # `"https://api.example.com/v2/"`. Defaults to `ENV["DOCKER_BASE_URL"]`
       base_url: ENV["DOCKER_BASE_URL"],

sig/docker_engine_ruby/client.rbs

@@ -8,6 +8,11 @@ module DockerEngineRuby
 
     DEFAULT_MAX_RETRY_DELAY: Float
 
+    ENVIRONMENTS: {
+      production: "http://localhost:2375",
+      production_tls: "https://localhost:2376"
+    }
+
     attr_reader auth: DockerEngineRuby::Resources::Auth
 
     attr_reader system_: DockerEngineRuby::Resources::System
@@ -39,6 +44,7 @@ module DockerEngineRuby
     attr_reader distribution: DockerEngineRuby::Resources::Distribution
 
     def initialize: (
+      ?environment: :production | :production_tls | nil,
       ?base_url: String?,
       ?max_retries: Integer,
       ?timeout: Float,

test/docker_engine_ruby/client_test.rb

@@ -27,6 +27,13 @@ def after_all
     super
   end
 
+  def test_raises_on_unknown_environment
+    e = assert_raises(ArgumentError) do
+      DockerEngineRuby::Client.new(environment: "wrong")
+    end
+    assert_match(/environment must be one of/, e.message)
+  end
+
   def test_client_default_request_default_retry_attempts
     stub_request(:get, "http://localhost/containers/json").to_return_json(status: 500, body: {})