MuranoCLI 2.2.4 → 3.0.0

data/lib/MrMurano/commands/cors.rb

@@ -1,30 +1,45 @@
+# Last Modified: 2017.08.16 /coding: utf-8
+# frozen_string_literal: true
+
+# Copyright © 2016-2017 Exosite LLC.
+# License: MIT. See LICENSE.txt.
+#  vim:tw=0:ts=2:sw=2:et:ai
+
 require 'yaml'
-require 'MrMurano/Solution-Cors'
+require 'MrMurano/ReCommander'
+require 'MrMurano/Webservice-Cors'
 
 command :cors do |c|
-  c.syntax = %{murano cors}
-  c.summary = %{Get the CORS for the project.}
-  c.description = %{Get the CORS for the project.
+  c.syntax = %(murano cors)
+  c.summary = %(Get the CORS for the project.)
+  c.description = %(
+Get the CORS for the project.
 
-  Set the CORS with `murano cors set`
-  }
+Set the CORS with `murano cors set`.
+  ).strip
+  c.project_not_required = true
 
-  c.action do |args,options|
-    sol = MrMurano::Cors.new
-    ret = sol.fetch()
+  c.action do |args, _options|
+    c.verify_arg_count!(args)
+    sol = MrMurano::Webservice::Cors.new
+    ret = sol.fetch
     sol.outf ret
   end
 end
 
 command 'cors set' do |c|
-  c.syntax = %{murano cors set [<file>]}
-  c.summary = %{Set the CORS for the project.}
+  c.syntax = %(murano cors set [<file>])
+  c.summary = %(Set the CORS for the project)
+  c.description = %(
+Set the CORS for the project.
+  ).strip
+  c.project_not_required = true
 
-  c.action do |args,options|
-    crs = MrMurano::Cors.new
+  c.action do |args, _options|
+    c.verify_arg_count!(args, 1, ['Missing <file>'])
+    crs = MrMurano::Webservice::Cors.new
     file = args.shift
     crs.upload(file)
   end
 end
 
-#  vim: set ai et sw=2 ts=2 :

data/lib/MrMurano/commands/devices.rb

