eac_docker 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54c66f9c5d78f503cd8b905a9707f9f9e4ca009dbf25c302710ce7ae7491de9b
-  data.tar.gz: '02049efabac40fd5d2d6ec91e5ea0cab0e04f56c25955dbeeea0feb067fe4a37'
+  metadata.gz: b7ab9fa3bac2e0412b72d2cc72bbfba976e201b41f7579b943c619c8dc100e5f
+  data.tar.gz: ff1730b169c326274ad6c928c503141c586907279fe1b90e720228fa62d64cfc
 SHA512:
-  metadata.gz: 4027a6350739c55ab076729fd43072f57cad99d004462189929fe18971149234a2257e5ee72f25058a21d21c1bb7810d49945b1bc93999a9c2ff4d3b1dc43061
-  data.tar.gz: 4d9130fe2d1827e3aa4cd2f2f438b34b06031122138cd3793063d2f533382160845fe6d8c403e3ba4b05483ff1f671253986336049f71b0911306cac561dddf6
+  metadata.gz: 0744a0dcee991434317cb8233ba18b7eb3f657ab625fb619ecd7d1e942b64db1f7e88e37bd82548f7ec3667e3ba9bbd80b8cb4172c57acda9b21be7bcf31208e
+  data.tar.gz: 774b285e7cfc47ec13506438f935170e39fea6869fda96a36026efabeb897fdd86993af09cf4eccd33b659480e905a17387320171a729a87fa42e8b54c86b403

data/lib/eac_docker/container/exist.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    # Verify if a container identified by {#id}, if present, or {#name} already exists
+    # (running or not).
+    class Exist
+      acts_as_instance_method name_mark: :'?'
+      common_constructor :container
+      delegate :id, :name, to: :container
+
+      # @return [Boolean]
+      def result # rubocop:disable Naming/PredicateMethod
+        ::EacDocker::Executables.docker.command(
+          'ps', '--all', '--quiet', '--filter', filter
+        ).execute!.present?
+      end
+
+      # Filter used by {#result}: by {#id}, if present, or by {#name}.
+      #
+      # @return [String]
+      def filter
+        id.presence ? "id=#{id}" : "name=^/#{name}$"
+      end
+    end
+  end
+end

data/lib/eac_docker/container/identifiers.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    module Identifiers
+      common_concern do
+        immutable_accessor :name, type: :common
+      end
+
+      attr_reader :id
+
+      # Value that identifies the container to Docker commands: {#id}, if present, or {#name}.
+      #
+      # @return [String]
+      def identifier
+        id.presence || name.presence || raise('Neither `id` or `name` is present ' \
+                                              '- need at least one of them')
+      end
+
+      protected
+
+      attr_writer :id
+    end
+  end
+end

data/lib/eac_docker/container/run_command.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    class RunCommand
+      acts_as_instance_method
+      common_constructor :container, :extra_args, default: [[]]
+      delegate :capabilities, :command_args, :envs, :image, :interactive?, :name, :temporary?,
+               :tty?, :volumes, to: :container
+
+      # @return [EacRubyUtils::Envs::Command]
+      def result
+        ::EacDocker::Executables.docker.command('run', *all_args)
+      end
+
+      # @return [Array<String>]
+      def all_args
+        %w[boolean capabilities envs name volumes]
+          .inject([]) { |a, e| a + send("#{e}_args") } +
+          extra_args + [image.provide.id] + command_args
+      end
+
+      # @return [Array<String>]
+      def boolean_args
+        r = []
+        r << '--interactive' if interactive?
+        r << '--tty' if tty?
+        r << '--rm' if temporary?
+        r
+      end
+
+      # @return [Array<String>]
+      def capabilities_args
+        capabilities.flat_map { |capability| ['--cap-add', capability] }
+      end
+
+      # @return [Array<String>]
+      def envs_args
+        envs.flat_map { |name, value| ['--env', "#{name}=#{value}"] }
+      end
+
+      # @return [Array<String>]
+      def name_args
+        name.if_present([]) { |v| ['--name', v] }
+      end
+
+      # @return [Array<String>]
+      def volumes_args
+        volumes.flat_map { |volume| ['--volume', volume] }
+      end
+    end
+  end
+end

