donce 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3870e1c444a1259a5cb5d3a2b32e73d66dba22e8bf1a519ba377d6a520d1637c
-  data.tar.gz: d19607fe2d7090bfa106b5858e051442b5b7d48839b479ef2df49c8c38f90d2f
+  metadata.gz: ad7d3419ce887d6b42f6f92f6dc9ad8414b0c3c89c1fb0ef4600972ac54f754e
+  data.tar.gz: a8d95d419418e037968ae4f659a5b538a8c67c44fee323974befefa7d5651b5c
 SHA512:
-  metadata.gz: 85863c16fd11008e5fd302724ddd23314cd7519e10803292a39a58312a8371e8345509dac4878cab32afd5198bd65079e03f2f496b701635d84af619fe7bfc45
-  data.tar.gz: 618eb11dd8880fbcdd08863fcfa332d7567bb1d405e6cf3e268398d6f3cb5123169867ecefe4a308e4b40d609bb03285593c4a98acea98437bb2f68d3b656ffd
+  metadata.gz: 22738b8cdd2b2eef8188c1e69dfea55a7d3b7317f73623fd2230cd65695dd033994f58a62fca0e549a5e846245c61b1ec0d870760d79becda4e4a769f62ba9dc
+  data.tar.gz: 86ee931f8f8149192661d2541b19abbd58377dd8d6aa7fc5770fbe1fdc66819aeb8ff409224938b74acedf5a94b5d961c40439f4263d83cdf3eb1e84b9e24169

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.3'
   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
@@ -85,15 +91,16 @@ module Kernel
       else
         i = "donce-#{SecureRandom.hex(8)}"
         if dockerfile
-          Dir.mktmpdir do |home|
-            File.write(File.join(home, 'Dockerfile'), dockerfile)
-            qbash("#{docker} build #{Shellwords.escape(home)} -t #{i}", log:)
+          Dir.mktmpdir do |tmp|
+            File.write(File.join(tmp, 'Dockerfile'), dockerfile)
+            qbash("#{docker} build #{Shellwords.escape(tmp)} -t #{i}", log:)
           end
+        else
+          qbash("#{docker} build #{Shellwords.escape(home)} -t #{i}", log:)
         end
         i
       end
     container = "donce-#{SecureRandom.hex(8)}"
-    host = OS.linux? ? '172.17.0.1' : 'host.docker.internal'
     begin
       stdout = nil
       code = 0
@@ -102,7 +109,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 +133,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

@@ -34,12 +34,24 @@ class TestDonce < Minitest::Test
     assert_equal("hello\n", stdout)
   end
 
+  def test_runs_existing_image
+    stdout = donce(image: 'ubuntu:24.04', command: 'echo hello', log: Loog::NULL)
+    assert_equal("hello\n", stdout)
+  end
+
+  def test_runs_from_home
+    Dir.mktmpdir do |home|
+      File.write(File.join(home, 'Dockerfile'), "FROM ubuntu\nCMD echo hello")
+      stdout = donce(home:, log: Loog::NULL)
+      assert_equal("hello\n", stdout)
+    end
+  end
+
   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.3
 platform: ruby
 authors:
 - Yegor Bugayenko