@@ -0,0 +1,286 @@
+# Last Modified: 2017.08.16 /coding: utf-8
+# frozen_string_literal: true
+
+# Copyright © 2016-2017 Exosite LLC.
+# License: MIT. See LICENSE.txt.
+#  vim:tw=0:ts=2:sw=2:et:ai
+
+require 'MrMurano/Gateway'
+require 'MrMurano/ReCommander'
+
+command 'device' do |c|
+  c.syntax = %(murano device)
+  c.summary = %(Interact with a device)
+  c.description = %(
+Interact with a device.
+  ).strip
+  c.project_not_required = true
+
+  c.action do |_args, _options|
+    ::Commander::UI.enable_paging
+    say MrMurano::SubCmdGroupHelp.new(c).get_help
+  end
+end
+
+command 'device list' do |c|
+  c.syntax = %(murano device list [--options])
+  c.summary = %(List identifiers for a product)
+  c.description = %(
+List identifiers for a product.
+  ).strip
+
+  c.option '--limit NUMBER', Integer, %(How many devices to return)
+  c.option '--before TIMESTAMP', Integer, %(Show devices before timestamp)
+  c.option '-l', '--long', %(show everything)
+  c.option '-o', '--output FILE', %(Download to file instead of STDOUT)
+
+  c.action do |args, options|
+    c.verify_arg_count!(args)
+    #options.default limit: 1000
+
+    prd = MrMurano::Gateway::Device.new
+    MrMurano::Verbose.whirly_start 'Looking for devices...'
+    data = prd.list(options.limit, options.before)
+    MrMurano::Verbose.whirly_stop
+    exit 1 if data.nil?
+
+    if !data[:devices].empty?
+      io = File.open(options.output, 'w') if options.output
+      prd.outf(data, io) do |_dd, ios|
+        dt = {}
+        if options.long
+          dt[:headers] = [
+            :Identifier,
+            :AuthType,
+            :Locked,
+            :Reprovision,
+            'Dev Mode',
+            'Last IP',
+            'Last Seen',
+            :Status,
+            :Online,
+          ]
+          dt[:rows] = data[:devices].map do |row|
+            [
+              row[:identity],
+              (row[:auth] || {})[:type],
+              row[:locked],
+              row[:reprovision],
+              row[:devmode],
+              row[:lastip],
+              row[:lastseen],
+              row[:status],
+              row[:online],
+            ]
+          end
+        else
+          dt[:headers] = %i[Identifier Status Online]
+          dt[:rows] = data[:devices].map do |row|
+            [row[:identity], row[:status], row[:online]]
+          end
+        end
+        prd.tabularize(dt, ios)
+      end
+      io.close unless io.nil?
+    else
+      prd.warning 'Did not find any devices'
+    end
+  end
+end
+alias_command 'devices list', 'device list'
+
+command 'device read' do |c|
+  c.syntax = %(murano device read <identifier> (<alias>...))
+  c.summary = %(Read state of a device)
+  c.description = %(
+Read state of a device.
+
+This reads the latest state values for the resources in a device.
+  ).strip
+
+  c.option '-o', '--output FILE', %(Download to file instead of STDOUT)
+
+  c.action do |args, options|
+    c.verify_arg_count!(args, nil, ['Identifier missing'])
+
+    prd = MrMurano::Gateway::Device.new
+
+    snid = args.shift
+
+    # FIXME/2017-06-14: Confirm that whirly is helpful here.
+    MrMurano::Verbose.whirly_start 'Fetching device data...'
+    data = prd.read(snid)
+    MrMurano::Verbose.whirly_stop
+    exit 1 if data.nil?
+
+    io = File.open(options.output, 'w') if options.output
+    data.select! { |k, _v| args.include? k.to_s } unless args.empty?
+    prd.outf(data, io) do |dd, ios|
+      rows = []
+      dd.each_pair do |k, v|
+        rows << [k, v[:reported], v[:set], v[:timestamp]]
+      end
+      prd.tabularize(
+        {
+          headers: %i[Alias Reported Set Timestamp],
+          rows: rows,
+        },
+        ios
+      )
+    end
+    io.close unless io.nil?
+  end
+end
+
+command 'device write' do |c|
+  c.syntax = %(murano device write <identifier> <Alias=Value> [<Alias=Value>...])
+  c.summary = %(Write to 'set' of aliases on devices)
+  c.description = %(
+Write to 'set' of aliases on devices.
+
+If an alias is not settable, this will fail.
+  ).strip
+
+  c.action do |args, _options|
+    c.verify_arg_count!(args, nil, ['Identifier missing'])
+
+    resources = (MrMurano::Gateway::GweBase.new.info || {})[:resources]
+
+    prd = MrMurano::Gateway::Device.new
+
+    snid = args.shift
+
+    set = Hash[args.map { |i| i.split('=') }]
+    set.each_pair do |k, v|
+      fmt = ((resources[k.to_sym] || {})[:format] || 'string')
+      case fmt
+      when 'number'
+        if v.to_f.to_i == v.to_i
+          set[k] = v.to_i
+        else
+          set[k] = v.to_f
+        end
+      when 'string'
+        set[k] = '' if v.nil?
+      when 'boolean'
+        set[k] = %w[1 yes true on].include?(v.downcase)
+      end
+    end
+
+    ret = prd.write(snid, set)
+    # On success, write returns empty curlies {}. So check nil or empty.
+    prd.outf(ret) unless ret.nil? || ret.empty?
+  end
+end
+
+command 'device enable' do |c|
+  c.syntax = %(murano device enable [<identifier>|--file <identifiers>])
+  c.summary = %(Enable an Identifier; Creates device in Murano)
+  c.description = %(
+Enables Identifiers, creating the digial shadow in Murano.
+  ).strip
+
+  c.option '-f', '--file FILE', %(A file of serial numbers, one per line)
+  c.option '--key FILE', %(Public TLS key for this device)
+
+  c.action do |args, options|
+    # SKIP: c.verify_arg_count!(args)
+    prd = MrMurano::Gateway::Device.new
+    if !options.file.nil? && !options.key.nil?
+      prd.error %(Cannot use both --file and --key)
+      exit 1
+    end
+    if options.file
+      # Check file for headers.
+      header = File.new(options.file).gets
+      if header.nil?
+        prd.error 'Nothing in file!'
+        exit 1
+      end
+      unless header =~ /\s*ID\s*(,SSL Client Certificate\s*)?/
+        prd.error "Missing column headers in file \"#{options.file}\""
+        prd.error %(First line in file should be either "ID" or "ID, SSL Client Certificate")
+        exit 2
+      end
+      prd.enable_batch(options.file)
+    elsif args.count > 0
+      if options.key
+        File.open(options.key, 'rb') do |io|
+          prd.enable(args[0], type: :certificate, publickey: io)
+        end
+      else
+        prd.enable(args[0])
+      end
+    else
+      prd.error 'Missing an Identifier to enable'
+    end
+  end
+end
+
+command 'device activate' do |c|
+  c.syntax = %(murano device activate <identifier>)
+  c.summary = %(Activate a serial number, retriving its CIK)
+  c.description = %(
+Activate an Identifier.
+
+Generally you should not use this.
+
+Instead, the device should make the activation call itself
+and save the CIK token.
+
+But sometimes when building a proof-of-concept it is just
+easier to hardcode the CIK.
+
+Note that you can only activate a device once. After that
+you cannot retrive the CIK again.
+  ).strip
+
+  c.action do |args, _options|
+    c.verify_arg_count!(args, nil, ['Identifier missing'])
+    prd = MrMurano::Gateway::Device.new
+    prd.outf prd.activate(args.first)
+  end
+end
+
+command 'device delete' do |c|
+  c.syntax = %(murano device delete <identifier>)
+  c.summary = %(Delete a device)
+  c.description = %(
+Delete a device.
+  ).strip
+
+  c.action do |args, _options|
+    c.verify_arg_count!(args, nil, ['Identifier missing'])
+    prd = MrMurano::Gateway::Device.new
+    snid = args.shift
+    ret = prd.remove(snid)
+    prd.outf ret unless ret.empty?
+  end
+end
+
+command 'device httpurl' do |c|
+  c.syntax = %(murano device httpurl)
+  c.summary = %(Get the URL for the HTTP-Data-API for this Project)
+  c.description = %(
+Get the URL for the HTTP-Data-API for this Project.
+  ).strip
+
+  c.action do |args, _options|
+    c.verify_arg_count!(args)
+    prd = MrMurano::Gateway::GweBase.new
+    ret = prd.info
+    say "https://#{ret[:fqdn]}/onep:v1/stack/alias"
+  end
+end
+
+alias_command 'product device', 'device'
+alias_command 'product device list', 'device list'
+alias_command 'product devices list', 'device list'
+alias_command 'product device read', 'device read'
+alias_command 'product device twee', 'device read'
+alias_command 'product device write', 'device write'
+alias_command 'product device enable', 'device enable'
+alias_command 'product device activate', 'device activate'
+alias_command 'product device delete', 'device delete'
+alias_command 'product device httpurl', 'device httpurl'
+

