morpheus-cli 4.2.18 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 625ac78e3858476f22af0b74911f623680b61a1f02808d7af341a49e591bd679
-  data.tar.gz: 9ba142c3499a5fbb16b5e920c19c2fc3efa0c3617b3d29b4766bc960f6372a51
+  metadata.gz: b7e5399fa687da8ee714dc1bfe80cd72c2f01bf15cb465f1e6e576df53aa0a84
+  data.tar.gz: d5fe9c71d49308c5f7f92e47b134647712c302f833d7e77a55431bcec2e3036f
 SHA512:
-  metadata.gz: 9ab2c8609c0fbc67d11a59db49b7dfb19b6f6bac97cea016797d5d43e56a620d74e0c2d125234aef996e6900afbab6258b7a069f6c36984f31760acd22023f54
-  data.tar.gz: eddf3b6dca658ee215313f7970af3377ad6c284bf127869b2b8c4ddeb212081dead70a909d6ee1740aba849a415e8d64c49859ecfba160fed2f36d395e447197
+  metadata.gz: a0904e36c4240d638d87862cefffd681241868a8cd06730eef6ddac921d4fb288a27043d365b4ba94b3223fa6be41b783f2b9aaa570e490b731528c6b282b5ff
+  data.tar.gz: b05b484d490e4829e20bba8d942acef387346cc03e214cd1c04d96a2cfca603d971d20054cb3bb9f9024d5bf977864b543d3c6d599089765f55426aa317a4f0e

data/Dockerfile

@@ -1,5 +1,5 @@
 FROM ruby:2.5.1
 
-RUN gem install morpheus-cli -v 4.2.18
+RUN gem install morpheus-cli -v 5.0.0
 
 ENTRYPOINT ["morpheus"]

data/lib/morpheus/api/api_client.rb

@@ -764,6 +764,20 @@ class Morpheus::APIClient
     Morpheus::BackupJobsInterface.new(common_interface_options).setopts(@options)
   end
 
+  def catalog_item_types
+    Morpheus::CatalogItemTypesInterface.new(common_interface_options).setopts(@options)
+  end
+
+  def billing
+    Morpheus::BillingInterface.new(common_interface_options).setopts(@options)
+  end
+  
   # add new interfaces here
 
+  protected
+
+  def validate_id!(id)
+    raise "#{self.class} passed a blank id!" if id.to_s.strip.empty?
+  end
+
 end

data/lib/morpheus/api/billing_interface.rb

@@ -0,0 +1,33 @@
+require 'morpheus/api/api_client'
+
+class Morpheus::BillingInterface < Morpheus::APIClient
+
+  def base_path
+    "/api/billing"
+  end
+
+  def list(params={})
+    execute(method: :get, url: "#{base_path}", params: params)
+  end
+
+  def list_account(params={})
+    execute(method: :get, url: "#{base_path}/account", params: params)
+  end
+
+  def list_zones(params={})
+    execute(method: :get, url: "#{base_path}/zones", params: params)
+  end
+
+  def list_instances(params={})
+    execute(method: :get, url: "#{base_path}/instances", params: params)
+  end
+
+  def list_servers(params={})
+    execute(method: :get, url: "#{base_path}/servers", params: params)
+  end
+
+  def list_discovered_servers(params={})
+    execute(method: :get, url: "#{base_path}/discoveredServers", params: params)
+  end
+
+end

data/lib/morpheus/api/catalog_item_types_interface.rb

@@ -0,0 +1,9 @@
+require 'morpheus/api/rest_interface'
+
+class Morpheus::CatalogItemTypesInterface < Morpheus::RestInterface
+
+  def base_path
+    "/api/catalog-item-types"
+  end
+
+end

data/lib/morpheus/api/rest_interface.rb

@@ -31,10 +31,4 @@ class Morpheus::RestInterface < Morpheus::APIClient
     execute(method: :delete, url: "#{base_path}/#{id}", params: params)
   end
 
-  protected
-
-  def validate_id!(id)
-    raise "#{self.class} passed a blank id!" if id.to_s.strip.empty?
-  end
-
 end

data/lib/morpheus/api/roles_interface.rb

@@ -77,6 +77,20 @@ class Morpheus::RolesInterface < Morpheus::APIClient
     execute(method: :put, url: url, headers: headers, payload: payload.to_json)
   end
 
