morpheus-cli 6.1.1 → 6.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3cf8719e8fbab69a6e0de10b9d2920b0394bb55d4928ba4266b82c9430f53658
-  data.tar.gz: a518e58f7b2adc050e786ca6f29e0f7832787e5c294c495d5599960f7232aacc
+  metadata.gz: 683efa948a958a0fb4a6def11cb94ae525bdde8cbde0ba1d1aa313adeef3387d
+  data.tar.gz: c19c0522892a7f96a8398811b89ea4324815f4494011bf6696be1fb362787304
 SHA512:
-  metadata.gz: 30263a5621c68dc42d8bb1093c67c21a27eab9c440bd12848a345ddee7200d45d8744531418dd9b936529405623a7c464d44b957503903ac0fc1e2bb462b431a
-  data.tar.gz: 2bc5e8dc185195a1dc470394d487b1c970c1c8626701803636441ae84a6f138352dcafd07481d39a151c24911a05526dfa8748882ee7b1b48f57c02bba584e54
+  metadata.gz: a1b269a981ec0fcbeecbad62a91ba90f6e7429c26593579185a0a513d0ab5ea5e2394ab11d7bf138570314a418059b6a072e47fb04b0393010dc0f66a463db54
+  data.tar.gz: 3c211238b4a2dae07c4da54659be1c43e9f0cf7aaf25f7bbfcf53f0c6a0482b43b87b44db541287dfd7201228902902e80c0a1b4a5b538207f3303174940cff9

data/Dockerfile

@@ -1,5 +1,5 @@
 FROM ruby:2.7.5
 
-RUN gem install morpheus-cli -v 6.1.1
+RUN gem install morpheus-cli -v 6.1.2
 
 ENTRYPOINT ["morpheus"]

data/lib/morpheus/api/api_client.rb

@@ -336,10 +336,6 @@ class Morpheus::APIClient
     }
   end
 
-  def doc
-    Morpheus::DocInterface.new(common_interface_options).setopts(@options)
-  end
-
   def ping
     Morpheus::PingInterface.new(common_interface_options).setopts(@options)
   end

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

@@ -599,6 +599,9 @@ class Morpheus::Cli::Instances
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[instance]")
       opts.on('--name VALUE', String, "Name") do |val|
+        params['name'] = val
+      end
+      opts.on('--displayName VALUE', String, "Name") do |val|
         params['displayName'] = val
       end
       opts.on('--description VALUE', String, "Description") do |val|
@@ -1400,6 +1403,7 @@ class Morpheus::Cli::Instances
       description_cols = {
         "ID" => 'id',
         "Name" => 'name',
+        "Display Name" => 'displayName',
         "Description" => 'description',
         "Group" => lambda {|it| it['group'] ? it['group']['name'] : '' },
         "Cloud" => lambda {|it| it['cloud'] ? it['cloud']['name'] : '' },
@@ -5423,6 +5427,7 @@ private
   def add_instance_schedule_option_types()
     [
       {'code' => 'scheduleType', 'fieldName' => 'scheduleType', 'fieldLabel' => 'Schedule Type', 'type' => 'select', 'selectOptions' => [{'name'=>'Day Of Week', 'value'=>'dayOfWeek'},{'name'=>'Exact', 'value'=>'exact'}], 'description' => "Schedule type  can be recurring day of the week str or exact start and end timestamp", 'required' => true, 'defaultValue' => 'dayOfWeek'},
+      {'dependsOnCode' => 'scheduleType:dayOfWeek', 'fieldName' => 'scheduleTimezone', 'fieldLabel' => 'Timezone', 'type' => 'select', 'optionSource' => 'timezones' , 'description' => "The timezone", 'defaultValue' => "UTC", 'required' => false},
       {'dependsOnCode' => 'scheduleType:dayOfWeek', 'fieldName' => 'startDayOfWeek', 'fieldLabel' => 'Start Day Of Week', 'type' => 'select', 'selectOptions' => day_of_week_dropdown, 'description' => "Start day of the week Sunday-Saturday (1-7)", 'defaultValue' => "Sunday", 'required' => true},
       {'dependsOnCode' => 'scheduleType:dayOfWeek', 'fieldName' => 'startTime', 'fieldLabel' => 'Start Time (HH:MM)', 'type' => 'text', 'description' => "Start time in HH:MM 24-hour format", 'placeHolder' => 'HH:MM', 'defaultValue' => "01:00", 'required' => true},
       {'dependsOnCode' => 'scheduleType:dayOfWeek', 'fieldName' => 'endDayOfWeek', 'fieldLabel' => 'End Day Of Week', 'type' => 'select', 'selectOptions' => day_of_week_dropdown, 'description' => "End day of the week Sunday-Saturday (1-7)", 'defaultValue' => "Sunday", 'required' => true},

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

@@ -13,7 +13,7 @@ class Morpheus::Cli::LoadBalancerPools
   set_rest_parent_name :load_balancers
 
   register_subcommands :list, :get, :add, :update, :remove
-  register_interfaces :load_balancers, :load_balancer_types
+  register_interfaces :load_balancer_pools_secondary, :load_balancers, :load_balancer_types
 
 
   # set_rest_interface_name :load_balancer_pools
@@ -90,4 +90,40 @@ class Morpheus::Cli::LoadBalancerPools
 
   ## using CliCommand's generic find_by methods
 
+  def find_load_balancer_pool_by_name_or_id(load_balancer_pool_id, val)
+    if val.to_s =~ /\A\d{1,}\Z/
+      return find_load_balancer_pool_by_id(load_balancer_pool_id, val)
+    else
+      return find_load_balancer_pool_by_name(load_balancer_pool_id, val)
+    end
+  end
+
+  def find_load_balancer_pool_by_id(load_balancer_pool_id, id)
+    begin
+      json_response = @load_balancer_pools_secondary_interface.get(load_balancer_pool_id, id.to_i)
+      return json_response[load_balancer_pool_object_key]
+    rescue RestClient::Exception => e
+      if e.response && e.response.code == 404
+        print_red_alert "Load Balancer Pool not found by id #{id}"
+      else
+        raise e
+      end
+    end
+  end
+
+  def find_load_balancer_pool_by_name(load_balancer_pool_id, name)
+    lbs = @load_balancer_pools_secondary_interface.list(load_balancer_pool_id, {name: name.to_s})[load_balancer_pool_list_key]
+    if lbs.empty?
+      print_red_alert "Load Balancer Pool not found by name #{name}"
+      return nil
+    elsif lbs.size > 1
+      print_red_alert "#{lbs.size} load balancer pools found by name #{name}"
+      #print_lbs_table(lbs, {color: red})
+      print reset,"\n\n"
+      return nil
+    else
+      return lbs[0]
+    end
+  end
+
 end

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/version.rb

@@ -1,6 +1,6 @@
 
 module Morpheus
   module Cli
-    VERSION = "6.1.1"
+    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.1
+  version: 6.1.2
 platform: ruby
 authors:
 - David Estes
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-17 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
@@ -400,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
@@ -578,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
@@ -624,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