turbot 0.0.2

data/lib/turbot/command/help.rb

@@ -0,0 +1,179 @@
+require "turbot/command/base"
+require "turbot/deprecated/help"
+
+# list commands and display help
+#
+class Turbot::Command::Help < Turbot::Command::Base
+
+  PRIMARY_NAMESPACES = %w( auth bots ps run addons config releases domains logs sharing )
+
+  include Turbot::Deprecated::Help
+
+  # help [COMMAND]
+  #
+  # list available commands or display help for a specific command
+  #
+  #Examples:
+  #
+  # $ turbot help
+  # Usage: turbot COMMAND [--bot APP] [command-specific-options]
+  #
+  # Primary help topics, type "turbot help TOPIC" for more details:
+  #
+  #   addons    #  manage addon resources
+  #   bots      #  manage bots (create, destroy)
+  #   ...
+  #
+  # Additional topics:
+  #
+  #   account      #  manage turbot account options
+  #   accounts     #  manage multiple turbot accounts
+  #   ...
+  #
+  # $ turbot help bots:create
+  # Usage: turbot bots:create [NAME]
+  #
+  #  create a new bot
+  #
+  #      --addons ADDONS        # a comma-delimited list of addons to install
+  #  -b, --buildpack BUILDPACK  # a buildpack url to use for this bot
+  #  -r, --remote REMOTE        # the git remote to create, default "turbot"
+  #  -s, --stack STACK          # the stack on which to create the bot
+  #
+  def index
+    if command = args.shift
+      help_for_command(command)
+    else
+      help_for_root
+    end
+  end
+
+  alias_command "-h", "help"
+  alias_command "--help", "help"
+
+private
+
+  def commands_for_namespace(name)
+    Turbot::Command.commands.values.select do |command|
+      command[:namespace] == name && command[:command] != name
+    end
+  end
+
+  def namespaces
+    namespaces = Turbot::Command.namespaces
+    namespaces.delete("bot")
+    namespaces
+  end
+
+  def commands
+    Turbot::Command.commands
+  end
+
+  def legacy_help_for_namespace(namespace)
+    instance = Turbot::Command::Help.groups.map do |group|
+      [ group.title, group.select { |c| c.first =~ /^#{namespace}/ }.length ]
+    end.sort_by { |l| l.last }.last
+    return nil unless instance
+    return nil if instance.last.zero?
+    instance.first
+  end
+
+  def legacy_help_for_command(command)
+    Turbot::Command::Help.groups.each do |group|
+      group.each do |cmd, description|
+        return description if cmd.split(" ").first == command
+      end
+    end
+    nil
+  end
+
+  def skip_namespace?(ns)
+    return true if ns[:description] =~ /DEPRECATED:/
+    return true if ns[:description] =~ /HIDDEN:/
+    false
+  end
+
+  def skip_command?(command)
+    return true if command[:help] =~ /DEPRECATED:/
+    return true if command[:help] =~ /^ HIDDEN:/
+    false
+  end
+
+  def primary_namespaces
+    PRIMARY_NAMESPACES.map { |name| namespaces[name] }.compact
+  end
+
+  def additional_namespaces
+    (namespaces.values - primary_namespaces)
+  end
+
+  def summary_for_namespaces(namespaces)
+    size = longest(namespaces.map { |n| n[:name] })
+    namespaces.sort_by {|namespace| namespace[:name]}.each do |namespace|
+      next if skip_namespace?(namespace)
+      name = namespace[:name]
+      namespace[:description] ||= legacy_help_for_namespace(name)
+      puts "  %-#{size}s  # %s" % [ name, namespace[:description] ]
+    end
+  end
+
+  def help_for_root
+    puts "Usage: turbot COMMAND [--bot APP] [command-specific-options]"
+    puts
+    puts "Primary help topics, type \"turbot help TOPIC\" for more details:"
+    puts
+    summary_for_namespaces(primary_namespaces)
+    puts
+    puts "Additional topics:"
+    puts
+    summary_for_namespaces(additional_namespaces)
+    puts
+  end
+
+  def help_for_namespace(name)
+    namespace_commands = commands_for_namespace(name)
+
+    unless namespace_commands.empty?
+      size = longest(namespace_commands.map { |c| c[:banner] })
+      namespace_commands.sort_by { |c| c[:banner].to_s }.each do |command|
+        next if skip_command?(command)
+        command[:summary] ||= legacy_help_for_command(command[:command])
+        puts "  %-#{size}s  # %s" % [ command[:banner], command[:summary] ]
+      end
+    end
+  end
+
+  def help_for_command(name)
+    if command_alias = Turbot::Command.command_aliases[name]
+      display("Alias: #{name} redirects to #{command_alias}")
+      name = command_alias
+    end
+    if command = commands[name]
+      puts "Usage: turbot #{command[:banner]}"
+
+      if command[:help].strip.length > 0
+        help = command[:help].split("\n").reject do |line|
+          line =~ /HIDDEN/
+        end
+        puts help[1..-1].join("\n")
+      else
+        puts
+        puts " " + legacy_help_for_command(name).to_s
+      end
+      puts
+    end
+
+    namespace_commands = commands_for_namespace(name).reject do |command|
+      command[:help] =~ /DEPRECATED/
+    end
+
+    if !namespace_commands.empty?
+      puts "Additional commands, type \"turbot help COMMAND\" for more details:"
+      puts
+      help_for_namespace(name)
+      puts
+    elsif command.nil?
+      error "#{name} is not a turbot command. See `turbot help`."
+    end
+  end
+end

data/lib/turbot/command/keys.rb

@@ -0,0 +1,115 @@
+require "turbot/command/base"
+
+module Turbot::Command
+
+  # manage authentication keys
+  #
+  class Keys < Base
+
+    # keys
+    #
+    # display keys for the current user
+    #
+    # -l, --long  # display extended information for each key
+    #
+    #Examples:
+    #
+    # $ turbot keys
+    # === email@example.com Keys
+    # ssh-rsa ABCDEFGHIJK...OPQRSTUV== email@example.com
+    #
+    # $ turbot keys --long
+    # === email@example.com Keys
+    # ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAp9AJD5QABmOcrkHm6SINuQkDefaR0MUrfgZ1Pxir3a4fM1fwa00dsUwbUaRuR7FEFD8n1E9WwDf8SwQTHtyZsJg09G9myNqUzkYXCmydN7oGr5IdVhRyv5ixcdiE0hj7dRnOJg2poSQ3Qi+Ka8SVJzF7nIw1YhuicHPSbNIFKi5s0D5a+nZb/E6MNGvhxoFCQX2IcNxaJMqhzy1ESwlixz45aT72mXYq0LIxTTpoTqma1HuKdRY8HxoREiivjmMQulYP+CxXFcMyV9kxTKIUZ/FXqlC6G5vSm3J4YScSatPOj9ID5HowpdlIx8F6y4p1/28r2tTl4CY40FFyoke4MQ== email@example.com
+    #
+    def index
+      validate_arguments!
+      keys = api.get_keys
+      if keys.length > 0
+        styled_header("#{Turbot::Auth.user} Keys")
+        keys = if options[:long]
+          keys.map {|key| key["contents"].strip}
+        else
+          keys.map {|key| format_key_for_display(key["contents"])}
+        end
+        styled_array(keys)
+      else
+        display("You have no keys.")
+      end
+    end
+
+    # keys:add [KEY]
+    #
+    # add a key for the current user
+    #
+    # if no KEY is specified, will try to find ~/.ssh/id_[rd]sa.pub
+    #
+    #Examples:
+    #
+    # $ turbot keys:add
+    # Could not find an existing public key.
+    # Would you like to generate one? [Yn] y
+    # Generating new SSH public key.
+    # Uploading SSH public key /.ssh/id_rsa.pub... done
+    #
+    # $ turbot keys:add /my/key.pub
+    # Uploading SSH public key /my/key.pub... done
+    #
+    def add
+      keyfile = shift_argument
+      validate_arguments!
+
+      if keyfile
+        Turbot::Auth.associate_key(keyfile)
+      else
+        # make sure we have credentials
+        Turbot::Auth.get_credentials
+        Turbot::Auth.associate_or_generate_ssh_key
+      end
+    end
+
+    # keys:remove KEY
+    #
+    # remove a key from the current user
+    #
+    #Examples:
+    #
+    # $ turbot keys:remove email@example.com
+    # Removing email@example.com SSH key... done
+    #
+    def remove
+      key = shift_argument
+      if key.nil? || key.empty?
+        error("Usage: turbot keys:remove KEY\nMust specify KEY to remove.")
+      end
+      validate_arguments!
+
+      action("Removing #{key} SSH key") do
+        api.delete_key(key)
+      end
+    end
+
+    # keys:clear
+    #
+    # remove all authentication keys from the current user
+    #
+    #Examples:
+    #
+    # $ turbot keys:clear
+    # Removing all SSH keys... done
+    #
+    def clear
+      validate_arguments!
+
+      action("Removing all SSH keys") do
+        api.delete_keys
+      end
+    end
+
+    protected
+      def format_key_for_display(key)
+        type, hex, local = key.strip.split(/\s/)
+        [type, hex[0,10] + '...' + hex[-10,10], local].join(' ')
+      end
+  end
+end

data/lib/turbot/command/logs.rb

@@ -0,0 +1,34 @@
+require "turbot/command/base"
+require "turbot/helpers/log_displayer"
+
+# display logs for an bot
+#
+class Turbot::Command::Logs < Turbot::Command::Base
+
+  # logs
+  #
+  # display recent log output
+  #
+  # -n, --num NUM        # the number of lines to display
+  # -p, --ps PS          # only display logs from the given process
+  # -s, --source SOURCE  # only display logs from the given source
+  # -t, --tail           # continually stream logs
+  #
+  #Example:
+  #
+  # $ turbot logs
+  # 2012-01-01T12:00:00+00:00 turbot[api]: Config add EXAMPLE by email@example.com
+  # 2012-01-01T12:00:01+00:00 turbot[api]: Release v1 created by email@example.com
+  #
+  def index
+    validate_arguments!
+
+    opts = []
+    opts << "tail=1"                                 if options[:tail]
+    opts << "num=#{options[:num]}"                   if options[:num]
+    opts << "ps=#{URI.encode(options[:ps])}"         if options[:ps]
+    opts << "source=#{URI.encode(options[:source])}" if options[:source]
+    log_displayer = ::Turbot::Helpers::LogDisplayer.new(api, bot, opts)
+    log_displayer.display_logs
+  end
+end

data/lib/turbot/command/ssl.rb

@@ -0,0 +1,43 @@
+require "turbot/command/base"
+
+module Turbot::Command
+
+  # DEPRECATED: see `turbot certs` instead
+  #
+  # manage ssl certificates for an bot
+  #
+  class Ssl < Base
+
+    # ssl
+    #
+    # list legacy certificates for an bot
+    #
+    def index
+      api.get_domains(bot).body.each do |domain|
+        if cert = domain['cert']
+          display "#{domain['domain']} has a SSL certificate registered to #{cert['subject']} which expires on #{format_date(cert['expires_at'])}"
+        else
+          display "#{domain['domain']} has no certificate"
+        end
+      end
+    end
+
+    # ssl:add PEM KEY
+    #
+    # DEPRECATED: see `turbot certs:add` instead
+    #
+    def add
+      $stderr.puts " !    `turbot ssl:add` has been deprecated. Please use the SSL Endpoint add-on and the `turbot certs` commands instead."
+      $stderr.puts " !    SSL Endpoint documentation is available at: https://devcenter.turbot.com/articles/ssl-endpoint"
+    end
+
+    # ssl:clear
+    #
+    # remove legacy ssl certificates from an bot
+    #
+    def clear
+      turbot.clear_ssl(bot)
+      display "Cleared certificates for #{bot}"
+    end
+  end
+end

data/lib/turbot/command/status.rb

@@ -0,0 +1,51 @@
+require "turbot/command/base"
+
+# check status of turbot platform
+#
+class Turbot::Command::Status < Turbot::Command::Base
+
+  # status
+  #
+  # display current status of turbot platform
+  #
+  #Example:
+  #
+  # $ turbot status
+  # === Turbot Status
+  # Development: No known issues at this time.
+  # Production:  No known issues at this time.
+  #
+  def index
+    validate_arguments!
+
+    turbot_status_host = ENV['TURBOT_STATUS_HOST'] || "status.turbot.com"
+    require('excon')
+    status = json_decode(Excon.get("https://#{turbot_status_host}/api/v3/current-status.json", :nonblock => false).body)
+
+    styled_header("Turbot Status")
+
+    status['status'].each do |key, value|
+      if value == 'green'
+        status['status'][key] = 'No known issues at this time.'
+      end
+    end
+    styled_hash(status['status'])
+
+    unless status['issues'].empty?
+      display
+      status['issues'].each do |issue|
+        duration = time_ago(issue['created_at']).gsub(' ago', '+')
+        styled_header("#{issue['title']}  #{duration}")
+        changes = issue['updates'].map do |issue|
+          [
+            time_ago(issue['created_at']),
+            issue['update_type'],
+            issue['contents']
+          ]
+        end
+        styled_array(changes, :sort => false)
+      end
+    end
+  end
+
+end

data/lib/turbot/command/update.rb

@@ -0,0 +1,47 @@
+require "turbot/command/base"
+require "turbot/updater"
+
+# update the turbot client
+#
+class Turbot::Command::Update < Turbot::Command::Base
+
+  # update
+  #
+  # update the turbot client
+  #
+  # Example:
+  #
+  # $ turbot update
+  # Updating from v1.2.3... done, updated to v2.3.4
+  #
+  def index
+    validate_arguments!
+    update_from_url("https://toolbelt.turbot.com/download/zip")
+  end
+
+  # update:beta
+  #
+  # update to the latest beta client
+  #
+  # $ turbot update
+  # Updating from v1.2.3... done, updated to v2.3.4.pre
+  #
+  def beta
+    validate_arguments!
+    update_from_url("https://toolbelt.turbot.com/download/beta-zip")
+  end
+
+private
+
+  def update_from_url(url)
+    Turbot::Updater.check_disabled!
+    action("Updating from #{Turbot::VERSION}") do
+      if new_version = Turbot::Updater.update(url)
+        status("updated to #{new_version}")
+      else
+        status("nothing to update")
+      end
+    end
+  end
+
+end

data/lib/turbot/command/version.rb

@@ -0,0 +1,23 @@
+require "turbot/command/base"
+require "turbot/version"
+
+# display version
+#
+class Turbot::Command::Version < Turbot::Command::Base
+
+  # version
+  #
+  # show turbot client version
+  #
+  #Example:
+  #
+  # $ turbot version
+  # turbot-toolbelt/1.2.3 (x86_64-darwin11.2.0) ruby/1.9.3
+  #
+  def index
+    validate_arguments!
+
+    display(Turbot.user_agent)
+  end
+
+end