pups 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d00f89445e8997c6549211ca5670b8eda9e4a9ebbb5d1900467b35c6bfb045f2
-  data.tar.gz: 7c8ec179c0b2efdbff2e46036efac28286afb41a1c04c1beb4e92451c9729bb7
+  metadata.gz: 3a3b8f3717bb917e039d84ec656835ce1c4b213d481de705244bb15fa58e8f1a
+  data.tar.gz: f104c2f76abccafc9705c08a1619dd1a0351ad91a19ddf5c29cb4f9bc283a91d
 SHA512:
-  metadata.gz: 2785911c74f74d7fc0104d143bcd0d4d64a2af4b110d18096171c85d1ab98d6c024918dc615de670d2d8d9fc634ad6081a5333fb31dc4ecaf39f71f3b03387de
-  data.tar.gz: 0dee75b5356f3341588bab687e584418df14ed262b3c67a541756d9e5725170321a2fa4c32763165078e0bf452200bf53d596cf9a314adebf377c0371999254e
+  metadata.gz: de7bd31e09e421f3a2ff172199694cc19e757a4be8fde50188cde889f8ca788c15f9733d354ad6ee0b8ef6551f804bdf470ab8175059a5b66be05d9c73cadf5f
+  data.tar.gz: 8b704e22e578e48870733a8c3925afff1dc7773cf17fe5a5c9182fa1a464fc2ca97c80a0bed174393e54ff5f2e3071d9c4abb2eee8086c07a9c96da0c44267b1

data/.github/workflows/ci.yml

@@ -16,10 +16,10 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        ruby: ["3.2"]
+        ruby: ["3.3"]
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
@@ -34,10 +34,10 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        ruby: ["3.2"]
+        ruby: ["3.3"]
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
@@ -52,7 +52,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Release Gem
         uses: discourse/publish-rubygems-action@v2

data/.rubocop.yml

@@ -1,3 +1,2 @@
 inherit_gem:
   rubocop-discourse: default.yml
-

data/CHANGELOG

@@ -1,3 +1,7 @@
+1.3.0 - 07-08-2025
+
+- Add --params option
+
 1.2.0 - 10-22-2023
 
 - Add --tags and --skip-tags options

data/README.md

@@ -25,10 +25,10 @@ Usage: pups [options] [FILE|--stdin]
         --stdin                      Read input from stdin.
         --quiet                      Don't print any logs.
         --ignore <elements>          Ignore specific configuration elements, multiple elements can be provided (comma-delimited).
-        --tags <elements>            Only run tagged commands.
-        --skip-tags <elements>       Run all but listed tagged commands.
                                      Useful if you want to skip over config in a pups execution.
                                      e.g. `--ignore env,params`.
