donce 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3870e1c444a1259a5cb5d3a2b32e73d66dba22e8bf1a519ba377d6a520d1637c
-  data.tar.gz: d19607fe2d7090bfa106b5858e051442b5b7d48839b479ef2df49c8c38f90d2f
+  metadata.gz: 458248c2903f4159ae8e840d9f79173fa5cfccaea2ef74de4ec8896fa2204be6
+  data.tar.gz: 54e651309713b136eac4f40c77db3840aadb95e626cfe861ccfc0d76e50e06b8
 SHA512:
-  metadata.gz: 85863c16fd11008e5fd302724ddd23314cd7519e10803292a39a58312a8371e8345509dac4878cab32afd5198bd65079e03f2f496b701635d84af619fe7bfc45
-  data.tar.gz: 618eb11dd8880fbcdd08863fcfa332d7567bb1d405e6cf3e268398d6f3cb5123169867ecefe4a308e4b40d609bb03285593c4a98acea98437bb2f68d3b656ffd
+  metadata.gz: 407378f5c2d8285092e468c7472fdc778558a5b4525c37eba2226a49b2e10debbe4943338030fb351ac28f3b285b7adf480f26335d9ffd5b18458204d3053f01
+  data.tar.gz: 84a740834b4e6c4277c9680ea85c0c124c1fdbefc6c5af33146ba6a70360be0781be1dfbe466aa69414cd3af99e0c3b31abb0172ef531524871f2e160db60d4d

data/donce.gemspec

@@ -26,7 +26,7 @@ Gem::Specification.new do |s|
   s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
   s.required_ruby_version = '>=3.0'
   s.name = 'donce'
-  s.version = '0.0.1'
+  s.version = '0.0.2'
   s.license = 'MIT'
   s.summary = 'Builds and starts temporary Docker containers'
   s.description =

data/lib/donce.rb

@@ -48,9 +48,8 @@ require 'shellwords'
 # background execution of the container (in daemon mode):
 #
 #  def test_runs_daemon
-#    donce(dockerfile: "FROM ubuntu\nCMD sleep 9999") do |id, host|
+#    donce(dockerfile: "FROM ubuntu\nCMD sleep 9999") do |id|
 #      refute_empty(id)  # the ID of the container
-#      refute_empty(host)  # the hostname of it
 #    end
 #  end
 #
@@ -61,6 +60,12 @@ require 'shellwords'
 # Copyright:: Copyright (c) 2025 Yegor Bugayenko
 # License:: MIT
 module Kernel
+  # The name of the localhost inside Docker container.
+  # @return [String] The hostname
+  def donce_host
+    OS.linux? ? '172.17.0.1' : 'host.docker.internal'
+  end
+
   # Build Docker image (or use existing one), run Docker container, and then clean up.
   #
   # @param [String] dockerfile The content of the +Dockerfile+
@@ -72,6 +77,7 @@ module Kernel
   # @param [Boolean] root Let user inside the container be "root"?
   # @param [String|Array<String>] command The command for the script inside the container
   # @param [Integer] timeout Maximum seconds to spend on each +docker+ call
+  # @return [String] The stdout of the container
   def donce(dockerfile: nil, image: nil, home: nil, log: $stdout, args: '', env: {}, root: false, command: '',
             timeout: 10)
     raise 'Either use "dockerfile" or "home"' if dockerfile && home
@@ -93,7 +99,6 @@ module Kernel
         i
       end
     container = "donce-#{SecureRandom.hex(8)}"
-    host = OS.linux? ? '172.17.0.1' : 'host.docker.internal'
     begin
       stdout = nil
       code = 0
@@ -102,7 +107,7 @@ module Kernel
           docker, 'run',
           block_given? ? '-d' : '',
           '--name', Shellwords.escape(container),
-          OS.linux? ? '' : "--add-host #{host}:host-gateway",
+          OS.linux? ? '' : "--add-host #{donce_host}:host-gateway",
           args,
           env.map { |k, v| "-e #{Shellwords.escape("#{k}=#{v}")}" }.join(' '),
           root ? '' : "--user=#{Shellwords.escape("#{Process.uid}:#{Process.gid}")}",
@@ -126,7 +131,7 @@ module Kernel
             "(exit code is ##{code}, stdout has #{stdout.split("\n").count} lines)"
         end
         if block_given?
-          r = yield container, host
+          r = yield container
           return r
         end
       ensure

data/test/test_donce.rb

@@ -36,10 +36,9 @@ class TestDonce < Minitest::Test
 
   def test_runs_daemon
     seen = false
-    donce(dockerfile: "FROM ubuntu\nCMD while true; do sleep 1; echo sleeping; done", log: Loog::NULL) do |id, host|
+    donce(dockerfile: "FROM ubuntu\nCMD while true; do sleep 1; echo sleeping; done", log: Loog::NULL) do |id|
       seen = true
       refute_empty(id)
-      refute_empty(host)
     end
     assert(seen)
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: donce
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Yegor Bugayenko