all_images 0.11.2 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 867a957c23f40a51b4635d1dcf7c64b4f9048225817a2232d95592c8256fc64b
-  data.tar.gz: e06511c7ff41ad563b4af373b4e7e92c0c33e79a4e55c520fa45649505288f06
+  metadata.gz: 4dcdc93b7a13b4553302d63dd2ff1cdd34c5e795d4b45119df2d54454b8c2dac
+  data.tar.gz: 0f6743c6e1f723596ea7749e76811815511175852f215dc9b9e74fbe20968df5
 SHA512:
-  metadata.gz: 4a075147ba9985c917d8d3f39b8243121940c279664b882d149c29cbafbb6c5eb1605392cace3645287efd46077d643f9f59aac5b272a8e25f0ec738b4e5a83e
-  data.tar.gz: 1f9c2f731c5be7be717434ae98f79e87c09f5df34845a0e6c42e95e3c19eba8fc488c1e18e04f35cf5c80d989d48c5c56e648cc9c764ab3d3e2a19eab6764d8e
+  metadata.gz: 7eba1f686ff9afdad5f01dae94ae17648b610a29155552aef157b90f82ce36b161550b457c3cbb10044f31007abce36b1b8eb25756f932b1976cb2bc815dbecc
+  data.tar.gz: 31496325b74e67a0bbd0c414375aade96b6e0ba798d0c88910ba2c6e239d48106e4cf10320ab467d83f75a4e91e89faaa7fa13eaa4a815f28d6a494c05f1e1e1

data/CHANGES.md

@@ -1,5 +1,18 @@
 # Changes
 
+## 2026-01-17 v0.12.0
+
+- Added new **before** and **after** configuration hooks in `.all_images.yml`
+  for pre/post execution functionality
+- Introduced `RESULT` environment variable to enable post-execution decision
+  making in hooks
+- Enhanced `sh` method with `crash: false` option to allow non-fatal hook execution
+- Updated `run_image` method to execute hooks and track test results
+- Updated README documentation for the new hook functionality
+- Updated `rubygems_version` from **4.0.2** to **4.0.3**
+- Updated `gem_hadar` development dependency from **>= 2.16.3** to **>=
+  2.17.0**
+
 ## 2026-01-02 v0.11.2
 
 - Updated rake execution to use `bundle exec` for consistent dependency

data/README.md

@@ -215,6 +215,32 @@ all_images run
 # Shows searchable list of available images
 ```
 
+### Pre/Post Execution Hooks 🔄
+
+AllImages supports pre/post execution hooks in your configuration:
+
+```yaml
+before: |-
+  echo 🏁 Preparing…
+  echo Deleting Gemfile.lock
+  rm -f Gemfile.lock
+
+after: |-
+  if [[ "$RESULT" = "1" ]]
+  then
+    echo 😵 Some tests failed!
+  else
+    echo 🥳 All tests passed!
+  fi
+
+# ... rest of your configuration
+```
+
+- `before` hook runs before each image execution
+- `after` hook runs after each image execution with `RESULT` environment variable
+- `RESULT` indicates success (0) or failure (1) of the test script
+- Hooks are non-fatal (won't stop the workflow if they fail)
+
 ## Error Handling ⚠️
 
 AllImages provides comprehensive error handling for common scenarios:

data/all_images.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: all_images 0.11.2 ruby lib
+# stub: all_images 0.12.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "all_images".freeze
-  s.version = "0.11.2".freeze
+  s.version = "0.12.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -17,13 +17,13 @@ Gem::Specification.new do |s|
   s.homepage = "https://github.com/flori/all_images".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "AllImages -- Runs a script in all of the docker images".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "4.0.2".freeze
+  s.rubygems_version = "4.0.3".freeze
   s.summary = "Runs a script in all of the docker images".freeze
   s.test_files = ["spec/app_spec.rb".freeze, "spec/spec_helper.rb".freeze]
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.16.3".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, [">= 2.17.0".freeze])
   s.add_development_dependency(%q<rake>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<rspec>.freeze, [">= 0".freeze])

data/lib/all_images/app.rb

@@ -116,27 +116,15 @@ class AllImages::App
     }
   end
 
-  # Executes a system command and handles its result
-  #
-  # This method runs a given system command with the provided arguments,
-  # optionally logging the execution when debug mode is enabled. It checks the
-  # command's exit status and raises an exception if the command fails,
-  # otherwise returning true to indicate success.
-  #
-  # @param a [ Array<String> ] the command and its arguments to be executed
-  #
-  # @return [ TrueClass ] when the command executes successfully
-  #
-  # @raise [ RuntimeError ] if the executed command exits with a non-zero status
-  def sh(*a)
+  def sh(script, crash: true)
     if $DEBUG
       STDERR.puts "Executing #{a.inspect}."
     end
-    system(*a)
+    system(script)
     if $?.success?
       true
-    else
-      raise "Command #{Shellwords.join(a).inspect} failed with: #{$?.exitstatus}"
+    elsif crash
+      raise "Command #{script.inspect} failed with: #{$?.exitstatus}"
     end
   end
 
@@ -165,25 +153,33 @@ class AllImages::App
   #
   # @return [ Integer ] exit code indicating success (0) or failure (1) of the script execution
   def run_image(image, script, interactive: false)
+    if before = @config['before']
+      sh before
+    end
     dockerfile = @config.fetch('dockerfile').to_s
     tag        = provide_image image, dockerfile, script
     envs       = env.full? { |e| +' ' << e.map { |n, v| '-e %s=%s' % [ n, v.inspect ] } * ' ' }
+    result     = 1
     if interactive
       puts "You can run /script interactively now."
-      sh "docker run --name #{name} -it#{envs} -v `pwd`:/work '#{tag}' sh"
-      return 0
+      sh "docker run --name #{name} -it#{envs} -v `pwd`:/work '#{tag}' sh", crash: true
+      result = nil
     else
       info_puts "Running container #{name.inspect} for image tagged #{tag.inspect}."
-      if sh "docker run --name #{name} -it#{envs} -v `pwd`:/work '#{tag}' sh -c /script"
+      if sh "docker run --name #{name} -it#{envs} -v `pwd`:/work '#{tag}' sh -c /script", crash: false
         info_puts "Image tagged #{tag.inspect} was run with result:"
         puts green('SUCCESS')
-        return 0
+        result = 0
       else
         info_puts "Image tagged #{tag.inspect} was run with result:"
         puts red('FAILURE')
-        return 1
       end
     end
+    if result and after = @config['after']
+      ENV['RESULT'] = result.to_s
+      sh after, crash: false
+    end
+    result.to_i
   ensure
     sh "docker rm -f #{name} >/dev/null"
   end

data/lib/all_images/version.rb

@@ -1,6 +1,6 @@
 module AllImages
   # AllImages version
-  VERSION         = '0.11.2'
+  VERSION         = '0.12.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/spec/app_spec.rb

@@ -4,4 +4,8 @@ RSpec.describe AllImages::App do
   it 'can be instantiated' do
     expect(described_class.new([])).to be_a described_class
   end
+
+  xit 'can fail' do
+    expect(true).to eq false
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: all_images
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.12.0
 platform: ruby
 authors:
 - Florian Frank
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.16.3
+        version: 2.17.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.16.3
+        version: 2.17.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -211,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Runs a script in all of the docker images
 test_files: