donce 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad7d3419ce887d6b42f6f92f6dc9ad8414b0c3c89c1fb0ef4600972ac54f754e
-  data.tar.gz: a8d95d419418e037968ae4f659a5b538a8c67c44fee323974befefa7d5651b5c
+  metadata.gz: 87e27e95378a5ad34a9ba6a7ef7c8578efb3d24990998beada04097c1a46d5c1
+  data.tar.gz: 0ea31ae8977024be7abdbc164a3250a8eb907511ea24b5427b2eb3f8960b2912
 SHA512:
-  metadata.gz: 22738b8cdd2b2eef8188c1e69dfea55a7d3b7317f73623fd2230cd65695dd033994f58a62fca0e549a5e846245c61b1ec0d870760d79becda4e4a769f62ba9dc
-  data.tar.gz: 86ee931f8f8149192661d2541b19abbd58377dd8d6aa7fc5770fbe1fdc66819aeb8ff409224938b74acedf5a94b5d961c40439f4263d83cdf3eb1e84b9e24169
+  metadata.gz: df41062bb8aea186f7bafc2df0070d7abbf1238d2eea5270f49a62e1901a495b0d50afca4659b5314ea0ea0117a299241b8757369a07b5e384cd8595abf956f2
+  data.tar.gz: 2d6de2cde5d5df5dc3048bb7e9d68cc8b866ec76842f9ce7f9441a4b3b1f683a58e65428c558244c02ab2bcf1a6760606f1e63cea7a7c1a77f08778a18c59fd4

data/README.md

@@ -12,7 +12,7 @@
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/yegor256/donce/blob/master/LICENSE.txt)
 
 This small Ruby library helps building temporary [Docker]
-images, run Docker containers, and clean up afterwards --- may be
+images, runs Docker containers, and cleans up afterwards — it may be
 convenient for automated tests (for example, with [Minitest]):
 
 ```ruby
@@ -29,6 +29,15 @@ class MyTest < Minitest::Test
 end
 ```
 
+It's possible to run Docker image in a background mode too:
+
+```ruby
+stdout = donce(image: 'ubuntu', command: 'sleep 9999') do |id|
+  # The "id" is the container id
+  # The "donce_host()" is the hostname of it
+end
+```
+
 That's it.
 
 ## How to contribute

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.3'
+  s.version = '0.0.4'
   s.license = 'MIT'
   s.summary = 'Builds and starts temporary Docker containers'
   s.description =

data/lib/donce.rb

@@ -89,7 +89,7 @@ module Kernel
       if image
         image
       else
-        i = "donce-#{SecureRandom.hex(8)}"
+        i = "donce-#{SecureRandom.hex(6)}"
         if dockerfile
           Dir.mktmpdir do |tmp|
             File.write(File.join(tmp, 'Dockerfile'), dockerfile)
@@ -100,7 +100,7 @@ module Kernel
         end
         i
       end
-    container = "donce-#{SecureRandom.hex(8)}"
+    container = "donce-#{SecureRandom.hex(6)}"
     begin
       stdout = nil
       code = 0
@@ -132,16 +132,14 @@ module Kernel
             "Failed to run #{cmd} " \
             "(exit code is ##{code}, stdout has #{stdout.split("\n").count} lines)"
         end
-        if block_given?
-          r = yield container
-          return r
-        end
+        yield container if block_given?
       ensure
-        qbash(
+        logs = qbash(
           "#{docker} logs #{Shellwords.escape(container)}",
           level: code.zero? ? Logger::DEBUG : Logger::ERROR,
           log:
         )
+        stdout = logs if block_given?
         qbash("#{docker} rm -f #{Shellwords.escape(container)}", log:)
       end
       stdout

data/test/test_donce.rb

@@ -55,4 +55,9 @@ class TestDonce < Minitest::Test
     end
     assert(seen)
   end
+
+  def test_returns_stdout_from_daemon
+    stdout = donce(dockerfile: "FROM ubuntu\nCMD echo hello", log: Loog::NULL) { |_| sleep 0.1 }
+    assert_equal("hello\n", stdout)
+  end
 end

metadata

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