+  def update_catalog_item_type(account_id, id, options)
+    url = build_url(account_id, id) + "/update-catalog-item-type"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
+  def update_persona(account_id, id, options)
+    url = build_url(account_id, id) + "/update-persona"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    payload = options
+    execute(method: :put, url: url, headers: headers, payload: payload.to_json)
+  end
+
   private
 
   def build_url(account_id=nil, role_id=nil)

data/lib/morpheus/cli.rb

@@ -67,8 +67,6 @@ module Morpheus
       # all standard commands
       Dir[File.dirname(__FILE__)  + "/cli/commands/standard/**/*.rb"].each {|file| load file }
 
-      # shell scripting commands
-
       # all the known commands
       load 'morpheus/cli/remote.rb'
       load 'morpheus/cli/doc.rb'
@@ -174,6 +172,8 @@ module Morpheus
       load 'morpheus/cli/projects_command.rb'
       load 'morpheus/cli/backups_command.rb'
       load 'morpheus/cli/backup_jobs_command.rb'
+      load 'morpheus/cli/catalog_command.rb'
+      load 'morpheus/cli/usage_command.rb'
       # add new commands here...
 
     end

data/lib/morpheus/cli/apps.rb

@@ -92,10 +92,9 @@ class Morpheus::Cli::Apps
       opts.footer = "List apps."
     end
     optparse.parse!(args)
-    if args.count != 0
-      print_error Morpheus::Terminal.angry_prompt
-      puts_error  "#{command_name} list expects 0 arguments and received #{args.count}: #{args}\n#{optparse}"
-      return 1
+    # verify_args!(args:args, optparse:optparse, count:0)
+    if args.count > 0
+      options[:phrase] = args.join(" ")
     end
     connect(options)
     begin

data/lib/morpheus/cli/backup_jobs_command.rb

@@ -225,6 +225,9 @@ EOT
       print_dry_run @backup_jobs_interface.dry.destroy(backup_job['id'], params)
       return
     end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the backup #{backup['name']}?")
+      return 9, "aborted command"
+    end
     json_response = @backup_jobs_interface.destroy(backup_job['id'], params)
     render_response(json_response, options) do
       print_green_success "Removed backup job #{backup_job['name']}"

data/lib/morpheus/cli/backups_command.rb

@@ -215,6 +215,9 @@ EOT
       print_dry_run @backups_interface.dry.destroy(backup['id'], params)
       return
     end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the backup #{backup['name']}?")
+      return 9, "aborted command"
+    end
     json_response = @backups_interface.destroy(backup['id'], params)
     render_response(json_response, options) do
       print_green_success "Removed backup #{backup['name']}"

data/lib/morpheus/cli/blueprints_command.rb

@@ -62,11 +62,15 @@ class Morpheus::Cli::BlueprintsCommand
         params['ownerId'] << val
       end
       opts.add_hidden_option('--created-by')
-      build_common_options(opts, options, [:list, :query, :json, :yaml, :csv, :fields, :dry_run, :remote])
+      build_standard_list_options(opts, options)
       opts.footer = "List blueprints."
     end
     optparse.parse!(args)
     connect(options)
+    # verify_args!(args:args, optparse:optparse, count:0)
+    if args.count > 0
+      options[:phrase] = args.join(" ")
+    end
     begin
       if params['ownerId']
         params['ownerId'] = params['ownerId'].collect do |owner_id|
@@ -125,7 +129,7 @@ class Morpheus::Cli::BlueprintsCommand
       opts.on( '-c', '--config', "Display raw config only. Default is YAML. Combine with -j for JSON instead." ) do
         options[:show_config] = true
       end
-      build_common_options(opts, options, [:json, :yaml, :csv, :fields, :outfile, :dry_run, :remote])
+      build_standard_get_options(opts, options)
       opts.footer = "Get details about a blueprint.\n" +
                     "[blueprint] is required. This is the name or id of a blueprint. Supports 1-N [instance] arguments."
     end
@@ -154,8 +158,9 @@ class Morpheus::Cli::BlueprintsCommand
       end
       @blueprints_interface.setopts(options)
       blueprint = find_blueprint_by_name_or_id(arg)
-      exit 1 if blueprint.nil?
-
+      if blueprint.nil?
+        return 1, "blueprint not found"
+      end
       json_response = {'blueprint' => blueprint}  # skip redundant request
       #json_response = @blueprints_interface.get(blueprint['id'])
       blueprint = json_response['blueprint']
@@ -165,43 +170,13 @@ class Morpheus::Cli::BlueprintsCommand
         unless options[:json] || options[:yaml] || options[:csv]
           options[:yaml] = true
         end
-        blueprint_config = blueprint['config']
-        render_result = render_with_format(blueprint_config, options)
-        return 0 if render_result
+        return render_with_format(blueprint['config'], options)
       end
-
-      render_result = render_with_format(json_response, options, 'blueprint')
-      return 0 if render_result
-
-      print_h1 "Blueprint Details"
-      
-      print_blueprint_details(blueprint)
-
-      if blueprint['resourcePermission'].nil?
-        #print "\n", "No group access found", "\n"
-      else
-        # print_h2 "Group Access"
-        # rows = []
-        # if blueprint['resourcePermission']['allSites'] || blueprint['resourcePermission']['all']
-        #   rows.push({"name" => 'All'})
-        # end
-        # if blueprint['resourcePermission']['sites']
-        #   blueprint['resourcePermission']['sites'].each do |site|
-        #     rows.push(site)
-        #   end
-        # end
-        # rows = rows.collect do |site|
-        #   {group: site['name'], default: site['default'] ? 'Yes' : ''}
-        # end
-        # # columns = [:group, :default]
-        # columns = [:group]
-        # print cyan
-        # print as_pretty_table(rows, columns)
-        # print reset,"\n"
-      end
-
-      #print reset,"\n"
-      return 0
+      render_response(json_response, options, 'blueprint') do
+        print_h1 "Blueprint Details"
+        print_blueprint_details(blueprint)
+      end
+      return 0, nil
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
       exit 1
@@ -216,17 +191,12 @@ class Morpheus::Cli::BlueprintsCommand
       opts.on('-t', '--type TYPE', String, "Blueprint Type. Default is morpheus.") do |val|
         options[:blueprint_type] = parse_blueprint_type(val.to_s)
       end
-      build_common_options(opts, options, [:options, :payload, :json, :dry_run, :quiet, :remote])
+      build_standard_add_options(opts, options)
       opts.footer = "Create a new blueprint.\n" + 
                     "[name] is required. This is the name of the new blueprint."
     end
     optparse.parse!(args)
-    if args.count > 1
-      print_error Morpheus::Terminal.angry_prompt
-      puts_error  "#{command_name} add expects 0-1 arguments and received #{args.count}: #{args}\n#{optparse}"
-      return 1
-    end
-    options[:options] ||= {}
+    verify_args!(args:args, optparse:optparse, min:0, max:1)
     if args[0]
       options[:options]['name'] = args[0]
     end
@@ -248,9 +218,7 @@ class Morpheus::Cli::BlueprintsCommand
         end
         params = Morpheus::Cli::OptionTypes.prompt(add_blueprint_option_types, options[:options], @api_client, options[:params])
         params.deep_compact!
-        #blueprint_payload = params.select {|k,v| ['name', 'description', 'category'].include?(k) }
         # expects no namespace, just the config
-        #payload = blueprint_payload
         payload.deep_merge!(params)
       end
       @blueprints_interface.setopts(options)
@@ -260,12 +228,8 @@ class Morpheus::Cli::BlueprintsCommand
       end
 
       json_response = @blueprints_interface.create(payload)
-
-      if options[:json]
-        print JSON.pretty_generate(json_response)
-        print "\n"
-      elsif !options[:quiet]
-        blueprint = json_response["blueprint"]
+      blueprint = json_response['blueprint']
+      render_response(json_response, options, 'blueprint') do
         print_green_success "Added blueprint #{blueprint['name']}"
         if !options[:no_prompt]
           if options[:payload].nil? && ::Morpheus::Cli::OptionTypes::confirm("Would you like to add a tier now?", options.merge({default: false}))
@@ -275,11 +239,11 @@ class Morpheus::Cli::BlueprintsCommand
             end
           else
             # print details
-            get([blueprint['id']] + (options[:remote] ? ["-r",options[:remote]] : []))
+            return _get(blueprint["id"], options)
           end
         end
       end
