rhelm 0.1.0.pre.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 32884b06d9fdc1fc9d86397f132ad9581ce7053165b33c275fe230dec6fc2d53
+  data.tar.gz: a030dd7932b5c252791db8b851de0f138118a21ca6af0426f728187c7c087ba4
+SHA512:
+  metadata.gz: c59de0c7c7440bdff5511991fc091d15c0c2d3adcef87ac5006360ea07286ff9b408b1df303fa502b23dd40aa461c424cc76fa01d44cc0224455c6ddd26b4cc5
+  data.tar.gz: d7bdb9b76792f1019ad13947d937537fc08ecf9e3509268cba39616dd7a2b27eb7242b166bf71882335629c0a998d776d4a3ecb3a6c9b391f580e35483a49978

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+.byebug_history

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in helm.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "minitest", "~> 5.0"
+gem "pry-byebug"

data/LICENSE.txt

@@ -0,0 +1,7 @@
+Copyright 2021 Internet Brands
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,133 @@
+# rhelm
+
+Ruby wrapper around the [helm](helm.sh) binary. Pronounced "realm", because English is weird like that.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rhelm'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install rhelm
+
+## Usage
+
+Usage of Rhelm is simple:
+
+1. Configure a Rhelm::Client object with appropriate kubeconfig or API/token information so that you can talk to your k8s cluster
+2. Using the client object, invoke subcommands such as "install", "upgrade", "status", etc.
+
+### Creating the client
+
+```ruby
+
+require 'rhelm/client'
+
+# Using kubeconfig
+cli = Rhelm::Client.new(kubeconfig: '/home/someone/.kube/config')
+
+# Using explicit API and token details
+cli = Rhelm::Client.new(kube_apiserver: 'http://localhost:8080/api', kube_token: 'verysecret')
+```
+
+#### Logging
+You can also pass a `logger:` kwarg. It should be an object that responds to `error`, `warn`, `info`, and `debug`. If you don't specify `logger:` then a default will be provided that logs to STDOUT at log level `info` and above. See [Rhelm::Client::SimpleLogger](lib/rhelm/client/simple_logger.rb)
+
+
+### Invoking a subcommand
+
+Subcommands such as `helm install`, `helm pull`, etc. can be invoked in one of two ways:
+
+* Via subcommand proxy:
+
+```ruby
+
+cli = Rhelm::Client.new(kubeconfig: '/home/someone/.kube/config')
+# .install creates a proxy to the ::Install subcommand; .run runs it
+cli.install(
+  'my-mysql-release',
+  'bitnami/mysql',
+  values: 'my-values.yml'
+).run
+```
+
+* Via direct subcommand object creation:
+
+```ruby
+subcommand = Rhelm::Subcommand::Install.new(
+  'my-mysql-release',
+  'bitnami/mysql',
+  kubeconfig: '/home/someone/.kube/config',
+  values: 'my-values.yml'
+)
+subcommand.run
+```
+
+The difference between creating subcommands via proxy and creating subcommand objects directly is that in the proxy case, client constructor kwargs (especially those related to authentication) will automatically propagate to all subcommands created by proxy.
+
+Non-kwarg arguments (such as `my-mysql-release` and `bitnami/mysql` in the example above) are passed as arguments to the underlying command without modification.
+
+For a complete list of subcommands, look at the subclasses of [Rhelm::Subcommand](lib/rhelm/subcommand).
+
+### Responding to helm exit status and output
+
+When `.run` is called, the command is invoked and its exit status and stdout/stderr are captured. These are submitted to a callback for handling. You can provide a callback (as a block) to the `.run` call like this:
+
+```ruby
+Rhelm::Client.new(kubeconfig: 'kube.cfg')
+             .install('my-release-name',
+                      'some-chart-dir').run do |lines, status|
+  if status == 0
+    logger.info("helm install worked great!")
+  elsif /timeout/im.match(lines)
+    raise MyTimeoutError, "helm install timed out, oh no!"
+  else
+    # Use the built-in error reporting code to get more details
+    report_failure(lines, status)
+  end
+end
+```
+
+This callback technique allows us to evaluate certain "error" conditions for semantic meaning and return more meaningful results instead of raising an error. See [Rhelm::Subcommand::Status#exists?](lib/rhelm/subcommand/status.rb) for example.
+
+For some commands like `install` and `upgrade` that are not instant, you may want to wait until the entire command is completed before evaluating status. To do this, specify `helm` options to wait for completion using the `wait: true` and `timeout: timeref` kwargs for your subcommand. Otherwise you'll just get the exit status of the `helm` command that was submitted to the server and you'll need to poll (with the `::Status` subcommand) to find out whether the helm command actually succeeded.
+
+### Specifying the helm binary to be used
+
+```ruby
+cli = Rhelm::Client.new(program: '/path/to/a/specific/helm/binary')
+```
+
+By default `helm` (with no path specification) will be used.
+
+### Version Info
+
+You can ask a client about the version of the `helm` binary it is using.
+
+```ruby
+2.7.1 :001 > cli = Rhelm::Client.new
+2.7.1 :002 > cli.helm_version
+ => "v3.4.2"
+2.7.1 :003 > cli.helm_commit
+ => "23dd3af5e19a02d4f4baa5b2f242645a1a3af629"
+2.7.1 :004 > cli.helm_go_version
+ => "go1.15.5"
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/internetbrands/rhelm.

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rhelm"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/rhelm.rb

@@ -0,0 +1,2 @@
+require_relative "rhelm/version"
+require_relative "rhelm/client"

data/lib/rhelm/client.rb

@@ -0,0 +1,57 @@
+require 'rhelm/client/simple_logger'
+require 'rhelm/subcommand_proxy'
+
+module Rhelm
+  class Client
+    class Error < StandardError; end
+
+    SUBCOMMANDS = %i(
+      dependency env history install pull rollback
+      status test uninstall upgrade verify version
+    )
+    SUBCOMMANDS.each { |s| require_relative "subcommand/#{s}" }
+
+    attr_reader :program, :logger
+
+    def initialize(program: "helm", logger: nil, **default_options)
+      @program = program
+      @logger ||= SimpleLogger.new
+      @default_options = default_options || {}
+    end
+
+    SUBCOMMANDS.each do |subcommand|
+      define_method subcommand do |*args, **kwargs, &block|
+        SubcommandProxy.new(subcommand, self, *args, **@default_options.merge(kwargs), &block)
+      end
+    end
+
+    def run_command(subcommand_name, *ordinal_options, **flag_options, &block)
+      SubcommandProxy.new(subcommand_name, self, *ordinal_options, **@default_options.merge(flag_options), &block).run
+    end
+
+    def helm_version
+      version_info[:Version]
+    end
+
+    def helm_commit
+      version_info[:GitCommit]
+    end
+
+    def helm_go_version
+      version_info[:GoVersion]
+    end
+
+    private
+
+    # version.BuildInfo{Version:"v3.4.2", GitCommit:"23dd3af5e19a02d4f4baa5b2f242645a1a3af629", GitTreeState:"dirty", GoVersion:"go1.15.5"}
+    HELM_VERSION_RE = /version\.BuildInfo\{Version:"([^"]+)", GitCommit:"([^"]+)", GitTreeState:"([^"]+)", GoVersion:"([^"]+)"\}/m.freeze
+    def version_info
+      @version_info ||= 
+        version.run do |lines, status|
+          if m = HELM_VERSION_RE.match(lines)
+            { Version: m[1], GitCommit: m[2], GoVersion: m[4] }
+          end
+        end
+    end
+  end
+end

data/lib/rhelm/client/simple_logger.rb

@@ -0,0 +1,19 @@
+module Rhelm
+  class Client
+    class SimpleLogger
+      class Error < StandardError; end
+      LEVELS = { debug: 3, info: 2, warn: 1, error: 0 }
+      attr_accessor :level
+      def initialize(level = :info)
+        raise(Error, "unknown log level #{level}") unless LEVELS.key?(level)
+        @level = LEVELS[level]
+      end
+      LEVELS.keys.each do |l|
+        define_method l do |*args|
+          return unless level >= LEVELS[l]
+          puts "[#{l.to_s.upcase}] #{args.compact.map(&:to_s).join(' ')}"
+        end
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/base.rb

@@ -0,0 +1,82 @@
+module Rhelm
+  module Subcommand
+    class Error < StandardError; end
+
+    ## Abstract base class for Helm subcommands.
+    class Base
+      class OptionError < StandardError; end
+
+      attr_reader :client,
+                  :debug,
+                  :kube_apiserver,
+                  :kube_as_group,
+                  :kube_as_user,
+                  :kube_context,
+                  :kube_token,
+                  :kubeconfig,
+                  :namespace,
+                  :registry_config,
+                  :repository_cache,
+                  :repository_config
+
+      def initialize(options = {})
+        @client = options.delete(:client) || Client.new
+        @debug = options[:debug]
+        @kube_apiserver = options[:kube_apiserver]
+        @kube_as_group = options[:kube_as_group]
+        @kube_as_user = options[:kube_as_user]
+        @kube_context = options[:kube_context]
+        @kube_token = options[:kube_token]
+        @kubeconfig = options[:kubeconfig]
+        @namespace = options[:namespace]
+        @registry_config = options[:registry_config]
+        @repository_cache = options[:repository_cache]
+        @repository_config = options[:repository_config]
+      end
+
+      def run(client: nil, raise_on_error: true, &block)
+        b = block_given? ? block : Proc.new { |_lines, status| status }
+
+        lines, status = Open3.capture2e(*full_cli_call)
+        report_failure(lines, status.exitstatus) if raise_on_error && status.exitstatus != 0
+
+        b.yield lines, status.exitstatus
+      end
+
+      def cli_args
+        [].tap do |args|
+          args << "--debug" if debug
+          args << ["--kube-apiserver", kube_apiserver] if kube_apiserver
+          args << ["--kube-as-group", kube_as_group ] if kube_as_group
+          args << ["--kube-context", kube_context] if kube_context
+          args << ["--kube-token", kube_token] if kube_token
+          args << ["--kubeconfig", kubeconfig ] if kubeconfig
+          args << ["--namespace", namespace] if namespace
+          args << ["--registry-config", registry_config] if registry_config
+          args << ["--repository-cache", repository_cache] if repository_cache
+          args << ["--repository-config", repository_config] if repository_config
+        end.flatten
+      end
+
+      def args
+        [subcommand_name, cli_args].flatten
+      end
+
+      def full_cli_call
+        [@client.program, args].flatten.map(&:to_s)
+      end
+
+      def report_failure(lines, status, and_raise: true)
+        preamble = "#{full_cli_call} failed with exit status #{status}. Output follows:"
+        if @client.logger
+          client.logger.error(preamble)
+          client.logger.error(lines)
+        else
+          STDERR.puts premable
+          STDERR.puts lines
+        end
+        raise(Error, "#{full_cli_call} failed with exit_status #{status}") if and_raise
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/dependency.rb

@@ -0,0 +1,49 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm dependency subcommand: `helm dependency COMMAND CHART [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_dependency/
+    class Dependency < Base
+      attr_reader :chart,
+                  :command,
+                  :help,
+                  :keyring,
+                  :skip_refresh,
+                  :verify
+
+      COMMANDS = %w(update)
+
+      def initialize(command, chart, options = {})
+        super(options)
+
+        @command = command.to_s
+        unless COMMANDS.include?(command)
+          raise(OptionError, "Invalid command #{command}. Valid values are: #{COMMANDS.join(', ')}")
+        end
+
+        @chart = chart
+        @help = !!options[:help]
+        @keyring = options[:keyring]
+        @skip_refresh = !!options[:skip_refresh]
+        @verify = !!options[:verify]
+      end
+
+      def subcommand_name
+        "dependency"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--help' if help
+          args << ['--keyring', keyring] if keyring
+          args << '--skip-refresh' if skip_refresh
+          args << '--verify' if verify
+
+          args << command
+          args << chart
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/env.rb

@@ -0,0 +1,27 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm env subcommand: `helm env [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_env/
+    class Env < Base
+      attr_reader :help
+
+      def initialize(options = {})
+        super
+
+        @help = options[:help]
+      end
+
+      def subcommand_name
+        "env"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << "--help" if help
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/history.rb

@@ -0,0 +1,37 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm history subcommand: `helm history RELEASE_NAME [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_history/
+    class History < Base
+      attr_reader :release_name,
+                  :help,
+                  :max,
+                  :output
+
+      def initialize(release_name, options = {})
+        super(options)
+
+        @release_name = release_name
+        @help = options[:help]
+        @max = options[:max]
+        @output = options[:output]
+      end
+
+      def subcommand_name
+        "history"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << "--help" if help
+          args << [ '--max', max ] if max
+          args << [ '--output', output ] if output
+
+          args << release_name
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/install.rb

@@ -0,0 +1,158 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm install subcommand: `helm install [NAME] [CHART] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_install/
+    class Install < Base
+      attr_reader :chart,
+                  :atomic,
+                  :ca_file,
+                  :cert_file,
+                  :create_namespace,
+                  :dependency_update,
+                  :description,
+                  :devel,
+                  :disable_openapi_validation,
+                  :dry_run,
+                  :generate_name,
+                  :insecure_skip_tls_verify,
+                  :key_file,
+                  :keyring,
+                  :name_template,
+                  :no_hooks,
+                  :output,
+                  :password,
+                  :post_renderer,
+                  :release,
+                  :render_subchart_notes,
+                  :replace,
+                  :repo,
+                  :set,
+                  :set_file,
+                  :set_string,
+                  :skip_crds,
+                  :timeout,
+                  :username,
+                  :values,
+                  :verify,
+                  :version,
+                  :wait
+
+      def initialize(release, chart, options = {})
+        super(options)
+
+        @release = release
+        @chart = chart
+        @atomic = options[:atomic]
+        @ca_file = options[:ca_file]
+        @cert_file = options[:cert_file]
+        @create_namespace = options[:create_namespace]
+        @dependency_update = options[:dependency_update]
+        @description = options[:description]
+        @devel = !!options[:devel]
+        @disable_openapi_validation = !!options[:disable_openapi_validation]
+        @dry_run = options[:dry_run]
+        @generate_name = options[:generate_name]
+        @insecure_skip_tls_verify = options[:insecure_skip_tls_verify]
+        @key_file = options[:key_file]
+        @keyring = options[:keyring]
+        @name_template = options[:name_template]
+        @no_hooks = options[:no_hooks]
+        @output = options[:output]
+        @password = options[:password]
+        @post_renderer = options[:post_renderer]
+        @render_subchart_notes = options[:render_subchart_notes]
+        @replace = options[:replace]
+        @repo = options[:repo]
+        @set = options[:set]
+        @set_file = options[:set_file]
+        @set_string = options[:set_string]
+        @skip_crds = options[:skip_crds]
+        @timeout = options[:timeout]
+        @username = options[:username]
+        @values = options[:values]
+        @verify = options[:verify]
+        @version = options[:version]
+        @wait = options[:wait]
+      end
+
+      def subcommand_name
+        "install"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--atomic' if atomic
+          args << ['--ca-file', ca_file] if ca_file
+          args << ['--cert-file', cert_file] if cert_file
+          args << '--create-namespace' if create_namespace
+          args << '--dependency-update' if dependency_update
+          args << ['--description', description] if description
+          args << '--devel' if devel
+          args << '--disable-openapi-validation' if disable_openapi_validation
+          args << '--dry-run' if dry_run
+          args << '--generate-name' if generate_name
+          args << '--insecure-skip-tls-verify' if insecure_skip_tls_verify
+          args << ['--key-file', key_file] if key_file
+          args << ['--keyring', keyring] if keyring
+          args << ['--name-template', name_template] if name_template
+          args << '--no-hooks' if no_hooks
+          args << ['--output', output] if output
+          args << ['--password', password] if password
+          args << ['--post-renderer', post_renderer] if post_renderer
+          args << '--render-subchart-notes' if render_subchart_notes
+          args << '--replace' if replace
+          args << ['--repo', repo] if repo
+
+          if set && !set.empty?
+            case set
+            when Hash
+              args << set.map { |key, value| ['--set', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set', set]
+            end
+          end
+
+          if set_file && !set_file.empty?
+            case set_file
+            when Hash
+              args << set_file.map { |key, value| ['--set-file', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set-file', set_file]
+            end
+          end
+
+          if set_string && !set_string.empty?
+            case set_string
+            when Hash
+              args << set_string.map { |key, value| ['--set-string', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set-string', set_string]
+            end
+          end
+
+          args << '--skip-crds' if skip_crds
+          args << ['--timeout', timeout] if timeout
+          args << ['--username', username] if username
+
+          if values && !values.empty?
+            case values
+            when Array
+              args << values.map { |values_file| ['--values', values_file ] }.flatten
+            else
+              args << ['--values', values]
+            end
+          end
+
+          args << '--verify' if verify
+          args << ['version', version] if version
+          args << '--wait' if wait
+
+          args << release
+          args << chart
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/pull.rb

@@ -0,0 +1,71 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm install subcommand: `helm pull [NAME] [CHART] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_pull/
+    class Pull < Base
+      attr_reader :ca_file,
+                  :chart,
+                  :cert_file,
+                  :destination,
+                  :devel,
+                  :insecure_skip_tls_verify,
+                  :key_file,
+                  :keyring,
+                  :password,
+                  :prov,
+                  :repo,
+                  :untar,
+                  :untardir,
+                  :username,
+                  :verify,
+                  :version
+
+      def initialize(chart, options = {})
+        super(options)
+
+        @chart = chart
+        @ca_file = options[:ca_file]
+        @cert_file = options[:cert_file]
+        @destination = options[:destination]
+        @devel = !!options[:devel]
+        @insecure_skip_tls_verify = !!options[:insecure_skip_tls_verify]
+        @key_file = options[:key_file]
+        @keyring = options[:keyring]
+        @password = options[:password]
+        @repo = options[:repo]
+        @untar = !!options[:untar]
+        @untardir = options[:untardir]
+        @username = options[:username]
+        @verify = !!options[:verify]
+        @version = options[:version]
+      end
+
+      def subcommand_name
+        "pull"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << ['--ca-file', ca_file] if ca_file
+          args << ['--cert-file', cert_file] if cert_file
+          args << ['--destination', destination] if destination
+          args << '--devel' if devel
+          args << '--insecure-skip-tls-verify' if insecure_skip_tls_verify
+          args << ['--key-file', key_file] if key_file
+          args << ['--keyring', keyring] if keyring
+          args << ['--password', password] if password
+          args << ['--repo', repo] if repo
+          args << '--untar' if untar
+          args << ['--untardir', untardir] if untardir
+          args << ['--username', username] if username
+          args << '--verify' if verify
+          args << ['--version', version] if version
+
+          args << chart
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/rollback.rb

@@ -0,0 +1,58 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm rollback subcommand: `helm rollback <RELEASE> [REVISION] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_rollback/
+    class Rollback < Base
+      attr_reader :release,
+                  :revision,
+                  :cleanup_on_fail,
+                  :dry_run,
+                  :force,
+                  :help,
+                  :history_max_int,
+                  :no_hooks,
+                  :recreate_pods,
+                  :timeout_duration,
+                  :wait
+
+      def initialize(release, revision, options = {})
+        super(options)
+
+        @release = release
+        @revision = revision
+        @cleanup_on_fail = options[:cleanup_on_fail]
+        @dry_run = options[:dry_run]
+        @force = options[:force]
+        @help = options[:help]
+        @history_max_int = options[:history_max_int]
+        @no_hooks = options[:no_hooks]
+        @recreate_pods = options[:recreate_pods]
+        @timeout_duration = options[:timeout_duration]
+        @wait = options[:wait]
+      end
+
+      def subcommand_name
+        "rollback"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--cleanup-on-fail' if cleanup_on_fail
+          args << '--dry-run' if dry_run
+          args << '--force' if force
+          args << '--help' if help
+          args << ['--history-max-int', history_max_int] if history_max_int
+          args << '--no-hooks' if no_hooks
+          args << '--recreate-pods' if recreate_pods
+          args << ['--timeout-duration', timeout_duration] if timeout_duration
+          args << '--wait' if wait
+
+          args << release
+          args << revision
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/status.rb

@@ -0,0 +1,43 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm status subcommand: `helm status RELEASE_NAME [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_status/
+    class Status < Base
+      attr_reader :release_name,
+                  :help
+
+      def initialize(release_name, options = {})
+        super(options)
+
+        @release_name = release_name
+        @help = options[:help]
+      end
+
+      def subcommand_name
+        "status"
+      end
+
+      def exists?
+        run(raise_on_error: false) do |lines,status|
+          if status == 0
+            true
+          elsif status == 1 && /Error: release: not found/m.match(lines)
+            false
+          else
+            report_failure(lines, status)
+          end
+        end
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--help' if help
+
+          args << release_name
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/test.rb

@@ -0,0 +1,37 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm test subcommand: `helm test [RELEASE] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_test/
+    class Test < Base
+      attr_reader :release,
+                  :help,
+                  :logs,
+                  :timeout
+
+      def initialize(release, options = {})
+        super(options)
+
+        @release = options[:release]
+        @help = options[:help]
+        @logs = options[:logs]
+        @timeout = options[:timeout]
+      end
+
+      def subcommand_name
+        "test"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--help' if help
+          args << '--logs' if logs
+          args << ['--timeout', timeout] if timeout
+
+          args << release
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/uninstall.rb

@@ -0,0 +1,27 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm uninstall subcommand: `helm uninstall RELEASE_NAME [...] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_uninstall/
+    class Uninstall < Base
+      attr_reader :release_name
+
+      def initialize(release_name, options = {})
+        super(options)
+
+        @release_name = release_name
+      end
+
+      def subcommand_name
+        "uninstall"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << release_name
+        end
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/upgrade.rb

@@ -0,0 +1,169 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm upgrade subcommand: `helm upgrade [RELEASE] [CHART] [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_upgrade/
+    class Upgrade < Base
+      attr_reader :release,
+                  :chart,
+                  :atomic,
+                  :ca_file,
+                  :cert_file,
+                  :cleanup_on_fail,
+                  :create_namespace,
+                  :dependency_update,
+                  :description,
+                  :devel,
+                  :disable_openapi_validation,
+                  :dry_run,
+                  :force,
+                  :help,
+                  :history_max,
+                  :insecure_skip_tls_verify,
+                  :install,
+                  :key_file,
+                  :keyring,
+                  :no_hooks,
+                  :output,
+                  :password,
+                  :post_renderer,
+                  :render_subchart_notes,
+                  :repo,
+                  :reset_values,
+                  :reuse_values,
+                  :set,
+                  :set_file,
+                  :set_string,
+                  :skip_crds,
+                  :timeout,
+                  :username,
+                  :values,
+                  :verify,
+                  :version,
+                  :wait
+
+
+      def initialize(release, chart, options = {})
+        super(options)
+
+        @release = release
+        @chart = chart
+        @atomic = !!options[:atomic]
+        @ca_file = options[:ca_file]
+        @cert_file = options[:cert_file]
+        @cleanup_on_fail = !!options[:cleanup_on_fail]
+        @dependency_update = !!options[:dependency_update]
+        @description = options[:description]
+        @devel = !!options[:devel]
+        @disable_openapi_validation = !!options[:disable_openapi_validation]
+        @dry_run = !!options[:dry_run]
+        @force = !!options[:force]
+        @help = !!options[:help]
+        @history_max = options[:history_max]
+        @insecure_skip_tls_verify = !!options[:insecure_skip_tls_verify]
+        @install = !!options[:install]
+        @key_file = options[:key_file]
+        @keyring = options[:keyring]
+        @no_hooks = !!options[:no_hooks]
+        @output = options[:output]
+        @password = options[:password]
+        @post_renderer = options[:post_renderer]
+        @render_subchart_notes = !!options[:render_subchart_notes]
+        @repo = options[:repo]
+        @reset_values = !!options[:reset_values]
+        @reuse_values = !!options[:reuse_values]
+        @set = options[:set]
+        @set_file = options[:set_file]
+        @set_string = options[:set_string]
+        @skip_crds = !!options[:skip_crds]
+        @timeout = options[:timeout]
+        @username = options[:username]
+        @values = options[:values]
+        @verify = !!options[:verify]
+        @version = options[:version]
+        @wait = !!options[:wait]
+      end
+
+      def subcommand_name
+        "upgrade"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--atomic' if atomic
+          args << ['--ca-file', ca_file] if ca_file
+          args << ['--cert-file', cert_file] if cert_file
+          args << '--cleanup-on-fail' if cleanup_on_fail
+          args << '--dependency-update' if dependency_update
+          args << ['--description', description] if description
+          args << '--devel' if devel
+          args << '--disable-openapi-validation' if disable_openapi_validation
+          args << '--dry-run' if dry_run
+          args << '--force' if force
+          args << '--help' if help
+          args << ['--history-max', history_max] if history_max
+          args << '--insecure-skip-tls-verify' if insecure_skip_tls_verify
+          args << '--install' if install
+          args << ['--key-file', key_file] if key_file
+          args << ['--keyring', keyring] if keyring
+          args << '--no-hooks' if no_hooks
+          args << ['--output', output] if output
+          args << ['--password', password] if password
+          args << ['--post-renderer', post_renderer] if post_renderer
+          args << '--render-subchart-notes' if render_subchart_notes
+          args << ['--repo', repo] if repo
+          args << '--reset-values' if reset_values
+          args << '--reuse-values' if reuse_values
+
+          if set && !set.empty?
+            case set
+            when Hash
+              args << set.map { |key, value| ['--set', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set', set]
+            end
+          end
+
+          if set_file && !set_file.empty?
+            case set_file
+            when Hash
+              args << set_file.map { |key, value| ['--set-file', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set-file', set_file]
+            end
+          end
+
+          if set_string && !set_string.empty?
+            case set_string
+            when Hash
+              args << set_string.map { |key, value| ['--set-string', "#{key}=#{value}" ] }.flatten
+            else
+              args << ['--set-string', set_string]
+            end
+          end
+
+          args << '--skip-crds' if skip_crds
+          args << ['--timeout', timeout] if timeout
+          args << ['--username', username] if username
+
+          if values && !values.empty?
+            case values
+            when Array
+              args << values.map { |values_file| ['--values', values_file ] }.flatten
+            else
+              args << ['--values', values]
+            end
+          end
+
+          args << '--verify' if verify
+          args << ['version', version] if version
+          args << '--wait' if wait
+
+          args << release
+          args << chart
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/verify.rb

@@ -0,0 +1,31 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm verify subcommand: `helm verify PATH [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_verify/
+    class Verify < Base
+      attr_reader :path,
+                  :keyring
+
+      def initialize(path, options = {})
+        super(options)
+
+        @path = path
+        @keyring = options[:keyring]
+      end
+
+      def subcommand_name
+        "verify"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << ['--keyring', keyring] if keyring
+
+          args << path
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand/version.rb

@@ -0,0 +1,33 @@
+require_relative "base"
+
+module Rhelm
+  module Subcommand
+    ## Helm version subcommand: `helm version [flags]`.
+    ## docs: https://helm.sh/docs/helm/helm_version/
+    class Version < Base
+      attr_reader :help,
+                  :short,
+                  :template
+
+      def initialize(options = {})
+        super
+
+        @help = options[:help]
+        @short = options[:short]
+        @template = options[:template]
+      end
+
+      def subcommand_name
+        "version"
+      end
+
+      def cli_args
+        super.tap do |args|
+          args << '--help' if help
+          args << '--short' if short
+          args << ['--template', template] if template
+        end.flatten
+      end
+    end
+  end
+end

data/lib/rhelm/subcommand_proxy.rb

@@ -0,0 +1,22 @@
+require 'open3'
+require 'pry-byebug'
+
+module Rhelm
+  class Client
+    class SubcommandProxy
+      def initialize(subcommand_name, client, *args, **kwargs)
+        unless SUBCOMMANDS.include?(subcommand_name.to_sym)
+          raise(Error, "Unknown subcommand #{subcommand_name}")
+        end
+
+        kwargs[:client] ||= client
+        class_name = "::Rhelm::Subcommand::#{subcommand_name.to_s.capitalize}"
+        @subcommand = Object.const_get(class_name).new(*args, **kwargs)
+      end
+
+      def method_missing(m, *args, **kwargs, &block)
+        @subcommand.send m, *args, **kwargs, &block
+      end
+    end
+  end
+end

data/lib/rhelm/version.rb

@@ -0,0 +1,4 @@
+
+module Rhelm
+  VERSION = "0.1.0-alpha1"
+end

data/rhelm.gemspec

@@ -0,0 +1,29 @@
+require_relative 'lib/rhelm/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rhelm"
+  spec.version       = Rhelm::VERSION
+  spec.authors       = ["Jack Newton", "Nick Marden"]
+  spec.email         = ["jnewton@avvo.com", "nick@rrsoft.co"]
+  spec.licenses      = ["MIT"]
+
+  spec.summary       = "A wrapper around helm3, including error detection and output parsing callback support"
+  spec.description   = "Invoke Helm 3.x commands from Ruby with easy result handling"
+  spec.homepage      = "https://github.com/avvo/ruby-helm"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.1")
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  #spec.metadata["changelog_uri"] = ""
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: rhelm
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre.alpha1
+platform: ruby
+authors:
+- Jack Newton
+- Nick Marden
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-05-23 00:00:00.000000000 Z
+dependencies: []
+description: Invoke Helm 3.x commands from Ruby with easy result handling
+email:
+- jnewton@avvo.com
+- nick@rrsoft.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/rhelm.rb
+- lib/rhelm/client.rb
+- lib/rhelm/client/simple_logger.rb
+- lib/rhelm/subcommand/base.rb
+- lib/rhelm/subcommand/dependency.rb
+- lib/rhelm/subcommand/env.rb
+- lib/rhelm/subcommand/history.rb
+- lib/rhelm/subcommand/install.rb
+- lib/rhelm/subcommand/pull.rb
+- lib/rhelm/subcommand/rollback.rb
+- lib/rhelm/subcommand/status.rb
+- lib/rhelm/subcommand/test.rb
+- lib/rhelm/subcommand/uninstall.rb
+- lib/rhelm/subcommand/upgrade.rb
+- lib/rhelm/subcommand/verify.rb
+- lib/rhelm/subcommand/version.rb
+- lib/rhelm/subcommand_proxy.rb
+- lib/rhelm/version.rb
+- rhelm.gemspec
+homepage: https://github.com/avvo/ruby-helm
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/avvo/ruby-helm
+  source_code_uri: https://github.com/avvo/ruby-helm
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
+summary: A wrapper around helm3, including error detection and output parsing callback
+  support
+test_files: []