morpheus-cli 6.1.0 → 6.1.2

data/lib/morpheus/cli/commands/security_groups.rb

@@ -210,6 +210,7 @@ class Morpheus::Cli::SecurityGroups
     params = {}
     options = {:options => {}}
     cloud_id = nil
+    resource_pool_id = nil
     tenants = nil
     group_access_all = nil
     group_access_list = nil
@@ -225,6 +226,9 @@ class Morpheus::Cli::SecurityGroups
       opts.on( '-c', '--cloud CLOUD', "Scoped Cloud Name or ID" ) do |val|
         cloud_id = val
       end
+      opts.on( '--resource-pool ID', String, "ID of the Resource Pool for Amazon VPC and Azure Resource Group" ) do |val|
+        resource_pool_id = val
+      end
       opts.on('--group-access-all [on|off]', String, "Toggle Access for all groups.") do |val|
         group_access_all = val.to_s == 'on' || val.to_s == 'true' || val.to_s == ''
       end
@@ -321,17 +325,20 @@ class Morpheus::Cli::SecurityGroups
           if !v_prompt['zoneId'].to_s.empty? && v_prompt['zoneId'].to_s != 'all' && v_prompt['zoneId'].to_s != '-1'
             payload['securityGroup']['zoneId'] = v_prompt['zoneId']
 
-            zone = find_cloud_by_id(payload['securityGroup']['zoneId'])
-            # networkServer needed here too? err
-            if zone['securityServer']
-              sec_server = @network_security_servers.get(zone['securityServer']['id'])['networkSecurityServer']
-
-              if sec_server['type']
-                payload['securityGroup'].deep_merge!(Morpheus::Cli::OptionTypes.prompt(sec_server['type']['optionTypes'], options[:options], @api_client, {zoneId: zone['id']}))
-              end
-            end
+            cloud = find_cloud_by_id(payload['securityGroup']['zoneId'])
+            
+            # parse --resource-pool
+            # if resource_pool_id
+            #   resource_pool = find_resource_pool_by_name_or_id(cloud['id'], resource_pool_id)
+            #   return 1 if resource_pool.nil?
+            # end
+
+            # prompt for zone specific settings that go under "securityGroup.customOptions" for some reason
+            custom_options_values = prompt_security_group_custom_options(options, cloud, resource_pool_id)
+            payload['securityGroup'].deep_merge!(custom_options_values)
           end
         rescue => ex
+          # raise ex
           print yellow,"Failed to determine the available scoped clouds.",reset,"\n"
         end
 
@@ -626,34 +633,8 @@ class Morpheus::Cli::SecurityGroups
         #   return 1 if resource_pool.nil?
         # end
 
-        # Custom Options prompt
-        # securityServer is no longer used, it has been replaced by networkServer, 
-        # default to the cloud type code, since it's the same...
-        # no optionTypes returned here, so hard coded by type
-        network_server_type = cloud['networkServer'] ? cloud['networkServer']['type'] : (cloud['securityServer'] ? cloud['securityServer']['type'] : cloud["zoneType"]["code"])
-        custom_options_values = {}
-        if network_server_type == 'amazon'
-          if cloud['config'] && !cloud['config']['vpc'].to_s.empty?
-            custom_options_values.deep_merge!({'customOptions' => {'vpc' => cloud['config']['vpc']} })
-          else
-            options[:options].deep_merge!({'customOptions' => {'vpc' => resource_pool_id} }) if resource_pool_id
-            custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'vpc', 'fieldLabel' => 'VPC', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true, 'config' => {'valueField' => 'externalId'}}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
-          end
-        elsif network_server_type == 'azure' || network_server_type == 'azurestack'
-          if cloud['config'] && !cloud['config']['resourceGroup'].to_s.empty?
-            custom_options_values.deep_merge!({'customOptions' => {'resourceGroup' => cloud['config']['resourceGroup']} })
-          else
-            options[:options].deep_merge!({'customOptions' => {'resourceGroup' => resource_pool_id} }) if resource_pool_id
-            custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'resourceGroup', 'fieldLabel' => 'Resource Group', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true, 'config' => {'valueField' => 'externalId'}}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
-          end
-        elsif network_server_type == 'openstack' || network_server_type == 'opentelekom' || network_server_type == 'huawei'
-          if cloud['config'] && !cloud['config']['resourcePoolId'].to_s.empty?
-            custom_options_values.deep_merge!({'customOptions' => {'resourcePoolId' => cloud['config']['resourcePoolId']} })
-          else
-            options[:options].deep_merge!({'customOptions' => {'resourcePoolId' => resource_pool_id} }) if resource_pool_id
-            custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'resourcePoolId', 'fieldLabel' => 'Resource Pool', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
-          end
-        end
+        # prompt for zone specific settings that go under "securityGroup.customOptions" for some reason
+        custom_options_values = prompt_security_group_custom_options(options, cloud, resource_pool_id)
         payload['securityGroupLocation'].deep_merge!(custom_options_values)
       end
       @security_groups_interface.setopts(options)
@@ -1270,4 +1251,44 @@ class Morpheus::Cli::SecurityGroups
     end
   end
 
+  def prompt_security_group_custom_options(options, cloud, resource_pool_id=nil)
+    custom_options_values = {}
+    # Custom Options prompt
+    # securityServer is no longer used, it has been replaced by networkServer, 
+    # default to the cloud type code, since it's the same...
+    # no optionTypes returned here, so hard coded by type
+    # The API used to return securityServer which could be fetched to get its optionTypes
+    if cloud['securityServer']
+      sec_server = @network_security_servers.get(cloud['securityServer']['id'])['networkSecurityServer']
+      if sec_server['type']
+        v_prompt = Morpheus::Cli::OptionTypes.prompt(sec_server['type']['optionTypes'], options[:options], @api_client, {zoneId: cloud['id']})
+        custom_options_values.deep_merge!(v_prompt)
+      end
+    else
+      network_server_type = cloud['networkServer'] ? cloud['networkServer']['type'] : (cloud['securityServer'] ? cloud['securityServer']['type'] : cloud["zoneType"]["code"])
+      if network_server_type == 'amazon'
+        if cloud['config'] && !cloud['config']['vpc'].to_s.empty?
+          custom_options_values.deep_merge!({'customOptions' => {'vpc' => cloud['config']['vpc']} })
+        else
+          options[:options].deep_merge!({'customOptions' => {'vpc' => resource_pool_id} }) if resource_pool_id
+          custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'vpc', 'fieldLabel' => 'VPC', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true, 'config' => {'valueField' => 'externalId'}}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
+        end
+      elsif network_server_type == 'azure' || network_server_type == 'azurestack'
+        if cloud['config'] && !cloud['config']['resourceGroup'].to_s.empty?
+          custom_options_values.deep_merge!({'customOptions' => {'resourceGroup' => cloud['config']['resourceGroup']} })
+        else
+          options[:options].deep_merge!({'customOptions' => {'resourceGroup' => resource_pool_id} }) if resource_pool_id
+          custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'resourceGroup', 'fieldLabel' => 'Resource Group', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true, 'config' => {'valueField' => 'externalId'}}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
+        end
+      elsif network_server_type == 'openstack' || network_server_type == 'opentelekom' || network_server_type == 'huawei'
+        if cloud['config'] && !cloud['config']['resourcePoolId'].to_s.empty?
+          custom_options_values.deep_merge!({'customOptions' => {'resourcePoolId' => cloud['config']['resourcePoolId']} })
+        else
+          options[:options].deep_merge!({'customOptions' => {'resourcePoolId' => resource_pool_id} }) if resource_pool_id
+          custom_options_values = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'customOptions', 'fieldName' => 'resourcePoolId', 'fieldLabel' => 'Resource Pool', 'type' => 'select', 'optionSource' => 'zonePools', 'required' => true}], options[:options], @api_client, {zoneId: cloud['id'], ignoreDefaultPool: true})
+        end
+      end
+    end
+    return custom_options_values
+  end
 end

data/lib/morpheus/cli/commands/users.rb

@@ -297,7 +297,29 @@ EOT
             if access.count > 0
               access.each {|it| it['access'] = format_access_string(it['access'], available_access_levels)}
 
-              if ['features', 'instance_types'].include?(field)
+              if ['features'].include?(field)
+                if access.find {|it| !it['subCategory'].to_s.empty? }
+                  rows = access.collect do |it|
+                    {
+                      code: it['code'],
+                      name: it['name'],
+                      category: it['subCategory'].to_s.titleize,
+                      access: format_access_string(it['access']),
+                    }
+                  end
+                  if options[:sort]
+                    rows.sort! {|a,b| a[options[:sort]] <=> b[options[:sort]] }
+                  else
+                    rows.sort! {|a,b| [a[:category],a[:name],a[:code]] <=> [b[:category],b[:name],b[:code]] }
+                  end
+                  if options[:direction] == 'desc'
+                    rows.reverse!
+                  end
+                  print as_pretty_table(rows, [:category, :name, :code, :access], options)
+                else
+                  print as_pretty_table(access, [:name, :code, :access], options)
+                end
+              elsif ['instance_types','report_types'].include?(field)
                 print as_pretty_table(access, [:name, :code, :access], options)
               else
                 print as_pretty_table(access, [:name, :access], options)
@@ -422,7 +444,29 @@ EOT
             if access.count > 0
               access.each {|it| it['access'] = format_access_string(it['access'], available_access_levels)}
 
-              if ['features', 'instance_types', 'report_types'].include?(field)
+              if ['features'].include?(field)
+                if access.find {|it| !it['subCategory'].to_s.empty? }
+                  rows = access.collect do |it|
+                    {
+                      code: it['code'],
+                      name: it['name'],
+                      category: it['subCategory'].to_s.titleize,
+                      access: format_access_string(it['access']),
+                    }
+                  end
+                  if options[:sort]
+                    rows.sort! {|a,b| a[options[:sort]] <=> b[options[:sort]] }
+                  else
+                    rows.sort! {|a,b| [a[:category],a[:name],a[:code]] <=> [b[:category],b[:name],b[:code]] }
+                  end
+                  if options[:direction] == 'desc'
+                    rows.reverse!
+                  end
+                  print as_pretty_table(rows, [:category, :name, :code, :access], options)
+                else
+                  print as_pretty_table(access, [:name, :code, :access], options)
+                end
+              elsif ['instance_types','report_types'].include?(field)
                 print as_pretty_table(access, [:name, :code, :access], options)
               else
                 print as_pretty_table(access, [:name, :access], options)

data/lib/morpheus/cli/mixins/provisioning_helper.rb

@@ -719,7 +719,7 @@ module Morpheus::Cli::ProvisioningHelper
     service_plan = nil
 
     prompt_service_plan = -> {
-      service_plans_json = instances_interface.service_plans({zoneId: cloud_id, layoutId: layout['id'], siteId: group_id}.merge(resource_pool.nil? ? {} : {'resourcePoolId' => resource_pool['id']}))
+      service_plans_json = instances_interface.service_plans({zoneId: cloud_id, layoutId: layout['id'], siteId: group_id}.merge(resource_pool.nil? ? {} : {'poolId' => resource_pool['id'], 'resourcePoolId' => resource_pool['id']}))
       service_plans = service_plans_json["plans"]
       if locked_fields.include?('plan.id')
         plan_id = options[:options]['plan']['id'] rescue nil
@@ -773,8 +773,8 @@ module Morpheus::Cli::ProvisioningHelper
         has_zone_pools = provision_type && provision_type["id"] && provision_type["hasZonePools"]
         if has_zone_pools
           # pluck out the resourcePoolId option type to prompt for
-          resource_pool_option_type = option_type_list.find {|opt| ['resourcePool','resourcePoolId','azureResourceGroupId'].include?(opt['fieldName']) }
-          option_type_list = option_type_list.reject {|opt| ['resourcePool','resourcePoolId','azureResourceGroupId'].include?(opt['fieldName']) }
+          resource_pool_option_type = option_type_list.find {|opt| ['poolId','resourcePool','resourcePoolId','azureResourceGroupId'].include?(opt['fieldName']) }
+          option_type_list = option_type_list.reject {|opt| ['poolId','resourcePool','resourcePoolId','azureResourceGroupId'].include?(opt['fieldName']) }
 
           resource_pool_options = options_interface.options_for_source('zonePools', {groupId: group_id, siteId: group_id, zoneId: cloud_id, cloudId: cloud_id, instanceTypeId: instance_type['id'], layoutId: layout["id"]}.merge(service_plan.nil? ? {} : {planId: service_plan["id"]}))['data']
           if options[:resource_pool]
@@ -836,7 +836,7 @@ module Morpheus::Cli::ProvisioningHelper
       # add selectable datastores for resource pool
       if options[:select_datastore]
         begin
-          selectable_datastores = datastores_interface.list({'zoneId' => cloud_id, 'siteId' => group_id, 'resourcePoolId' => resource_pool['id']})
+          selectable_datastores = datastores_interface.list({'zoneId' => cloud_id, 'siteId' => group_id, 'poolId' => resource_pool['id'], 'resourcePoolId' => resource_pool['id']})
           service_plan['datastores'] = {'clusters' => [], 'datastores' => []}
           ['clusters', 'datastores'].each do |type|
             service_plan['datastores'][type] ||= []
@@ -1538,7 +1538,7 @@ module Morpheus::Cli::ProvisioningHelper
             
             if datastore_options.empty? && storage_type['hasDatastore'] != false
               begin
-                datastore_res = datastores_interface.list({'resourcePoolId' => current_root_volume['resourcePoolId'], 'zoneId' => options['zoneId'], 'siteId' => options['siteId']})['datastores']
+                datastore_res = datastores_interface.list({'poolId' => current_root_volume['resourcePoolId'], 'resourcePoolId' => current_root_volume['resourcePoolId'], 'zoneId' => options['zoneId'], 'siteId' => options['siteId']})['datastores']
                 datastore_res.each do |opt|
                   datastore_options << {'name' => opt['name'], 'value' => opt['id']}
                 end
@@ -1578,7 +1578,7 @@ module Morpheus::Cli::ProvisioningHelper
     no_prompt = (options[:no_prompt] || (options[:options] && options[:options][:no_prompt]))
     network_interfaces = []
     api_params = {zoneId: zone_id, provisionTypeId: provision_type_id}.merge(options[:api_params] || {})
-    if pool_id.to_s =~ /\A\d{1,}\Z/
+    if pool_id
       api_params[:poolId] = pool_id 
     end
 

data/lib/morpheus/cli/version.rb

@@ -1,6 +1,6 @@
 
 module Morpheus
   module Cli
-    VERSION = "6.1.0"
+    VERSION = "6.1.2"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: morpheus-cli
 version: !ruby/object:Gem::Version
-  version: 6.1.0
+  version: 6.1.2
 platform: ruby
 authors:
 - David Estes
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-20 00:00:00.000000000 Z
+date: 2023-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -226,7 +226,6 @@ files:
 - lib/morpheus/api/datastores_interface.rb
 - lib/morpheus/api/deploy_interface.rb
 - lib/morpheus/api/deployments_interface.rb
-- lib/morpheus/api/doc_interface.rb
 - lib/morpheus/api/environments_interface.rb
 - lib/morpheus/api/execute_schedules_interface.rb
 - lib/morpheus/api/execution_request_interface.rb
@@ -260,7 +259,9 @@ files:
 - lib/morpheus/api/library_spec_templates_interface.rb
 - lib/morpheus/api/license_interface.rb
 - lib/morpheus/api/load_balancer_monitors_interface.rb
+- lib/morpheus/api/load_balancer_pool_nodes_interface.rb
 - lib/morpheus/api/load_balancer_pools_interface.rb
+- lib/morpheus/api/load_balancer_pools_secondary_interface.rb
 - lib/morpheus/api/load_balancer_profiles_interface.rb
 - lib/morpheus/api/load_balancer_types_interface.rb
 - lib/morpheus/api/load_balancer_virtual_servers_interface.rb
@@ -398,7 +399,6 @@ files:
 - lib/morpheus/cli/commands/deploy.rb
 - lib/morpheus/cli/commands/deployments.rb
 - lib/morpheus/cli/commands/deploys.rb
-- lib/morpheus/cli/commands/doc.rb
 - lib/morpheus/cli/commands/echo_command.rb
 - lib/morpheus/cli/commands/edit_profile_command.rb
 - lib/morpheus/cli/commands/edit_rc_command.rb
@@ -434,6 +434,7 @@ files:
 - lib/morpheus/cli/commands/library_upgrades_command.rb
 - lib/morpheus/cli/commands/license.rb
 - lib/morpheus/cli/commands/load_balancer_monitors.rb
+- lib/morpheus/cli/commands/load_balancer_pool_nodes.rb
 - lib/morpheus/cli/commands/load_balancer_pools.rb
 - lib/morpheus/cli/commands/load_balancer_profiles.rb
 - lib/morpheus/cli/commands/load_balancer_types.rb
@@ -575,14 +576,12 @@ files:
 - lib/morpheus/util.rb
 - morpheus-cli.gemspec
 - test/api/containers_interface_test.rb
-- test/api/doc_interface_test.rb
 - test/api/instances_interface_test.rb
 - test/api/whoami_interface_test.rb
 - test/cli/access_token_test.rb
 - test/cli/auth_test.rb
 - test/cli/cli_test.rb
 - test/cli/containers_test.rb
-- test/cli/doc_test.rb
 - test/cli/help_test.rb
 - test/cli/instances_test.rb
 - test/cli/man_test.rb
@@ -621,14 +620,12 @@ specification_version: 4
 summary: Provides CLI Interface to the Morpheus Public/Private Cloud Appliance
 test_files:
 - test/api/containers_interface_test.rb
-- test/api/doc_interface_test.rb
 - test/api/instances_interface_test.rb
 - test/api/whoami_interface_test.rb
 - test/cli/access_token_test.rb
 - test/cli/auth_test.rb
 - test/cli/cli_test.rb
 - test/cli/containers_test.rb
-- test/cli/doc_test.rb
 - test/cli/help_test.rb
 - test/cli/instances_test.rb
 - test/cli/man_test.rb

data/lib/morpheus/api/doc_interface.rb

@@ -1,50 +0,0 @@
-require 'morpheus/api/api_client'
-
-class Morpheus::DocInterface < Morpheus::APIClient
-
-  def list(params={})
-    url = "/api/doc"
-    headers = {params: params}
-    execute(method: :get, url: url, headers: headers)
-  end
-
-  def openapi(params={})
-    url = "/api/doc/openapi"
-    fmt = params.delete('format')
-    if fmt
-      url = url + "." + fmt
-    end
-    is_yaml = fmt == "yml" || fmt == "yaml"
-    headers = {params: params}
-    execute(method: :get, url: url, headers: headers, timeout: 172800, parse_json: !is_yaml)
-  end
-
-  def download_openapi(outfile, params={})
-    # note that RestClient.execute still requires the full path with base_url
-    url = "#{@base_url}/api/doc/openapi"
-    fmt = params.delete('format')
-    if fmt
-      url = url + "." + fmt
-    end
-    headers = {params: params, authorization: "Bearer #{@access_token}"}
-    opts = {method: :get, url: url, headers: headers, timeout: 172800, parse_json: false}
-
-    if @dry_run
-      return opts
-    end
-
-    http_response = nil
-    File.open(File.expand_path(outfile), 'w') {|f|
-      block = proc { |response|
-        response.read_body do |chunk|
-          # writing to #{outfile} ..."
-          f.write chunk
-        end
-      }
-      opts[:block_response] = block
-      http_response = Morpheus::RestClient.execute(opts)
-    }
-    http_response
-  end
-
-end

data/lib/morpheus/cli/commands/doc.rb

@@ -1,182 +0,0 @@
-require 'morpheus/cli/cli_command'
-
-# This provides commands for authentication 
-# This also includes credential management.
-class Morpheus::Cli::Doc
-  include Morpheus::Cli::CliCommand
-
-  set_command_name :'doc'
-  register_subcommands :list
-  register_subcommands :get => :openapi
-  register_subcommands :download => :download_openapi
-
-  # hidden until doc complete (or close to it)
-  set_command_hidden
-
-  def initialize()
-    # @appliance_name, @appliance_url = Morpheus::Cli::Remote.active_appliance
-  end
-
-  def handle(args)
-    handle_subcommand(args)
-  end
-
-  def connect(options)
-    # @api_client = establish_remote_appliance_connection(options.merge({:no_prompt => true, :skip_verify_access_token => true, :skip_login => true}))
-    @api_client = establish_remote_appliance_connection(options)
-    @doc_interface = @api_client.doc
-  end
-
-  def list(args)
-    exit_code, err = 0, nil
-    params, options = {}, {}
-    optparse = Morpheus::Cli::OptionParser.new do |opts|
-      opts.banner = subcommand_usage()
-      build_standard_get_options(opts, options)
-      opts.footer = <<-EOT
-List documentation links.
-EOT
-    end
-    optparse.parse!(args)
-    verify_args!(args:args, optparse:optparse, count:0)
-    connect(options)
-    # construct the api request
-    params.merge!(parse_list_options(options))
-    # execute the api request
-    @doc_interface.setopts(options)
-    if options[:dry_run]
-      print_dry_run @doc_interface.dry.list(params)
-      return 0, nil
-    end
-    json_response = @doc_interface.list(params)
-    render_response(json_response, options, "links") do
-      title = "Morpheus Documentation"
-      print_h1 title, options
-      if json_response['links'].empty?
-        print yellow, "No help links found.",reset,"\n"
-      else
-        columns = {
-          "Link Name" => 'name',
-          "URL" => 'url',
-          "Description" => {display_method:'description', max_width: (options[:wrap] ? nil : 50)}, 
-        }
-        print as_pretty_table(json_response['links'], columns.upcase_keys!, options)
-        # print_results_pagination(json_response)
-      end
-      print reset,"\n"
-    end
-    return exit_code, err
-  end
-
-  def openapi(args)
-    exit_code, err = 0, nil
-    params, options = {}, {}
-    optparse = Morpheus::Cli::OptionParser.new do |opts|
-      opts.banner = subcommand_usage()
-      # opts.on(nil, "--refresh", "Refresh the document. By default the openapi.yml and openapi.json are cached by the server.") do
-      #   params['refresh'] = true
-      # end
-      # opts.on('-g', '--generate', "Alias for --refresh") do
-      #   params['refresh'] = true
-      # end
-      build_standard_get_options(opts, options, [], [:csv])
-      opts.footer = <<-EOT
-Print the Morpheus API OpenAPI Documentation (swagger).
-The default format is JSON. Supports json or yaml.
-EOT
-    end
-    optparse.parse!(args)
-    verify_args!(args:args, optparse:optparse, count:0)
-    connect(options)
-    # construct the api request
-    params.merge!(parse_list_options(options))
-    # for now, always use .json, and just convert to yaml for display on cli side
-    openapi_format = options[:yaml] ? "yaml" : "json"
-    # params['format'] = openapi_format
-    # execute the api request
-    @doc_interface.setopts(options)
-    if options[:dry_run]
-      params['format'] = openapi_format
-      print_dry_run @doc_interface.dry.openapi(params)
-      return 0, nil
-    end
-    json_response = @doc_interface.openapi(params)
-    # default format is to print header and json
-    render_response(json_response, options) do
-      title = "Morpheus API openapi.#{openapi_format}"
-      print_h1 title, options
-      print cyan
-      print as_json(json_response, options)
-      print reset,"\n"
-    end
-    return exit_code, err
-  end
-
-  def download_openapi(args)
-    exit_code, err = 0, nil
-    params, options = {}, {}
-    optparse = Morpheus::Cli::OptionParser.new do |opts|
-      opts.banner = subcommand_usage("[local-file]")
-      # build_standard_get_options(opts, options, [], [:csv,:out])
-      opts.on(nil, '--yaml', "YAML Output") do
-        options[:yaml] = true
-        options[:format] = :yaml
-      end
-      # opts.on(nil, "--refresh", "Refresh the document. By default the openapi.yml and openapi.json are cached by the server.") do
-      #   params['refresh'] = true
-      # end
-      # opts.on('-g', '--generate', "Alias for --refresh") do
-      #   params['refresh'] = true
-      # end
-      opts.on( '-f', '--force', "Overwrite existing [local-file] if it exists." ) do
-        options[:overwrite] = true
-      end
-      opts.on( '-p', '--mkdir', "Create missing directories for [local-file] if they do not exist." ) do
-        options[:mkdir] = true
-      end
-      build_common_options(opts, options, [:dry_run, :quiet, :remote])
-      opts.footer = <<-EOT
-Download the Morpheus API OpenAPI Documentation (swagger).
-[local-file] is required. This is the full local filepath for the downloaded file.
-The default format is JSON. Supports json or yaml.
-EOT
-    end
-    optparse.parse!(args)
-    verify_args!(args:args, optparse:optparse, count:1)
-    connect(options)
-    # parse args
-    outfile = args[0]
-    if !validate_outfile(outfile, options)
-      return 1, "Failed to validate outfile"
-    end
-    # construct the api request
-    params.merge!(parse_list_options(options))
-    if outfile.include?(".yml") || outfile.include?(".yaml")
-      options[:yaml] = true
-    end
-    openapi_format = options[:yaml] ? "yaml" : "json"
-    params['format'] = openapi_format
-    # execute the api request
-    @doc_interface.setopts(options)
-    if options[:dry_run]
-      print_dry_run @doc_interface.dry.download_openapi(outfile, params)
-      return 0, nil
-    end
-    print cyan + "Downloading openapi.#{openapi_format} to #{outfile} ... " if !options[:quiet]
-    http_response = @doc_interface.download_openapi(outfile, params)
-    if http_response.code.to_i == 200
-      print green + "SUCCESS" + reset + "\n" if !options[:quiet]
-      return 0, nil
-    else
-      print red + "ERROR" + reset + " HTTP #{http_response.code}" + "\n" if !options[:quiet]
-      if File.exist?(outfile) && File.file?(outfile)
-        Morpheus::Logging::DarkPrinter.puts "Deleting bad file download: #{outfile}" if Morpheus::Logging.debug?
-        File.delete(outfile)
-      end
-      return 1, "HTTP #{http_response.code}"
-    end
-  end
-
-  protected
-
-end

data/test/api/doc_interface_test.rb

@@ -1,35 +0,0 @@
-require 'morpheus_test'
-
-# Tests for Morpheus::DocInterface
-class MorpheusTest::DocInterfaceTest < MorpheusTest::TestCase
-  
-  def test_doc_list
-    @doc_interface = client.doc
-    response = @doc_interface.list()
-    assert_equal response['links'].class, Array
-  end
-
-  def test_doc_get
-    @doc_interface = client.doc
-    response = @doc_interface.openapi()
-    assert_equal response['openapi'], '3.0.3'
-    # todo: fix this, can be cached and fail
-    #assert_equal response['version'], Morpheus::Cli::Remote.load_remote(@config.remote_name)[:build_version]
-  end
-
-  def test_doc_get_yaml
-    @doc_interface = client.doc
-    response = @doc_interface.openapi({'format' => "yaml"})
-    assert response.body
-    assert YAML.load(response.body)
-  end
-
-  # def test_doc_download
-  #   @doc_interface = client.doc
-  #   response = @doc_interface.download_openapi('/path/to/openapi.json')
-  #   yaml_content = response.body
-  #   yaml_data = YAML.load(yaml_content)
-  #   assert_not_nil yaml_data
-  # end
-
-end

data/test/cli/doc_test.rb

@@ -1,35 +0,0 @@
-require 'morpheus_test'
-
-# Tests for Morpheus::Cli::Doc
-class MorpheusTest::DocTest < MorpheusTest::TestCase
-  
-  def test_doc_list
-    assert_execute("doc list")
-  end
-
-  def test_doc_get
-    # using --quiet because the output is massive
-    assert_execute("doc get --quiet")
-  end
-
-  def test_doc_get_yaml
-    # using --quiet because the output is massive
-    assert_execute("doc get --yaml --quiet") 
-  end
-
-  # def test_doc_download
-  #   assert_execute("doc download '/path/to/openapi.json')
-  # end
-
-  # def test_doc_download_yaml
-  #   assert_execute("doc download '/path/to/openapi.yaml' --yaml")
-  # end
-
-  def test_doc_get_unauthorized
-    # authentication is NOT required for this api
-    without_authentication do
-      assert_error("doc get -q")
-    end
-  end
-
-end