data/lib/eac_docker/container/start_command.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module EacDocker
+  class Container
+    # Start an already existing container identified by {#id}, if present, or {#name}.
+    class StartCommand
+      acts_as_instance_method
+      common_constructor :container
+      delegate :identifier, :interactive?, :tty?, to: :container
+
+      # @return [EacRubyUtils::Envs::Command]
+      def result
+        ::EacDocker::Executables.docker.command('start', *start_args)
+      end
+
+      # @return [Array<String>]
+      def start_args
+        r = []
+        r << '--attach' if interactive? || tty?
+        r << '--interactive' if interactive?
+        r << identifier
+        r
+      end
+    end
+  end
+end

data/lib/eac_docker/container.rb

@@ -6,7 +6,6 @@ module EacDocker
     immutable_accessor :interactive, :temporary, :tty, type: :boolean
     immutable_accessor :env, type: :hash
     immutable_accessor :capability, :command_arg, :volume, type: :array
-    attr_reader :id
 
     common_constructor :image
 
@@ -29,8 +28,7 @@ module EacDocker
     end
 
     def on_detached
-      command = ::EacDocker::Executables.docker.command(*(%w[run --detach] + run_command_args))
-      self.id = command.execute!.strip
+      self.id = run_command(%w[--detach]).execute!.strip
       begin
         yield(self)
       ensure
@@ -42,42 +40,17 @@ module EacDocker
       immutable_volume(right_part.if_present(left_part) { |v| "#{left_part}:#{v}" })
     end
 
-    def run_command
-      ::EacDocker::Executables.docker.command('run', *run_command_args)
-    end
-
-    def run_command_args
-      %w[boolean capabilities envs volumes]
-        .inject([]) { |a, e| a + send("run_command_#{e}_args") } +
-        [image.provide.id] + command_args
+    # Force removal of the container identified by {#id}, if present, or {#name}.
+    #
+    # @return [String] output of the "docker rm" command.
+    def remove_command
+      ::EacDocker::Executables.docker.command('rm', '--force', identifier)
     end
 
     def stop
       ::EacDocker::Executables.docker.command('stop', id).execute!
     end
 
-    private
-
-    attr_writer :id
-
-    def run_command_boolean_args
-      r = []
-      r << '--interactive' if interactive?
-      r << '--tty' if tty?
-      r << '--rm' if temporary?
-      r
-    end
-
-    def run_command_capabilities_args
-      capabilities.flat_map { |capability| ['--cap-add', capability] }
-    end
-
-    def run_command_volumes_args
-      volumes.flat_map { |volume| ['--volume', volume] }
-    end
-
-    def run_command_envs_args
-      envs.flat_map { |name, value| ['--env', "#{name}=#{value}"] }
-    end
+    require_sub __FILE__, require_mode: :kernel, include_modules: true
   end
 end

data/lib/eac_docker/images/named.rb

@@ -5,12 +5,18 @@ module EacDocker
     class Named < ::EacDocker::Images::Base
       common_constructor :source_tag
 
+      # @return [Boolean]
+      def exist?
+        ::EacDocker::Executables.docker.command('image', 'inspect', source_tag).execute
+          .fetch(:exit_code).zero?
+      end
+
       def id
         source_tag
       end
 
       def provide
-        provide_command.execute!
+        provide_command.execute! unless exist?
         self
       end
 

data/lib/eac_docker/rspec/stub_image.rb

@@ -18,13 +18,13 @@ module EacDocker
         internal_container
       end
 
-      def on_container(&block)
+      def on_container(&)
         raise 'A container was already created' if internal_container.present?
 
         build_container.on_detached do |container|
           self.internal_container = container
           begin
-            run_callbacks(:on_container, &block)
+            run_callbacks(:on_container, &)
           ensure
             self.internal_container = nil
           end

data/lib/eac_docker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EacDocker
-  VERSION = '0.8.1'
+  VERSION = '0.9.0'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: eac_docker
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Put here the authors
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: eac_ruby_base1
@@ -50,22 +49,24 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
-description:
-email:
+        version: '0.15'
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/eac_docker.rb
 - lib/eac_docker/container.rb
+- lib/eac_docker/container/exist.rb
+- lib/eac_docker/container/identifiers.rb
+- lib/eac_docker/container/run_command.rb
+- lib/eac_docker/container/start_command.rb
 - lib/eac_docker/debug.rb
 - lib/eac_docker/executables.rb
 - lib/eac_docker/images/base.rb
@@ -76,10 +77,8 @@ files:
 - lib/eac_docker/rspec/setup.rb
 - lib/eac_docker/rspec/stub_image.rb
 - lib/eac_docker/version.rb
-homepage:
 licenses: []
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -94,8 +93,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Put here de description.
 test_files: []