-      return 0
+      return 0, nil
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
       exit 1
@@ -294,7 +258,7 @@ class Morpheus::Cli::BlueprintsCommand
       opts.on( '--owner USER', "Owner Username or ID" ) do |val|
         options[:owner] = val == 'null' ? nil : val
       end
-      build_common_options(opts, options, [:options, :payload, :json, :dry_run, :quiet, :remote])
+      build_standard_update_options(opts, options)
       opts.footer = "Update a blueprint.\n" + 
                     "[blueprint] is required. This is the name or id of a blueprint."
     end
@@ -388,7 +352,7 @@ class Morpheus::Cli::BlueprintsCommand
         options[:owner] = val == 'null' ? nil : val
       end
       build_option_type_options(opts, options, update_blueprint_option_types(false))
-      build_common_options(opts, options, [:options, :payload, :json, :dry_run, :quiet, :remote])
+      build_standard_update_options(opts, options)
       opts.footer = "Update a blueprint permissions.\n" + 
                     "[blueprint] is required. This is the name or id of a blueprint."
     end
@@ -586,7 +550,7 @@ class Morpheus::Cli::BlueprintsCommand
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[blueprint]")
-      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :remote])
+      build_standard_remove_options(opts, options)
       opts.footer = "Delete a blueprint." + "\n" +
                     "[blueprint] is required. This is the name or id of a blueprint."
     end
@@ -2123,6 +2087,7 @@ class Morpheus::Cli::BlueprintsCommand
     }
 
     print_description_list(description_cols, blueprint)
+    print reset,"\n"
     # print_h2 "Tiers"
     if blueprint["config"] && blueprint["config"]["tiers"] && blueprint["config"]["tiers"].keys.size != 0
       print cyan
@@ -2213,7 +2178,8 @@ class Morpheus::Cli::BlueprintsCommand
     else
       #print white,"\nTemplate is empty, use `blueprints add-tier \"#{blueprint['name']}\"`",reset,"\n"
     end
-    print reset,"\n"
+    # print reset,"\n"
+    print reset
   end
 
   # this parses the environments => groups => clouds tree structure

data/lib/morpheus/cli/budgets_command.rb

@@ -570,16 +570,16 @@ class Morpheus::Cli::BudgetsCommand
       {'fieldName' => 'description', 'fieldLabel' => 'Description', 'type' => 'text', 'displayOrder' => 1},
       # {'fieldName' => 'enabled', 'fieldLabel' => 'Enabled', 'type' => 'checkbox', 'defaultValue' => true},
       {'fieldName' => 'scope', 'fieldLabel' => 'Scope', 'code' => 'budget.scope', 'type' => 'select', 'selectOptions' => [{'name'=>'Account','value'=>'account'},{'name'=>'Tenant','value'=>'tenant'},{'name'=>'Cloud','value'=>'cloud'},{'name'=>'Group','value'=>'group'},{'name'=>'User','value'=>'user'}], 'defaultValue' => 'account', 'required' => true, 'displayOrder' => 3},
-      {'fieldName' => 'tenant', 'fieldLabel' => 'Tenant', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'tenant', 'fieldLabel' => 'Tenant', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("tenants", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:tenant', 'displayOrder' => 4},
-      {'fieldName' => 'user', 'fieldLabel' => 'User', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'user', 'fieldLabel' => 'User', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params|
         @options_interface.options_for_source("users", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:user', 'displayOrder' => 5},
-      {'fieldName' => 'group', 'fieldLabel' => 'Group', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'group', 'fieldLabel' => 'Group', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("groups", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:group', 'displayOrder' => 6},
-      {'fieldName' => 'cloud', 'fieldLabel' => 'Cloud', 'type' => 'select', 'optionSource' => lambda { 
+      {'fieldName' => 'cloud', 'fieldLabel' => 'Cloud', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
         @options_interface.options_for_source("clouds", {})['data']
       }, 'required' => true, 'dependsOnCode' => 'budget.scope:cloud', 'displayOrder' => 7},
       {'fieldName' => 'year', 'fieldLabel' => 'Period', 'type' => 'text', 'required' => true, 'defaultValue' => Time.now.year, 'description' => "The period (year) the budget applies to. Default is the current year.", 'displayOrder' => 8},

data/lib/morpheus/cli/catalog_command.rb

@@ -0,0 +1,507 @@
+require 'morpheus/cli/cli_command'
+
+# CLI command self service
+# UI is Tools: Self Service - Catalog Items
+# API is /catalog-item-types and returns catalogItemTypes
+class Morpheus::Cli::CatalogCommand
+  include Morpheus::Cli::CliCommand
+  include Morpheus::Cli::CatalogHelper
+  include Morpheus::Cli::LibraryHelper
+  include Morpheus::Cli::OptionSourceHelper
+
+  # hide until 5.1 when update api is fixed and service-catalog endpoints are available
+  set_command_hidden  
+  set_command_name :'catalog'
+
+  register_subcommands :list, :get, :add, :update, :remove
+  
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @catalog_item_types_interface = @api_client.catalog_item_types
+    @option_types_interface = @api_client.option_types
+  end
+
+  def handle(args)
+    handle_subcommand(args)
+  end
+
+  def list(args)
+    options = {}
+    params = {}
+    ref_ids = []
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[search]")
+      opts.on( '--enabled [on|off]', String, "Filter by enabled" ) do |val|
+        params['enabled'] = (val.to_s != 'false' && val.to_s != 'off')
+      end
+      opts.on( '--featured [on|off]', String, "Filter by featured" ) do |val|
+        params['featured'] = (val.to_s != 'false' && val.to_s != 'off')
+      end
+      build_standard_list_options(opts, options)
+      opts.footer = "List catalog items."
+    end
+    optparse.parse!(args)
+    connect(options)
+    # verify_args!(args:args, optparse:optparse, count:0)
+    if args.count > 0
+      options[:phrase] = args.join(" ")
+    end
+    params.merge!(parse_list_options(options))
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.list(params)
+      return
+    end
+    json_response = @catalog_item_types_interface.list(params)
+    catalog_item_types = json_response[catalog_item_type_list_key]
+    render_response(json_response, options, catalog_item_type_list_key) do
+      print_h1 "Morpheus Catalog Items", parse_list_subtitles(options), options
+      if catalog_item_types.empty?
+        print cyan,"No catalog items found.",reset,"\n"
+      else
+        list_columns = catalog_item_type_column_definitions.upcase_keys!
+        #list_columns["Config"] = lambda {|it| truncate_string(it['config'], 100) }
+        print as_pretty_table(catalog_item_types, list_columns.upcase_keys!, options)
+        print_results_pagination(json_response)
+      end
+      print reset,"\n"
+    end
+    if catalog_item_types.empty?
+      return 1, "no catalog items found"
+    else
+      return 0, nil
+    end
+  end
+  
+  def get(args)
+    params = {}
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type]")
+      opts.on( '-c', '--config', "Display raw config only. Default is YAML. Combine with -j for JSON instead." ) do
+        options[:show_config] = true
+      end
+      # opts.on('--no-config', "Do not display config content." ) do
+      #   options[:no_config] = true
+      # end
+      build_standard_get_options(opts, options)
+      opts.footer = <<-EOT
+Get details about a specific catalog item type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:1)
+    connect(options)
+    id_list = parse_id_list(args)
+    return run_command_for_each_arg(id_list) do |arg|
+      _get(arg, params, options)
+    end
+  end
+
+  def _get(id, params, options)
+    catalog_item_type = nil
+    if id.to_s !~ /\A\d{1,}\Z/
+      catalog_item_type = find_catalog_item_type_by_name(id)
+      return 1, "catalog item type not found for #{id}" if catalog_item_type.nil?
+      id = catalog_item_type['id']
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.get(id, params)
+      return
+    end
+    # skip extra query, list has same data as show right now
+    if catalog_item_type
+      json_response = {catalog_item_type_object_key => catalog_item_type}
+    else
+      json_response = @catalog_item_types_interface.get(id, params)
+    end
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    config = catalog_item_type['config'] || {}
+    # export just the config as json or yaml (default)
+    if options[:show_config]
+      unless options[:json] || options[:yaml] || options[:csv]
+        options[:yaml] = true
+      end
+      return render_with_format(config, options)
+    end
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_h1 "Catalog Item Type Details", [], options
+      print cyan
+      show_columns = catalog_item_type_column_definitions
+      show_columns.delete("Blueprint") unless catalog_item_type['blueprint']
+      print_description_list(show_columns, catalog_item_type)
+
+      if catalog_item_type['optionTypes'] && catalog_item_type['optionTypes'].size > 0
+        print_h2 "Option Types"
+        opt_columns = [
+          {"ID" => lambda {|it| it['id'] } },
+          {"NAME" => lambda {|it| it['name'] } },
+          {"TYPE" => lambda {|it| it['type'] } },
+          {"FIELD NAME" => lambda {|it| it['fieldName'] } },
+          {"FIELD LABEL" => lambda {|it| it['fieldLabel'] } },
+          {"DEFAULT" => lambda {|it| it['defaultValue'] } },
+          {"REQUIRED" => lambda {|it| format_boolean it['required'] } },
+        ]
+        print as_pretty_table(catalog_item_type['optionTypes'], opt_columns)
+      else
+        # print cyan,"No option types found for this catalog item.","\n",reset
+      end
+
+      if config && options[:no_config] != true
+        print_h2 "Config YAML"
+        #print reset,(JSON.pretty_generate(config) rescue config),"\n",reset
+        #print reset,(as_yaml(config, options) rescue config),"\n",reset
+        config_string = as_yaml(config, options) rescue config
+        config_lines = config_string.split("\n")
+        config_line_count = config_lines.size
+        max_lines = 10
+        if config_lines.size > max_lines
+          config_string = config_lines.first(max_lines).join("\n")
+          config_string << "\n\n"
+          config_string << "(#{(config_line_count - max_lines)} more lines were not shown, use -c to show the config)"
+          #config_string << "\n"
+        end
+        # strip --- yaml header
+        if config_string[0..3] == "---\n"
+          config_string = config_string[4..-1]
+        end
+        print reset,config_string.chomp("\n"),"\n",reset
+      end
+
+      print reset,"\n"
+    end
+    return 0, nil
+  end
+
+  def add(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[name] [options]")
+      build_option_type_options(opts, options, add_catalog_item_type_option_types)
+      opts.on('--config-file FILE', String, "Config from a local JSON or YAML file") do |val|
+        options[:config_file] = val.to_s
+        file_content = nil
+        full_filename = File.expand_path(options[:config_file])
+        if File.exists?(full_filename)
+          file_content = File.read(full_filename)
+        else
+          print_red_alert "File not found: #{full_filename}"
+          return 1
+        end
+        parse_result = parse_json_or_yaml(file_content)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+          options[:options]['config'] = params['config'] # or file_content
+        end
+      end
+      opts.on('--option-types [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.on('--optionTypes [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.add_hidden_option('--optionTypes')
+      build_option_type_options(opts, options, add_catalog_item_type_advanced_option_types)
+      build_standard_add_options(opts, options)
+      opts.footer = <<-EOT
+Create a new catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:0, max:1)
+    options[:options]['name'] = args[0] if args[0]
+    connect(options)
+    payload = {}
+    if options[:payload]
+      payload = options[:payload]
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+    else
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+      v_prompt = Morpheus::Cli::OptionTypes.prompt(add_catalog_item_type_option_types(), options[:options], @api_client, options[:params])
+      params.deep_merge!(v_prompt)
+      advanced_config = Morpheus::Cli::OptionTypes.no_prompt(add_catalog_item_type_advanced_option_types, options[:options], @api_client, options[:params])
+      advanced_config.deep_compact!
+      params.deep_merge!(advanced_config)
+      # convert checkbox "on" and "off" to true and false
+      params.booleanize!
+      # convert type to refType until api accepts type
+      if params['type'] && !params['refType']
+        if params['type'].to_s.downcase == 'blueprint'
+          params['refType'] = 'AppTemplate'
+        else
+          params['refType'] = 'InstanceType'
+        end
+      end
+      # convert config string to a map
+      config = params['config']
+      if config && config.is_a?(String)
+        parse_result = parse_json_or_yaml(config)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+        end
+      end
+      if params['optionTypes']
+        # todo: move to optionSource, so it will be /api/options/optionTypes  lol
+        prompt_results = prompt_for_option_types(params, options, @api_client)
+        if prompt_results[:success]
+          params['optionTypes'] = prompt_results[:data] unless prompt_results[:data].nil?
+        else
+          return 1
+        end
+      end
+      payload[catalog_item_type_object_key].deep_merge!(params)
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.create(payload)
+      return 0, nil
+    end
+    json_response = @catalog_item_types_interface.create(payload)
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_green_success "Added catalog item #{catalog_item_type['name']}"
+      return _get(catalog_item_type["id"], {}, options)
+    end
+    return 0, nil
+  end
+
+  def update(args)
+    options = {}
+    params = {}
+    payload = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type] [options]")
+      build_option_type_options(opts, options, update_catalog_item_type_option_types)
+      opts.on('--config-file FILE', String, "Config from a local JSON or YAML file") do |val|
+        options[:config_file] = val.to_s
+        file_content = nil
+        full_filename = File.expand_path(options[:config_file])
+        if File.exists?(full_filename)
+          file_content = File.read(full_filename)
+        else
+          print_red_alert "File not found: #{full_filename}"
+          return 1
+        end
+        parse_result = parse_json_or_yaml(file_content)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+          options[:options]['config'] = params['config'] # or file_content
+        end
+      end
+      opts.on('--option-types [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.on('--optionTypes [x,y,z]', Array, "List of Option Type IDs") do |list|
+        if list.nil?
+          params['optionTypes'] = []
+        else
+          params['optionTypes'] = list.collect {|it| it.to_s.strip.empty? ? nil : it.to_s.strip }.compact.uniq
+        end
+      end
+      opts.add_hidden_option('--optionTypes')
+      build_option_type_options(opts, options, update_catalog_item_type_advanced_option_types)
+      build_standard_update_options(opts, options)
+      opts.footer = <<-EOT
+Update a catalog item type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+    catalog_item_type = find_catalog_item_type_by_name_or_id(args[0])
+    return 1 if catalog_item_type.nil?
+    payload = {}
+    if options[:payload]
+      payload = options[:payload]
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+    else
+      payload.deep_merge!({catalog_item_type_object_key => parse_passed_options(options)})
+      # do not prompt on update
+      v_prompt = Morpheus::Cli::OptionTypes.no_prompt(update_catalog_item_type_option_types, options[:options], @api_client, options[:params])
+      v_prompt.deep_compact!
+      params.deep_merge!(v_prompt)
+      advanced_config = Morpheus::Cli::OptionTypes.no_prompt(update_catalog_item_type_advanced_option_types, options[:options], @api_client, options[:params])
+      advanced_config.deep_compact!
+      params.deep_merge!(advanced_config)
+      # convert checkbox "on" and "off" to true and false
+      params.booleanize!
+      # convert type to refType until api accepts type
+      if params['type'] && !params['refType']
+        if params['type'].to_s.downcase == 'blueprint'
+          params['refType'] = 'AppTemplate'
+        else
+          params['refType'] = 'InstanceType'
+        end
+      end
+      # convert config string to a map
+      config = params['config']
+      if config && config.is_a?(String)
+        parse_result = parse_json_or_yaml(config)
+        config_map = parse_result[:data]
+        if config_map.nil?
+          # todo: bubble up JSON.parse error message
+          raise_command_error "Failed to parse config as YAML or JSON. Error: #{parse_result[:err]}"
+          #raise_command_error "Failed to parse config as valid YAML or JSON."
+        else
+          params['config'] = config_map
+        end
+      end
+      payload.deep_merge!({catalog_item_type_object_key => params})
+      if payload[catalog_item_type_object_key].empty? # || options[:no_prompt]
+        raise_command_error "Specify at least one option to update.\n#{optparse}"
+      end
+    end
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.update(catalog_item_type['id'], payload)
+      return
+    end
+    json_response = @catalog_item_types_interface.update(catalog_item_type['id'], payload)
+    catalog_item_type = json_response[catalog_item_type_object_key]
+    render_response(json_response, options, catalog_item_type_object_key) do
+      print_green_success "Updated catalog item #{catalog_item_type['name']}"
+      return _get(catalog_item_type["id"], {}, options)
+    end
+    return 0, nil
+  end
+
+  def remove(args)
+    options = {}
+    params = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[catalog item type] [options]")
+      build_standard_remove_options(opts, options)
+      opts.footer = <<-EOT
+Delete a catalog_item_type.
+[catalog item type] is required. This is the name or id of a catalog item type.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, count:1)
+    connect(options)
+    catalog_item_type = find_catalog_item_type_by_name_or_id(args[0])
+    return 1 if catalog_item_type.nil?
+    @catalog_item_types_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @catalog_item_types_interface.dry.destroy(catalog_item_type['id'], params)
+      return
+    end
+    unless options[:yes] || Morpheus::Cli::OptionTypes.confirm("Are you sure you want to delete the catalog item #{catalog_item_type['name']}?")
+      return 9, "aborted command"
+    end
+    json_response = @catalog_item_types_interface.destroy(catalog_item_type['id'], params)
+    render_response(json_response, options) do
+      print_green_success "Removed catalog item #{catalog_item_type['name']}"
+    end
+    return 0, nil
+  end
+
+  private
+
+  def catalog_item_type_column_definitions()
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Description" => 'description',
+      "Type" => lambda {|it| format_catalog_type(it) },
+      "Blueprint" => lambda {|it| it['blueprint'] ? it['blueprint']['name'] : nil },
+      "Enabled" => lambda {|it| format_boolean(it['enabled']) },
+      "Featured" => lambda {|it| format_boolean(it['featured']) },
+      #"Config" => lambda {|it| it['config'] },
+      "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+      "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+    }
+  end
+
+  def format_catalog_type(catalog_item_type)
+    out = ""
+    # api "blueprint": {"name":my blueprint"} }
+    # instead of cryptic refType
+    if catalog_item_type['type']
+      if catalog_item_type['type'].is_a?(String)
+        out << catalog_item_type['type'].to_s.capitalize
+      else
+        out << (catalog_item_type['type']['name'] || catalog_item_type['type']['code']) rescue catalog_item_type['type'].to_s
+      end
+    else
+      ref_type = catalog_item_type['refType']
+      if ref_type == 'InstanceType'
+        out << "Instance"
+      elsif ref_type == 'AppTemplate'
+        out << "Blueprint"
+      elsif ref_type
+        out << ref_type
+      else
+        "(none)"
+      end
+    end
+    out
+  end
+
+  # this is not so simple, need to first choose select instance, host or provider
+  def add_catalog_item_type_option_types
+    [
+      {'fieldName' => 'name', 'fieldLabel' => 'Name', 'type' => 'text', 'required' => true},
+      {'fieldName' => 'description', 'fieldLabel' => 'Description', 'type' => 'text'},
+      {'fieldName' => 'type', 'fieldLabel' => 'Type', 'type' => 'select', 'selectOptions' => [{'name' => 'Instance', 'value' => 'instance'}, {'name' => 'Blueprint', 'value' => 'blueprint'}], 'defaultValue' => 'instance'},
+      {'fieldName' => 'enabled', 'fieldLabel' => 'Enabled', 'type' => 'checkbox', 'defaultValue' => true},
+      {'fieldName' => 'featured', 'fieldLabel' => 'Featured', 'type' => 'checkbox', 'defaultValue' => false},
+      {'fieldName' => 'visibility', 'fieldLabel' => 'Visibility', 'type' => 'select', 'selectOptions' => [{'name' => 'Private', 'value' => 'private'}, {'name' => 'Public', 'value' => 'public'}], 'defaultValue' => 'private', 'required' => true},
+      {'fieldName' => 'iconPath', 'fieldLabel' => 'Logo', 'type' => 'select', 'optionSource' => 'iconList'},
+      #{'fieldName' => 'optionTypes', 'fieldLabel' => 'Option Types', 'type' => 'text', 'description' => 'Option Types to include, comma separated list of names or IDs.'},
+      {'fieldName' => 'config', 'fieldLabel' => 'Config', 'type' => 'code-editor', 'required' => true, 'description' => 'JSON or YAML'}
+    ]
+  end
+
+  def add_catalog_item_type_advanced_option_types
+    []
+  end
+
+  def update_catalog_item_type_option_types
+    add_catalog_item_type_option_types.collect {|it|
+      it.delete('required')
+      it.delete('defaultValue')
+      it
+    }
+  end
+
+  def update_catalog_item_type_advanced_option_types
+    add_catalog_item_type_advanced_option_types.collect {|it|
+      it.delete('required')
+      it.delete('defaultValue')
+      it
+    }
+  end
+
+end