data/lib/MrMurano/commands/domain.rb

@@ -1,17 +1,57 @@
+# Last Modified: 2017.08.16 /coding: utf-8
+# frozen_string_literal: true
+
+# Copyright © 2016-2017 Exosite LLC.
+# License: MIT. See LICENSE.txt.
+#  vim:tw=0:ts=2:sw=2:et:ai
+
+require 'MrMurano/ReCommander'
 require 'MrMurano/Solution'
+require 'MrMurano/commands/solution'
+
 command :domain do |c|
-  c.syntax = %{murano domain}
-  c.summary = %{Print the domain for this solution}
-  c.option '--[no-]raw', %{Don't add scheme}
-  c.action do |args,options|
-    options.default :raw=>true
-    sol = MrMurano::Solution.new
-    ret = sol.info()
-    if options.raw then
-      say ret[:domain]
-    else
-      say "https://#{ret[:domain]}"
+  c.syntax = %(murano domain)
+  c.summary = %(Print the domain for this solution)
+  c.description = %(
+Print the domain for this solution.
+  ).strip
+
+  c.option '--[no-]raw', %(Don't add scheme (default with brief))
+  c.option '--[no-]brief', %(Show fewer fields: only the URL)
+  c.option '--[no-]all', 'Show domains for all Solutions in Business, not just Project'
+
+  # Add flag: --type [application|product|all].
+  cmd_add_solntype_pickers(c)
+
+  c.action do |args, options|
+    c.verify_arg_count!(args)
+    options.default(all: false)
+    options.default(raw: true) if options.brief
+    cmd_defaults_solntype_pickers(options)
+
+    solz = must_fetch_solutions!(options)
+
+    domain_s = MrMurano::Verbose.pluralize?('domain', solz.length)
+    MrMurano::Verbose.whirly_start("Fetching #{domain_s}...")
+    solz.each do |soln|
+      # Get the solution info; stores the result in the Solution object.
+      _meta = soln.info_safe
+    end
+    MrMurano::Verbose.whirly_stop
+
+    solz.each do |sol|
+      if !options.brief
+        say(sol.pretty_desc(add_type: true, raw_url: options.raw))
+      elsif options.raw
+        say(sol.domain)
+      else
+        say("https://#{sol.domain}")
+      end
     end
   end
 end
-#  vim: set ai et sw=2 ts=2 :
+alias_command 'domain application', 'domain', '--type', 'application'
+alias_command 'domain product', 'domain', '--type', 'product'
+alias_command 'application domain', 'domain', '--type', 'application'
+alias_command 'product domain', 'domain', '--type', 'product'
+

data/lib/MrMurano/commands/gb.rb

@@ -1,3 +1,10 @@
+# Last Modified: 2017.08.16 /coding: utf-8
+# frozen_string_literal: true
+
+# Copyright © 2016-2017 Exosite LLC.
+# License: MIT. See LICENSE.txt.
+#  vim:tw=0:ts=2:sw=2:et:ai
+
 require 'pp'
 
 # You don't need this.
@@ -6,29 +13,37 @@ require 'pp'
 # - ln gb.rb ~/.murano/plugins
 
 command :_gb do |c|
-  c.syntax = %{murano _gb <class> <method> (<args>)}
-  c.summary = %{Call internal class methods directly.}
-  c.description = %{Call internal class methods directly.}
+  c.syntax = %(murano _gb <class> <method> (<args>))
+  c.summary = %(Call internal class methods directly)
+  c.description = %(
+Call internal class methods directly.
+  ).strip
+  c.project_not_required = true
+
+  # Will a plugin need to let user restrict the solution type?
+  # Add flag: --type [application|product|all].
+  cmd_add_solntype_pickers(c)
 
   c.action do |args, options|
+    # SKIP: c.verify_arg_count!(args)
+    cmd_defaults_solntype_pickers(options)
+
     cls = args[0]
     meth = args[1].to_sym
     args.shift(2)
 
     begin
-      gb = Object::const_get("MrMurano::#{cls}").new
-      if gb.respond_to? meth then
+      gb = Object.const_get("MrMurano::#{cls}").new
+      if gb.respond_to? meth
         ret = gb.__send__(meth, *args)
-        gb.outf(ret) {|o,i| pp o}
+        gb.outf(ret) { |o, _i| pp o }
       else
         say_error "'#{cls}' doesn't '#{meth}'"
       end
-    rescue Exception => e
+    rescue StandardError => e
       say_error e.message
       pp e
     end
   end
 end
 
-
-#  vim: set ai et sw=2 ts=2 :