ranch-hand 0.7.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 739b914a9a3aaa61cbd1ea414310158a5de894f02f93028c6c6927d3dcf4d567
-  data.tar.gz: 0166cfe7b29ad795d8f8ee3e0bef4a91bb3fce4e55e2a662ab24e7cf06474596
+  metadata.gz: 2fb14b44db08c6e28ef1ff0e3af33dac5d59db3796b258a335d97e2877a0f8d9
+  data.tar.gz: 2f511a77fc5e745c0dd82669e45994be770bd459e362c71023a3c3cf61261de5
 SHA512:
-  metadata.gz: d0608be5112035aa5f4ca5e9e7ce1fc570763f485d688541de6c9095bcd3345cf0ce69378c820f60b782f0051b88322e4f7c052960f75db9c18ddffd3be44dc8
-  data.tar.gz: 957785da2e00ac1fb0834a9cb9cec97a6ed7628d1c0ad02e458ab1da3fdf76625801b733c1d4439a58ab8d1437d7ab6b3ce80ad09978a4d79417e1e39ff86f72
+  metadata.gz: b6144eaf7a166690fa432663ff327d07039a587ccbb0273ab48d05cb05210a89296821ff1720f7050aa2d06274b00216774d2b437551e64cfa1ba46e873e10d6
+  data.tar.gz: 4607f82b622d699f95ca94ad21fe0b82a8b8ff9a172f164731dc5e4ea43939ced13ad80e472f0c1f138b6eb5d6806a0157819c2486538363952ad1359df48cf1

data/Changelog.md

@@ -1,4 +1,23 @@
+### 0.8.1
+- Bug fix for ohmyzsh shortcut that used wrong flag for skip prefix
+### 0.8.0
+- Add ability to specify a command prefix that will be added to all commands run via `ranch-hand exec` by default (peregrinator/ranch-hand/issues/8)
+- Add ability to edit the project config file via new command `ranch-hand update_config` (peregrinator/ranch-hand/issues/9)
+- Add ohmyzsh aliases for new commands
+### 0.7.1
+Add Oh My Zsh plugin to provide shortcuts, see files/ranch-hand.plugin.zsh
+Add new `ranch-hand ohmyzsh` command to install plugins
+
+### 0.7.0
+#### Features
+Add support for command arguments. Commands that use arguments no longer need to be wrapped in a string in order to be passed properly. This provides a better interface for editor plugins that automatically append arguments to the end of a custom command.
+  - https://github.com/peregrinator/ranch-hand/commit/a70d44042507d407c0088a2a8ffa4d4514a800af
+  - ex: before: `ranch-hand exec -c 'rspec spec/foo.rb:21'`, now: `ranch-hand exec -c rspec spec/foo.rb:21`
+
+#### Bugfixes:
+- d76855: correctly handle scenario in which the namespace queried has no pods
+
 ### 0.6.0
 
 Updates for Ruby 3.0 compat
-  - https://rubyreferences.github.io/rubychanges/3.0.html#keyword-arguments-are-now-fully-separated-from-positional-arguments
+  - https://rubyreferences.github.io/rubychanges/3.0.html#keyword-arguments-are-now-fully-separated-from-positional-arguments

data/bin/ranch-hand

@@ -23,13 +23,27 @@ module RanchHandCLI
     end
   end
 
-  desc 'Initializes ranch hand for project'
+  desc 'Installs ranch hand Oh My Zsh shortcuts'
+  command :ohmyzsh do |c|
+    c.action do |global_options, options, args|
+      RanchHand::Base.install_ohmyzsh
+    end
+  end
+
+  desc 'Initializes ranch hand for current project'
   command :init do |c|
     c.action do |global_options, command_options, args|
       RanchHand::Base.init
     end
   end
 
+  desc 'Updates ranch hand config for current project'
+  command :update_config do |c|
+    c.action do |global_options, command_options, args|
+      RanchHand::Base.update_config
+    end
+  end
+
   desc 'Execs into a running container'
   command :exec do |c|
     config = RanchHand::Config.load
@@ -37,14 +51,20 @@ module RanchHandCLI
     c.switch [:g, :group], negatable: true, default_value: config[:group] || false, desc: "Group pods returned so that there is only one from each deployment, --no-group can be used to override project config as needed."
     c.switch [:rm, :remove], negatable: false, desc: "Used to indicated that you want to remove a previously saved command."
     c.switch [:r, :repeat], negatable: false, desc: "Repeat the last command ran (against the same pod)."
-    
+    c.switch [:sp, :skip_prefix], negatable: false, default_value: false, desc: "Do not add configured command prefix."
+
     c.flag [:c, :command], desc: "Command to run once (not permanently stored)"
     c.flag [:f, :filter], desc: "Filter pods returned to those that contain the string provided (negative matches supported). Examples: '-f nginx', '-f -apache'"
     c.flag [:n, :namespace], required: true, default_value: config[:namespace], desc: "Namespace against which to retreive pods and run command"
     c.flag [:p, :pod], default_value: config[:pod], desc: "Run command in a specific pod. If used with -g only the pod name can be specified and the command will be run against the first in the group"
 
+    default_command_options = {
+      command_prefix: config[:command_prefix],
+      prefer_ui: config[:prefer_ui]
+    }
+
     c.action do |global_options, command_options, args|
-      RanchHand::KubeCtl.new.exec(args: args, cmd_options: command_options)
+      RanchHand::KubeCtl.new.exec(args: args, cmd_options: default_command_options.merge(command_options))
     end
   end
 

data/files/ranch-hand.plugin.zsh

@@ -0,0 +1,6 @@
+alias rh='ranch-hand'                       # main binary alias
+alias rhs='ranch-hand setup'                # setup ranch hand with Rancher CLI credentials
+alias rhi='ranch-hand init'                 # initialize default ranch hand settings in a project
+alias rhu='ranch-hand update_config'        # update default ranch hand settings for a project
+alias rhe='ranch-hand exec'                 # run a command in a container
+alias rhes='ranch-hand exec --skip_prefix'  # run a command in a container but skip default command_prefix

data/lib/ranch_hand/base.rb

@@ -12,5 +12,33 @@ module RanchHand
       RanchHand::Config.create
       RanchHand::Logger.info("initialization complete")
     end
+
+    def self.install_ohmyzsh
+      RanchHand::Logger.info("installing ranch-hand Oh My Zsh shortcuts")
+
+      unless ENV['ZSH_CUSTOM'] || ENV['ZSH']
+        RanchHand::Logger.warn("Could not find $ZSH_CUSTOM or $ZSH in your environment, can not install shortcuts")
+        return
+      end
+
+      zsh_custom_dir = ENV['ZSH_CUSTOM'] || File.join(ENV['ZSH'], 'custom')
+
+      zsh_plugin_dir = File.join(zsh_custom_dir, 'plugins', 'ranch-hand')
+      FileUtils.mkdir_p(zsh_plugin_dir)
+
+      current_path = File.expand_path(File.dirname(__FILE__))
+      gem_plugin_path = File.join(current_path, '..', '..', 'files', 'ranch-hand.plugin.zsh')
+
+      FileUtils.cp(gem_plugin_path, zsh_plugin_dir)
+
+      RanchHand::Logger.info("installation complete")
+      RanchHand::Logger.info("Don't forget to add 'ranch-hand' to your plugins in ~/.zshrc -- e.g. plugins=(ranch-hand) -- and then 'source ~/.zshrc'")
+    end
+
+    def self.update_config
+      RanchHand::Logger.info("updating ranch-hand config for project")
+      RanchHand::Config.update
+      RanchHand::Logger.info("update complete")
+    end
   end
-end
+end

data/lib/ranch_hand/commands.rb

@@ -10,4 +10,4 @@ module RanchHand
       TTY::Prompt.new
     end
   end
-end
+end

data/lib/ranch_hand/config.rb

@@ -15,24 +15,51 @@ module RanchHand
       end
     end
 
+    def self.update
+      save(generate_config(load))
+    end
+
     private
 
-    def self.generate_config
+    def self.generate_config(current={})
+      unless current.empty?
+        puts "Current config:"
+        pp current
+        puts "A blank entry to the following prompts will keep the current config value."
+      end
+
       namespace = prompt.ask('Namespace:')
       group = prompt.ask('Use group command by default? (Y/n):')
-      group = %w(n N).include?(group) ? false : true
       pod = prompt.ask('Pod name:')
+      prefix = prompt.ask('Command prefix (optional):')
 
-      {
+      # set default value if there is no current or entered value
+      if group.nil? && current[:group].nil?
+        group = %w(n N).include?(group) ? false : true
+      end
+
+      # if command prefix is provided set prefer_ui to false
+      # prefer_ui skips the #exec command line ui if set to true
+      # this supports a base case where the prefix command is the
+      # only command the user wants to run (eg. simple connection to the pod)
+      if current[:prefer_ui]
+        prefer_ui = nil
+      elsif prefix || current[:command_prefix]
+        prefer_ui = false
+      else
+        prefer_ui = true
+      end
+
+      current.merge({
+        command_prefix: prefix,
         group: group,
         namespace: namespace,
-        pod: pod
-      }
+        pod: pod,
+        prefer_ui: prefer_ui
+      }.compact)
     end
 
     def self.save(config)
-      # File.new(project_config_path, 'w+', 0640)
-
       File.open(project_config_path, 'w', 0640) do |f|
         f.write(config.to_yaml)
       end

data/lib/ranch_hand/constants.rb

@@ -1,4 +1,4 @@
 module RanchHand
   RANCH_HAND_HOME = File.join(ENV['HOME'], '.ranch-hand')
   STORE_FILE = File.join(RANCH_HAND_HOME, 'store.yml')
-end
+end

data/lib/ranch_hand/kube_ctl.rb

@@ -6,19 +6,27 @@ module RanchHand
       args = Array(args)
 
       namespace = cmd_options.delete(:namespace)
-      
+
       if cmd_options[:remove]
         remove_command(namespace)
       elsif cmd_options[:repeat]
         repeat_command(namespace)
-      elsif cmd_options[:command]
+      elsif cmd_options[:command] || (!cmd_options[:prefer_ui] && cmd_options[:command_prefix])
         pod = select_pod(namespace, cmd_options)
-        run_command(namespace, pod, cmd_options[:command], args)
+        run_command(namespace, pod, generate_command(cmd_options), args)
       else
         choose_command(namespace, cmd_options)
       end
     end
 
+    def generate_command(cmd_options)
+      if cmd_options[:skip_prefix]
+        command = cmd_options[:command]
+      else
+        command = "#{cmd_options[:command_prefix]} #{cmd_options[:command]}".strip
+      end
+    end
+
     def run_command(namespace, pod, cmd, args=[])
       system("rancher kubectl -n #{namespace} exec -it #{pod} -- #{cmd} #{args.join(' ')}".strip)
     end
@@ -26,7 +34,7 @@ module RanchHand
     def choose_command(namespace, options={})
       pod = select_pod(namespace, options)
       type, cmd = select_command(namespace, pod)
-      
+
       run_command(namespace, pod, cmd)
     end
 
@@ -59,9 +67,9 @@ module RanchHand
 
       if options[:filter]
         if options[:filter].start_with?('-')
-          pods = pods.reject{|p| p.match?(/#{options[:filter][1..-1]}/)} 
+          pods = pods.reject{|p| p.match?(/#{options[:filter][1..-1]}/)}
         else
-          pods = pods.select{|p| p.match?(/#{options[:filter]}/)} 
+          pods = pods.select{|p| p.match?(/#{options[:filter]}/)}
         end
       end
       prompt.error("No pods matching filter: '#{options[:filter]}'") and exit if pods.empty?
@@ -183,10 +191,5 @@ module RanchHand
     def storage
       @storage ||= RanchHand::Storage.new
     end
-
-    # def project_config
-    #   project_config_file = File.join(Dir.pwd, ".ranch-hand")
-    #   YAML.load_file(project_config_file) || {}
-    # end
   end
-end
+end

data/lib/ranch_hand/logger.rb

@@ -8,4 +8,4 @@ module RanchHand
       @@logger ||= ::Logger.new(STDOUT)
     end
   end
-end
+end

data/lib/ranch_hand/storage.rb

@@ -21,4 +21,4 @@ module RanchHand
       end
     end
   end
-end
+end

data/lib/ranch_hand/version.rb

@@ -1,3 +1,3 @@
 module RanchHand
-  VERSION = "0.7.0"
+  VERSION = "0.8.1"
 end

data/lib/ranch_hand.rb

@@ -1,6 +1,7 @@
 # stdlib
 require 'fileutils'
 require 'logger'
+require 'pp'
 require 'yaml'
 
 # gems
@@ -15,4 +16,4 @@ require 'ranch_hand/constants.rb'
 require 'ranch_hand/kube_ctl.rb'
 require 'ranch_hand/logger.rb'
 require 'ranch_hand/storage.rb'
-require 'ranch_hand/version.rb'
+require 'ranch_hand/version.rb'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ranch-hand
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: ruby
 authors:
 - Peregrinator
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-19 00:00:00.000000000 Z
+date: 2022-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -129,6 +129,7 @@ files:
 - bin/ranch-hand
 - bin/setup
 - doc/ranch-hand-demo.gif
+- files/ranch-hand.plugin.zsh
 - lib/ranch_hand.rb
 - lib/ranch_hand/base.rb
 - lib/ranch_hand/commands.rb
@@ -158,7 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.2.22
 signing_key: 
 specification_version: 4
 summary: Provides an interface between the Rancher CLI and the Kubectl commands