morpheus-cli 3.6.8 → 3.6.9

data/lib/morpheus/cli/remote.rb

@@ -64,7 +64,7 @@ EOT
       return 0
     end
 
-    print_h1 "Morpheus Appliances"
+    print_h1 "Morpheus Appliances", [], options
     if appliances.empty?
       print yellow
       puts "You have no appliances configured. See the `remote add` command."
@@ -494,9 +494,9 @@ EOT
 
       if appliance[:active]
         # print_h1 "Current Remote Appliance: #{appliance[:name]}"
-        print_h1 "Remote Appliance: #{appliance[:name]}"
+        print_h1 "Remote Appliance: #{appliance[:name]}", [], options
       else
-        print_h1 "Remote Appliance: #{appliance[:name]}"
+        print_h1 "Remote Appliance: #{appliance[:name]}", [], options
       end
       print cyan
       description_cols = {
@@ -560,7 +560,7 @@ EOT
 
     # ok, delete it
     ::Morpheus::Cli::Remote.delete_remote(appliance_name)
-    
+
     # return result
     if options[:quiet]
       return 0, nil
@@ -667,7 +667,7 @@ EOT
     optparse = Morpheus::Cli::OptionParser.new do|opts|
       opts.banner = subcommand_usage()
       build_common_options(opts, options, [])
-      opts.footer = "Prints the name of the current remote appliance"
+      opts.footer = "Print the name of the current remote appliance"
     end
     optparse.parse!(args)
 
@@ -735,7 +735,7 @@ EOT
       # end
       return false
     else
-      print_h1 "Morpheus Appliance Setup"
+      print_h1 "Morpheus Appliance Setup", [], options
 
       puts "It looks like you're the first one here."
       puts "Let's initialize your remote appliance at #{@appliance_url}"
@@ -743,7 +743,7 @@ EOT
 
       
       # Master Account
-      print_h2 "Create Master Account"
+      print_h2 "Create Master Account", options
       account_option_types = [
         {'fieldName' => 'accountName', 'fieldLabel' => 'Master Account Name', 'type' => 'text', 'required' => true, 'displayOrder' => 1},
       ]
@@ -751,7 +751,7 @@ EOT
       payload.merge!(v_prompt)
 
       # Master User
-      print_h2 "Create Master User"
+      print_h2 "Create Master User", options
       user_option_types = [
         {'fieldName' => 'firstName', 'fieldLabel' => 'First Name', 'type' => 'text', 'required' => false, 'displayOrder' => 1},
         {'fieldName' => 'lastName', 'fieldLabel' => 'Last Name', 'type' => 'text', 'required' => false, 'displayOrder' => 2},
@@ -774,7 +774,7 @@ EOT
       payload.merge!(v_prompt)
 
       # Extra settings
-      print_h2 "Initial Setup"
+      print_h2 "Initial Setup", options
       extra_option_types = [
         {'fieldName' => 'applianceName', 'fieldLabel' => 'Appliance Name', 'type' => 'text', 'required' => true, 'defaultValue' => nil},
         {'fieldName' => 'applianceUrl', 'fieldLabel' => 'Appliance URL', 'type' => 'text', 'required' => true, 'defaultValue' => appliance_status_json['applianceUrl']},
@@ -847,10 +847,8 @@ EOT
       out << "#{green}#{status_str.upcase}#{return_color}"
     elsif status_str == "unreachable"
       out << "#{red}#{status_str.upcase}#{return_color}"
-    elsif status_str.include?("error")
-      out << "#{red}#{status_str.upcase}#{return_color}"
-    # elsif status_str == "unknown"
-    #   out << "#{yellow}#{status_str}#{return_color}"
+    elsif ['error', 'net-error', 'ssl-error', 'http-timeout', 'unreachable']
+      out << "#{red}#{status_str.upcase.gsub('-',' ')}#{return_color}"
     elsif status_str == "fresh" 
       # cold appliance, needs setup
       out << "#{magenta}#{status_str.upcase}#{return_color}"
@@ -887,10 +885,6 @@ EOT
     # Current User
     # 
     username = app_map[:username]
-    # creds = app_map[:access_token]
-    #creds = Morpheus::Cli::Credentials.new(app_map[:name], app_map[:host]).load_saved_credentials()
-    
-    
     
     if app_map[:status] == 'ready'
 

data/lib/morpheus/cli/roles.rb

@@ -50,7 +50,7 @@ class Morpheus::Cli::Roles
       params.merge!(parse_list_options(options))
 
       if options[:dry_run]
-        print_dry_run @roles_interface.dry.list(account_id, params)
+        print_dry_run @roles_interface.dry.list(account_id, params), options
         return
       end
       load_whoami()
@@ -69,11 +69,11 @@ class Morpheus::Cli::Roles
       title = "Morpheus Roles"
       subtitles = []
       subtitles += parse_list_subtitles(options)
-      print_h1 title, subtitles
+      print_h1 title, subtitles, options
       if roles.empty?
         print cyan,"No roles found.",reset,"\n"
       else
-        print_roles_table(roles, {is_master_account: @is_master_account})
+        print_roles_table(roles, options.merge({is_master_account: @is_master_account}))
         print_results_pagination(json_response)
       end
       print reset,"\n"
@@ -164,7 +164,7 @@ class Morpheus::Cli::Roles
       end
 
       print cyan
-      print_h1 "Role Details"
+      print_h1 "Role Details", options
       print cyan
       description_cols = {
         "ID" => 'id',
@@ -180,16 +180,16 @@ class Morpheus::Cli::Roles
       }
       print_description_list(description_cols, role)
 
-      print_h2 "Role Instance Limits"
-      print cyan
-      print_description_list({
-        "Max Storage"  => lambda {|it| (it && it['maxStorage'].to_i != 0) ? Filesize.from("#{it['maxStorage']} B").pretty : "no limit" },
-        "Max Memory"  => lambda {|it| (it && it['maxMemory'].to_i != 0) ? Filesize.from("#{it['maxMemory']} B").pretty : "no limit" },
-        "CPU Count"  => lambda {|it| (it && it['maxCpu'].to_i != 0) ? it['maxCpu'] : "no limit" }
-      }, role['instanceLimits'])
+      # print_h2 "Role Instance Limits", options
+      # print cyan
+      # print_description_list({
+      #   "Max Storage"  => lambda {|it| (it && it['maxStorage'].to_i != 0) ? Filesize.from("#{it['maxStorage']} B").pretty : "no limit" },
+      #   "Max Memory"  => lambda {|it| (it && it['maxMemory'].to_i != 0) ? Filesize.from("#{it['maxMemory']} B").pretty : "no limit" },
+      #   "CPU Count"  => lambda {|it| (it && it['maxCpu'].to_i != 0) ? it['maxCpu'] : "no limit" }
+      # }, role['instanceLimits'])
 
-      print_h2 "Feature Access"
-      print cyan
+      # print_h2 "Feature Access", options
+      # print cyan
 
       if options[:include_feature_access]
         rows = json_response['featurePermissions'].collect do |it|
@@ -204,7 +204,7 @@ class Morpheus::Cli::Roles
         puts "Use --feature-access to list feature access"
       end
 
-      print_h2 "Group Access"
+      print_h2 "Group Access", options
       print cyan
       puts "Global Group Access: #{get_access_string(json_response['globalSiteAccess'])}\n\n"
       if json_response['globalSiteAccess'] == 'custom'
@@ -221,7 +221,7 @@ class Morpheus::Cli::Roles
         end
       end
 
-      print_h2 "Cloud Access"
+      print_h2 "Cloud Access", options
       print cyan
       puts "Global Cloud Access: #{get_access_string(json_response['globalZoneAccess'])}\n\n"
       if json_response['globalZoneAccess'] == 'custom'
@@ -238,7 +238,7 @@ class Morpheus::Cli::Roles
         end
       end
 
-      print_h2 "Instance Type Access"
+      print_h2 "Instance Type Access", options
       print cyan
       puts "Global Instance Type Access: #{get_access_string(json_response['globalInstanceTypeAccess'])}\n\n"
       if json_response['globalInstanceTypeAccess'] == 'custom'
@@ -257,7 +257,7 @@ class Morpheus::Cli::Roles
 
       blueprint_global_access = json_response['globalAppTemplateAccess'] || json_response['globalBlueprintAccess']
       blueprint_permissions = json_response['appTemplatePermissions'] || json_response['blueprintPermissions'] || []
-      print_h2 "Blueprint Access"
+      print_h2 "Blueprint Access", options
       print cyan
       puts "Global Blueprint Access: #{get_access_string(json_response['globalAppTemplateAccess'])}\n\n"
       if blueprint_global_access == 'custom'

data/lib/morpheus/cli/security_groups.rb

@@ -27,41 +27,71 @@ class Morpheus::Cli::SecurityGroups
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage()
-      build_common_options(opts, options, [:json, :dry_run])
+      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
     end
     optparse.parse!(args)
     connect(options)
     begin
       params = {}
+      params.merge!(parse_list_options(options))
       if options[:dry_run]
         print_dry_run @security_groups_interface.dry.list(params)
         return
       end
       json_response = @security_groups_interface.list(params)
-      if options[:json]
-        print JSON.pretty_generate(json_response)
-        print "\n"
-        return
-      end
+      
+      render_result = render_with_format(json_response, options, 'securityGroups')
+      return 0 if render_result
+
+      title = "Morpheus Security Groups"
+      subtitles = []
+      subtitles += parse_list_subtitles(options)
+      print_h1 title, subtitles
+
       security_groups = json_response['securityGroups']
-      print_h1 "Morpheus Security Groups"
+      
       if security_groups.empty?
-        print yellow,"No Security Groups currently configured.",reset,"\n"
+        print yellow,"No security groups found.",reset,"\n"
       else
         active_id = @active_security_group[@appliance_name.to_sym]
-        security_groups.each do |security_group|
-          if @active_security_group[@appliance_name.to_sym] == security_group['id']
-            print cyan, "=> #{security_group['id']}: #{security_group['name']} (#{security_group['description']})\n"
-          else
-            print cyan, "   #{security_group['id']}: #{security_group['name']} (#{security_group['description']})\n"
-          end
+        # table_color = options[:color] || cyan
+        # rows = security_groups.collect do |security_group|
+        #   {
+        #     id: security_group['id'].to_s + ((security_group['id'] == active_id.to_i) ? " (active)" : ""),
+        #     name: security_group['name'],
+        #     description: security_group['description']
+        #   }
+        # end
+
+        # columns = [
+        #   :id,
+        #   :name,
+        #   :description,
+        #   # :ports,
+        #   # :status,
+        # ]
+        columns = {
+          "ID" => 'id',
+          "NAME" => 'name',
+          "DESCRIPTION" => 'description',
+          # need more to show here
+        }
+        # custom pretty table columns ...
+        if options[:include_fields]
+          columns = options[:include_fields]
         end
-        if active_id
-          print cyan, "\n# => - current", reset, "\n"
+        print as_pretty_table(security_groups, columns, options)
+        print reset
+        if json_response['meta']
+          print_results_pagination(json_response, {:label => "security group", :n_label => "security groups"})
+        else
+          print_results_pagination({'meta'=>{'total'=>(json_response['securityGroupCount'] ? json_response['securityGroupCount'] : security_groups.size),'size'=>security_groups.size,'max'=>(params['max']||25),'offset'=>(params['offset']||0)}}, {:label => "security group", :n_label => "security groups"})
         end
+        # print reset
       end
       print reset,"\n"
-          rescue RestClient::Exception => e
+      return 0
+    rescue RestClient::Exception => e
       print_rest_exception(e, options)
       exit 1
     end

data/lib/morpheus/cli/shell.rb

@@ -10,6 +10,8 @@ require 'morpheus/cli/cli_command'
 require 'morpheus/cli/error_handler'
 require 'morpheus/cli/expression_parser'
 require 'morpheus/terminal'
+require 'morpheus/logging'
+require 'morpheus/benchmarking'
 
 #class Morpheus::Cli::Shell < Morpheus::Terminal
 class Morpheus::Cli::Shell
@@ -88,7 +90,7 @@ class Morpheus::Cli::Shell
 
   def recalculate_auto_complete_commands
     @morpheus_commands = Morpheus::Cli::CliRegistry.all.keys.reject {|k| [:shell].include?(k) }
-    @shell_commands = [:clear, :history, :'flush-history', :reload!, :help, :exit]
+    @shell_commands = [:clear, :history, :reload!, :help, :exit]
     @alias_commands = Morpheus::Cli::CliRegistry.all_aliases.keys
     @exploded_commands = []
     Morpheus::Cli::CliRegistry.all.each do |cmd, klass|
@@ -126,7 +128,7 @@ class Morpheus::Cli::Shell
         @@insecure = true
         Morpheus::RestClient.enable_ssl_verification = false
       end
-       opts.on('-Z','--incognito', "Incognito mode. Use a temporary shell, no saved credentials and no history.") do
+       opts.on('-Z','--incognito', "Incognito mode. Use a temporary shell. Remotes are loaded without without saved credentials or history logging.") do
         @incognito_mode = true
         #@norc = true # perhaps?
         tmpdir = ENV['MORPHEUS_CLI_TMPDIR'] || ENV['TMPDIR'] || ENV['TMP']
@@ -167,11 +169,15 @@ class Morpheus::Cli::Shell
       opts.on('-C','--nocolor', "Disable ANSI coloring") do
         Term::ANSIColor::coloring = false
       end
-      opts.on('-V','--debug', "Print extra output for debugging.") do |json|
+      opts.on('-V','--debug', "Print extra output for debugging.") do
         Morpheus::Logging.set_log_level(Morpheus::Logging::Logger::DEBUG)
         ::RestClient.log = Morpheus::Logging.debug? ? Morpheus::Logging::DarkPrinter.instance : nil
       end
-      opts.on( '-h', '--help', "Prints this help" ) do
+      opts.on('-B','--benchmark', "Print benchmark time after each command is finished, including shell itself." ) do
+        Morpheus::Benchmarking.enabled = true
+        my_terminal.benchmarking = Morpheus::Benchmarking.enabled
+      end
+      opts.on( '-h', '--help', "Print this help" ) do
         puts opts
         exit
       end
@@ -235,33 +241,12 @@ class Morpheus::Cli::Shell
     return result
   end
 
-  # return exitstatus integer for a given command result
-  #todo: clean up CliCommand return values, handle a few diff types for now
-  def parse_result_exitstatus(result)
-    exit_code, err = 0, nil
-    if result.is_a?(Array) # exit_code, err
-      exit_code = result[0].to_i
-      err = result[1]
-    elsif result == nil || result == true || result == 0
-      exit_code = 0
-    elsif result == false
-      exit_code = 1
-    # elsif result.is_a?(Integer)
-    #   exit_code = result.to_i
-    else
-      exit_code = result.to_i
-    end
-    # return exit_code, err
-    return exit_code
-  end
-
-  # same as Terminal instance
+  # execute the input as an expression. 
+  # provides support for operators '(', ')', '&&', '||', ';'
+  # logs entire input as one command in shell history
+  # logging is skipped for certain commands: exit, !,  !!
   def execute(input)
-    # args = Shellwords.shellsplit(input)
-    #cmd = args.shift
-    #execute_commands(input)
     result = execute_commands_as_expression(input)
-    # skip logging of exit and !cmd
     unless input.strip.empty? || (["exit", "history"].include?(input.strip)) || input.strip[0].to_s.chr == "!"
       log_history_command(input.strip)
     end
@@ -302,12 +287,14 @@ class Morpheus::Cli::Shell
             if flow_cmd == '&&'
               # AND operator
               current_operator = flow_cmd
-              if parse_result_exitstatus(previous_command_result) != 0
+              exit_code, cmd_err = parse_command_result(previous_command_result)
+              if exit_code != 0
                 still_executing = false
               end
             elsif flow_cmd == '||' # or with previous command
               current_operator = flow_cmd
-              if parse_result_exitstatus(previous_command_result) == 0
+              exit_code, err = parse_command_result(previous_command_result)
+              if exit_code == 0
                 still_executing = false
               end
             elsif flow_cmd == '|' # or with previous command
@@ -350,9 +337,6 @@ class Morpheus::Cli::Shell
         #exit 0
       elsif input == 'help'
 
-        #print_h1 "Morpheus Shell Help", [], white
-        #print "\n"
-
         puts "You are in a morpheus client shell."
         puts "See the available commands below."
 
@@ -390,37 +374,37 @@ class Morpheus::Cli::Shell
       #     Morpheus::Logging::DarkPrinter.puts "\nInterrupt. waking up from sleep early"
       #   end
       #   return 0
-      elsif input =~ /^history/
-        n_commands = input.sub(/^history\s?/, '').sub(/\-n\s?/, '')
-        n_commands = n_commands.empty? ? 25 : n_commands.to_i
-        cmd_numbers = @history.keys.last(n_commands)
-        if cmd_numbers.size == 1
-          puts "Last command"
-        else
-          puts "Last #{cmd_numbers.size} commands"
-        end
-        cmd_numbers.each do |cmd_number|
-          cmd = @history[cmd_number]
-          puts "#{cmd_number.to_s.rjust(3, ' ')}  #{cmd}"
-        end
-        last_cmd = cmd_numbers.last ? @history[cmd_numbers.last] : nil
-        if input != last_cmd # no consecutive
-          log_history_command(input)
-        end
-        return 0
+      # elsif input =~ /^history/
+      #   n_commands = input.sub(/^history\s?/, '').sub(/\-n\s?/, '')
+      #   n_commands = n_commands.empty? ? 25 : n_commands.to_i
+      #   cmd_numbers = @history.keys.last(n_commands)
+      #   if cmd_numbers.size == 1
+      #     puts "Last command"
+      #   else
+      #     puts "Last #{cmd_numbers.size} commands"
+      #   end
+      #   cmd_numbers.each do |cmd_number|
+      #     cmd = @history[cmd_number]
+      #     puts "#{cmd_number.to_s.rjust(3, ' ')}  #{cmd}"
+      #   end
+      #   last_cmd = cmd_numbers.last ? @history[cmd_numbers.last] : nil
+      #   if input != last_cmd # no consecutive
+      #     log_history_command(input)
+      #   end
+      #   return 0
       elsif input == 'clear'
         print "\e[H\e[2J"
         return 0
-      elsif input == 'flush-history' || input == 'flush_history'
-        file_path = history_file_path
-        if File.exists?(file_path)
-          File.truncate(file_path, 0)
-        end
-        @history = {}
-        @last_command_number = 0
-        @history_logger = load_history_logger
-        puts "history cleared!"
-        return 0
+      # elsif input == 'flush-history' || input == 'flush_history'
+      #   file_path = history_file_path
+      #   if File.exists?(file_path)
+      #     File.truncate(file_path, 0)
+      #   end
+      #   @history = {}
+      #   @last_command_number = 0
+      #   @history_logger = load_history_logger
+      #   puts "history cleared!"
+      #   return 0
       # elsif input == "edit rc"
       #   fn = Morpheus::Cli::DotFile.morpheusrc_filename
       #   editor = ENV['EDITOR'] # || 'nano'
@@ -511,16 +495,17 @@ class Morpheus::Cli::Shell
         Morpheus::RestClient.enable_ssl_verification = false
         return 0
 
-      # use log-level [debug|info]
-      # elsif input =~ /^log_level/ # hidden for now
-      #   log_level = input.sub(/^log_level\s*/, '').strip
-      #   if log_level == ""
-      #     puts "#{Morpheus::Logging.log_level}"
-      elsif input == "debug"
-        log_history_command(input)
-        return Morpheus::Cli::LogLevelCommand.new.handle(["debug"])
       elsif ["hello","hi","hey","hola"].include?(input.strip.downcase)
-        print "#{input.capitalize}, how may I #{cyan}help#{reset} you?\n"
+        # need a logged_in? method already damnit
+        #wallet = @wallet
+        wallet = Morpheus::Cli::Credentials.new(@appliance_name, @appliance_url).load_saved_credentials
+        if wallet
+          # my_terminal.echo("#{input} %username!")
+          # todo: this morning|afternoon|evening would be pleasant
+          print "#{input} #{green}#{wallet['username']}#{reset}, how may I #{cyan}help#{reset} you?\n"
+        else
+          print "#{input}, how may I #{cyan}help#{reset} you?\n"
+        end
         return 0
       elsif input == "shell"
         print "#{cyan}You are already in a shell.#{reset}\n"
@@ -531,21 +516,31 @@ class Morpheus::Cli::Shell
         return Morpheus::Cli::SourceCommand.new.handle(input.split[1..-1])
       end
       cmd_result = nil
-      unless input =~ /log-level/
-        @return_to_log_level = Morpheus::Logging.log_level
-      end
-      unless input =~ /coloring/
-        @return_to_coloring = Term::ANSIColor::coloring?
-      end
       begin
         argv = Shellwords.shellsplit(input)
         cmd_name = argv[0]
         cmd_args = argv[1..-1]
+        # crap hack, naming conflicts can occur with aliases
+        @return_to_log_level = ["log-level","debug"].include?(cmd_name) ? nil : Morpheus::Logging.log_level
+        @return_to_coloring = ["coloring"].include?(cmd_name) ? nil : Term::ANSIColor::coloring?
+        @return_to_benchmarking = ["benchmark"].include?(cmd_name) ? nil : Morpheus::Benchmarking.enabled?
+        
         if Morpheus::Cli::CliRegistry.has_command?(cmd_name) || Morpheus::Cli::CliRegistry.has_alias?(cmd_name)
           #log_history_command(input)
+          # start a benchmark, unless the command is benchmark of course
+          if my_terminal.benchmarking || cmd_args.include?("-B") || cmd_args.include?("--benchmark")
+            if cmd_name != 'benchmark' # jd: this does not work still 2 of them printed.. fix it!
+              # benchmark_name = "morpheus " + argv.reject {|it| it == '-B' || it == '--benchmark' }.join(' ')
+              benchmark_name = argv.reject {|it| it == '-B' || it == '--benchmark' }.join(' ')
+              start_benchmark(benchmark_name)
+            end
+          end
           cmd_result = Morpheus::Cli::CliRegistry.exec(cmd_name, cmd_args)
+          cmd_exit_code, cmd_err = parse_command_result(cmd_result)
+          benchmark_record = stop_benchmark(cmd_exit_code, cmd_err) # if benchmarking?
+          Morpheus::Logging::DarkPrinter.puts(cyan + dark + benchmark_record.msg) if benchmark_record
         else
-          puts_error "#{Morpheus::Terminal.angry_prompt}'#{cmd_name}' is not a morpheus command. Use 'help' to see the list of available commands."
+          puts_error "#{Morpheus::Terminal.angry_prompt}'#{cmd_name}' is not recognized. Use 'help' to see the list of available commands."
           @history_logger.warn "Unrecognized Command #{cmd_name}" if @history_logger
           cmd_result = -1
         end
@@ -571,6 +566,11 @@ class Morpheus::Cli::Shell
           Term::ANSIColor::coloring = @return_to_coloring
           @return_to_coloring = nil
         end
+        if @return_to_benchmarking != nil
+          Morpheus::Benchmarking.enabled = @return_to_benchmarking
+          my_terminal.benchmarking = Morpheus::Benchmarking.enabled
+          @return_to_benchmarking = nil
+        end
       end
 
       # commands should be a number or nil (treated as 0)
@@ -664,7 +664,67 @@ class Morpheus::Cli::Shell
     @last_command_number += 1
     @history[@last_command_number] = cmd
     if @history_logger
-      @history_logger.info "#{@current_username}@#{@appliance_name} : -- : (cmd #{@last_command_number}) #{cmd}"
+      @history_logger.info "#{@current_username}@#{@appliance_name} -- : (cmd #{@last_command_number}) #{cmd}"
+    end
+  end
+
+  def last_command(n=25)
+    return list_history_commands(max:1)[0]
+  end
+
+  # list the N most recent commands, sorted oldest -> newest
+  # todo: support sort and order options..
+  def list_history_commands(options={})
+    history_records = []
+    max = options[:max] ? options[:max].to_i : 25
+    max = 50
+    load_history_from_log_file if !@history
+    cmd_numbers = @history.keys.last(max.to_i)
+    history_records = cmd_numbers.collect { |cmd_number| {command_number: cmd_number, command: @history[cmd_number]} }
+    last_cmd = cmd_numbers.last ? @history[cmd_numbers.last] : nil
+    # if input != last_cmd # no consecutive
+    #   log_history_command(input)
+    # end
+    return history_records
+  end
+
+  def print_history(n)
+    n ||= 25
+    load_history_from_log_file if !@history
+    cmd_numbers = @history.keys.last(n.to_i)
+    if cmd_numbers.size == 1
+      puts "Last command"
+    else
+      puts "Last #{cmd_numbers.size} commands"
     end
+    print cyan
+    cmd_numbers.each do |cmd_number|
+      cmd = @history[cmd_number]
+      puts "#{cmd_number.to_s.rjust(3, ' ')}  #{cmd}"
+    end
+    print reset
+    #last_cmd = cmd_numbers.last ? @history[cmd_numbers.last] : nil
+    # if input != last_cmd # no consecutive
+    #   log_history_command(input)
+    # end
+    return 0
+  end
+
+  def history_commands_count()
+    load_history_from_log_file if !@history
+    @history.keys.size
+  end
+
+  def flush_history(n=nil)
+    # todo: support only flushing last n commands
+      file_path = history_file_path
+      if File.exists?(file_path)
+        File.truncate(file_path, 0)
+      end
+      @history = {}
+      @last_command_number = 0
+      @history_logger = load_history_logger
+      print cyan, "Command history flushed!", reset, "\n"
+      return 0
   end
 end