donce 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 441d95b36d07ea59d9d3bb2adac79fda0391c241ecb7d6c100aea5f62552dcba
-  data.tar.gz: 7cc6a4122c5eebe172e65b8d71cd262f11ac2325786567a87ee5cbf50e9a38c5
+  metadata.gz: '03161908e407496425db2581fce2d802d834fce0e06cc97daf13de1c2edecc21'
+  data.tar.gz: 7339a08b6820ec2aa9e0bda4067e3fd8947b387509ea96f9ac4e9971399ac24e
 SHA512:
-  metadata.gz: 80e61fec77d8d68d588bd5600150648eb77a5e35513137badcd0dcb6b45c0f2f7968ddc13b345407ebe6c32d9bc557769ac5dce61ea165661a24bd366d9c44d9
-  data.tar.gz: 4dd1618e4247936efc4dc6d15ae3397c655aedafa74555a7353df6a241a2ae0fc4292e676dc7889161c7ee6a4fc07cfc33921f1905ea3e3cd6b740f17b2df3a8
+  metadata.gz: 81203a7306ab4edd80ac3ce16a27bcacb8505bb73bd99c3d0ad629193cdd98222b7e954382d671a76e9a3f8f2a461914f5a18c2f7845955dc31242b3b8796c09
+  data.tar.gz: f4978002f8c14db6783e5480f0f50e064e6c6883c6c1de61d4728022fa522bdc98be1cba1449ad88ec2db8eb08c2a2f65f18691eef9a673f71ffbaf8157e322f

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 source 'https://rubygems.org'

data/Gemfile.lock

@@ -15,15 +15,17 @@ GEM
     builder (3.3.0)
     date (3.5.1)
     docile (1.4.1)
-    elapsed (0.2.1)
+    elapsed (0.2.2)
       loog (~> 0.6)
       tago (~> 0.1)
+    ellipsized (0.3.0)
     erb (6.0.1)
     json (2.18.0)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    loog (0.6.1)
+    loog (0.7.2)
+      ellipsized
       logger (~> 1.0)
     minitest (6.0.1)
       prism (~> 1.5)
@@ -32,18 +34,18 @@ GEM
       builder
       minitest (>= 5.0)
       ruby-progressbar
-    minitest-retry (0.3.0)
+    minitest-retry (0.3.1)
       minitest (>= 5.0)
     os (1.1.4)
     parallel (1.27.0)
-    parser (3.3.10.0)
+    parser (3.3.10.1)
       ast (~> 2.4.1)
       racc
-    prism (1.7.0)
+    prism (1.8.0)
     psych (5.3.1)
       date
       stringio
-    qbash (0.4.8)
+    qbash (0.7.1)
       backtrace (> 0)
       elapsed (> 0)
       loog (> 0)
@@ -51,7 +53,7 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.1)
-    rdoc (7.0.3)
+    rdoc (7.1.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -93,7 +95,7 @@ GEM
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
     stringio (3.2.0)
-    tago (0.6.0)
+    tago (0.7.0)
     tsort (0.2.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)

data/LICENSE.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2024-2025 Yegor Bugayenko
+Copyright (c) 2024-2026 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/LICENSES/MIT.txt

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2024-2025 Yegor Bugayenko
+Copyright (c) 2024-2026 Yegor Bugayenko
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the 'Software'), to deal

data/README.md