+        --tags <elements>            Only run tagged commands.
+        --skip-tags <elements>       Run all but listed tagged commands.
         --gen-docker-run-args        Output arguments from the pups configuration for input into a docker run command. All other pups config is ignored.
     -h, --help
 ```
@@ -76,6 +76,26 @@ Running: `pups --tags="sometag,anothertag" somefile.yaml` will not run the echo
 
 Running: `pups --skip-tags="sometag,anothertag" somefile.yaml` will ONLY run the echo goodbye statement.
 
+#### Parameter overriding
+
+The `--params` argument allows pups to dynamically override params set within a configuration for the single pups run.
+
+Note, it is expected to be of the form `key=value`. If it is malformed, a warning will be thrown.
+
+Example:
+
+```
+# somefile.yaml
+
+params:
+  param1: false_prophet
+  param2: also overridden
+run:
+  - exec:
+      cmd: /bin/bash -c 'echo $param1 $param2 >> hello'
+```
+Running `pups --params="param1=true_value,param2=other_true_value" somefile.yaml` will overwrite param1 and param2 with true_value and other_true_value respectively
+
 #### Docker run argument generation
 
 The `--gen-docker-run-args` argument is used to make pups output arguments be in the format of `docker run <arguments output>`. Specifically, pups

data/lib/pups/cli.rb

@@ -24,6 +24,11 @@ module Pups
           Array,
           "Run all but listed tagged commands."
         )
+        opts.on(
+          "--params <param(s)>",
+          Array,
+          "Replace params in the config with params listed."
+        )
         opts.on("-h", "--help") do
           puts opts
           exit
@@ -69,7 +74,8 @@ module Pups
             conf,
             options[:ignore],
             tags: options[:tags],
-            skip_tags: options[:"skip-tags"]
+            skip_tags: options[:"skip-tags"],
+            extra_params: options[:params]
           )
       else
         config =
@@ -77,7 +83,8 @@ module Pups
             input_file,
             options[:ignore],
             tags: options[:tags],
-            skip_tags: options[:"skip-tags"]
+            skip_tags: options[:"skip-tags"],
+            extra_params: options[:params]
           )
       end
 

data/lib/pups/config.rb

@@ -7,8 +7,9 @@ module Pups
     def initialize(
       config,
       ignored = nil,
-      tags: tags = nil,
-      skip_tags: skip_tags = nil
+      tags: nil,
+      skip_tags: nil,
+      extra_params: nil
     )
       @config = config
 
@@ -41,6 +42,16 @@ module Pups
       )
 
       @params = @config["params"]
+      if extra_params
+        extra_params.each do |val|
+          key_val = val.split("=", 2)
+          if key_val.length == 2
+            @params[key_val[0]] = key_val[1]
+          else
+            warn "Malformed param #{val}. Expected param to be of the form `key=value`"
+          end
+        end
+      end
       ENV.each { |k, v| @params["$ENV_#{k}"] = v }
       inject_hooks
     end
@@ -48,14 +59,16 @@ module Pups
     def self.load_file(
       config_file,
       ignored = nil,
-      tags: tags = nil,
-      skip_tags: skip_tags = nil
+      tags: nil,
+      skip_tags: nil,
+      extra_params: nil
     )
       Config.new(
         YAML.load_file(config_file),
         ignored,
         tags: tags,
-        skip_tags: skip_tags
+        skip_tags: skip_tags,
+        extra_params: extra_params
       )
     rescue Exception
       warn "Failed to parse #{config_file}"
@@ -67,14 +80,16 @@ module Pups
     def self.load_config(
       config,
       ignored = nil,
-      tags: tags = nil,
-      skip_tags: skip_tags = nil
+      tags: nil,
+      skip_tags: nil,
+      extra_params: nil
     )
       Config.new(
         YAML.safe_load(config),
         ignored,
         tags: tags,
-        skip_tags: skip_tags
+        skip_tags: skip_tags,
+        extra_params: extra_params
       )
     end
 
@@ -108,10 +123,7 @@ module Pups
 
     # Filter run commands by tag: by default, keep all commands that contain tags.
     # If skip_tags argument is true, keep all commands that DO NOT contain tags.
-    def filter_tags(
-      include_tags: include_tags = nil,
-      exclude_tags: exclude_tags = nil
-    )
+    def filter_tags(include_tags: nil, exclude_tags: nil)
       if include_tags
         @config["run"] = @config["run"].select do |row|
           keep = false

data/lib/pups/exec_command.rb

@@ -87,7 +87,6 @@ module Pups
         Pups.log.info("> #{command}")
         pid = spawn(command)
         Pups.log.info(@result.readlines.join("\n")) if @result
-        pid
       end
     rescue StandardError
       raise if @raise_on_fail

data/lib/pups/file_command.rb

@@ -20,8 +20,6 @@ module Pups
       @type = :bash
     end
 
-    attr_writer :params
-
     def run
       path = interpolate_params(@path)
 

data/lib/pups/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pups
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/pups.gemspec

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 lib = File.expand_path('lib', __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+$LOAD_PATH.unshift(lib) if !$LOAD_PATH.include?(lib)
 require 'pups/version'
 
 Gem::Specification.new do |spec|

data/test/cli_test.rb

@@ -140,6 +140,7 @@ module Pups
       Cli.run(["--tags", "1,3", cf.path])
       assert_equal("1\n3", File.read(f.path).strip)
     end
+
     def test_cli_skip_tags
       # for testing output
       f = Tempfile.new("test_output")
@@ -164,5 +165,28 @@ module Pups
       Cli.run(["--skip-tags", "1,3", cf.path])
       assert_equal("2", File.read(f.path).strip)
     end
+
+    def test_cli_params
+      # for testing output
+      f = Tempfile.new("test_output")
+      f.close
+
+      # for testing input
+      cf = Tempfile.new("test_config")
+      cf.puts <<~YAML
+        params:
+          one: 0
+          two: 0
+        run:
+          - exec:
+              cmd: echo $one >> #{f.path}
+          - exec:
+              cmd: echo $two >> #{f.path}
+      YAML
+      cf.close
+
+      Cli.run(["--params", "one=1,two=2", cf.path])
+      assert_equal("1\n2", File.read(f.path).strip)
+    end
   end
 end

data/test/config_test.rb

@@ -283,5 +283,15 @@ module Pups
         config["run"][1]
       )
     end
+
+    def test_extra_params
+      config = <<~YAML
+        params:
+          one: 1
+      YAML
+      config = Config.new(YAML.safe_load(config), extra_params: %w[one=2 two=2])
+      assert_equal("2", config.params["one"])
+      assert_equal("2", config.params["two"])
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pups
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Sam Saffron
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-23 00:00:00.000000000 Z
+date: 2025-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler