morpheus-cli 3.6.38 → 4.0.0

data/lib/morpheus/cli/hosts.rb

@@ -14,7 +14,7 @@ class Morpheus::Cli::Hosts
   include Morpheus::Cli::ProvisioningHelper
   set_command_name :hosts
   set_command_description "View and manage hosts (servers)."
-  register_subcommands :list, :count, :get, :stats, :add, :update, :remove, :logs, :start, :stop, :resize, :run_workflow, {:'make-managed' => :install_agent}, :upgrade_agent
+  register_subcommands :list, :count, :get, :view, :stats, :add, :update, :remove, :logs, :start, :stop, :resize, :run_workflow, {:'make-managed' => :install_agent}, :upgrade_agent
   register_subcommands :'types' => :list_types
   register_subcommands :exec => :execution_request
   register_subcommands :wiki, :update_wiki
@@ -359,7 +359,7 @@ class Morpheus::Cli::Hosts
     options = {}
     optparse = Morpheus::Cli::OptionParser.new do |opts|
       opts.banner = subcommand_usage("[name]")
-      opts.on('--refresh [SECONDS]', String, "Refresh until status is running,failed. Default interval is 5 seconds.") do |val|
+      opts.on('--refresh [SECONDS]', String, "Refresh until status is provisioned,failed. Default interval is #{default_refresh_interval} seconds.") do |val|
         options[:refresh_until_status] ||= "provisioned,failed"
         if !val.to_s.empty?
           options[:refresh_interval] = val.to_f
@@ -436,19 +436,34 @@ class Morpheus::Cli::Hosts
         "Power" => lambda {|it| format_server_power_state(it) },
       }, server)
       
+      if server['statusMessage']
+        print_h2 "Status Message", options
+        if server['status'] == 'failed'
+          print red, server['statusMessage'], reset
+        else
+          print server['statusMessage']
+        end
+        print "\n"
+      end
+      if server['errorMessage']
+        print_h2 "Error Message", options
+        print red, server['errorMessage'], reset, "\n"
+      end
+
       print_h2 "Host Usage", options
       print_stats_usage(stats)
       print reset, "\n"
 
+
       # refresh until a status is reached
       if options[:refresh_until_status]
         if options[:refresh_interval].nil? || options[:refresh_interval].to_f < 0
-          options[:refresh_interval] = 5
+          options[:refresh_interval] = default_refresh_interval
         end
         statuses = options[:refresh_until_status].to_s.downcase.split(",").collect {|s| s.strip }.select {|s| !s.to_s.empty? }
         if !statuses.include?(server['status'])
           print cyan
-          print cyan, "Refreshing in #{options[:refresh_interval]} seconds"
+          print cyan, "Refreshing in #{options[:refresh_interval] > 1 ? options[:refresh_interval].to_i : options[:refresh_interval]} seconds"
           sleep_with_dots(options[:refresh_interval])
           print "\n"
           _get(arg, options)
@@ -599,14 +614,23 @@ class Morpheus::Cli::Hosts
       opts.on( '-t', '--type TYPE', "Server Type Code" ) do |val|
         options[:server_type_code] = val
       end
+      opts.on("--security-groups LIST", Integer, "Security Groups, comma sepearated list of security group IDs") do |val|
+        options[:security_groups] = val.split(",").collect {|s| s.strip }.select {|s| !s.to_s.empty? }
+      end
+      opts.on('--refresh [SECONDS]', String, "Refresh until status is running,failed. Default interval is #{default_refresh_interval} seconds.") do |val|
+        options[:refresh_interval] = val.to_s.empty? ? default_refresh_interval : val.to_f
+      end
       build_common_options(opts, options, [:options, :payload, :json, :dry_run, :quiet, :remote])
     end
     optparse.parse!(args)
     connect(options)
     begin
+      passed_options = options[:options] ? options[:options].reject {|k,v| k.is_a?(Symbol) } : {}
       payload = nil
       if options[:payload]
         payload = options[:payload]
+        #payload.deep_merge!({'server' => passed_options}) unless passed_options.empty?
+        payload.deep_merge!(passed_options) unless passed_options.empty?
       else
         # support old format of `hosts add CLOUD NAME`
         if args[0]
@@ -619,7 +643,6 @@ class Morpheus::Cli::Hosts
         options[:group] ||= @active_group_id
 
         params = {}
-
         # Group
         group_id = nil
         group = options[:group] ? find_group_by_name_or_id_for_provisioning(options[:group]) : nil
@@ -683,20 +706,45 @@ class Morpheus::Cli::Hosts
         plan_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'plan', 'type' => 'select', 'fieldLabel' => 'Plan', 'selectOptions' => service_plans_dropdown, 'required' => true, 'description' => 'Choose the appropriately sized plan for this server'}],options[:options])
         service_plan = service_plans.find {|sp| sp["id"] == plan_prompt['plan'].to_i }
 
-        payload['server'] = {
+        # uh ok, this actually expects config at root level, sibling of server 
+        # payload.deep_merge!({'server' => passed_options}) unless passed_options.empty?
+        payload.deep_merge!(passed_options) unless passed_options.empty?
+        payload.deep_merge!({'server' => {
           'name' => host_name,
           'zone' => {'id' => cloud['id']},
           'computeServerType' => {'id' => server_type['id']},
           'plan' => {'id' => service_plan["id"]}
-        }
+          }
+        })
+
+        option_type_list = server_type['optionTypes']
+        # remove volume options if volumes were configured
+        if !payload['volumes'].empty?
+          option_type_list = reject_volume_option_types(option_type_list)
+        end
+        # remove networkId option if networks were configured above
+        if !payload['networkInterfaces'].empty?
+          option_type_list = reject_networking_option_types(option_type_list)
+        end
+
+        # remove cpu and memory option types, which now come from the plan
+        option_type_list = reject_service_plan_option_types(option_type_list)
 
         # prompt for resource pool
+        pool_id = nil
         has_zone_pools = server_type["provisionType"] && server_type["provisionType"]["hasZonePools"]
         if has_zone_pools
-          resource_pool_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldContext' => 'config', 'fieldName' => 'resourcePool', 'type' => 'select', 'fieldLabel' => 'Resource Pool', 'optionSource' => 'zonePools', 'required' => true, 'skipSingleOption' => true, 'description' => 'Select resource pool.'}],options[:options],api_client,{groupId: group_id, zoneId: cloud_id, cloudId: cloud_id, planId: service_plan["id"]})
-          if resource_pool_prompt['config'] && resource_pool_prompt['config']['resourcePool']
-            payload['config'] ||= {}
-            payload['config']['resourcePool'] = resource_pool_prompt['config']['resourcePool']
+          # pluck out the resourcePoolId option type to prompt for..why the heck is this even needed? 
+          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 ||= {'fieldContext' => 'config', 'fieldName' => 'resourcePool', 'type' => 'select', 'fieldLabel' => 'Resource Pool', 'optionSource' => 'zonePools', 'required' => true, 'skipSingleOption' => true, 'description' => 'Select resource pool.'}
+          resource_pool_prompt = Morpheus::Cli::OptionTypes.prompt([resource_pool_option_type],options[:options],api_client,{groupId: group_id, siteId: group_id, zoneId: cloud_id, cloudId: cloud_id, planId: service_plan["id"], serverTypeId: server_type['id']})
+          resource_pool_prompt.deep_compact!
+          payload.deep_merge!(resource_pool_prompt)
+          if resource_pool_option_type['fieldContext'] && resource_pool_prompt[resource_pool_option_type['fieldContext']]
+            pool_id = resource_pool_prompt[resource_pool_option_type['fieldContext']][resource_pool_option_type['fieldName']]
+          elsif resource_pool_prompt[resource_pool_option_type['fieldName']]
+            pool_id = resource_pool_prompt[resource_pool_option_type['fieldName']]
           end
         end
 
@@ -709,7 +757,7 @@ class Morpheus::Cli::Hosts
         # prompt for network interfaces (if supported)
         if server_type["provisionType"] && server_type["provisionType"]["id"] && server_type["provisionType"]["hasNetworks"]
           begin
-            network_interfaces = prompt_network_interfaces(cloud['id'], server_type["provisionType"]["id"], options)
+            network_interfaces = prompt_network_interfaces(cloud['id'], server_type["provisionType"]["id"], pool_id, options)
             if !network_interfaces.empty?
               payload['networkInterfaces'] = network_interfaces
             end
@@ -719,23 +767,36 @@ class Morpheus::Cli::Hosts
           end
         end
 
-        server_type_option_types = server_type['optionTypes']
-        # remove volume options if volumes were configured
-        if !payload['volumes'].empty?
-          server_type_option_types = reject_volume_option_types(server_type_option_types)
+        # Security Groups
+        # prompt for multiple security groups
+        sg_option_type = option_type_list.find {|opt| ((opt['code'] == 'provisionType.amazon.securityId') || (opt['name'] == 'securityId')) }
+        option_type_list = option_type_list.reject {|opt| ((opt['code'] == 'provisionType.amazon.securityId') || (opt['name'] == 'securityId')) }
+        # ok.. seed data has changed and serverTypes do not have this optionType anymore...
+        if sg_option_type.nil?
+          if server_type["provisionType"] && (server_type["provisionType"]["code"] == 'amazon')
+            sg_option_type = {'fieldContext' => 'config', 'fieldName' => 'securityId', 'type' => 'select', 'fieldLabel' => 'Security Group', 'optionSource' => 'amazonSecurityGroup', 'required' => true, 'description' => 'Select security group.'}
+          end
         end
-        # remove networkId option if networks were configured above
-        if !payload['networkInterfaces'].empty?
-          server_type_option_types = reject_networking_option_types(server_type_option_types)
+        has_security_groups = !!sg_option_type
+        if options[:security_groups]
+          payload['securityGroups'] = options[:security_groups].collect {|sg_id| {'id' => sg_id} }
+        else
+          if has_security_groups
+            security_groups_array = prompt_security_groups(sg_option_type, {zoneId: cloud_id, poolId: pool_id}, options)
+            if !security_groups_array.empty?
+              payload['securityGroups'] = security_groups_array.collect {|sg_id| {'id' => sg_id} }
+            end
+          end
         end
-        # remove resourcePoolId if it was configured above
-        if has_zone_pools
-          server_type_option_types = server_type_option_types.reject {|opt| ['resourcePool','resourcePoolId','azureResourceGroupId'].include?(opt['fieldName']) }
+    
+        api_params = {}
+        api_params['zoneId'] = cloud['id']
+        api_params['poolId'] = payload['config']['resourcePool'] if (payload['config'] && payload['config']['resourcePool'])
+        if payload['config']
+          api_params.deep_merge!(payload['config'])
         end
-        # remove cpu and memory option types, which now come from the plan
-        server_type_option_types = reject_service_plan_option_types(server_type_option_types)
-
-        params = Morpheus::Cli::OptionTypes.prompt(server_type_option_types,options[:options],@api_client, {zoneId: cloud['id']})
+        #api_params.deep_merge(payload)
+        params = Morpheus::Cli::OptionTypes.prompt(option_type_list,options[:options],@api_client, api_params)
         payload.deep_merge!(params)
         
       end
@@ -749,8 +810,12 @@ class Morpheus::Cli::Hosts
         print JSON.pretty_generate(json_response)
         print "\n"
       elsif !options[:quiet]
-        print_green_success "Provisioning Server..." 
-        list([])
+        server_id = json_response["server"]["id"]
+        server_name = json_response["server"]["name"]
+        print_green_success "Provisioning host [#{server_id}] #{server_name}"
+        # print details
+        get_args = [server_id] + (options[:remote] ? ["-r",options[:remote]] : []) + (options[:refresh_interval] ? ['--refresh', options[:refresh_interval].to_s] : [])
+        get(get_args)
       end
     rescue RestClient::Exception => e
       print_rest_exception(e, options)
@@ -794,7 +859,8 @@ class Morpheus::Cli::Hosts
       server = find_host_by_name_or_id(args[0])
       return 1 if server.nil?
       new_group = nil
-      params.deep_merge!(options[:options].reject {|k,v| k.is_a?(Symbol) }) if options[:options]
+      passed_options = options[:options] ? options[:options].reject {|k,v| k.is_a?(Symbol) } : {}
+      params.deep_merge!(passed_options) unless passed_options.empty?
       payload = nil
       if options[:payload]
         payload = options[:payload]
@@ -1039,7 +1105,7 @@ class Morpheus::Cli::Hosts
       # prompt for network interfaces (if supported)
       # if server_type["provisionType"] && server_type["provisionType"]["id"] && server_type["provisionType"]["hasNetworks"]
       #   begin
-      #     network_interfaces = prompt_network_interfaces(cloud['id'], server_type["provisionType"]["id"], options)
+      #     network_interfaces = prompt_network_interfaces(cloud['id'], server_type["provisionType"]["id"], null, options)
       #     if !network_interfaces.empty?
       #       payload[:networkInterfaces] = network_interfaces
       #     end
@@ -1410,6 +1476,64 @@ class Morpheus::Cli::Hosts
     end
   end
 
+  def view(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do |opts|
+      opts.banner = subcommand_usage("[host]")
+      opts.on('-w','--wiki', "Open the wiki tab for this host") do
+        options[:link_tab] = "wiki"
+      end
+      opts.on('--tab VALUE', String, "Open a specific tab") do |val|
+        options[:link_tab] = val.to_s
+      end
+      build_common_options(opts, options, [:dry_run, :remote])
+      opts.footer = "View a host in a web browser" + "\n" +
+                    "[host] is required. This is the name or id of a host. Supports 1-N [host] arguments."
+    end
+    optparse.parse!(args)
+    if args.count != 1
+      raise_command_error "wrong number of arguments, expected 1 and got (#{args.count}) #{args.join(' ')}\n#{optparse}"
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    return run_command_for_each_arg(id_list) do |arg|
+      _view(arg, options)
+    end
+  end
+
+  def _view(arg, options={})
+    begin
+      host = find_host_by_name_or_id(arg)
+      return 1 if host.nil?
+
+      link = "#{@appliance_url}/login/oauth-redirect?access_token=#{@access_token}\\&redirectUri=/infrastructure/servers/#{host['id']}"
+      if options[:link_tab]
+        link << "#!#{options[:link_tab]}"
+      end
+
+      open_command = nil
+      if RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
+        open_command = "start #{link}"
+      elsif RbConfig::CONFIG['host_os'] =~ /darwin/
+        open_command = "open #{link}"
+      elsif RbConfig::CONFIG['host_os'] =~ /linux|bsd/
+        open_command = "xdg-open #{link}"
+      end
+
+      if options[:dry_run]
+        puts "system: #{open_command}"
+        return 0
+      end
+
+      system(open_command)
+      
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
   def wiki(args)
     options = {}
     params = {}

data/lib/morpheus/cli/instances.rb

@@ -22,7 +22,7 @@ class Morpheus::Cli::Instances
   # register_subcommands {:'lb-update' => :load_balancer_update}
   alias_subcommand :details, :get
   set_default_subcommand :list
-  
+
   def initialize()
     #@appliance_name, @appliance_url = Morpheus::Cli::Remote.active_appliance
   end
@@ -333,6 +333,12 @@ class Morpheus::Cli::Instances
       opts.on("--create-backup [on|off]", String, "Automation: Create Backups.") do |val|
         options[:create_backup] = ['on','true','1',''].include?(val.to_s.downcase) ? 'on' : 'off'
       end
+      opts.on("--security-groups LIST", Integer, "Security Groups, comma sepearated list of security group IDs") do |val|
+        options[:security_groups] = val.split(",").collect {|s| s.strip }.select {|s| !s.to_s.empty? }
+      end
+      opts.on('--refresh [SECONDS]', String, "Refresh until status is running,failed. Default interval is #{default_refresh_interval} seconds.") do |val|
+        options[:refresh_interval] = val.to_s.empty? ? default_refresh_interval : val.to_f
+      end
       build_common_options(opts, options, [:options, :payload, :json, :dry_run, :remote, :quiet])
       opts.footer = "Create a new instance." + "\n" +
                     "[name] is required. This is the new instance name." + "\n" +
@@ -427,7 +433,9 @@ class Morpheus::Cli::Instances
         instance_id = json_response["instance"]["id"]
         instance_name = json_response["instance"]["name"]
         print_green_success "Provisioning instance [#{instance_id}] #{instance_name}"
-        get([instance_id] + (options[:remote] ? ["-r",options[:remote]] : []))
+        # print details
+        get_args = [instance_id] + (options[:remote] ? ["-r",options[:remote]] : []) + (options[:refresh_interval] ? ['--refresh', options[:refresh_interval].to_s] : [])
+        get(get_args)
       end
       return 0
     rescue RestClient::Exception => e
@@ -547,7 +555,6 @@ class Morpheus::Cli::Instances
   end
 
   def update_notes(args)
-    print_error "#{yellow}DEPRECATION WARNING: `instances update-notes` is deprecated in 4.0, use `instances update-wiki` instead.#{reset}\n"
     usage = "Usage: morpheus instances update-notes [instance] [options]"
     options = {}
     params = {}
@@ -580,7 +587,7 @@ class Morpheus::Cli::Instances
       return 1
     end
     connect(options)
-
+    print_error "#{yellow}DEPRECATION WARNING: `instances update-notes` is deprecated in 4.0, use `instances update-wiki` instead.#{reset}\n"
     begin
       instance = find_instance_by_name_or_id(args[0])
       return 1 if instance.nil?
@@ -1092,7 +1099,7 @@ class Morpheus::Cli::Instances
       opts.on( nil, '--scaling', "Display Instance Scaling Settings" ) do
         options[:include_scaling] = true
       end
-      opts.on('--refresh [SECONDS]', String, "Refresh until status is running,failed. Default interval is 5 seconds.") do |val|
+      opts.on('--refresh [SECONDS]', String, "Refresh until status is running,failed. Default interval is #{default_refresh_interval} seconds.") do |val|
         options[:refresh_until_status] ||= "running,failed"
         if !val.to_s.empty?
           options[:refresh_interval] = val.to_f
@@ -1279,6 +1286,7 @@ class Morpheus::Cli::Instances
               status: format_container_status(container),
               name: container['server'] ? container['server']['name'] : '(no server)', # there is a server.displayName too?
               type: container['containerType'] ? container['containerType']['name'] : '',
+              host: container['server'] ? container['server']['name'] : '',
               cloud: container['cloud'] ? container['cloud']['name'] : '',
               location: format_container_connection_string(container),
               cpu: cpu_usage_str + cyan,
@@ -1287,7 +1295,7 @@ class Morpheus::Cli::Instances
             }
             row
           }
-          columns = [:id, :status, :name, :type, :cloud, :location, :cpu, :memory, :storage]
+          columns = [:id, :status, :name, :type, :cloud, :host, :location, :cpu, :memory, :storage]
           # custom pretty table columns ...
           if options[:include_fields]
             columns = options[:include_fields]
@@ -1314,11 +1322,11 @@ class Morpheus::Cli::Instances
       # refresh until a status is reached
       if options[:refresh_until_status]
         if options[:refresh_interval].nil? || options[:refresh_interval].to_f < 0
-          options[:refresh_interval] = 5
+          options[:refresh_interval] = default_refresh_interval
         end
         statuses = options[:refresh_until_status].to_s.downcase.split(",").collect {|s| s.strip }.select {|s| !s.to_s.empty? }
         if !statuses.include?(instance['status'])
-          print cyan, "Refreshing in #{options[:refresh_interval]} seconds"
+          print cyan, "Refreshing in #{options[:refresh_interval] > 1 ? options[:refresh_interval].to_i : options[:refresh_interval]} seconds"
           sleep_with_dots(options[:refresh_interval])
           print "\n"
           _get(arg, options)

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

@@ -5,6 +5,7 @@ require 'yaml'
 require 'ostruct'
 require 'io/console'
 require 'morpheus/logging'
+require 'fileutils'
 
 module Morpheus::Cli::PrintHelper
 
@@ -144,9 +145,9 @@ module Morpheus::Cli::PrintHelper
     params = nil
     if api_request[:params] && !api_request[:params].empty?
       params = api_request[:params]
-    elsif api_request[:headers] && api_request[:headers][:params]
+    elsif headers && headers[:params]
       # params inside headers for restclient reasons..
-      params = api_request[:headers][:params]
+      params = headers[:params]
     elsif api_request[:query] && !api_request[:query].empty?
       params = api_request[:query]
     end
@@ -159,8 +160,54 @@ module Morpheus::Cli::PrintHelper
     end
     request_string = "#{http_method.to_s.upcase} #{url}".strip
     payload = api_request[:payload] || api_request[:body]
-
     #Morpheus::Logging::DarkPrinter.puts "API payload is: (#{payload.class}) #{payload.inspect}"
+    content_type = (headers && headers['Content-Type']) ? headers['Content-Type'] : 'application/x-www-form-urlencoded'
+    
+    # write to a file?
+    if options[:outfile]
+      output = ""
+      if api_request[:curl] || options[:curl]
+        output = format_curl_command(http_method, url, headers, payload, options)
+      else
+        # body payload
+        output = payload
+        if content_type == 'application/json'
+          if payload.is_a?(String)
+            begin
+              payload = JSON.parse(payload)
+            rescue => e
+              #payload = "(unparsable) #{payload}"
+            end
+          end
+          output = JSON.pretty_generate(payload)
+        else
+          if payload.is_a?(File)
+            pretty_size = "#{payload.size} B"
+            output = "File: #{payload.path} (#{pretty_size})"
+          elsif payload.is_a?(String)
+            output = payload
+          else
+            if content_type == 'application/x-www-form-urlencoded'
+              body_str = payload.to_s
+              begin
+                body_str = URI.encode_www_form(payload)
+              rescue => ex
+                # raise ex
+              end
+              output = body_str
+            else
+              begin
+                output = JSON.pretty_generate(payload)
+              rescue
+                output = payload.to_s
+              end
+            end
+          end
+        end
+      end
+      print_result = print_to_file(output, options[:outfile], options[:overwrite])
+      return print_result
+    end
 
     # curl output?
     if api_request[:curl] || options[:curl]
@@ -171,30 +218,14 @@ module Morpheus::Cli::PrintHelper
       return
     end
 
-    # print this thing:
-    # REQUEST:
-    # POST http://morpheusdata.com/api/whoami
-    # f it..removing this, just DRY RUN printed at the start of command
     print "\n"
-    # if command_string != false
-    #   if command_string
-    #     print_h1 "DRY RUN > #{command_string}"
-    #   else
-    #     #print "\n"
-    #     #print_h1 "DRY RUN"
-    #   end
-    # end
     puts "#{cyan}#{bold}#{dark}REQUEST#{reset}\n"
-    # print cyan
-    # print "Request: ", "\n"
-    # print reset
     request_string = "#{http_method.to_s.upcase} #{url}".strip
     print request_string, "\n"
     print cyan
     if payload
-      
       print "\n"
-      if api_request[:headers] && api_request[:headers]['Content-Type'] == 'application/json'
+      if content_type == 'application/json'
         if payload.is_a?(String)
           begin
             payload = JSON.parse(payload)
@@ -203,18 +234,12 @@ module Morpheus::Cli::PrintHelper
           end
         end
         puts "#{cyan}#{bold}#{dark}JSON#{reset}\n"
-        # print "JSON: ", "\n"
-        # print reset
         print JSON.pretty_generate(payload)
       else
-        content_type = api_request[:headers]['Content-Type'] || 'application/x-www-form-urlencoded'
         print "Content-Type: #{content_type}", "\n"
-        # print "Body: ", "\n"
         print reset
         if payload.is_a?(File)
-          # pretty_size = Filesize.from("#{payload.size} B").pretty.strip
           pretty_size = "#{payload.size} B"
-          # print "File: #{payload.path} (#{payload.size} bytes)"
           print "File: #{payload.path} (#{pretty_size})"
         elsif payload.is_a?(String)
           print payload
@@ -1039,4 +1064,37 @@ module Morpheus::Cli::PrintHelper
     end
   end
 
+  def print_to_file(txt, filename, overwrite=false, access_mode = 'w+')
+    Morpheus::Logging::DarkPrinter.puts "Writing #{txt.to_s.bytesize} bytes to file #{filename} ..." if Morpheus::Logging.debug?
+    outfile = nil
+    begin
+      full_filename = File.expand_path(filename)
+      if File.exists?(full_filename)
+        if !overwrite
+          print "#{red}Output file '#{filename}' already exists.#{reset}\n"
+          print "#{red}Use --overwrite to overwrite the existing file.#{reset}\n"
+          return 1
+        end
+      end
+      if Dir.exists?(full_filename)
+        print "#{red}Output file '#{filename}' is invalid. It is the name of an existing directory.#{reset}\n"
+        return 1
+      end
+      target_dir = File.dirname(full_filename)
+      if !Dir.exists?(target_dir)
+        FileUtils.mkdir_p(target_dir)
+      end
+      outfile = File.open(full_filename, access_mode)
+      outfile.print(txt)
+      print "#{cyan}Wrote #{txt.to_s.bytesize} bytes to file #{filename}\n"
+      return 0
+    rescue => ex
+      # puts_error "Error writing to outfile '#{filename}'. Error: #{ex}"
+      print "#{red}Error writing to file '#{filename}'.  Error: #{ex}#{reset}\n"
+      return 1
+    ensure
+      outfile.close if outfile
+    end
+  end
+
 end