@@ -38,8 +38,24 @@ stdout = donce(image: 'ubuntu', command: 'sleep 9999') do |id|
 end
 ```
 
-If you set `DONCE_SUDO` environment variable to `true`, `docker` will
-be executed via `sudo`.
+If you set `DONCE_SUDO` environment variable to `true`,
+  `docker` will be executed via `sudo`.
+
+Host group/user IDs are passed to the build, as `GID` and `UID` args.
+You can use them, when you copy resources into the image, for example:
+
+```
+FROM ubuntu
+ARG UID
+ARG GID
+RUN groupadd -g ${GID} foo || true
+RUN useradd -m -u ${UID} -g ${GID} foo
+USER foo',
+WORKDIR /foo
+COPY --chown=${UID}:${GID} bar.txt .
+```
+
+The `bar.txt` file is not ready to be modified inside the container.
 
 ## Parameters
 

data/REUSE.toml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 version = 1
@@ -31,5 +31,5 @@ path = [
     "renovate.json",
 ]
 precedence = "override"
-SPDX-FileCopyrightText = "Copyright (c) 2024-2025 Yegor Bugayenko"
+SPDX-FileCopyrightText = "Copyright (c) 2024-2026 Yegor Bugayenko"
 SPDX-License-Identifier = "MIT"

data/Rakefile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'rubygems'

data/donce.gemspec

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'English'
@@ -9,7 +9,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.3.0'
+  s.version = '0.5.0'
   s.license = 'MIT'
   s.summary = 'Builds and starts temporary Docker containers'
   s.description =

data/lib/donce.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# SPDX-FileCopyrightText: Copyright (c) 2024-2025 Yegor Bugayenko
+# SPDX-FileCopyrightText: Copyright (c) 2024-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
 require 'logger'
@@ -42,7 +42,7 @@ require 'tmpdir'
 # variable to any value.
 #
 # Author:: Yegor Bugayenko (yegor256@gmail.com)
-# Copyright:: Copyright (c) 2024-2025 Yegor Bugayenko
+# Copyright:: Copyright (c) 2024-2026 Yegor Bugayenko
 # License:: MIT
 module Kernel
   # The name of the localhost inside Docker container.
@@ -81,7 +81,8 @@ module Kernel
     raise 'The "volumes" must be a Hash' unless volumes.is_a?(Hash)
     raise 'The "log" is nil' if log.nil?
     raise 'The "args" is nil' if args.nil?
-    raise 'The "args" must be a String' unless args.is_a?(String)
+    raise 'The "args" must be a String or Array' unless args.is_a?(String) || args.is_a?(Array)
+    args = args.join(' ') if args.is_a?(Array)
     raise 'The "env" is nil' if env.nil?
     raise 'The "env" must be a Hash' unless env.is_a?(Hash)
     raise 'The "command" is nil' if command.nil?
@@ -102,16 +103,18 @@ module Kernel
         i = "donce-#{SecureRandom.hex(6)}"
         a = [
           "--tag #{i}",
-          build_args.map { |k, v| "--build-arg #{Shellwords.escape("#{k}=#{v}")}" }.join(' ')
+          build_args.merge({ GID: Process.gid, UID: Process.uid }).map do |k, v|
+            "--build-arg #{Shellwords.escape("#{k}=#{v}")}"
+          end.join(' ')
         ].compact.join(' ')
         if dockerfile
           Dir.mktmpdir do |tmp|
             dockerfile = dockerfile.join("\n") if dockerfile.is_a?(Array)
             File.write(File.join(tmp, 'Dockerfile'), dockerfile)
-            qbash("#{docker} build #{a} #{Shellwords.escape(tmp)}", log:)
+            qbash("#{docker} build #{a} #{Shellwords.escape(tmp)}", stdout: log)
           end
         elsif home
-          qbash("#{docker} build #{a} #{Shellwords.escape(home)}", log:)
+          qbash("#{docker} build #{a} #{Shellwords.escape(home)}", stdout: log)
         else
           raise 'Either "dockerfile" or "home" must be provided'
         end
@@ -139,7 +142,7 @@ module Kernel
           Timeout.timeout(timeout) do
             qbash(
               cmd,
-              log:,
+              stdout: log,
               accept: nil,
               both: true,
               env:
@@ -156,15 +159,15 @@ module Kernel
         logs = qbash(
           "#{docker} logs #{Shellwords.escape(container)}",
           level: code.zero? ? Logger::DEBUG : Logger::ERROR,
-          log:
+          stdout: log
         )
         stdout = logs if block_given?
-        qbash("#{docker} rm --force #{Shellwords.escape(container)}", log:)
+        qbash("#{docker} rm --force #{Shellwords.escape(container)}", stdout: log)
       end
       stdout
     ensure
       Timeout.timeout(10) do
-        qbash("#{docker} rmi #{img}", log:) unless image
+        qbash("#{docker} rmi #{img}", stdout: log) unless image
       end
     end
   end

metadata

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