ftl 0.1.1 → 0.2.0

data/.bundle/config

@@ -0,0 +1,2 @@
+---
+BUNDLE_DISABLE_SHARED_GEMS: '1'

data/.gitignore

@@ -1,21 +1,4 @@
-## MAC OS
 .DS_Store
-
-## TEXTMATE
-*.tmproj
-tmtags
-
-## EMACS
-*~
-\#*
-.\#*
-
-## VIM
-*.swp
-
-## PROJECT::GENERAL
-coverage
-rdoc
+results.html
 pkg
-
-## PROJECT::SPECIFIC
+html

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ftl.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,67 @@
+PATH
+  remote: .
+  specs:
+    ftl (0.2.0)
+      fog
+      formatador (~> 0.2.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aruba (0.4.11)
+      childprocess (>= 0.2.3)
+      cucumber (>= 1.1.1)
+      ffi (>= 1.0.11)
+      rspec (>= 2.7.0)
+    builder (3.0.0)
+    childprocess (0.3.2)
+      ffi (~> 1.0.6)
+    cucumber (1.2.0)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.10.0)
+      json (>= 1.4.6)
+    diff-lcs (1.1.3)
+    excon (0.13.4)
+    ffi (1.0.11)
+    fog (1.3.1)
+      builder
+      excon (~> 0.13.0)
+      formatador (~> 0.2.0)
+      mime-types
+      multi_json (~> 1.0)
+      net-scp (~> 1.0.4)
+      net-ssh (>= 2.1.3)
+      nokogiri (~> 1.5.0)
+      ruby-hmac
+    formatador (0.2.2)
+    gherkin (2.10.0)
+      json (>= 1.4.6)
+    json (1.7.3)
+    mime-types (1.18)
+    multi_json (1.3.5)
+    net-scp (1.0.4)
+      net-ssh (>= 1.99.1)
+    net-ssh (2.3.0)
+    nokogiri (1.5.2)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.0)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    ruby-hmac (0.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  ftl!
+  rake (~> 0.9.2)
+  rdoc

data/LICENSE

@@ -1,4 +1,6 @@
-Copyright (c) 2010 Matt Petty
+Copyright (c) 2012 Matt Petty
+
+MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -17,4 +19,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# Ftl
+
+Faster Than Light. Fog Terminal Language. For Terminal Launching.
+
+## Description
+
+Ftl is an AWS (fog) based application for managing cloud instances from the command line.
+
+## Installation
+
+Install is easy.
+
+    $ gem install ftl # or sudo gem install ftl
+
+## Usage
+
+### Example commands
+
+    Usage: ftl [<config-options>] <command> [<command-options>]
+        commands: start, kill, list, connect, servers, tags, images, snapshots, volumes
+        examples:
+          ftl start ninja                    # starts an instance named 'ninja'
+          ftl up ninja                       # starts an instance named 'ninja'
+          ftl spinup ninja                   # starts an instance named 'ninja'
+          ftl launch ninja                   # starts an instance named 'ninja'
+          ftl start ninja                    # starts an instance named 'ninja'
+          ftl list                           # shows running instances and status
+          ftl l                              # shows running instances and status
+          ftl connect ninja                  # connects to instance named 'ninja'
+          ftl kill ninja                     # kills instance Named "ninja"
+          ftl kill i-123456                  # kills instance with id i-123456
+          ftl images                         # shows aws images
+          ftl snapshots                      # shows aws snapshots
+          ftl tags                           # shows aws tags
+          ftl volumes                        # shows aws volumes
+          ftl --config=~/ftl.yml servers     # Uses custom config file 
+          ftl -c=~/ftl.yml servers           # Uses custom config file 
+          ftl --headers=id,tags.Name servers # Uses headers 
+          ftl headers servers                # Show possible headers for servers
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -1,53 +1,31 @@
-require 'rubygems'
-require 'rake'
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "ftl"
-    gem.summary = %Q{Easily launch ec2 instances for pair programming}
-    gem.description = %Q{FTL spins up and down Amazon EC2 instances for pair programming}
-    gem.email = "matt@kizmeta.com"
-    gem.homepage = "http://github.com/lodestone/ftl"
-    gem.authors = ["Matt Petty"]
-    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
-end
-
+require 'bundler'
+require 'rake/clean'
 require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-end
+require 'cucumber'
+require 'cucumber/rake/task'
+gem 'rdoc' # we need the installed RDoc gem, not the system one
+require 'rdoc/task'
 
-begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |test|
-    test.libs << 'test'
-    test.pattern = 'test/**/test_*.rb'
-    test.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
-end
+include Rake::DSL
 
-task :test => :check_dependencies
+Bundler::GemHelper.install_tasks
 
-task :default => :test
+Rake::TestTask.new do |t|
+  t.pattern = 'test/tc_*.rb'
+end
 
-require 'rake/rdoctask'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+CUKE_RESULTS = 'results.html'
+CLEAN << CUKE_RESULTS
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format html -o #{CUKE_RESULTS} --format progress -x"
+  t.fork = false
+end
 
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "ftl #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
+Rake::RDocTask.new do |rd|
+  
+  rd.main = "README.rdoc"
+  
+  rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
 end
+
+task :default => [:test,:features]

data/bin/ftl

@@ -1,5 +1,27 @@
 #!/usr/bin/env ruby
-require 'rubygems'
+$LOAD_PATH << 'lib'
+require 'optparse'
 require 'ftl'
-FTL::Client.new(ARGV)
+
+options = {}
+optparse = OptionParser.new do |opts|
+
+  opts.on('-h', '--help', "Display this message") do
+    Ftl.help
+    exit
+  end
+
+  opts.on('-h', '--headers FILE', Array, "provide custom config file") do |headers|
+    options[:headers] = headers
+  end
+
+  opts.on('-c', '--config FILE', "provide custom config file") do
+    puts "Supplied config file"
+    puts opts
+  end
+
+end
+
+optparse.parse!
+Ftl::Client.new(ARGV, options)
 

data/features/ftl.feature

@@ -0,0 +1,13 @@
+Feature: My bootstrapped app kinda works
+  In order to get going on coding my awesome app
+  I want to have aruba and cucumber setup
+  So I don't have to do it myself
+
+  Scenario: App just runs
+    When I get help for "ftl"
+    Then the exit status should be 0
+    And the banner should be present
+    And the banner should document that this app takes options
+    And the following options should be documented:
+      |--version|
+    And the banner should document that this app takes no arguments

data/features/step_definitions/ftl_steps.rb

@@ -0,0 +1 @@
+# Put your step defintions here

data/features/support/env.rb

@@ -0,0 +1,16 @@
+require 'aruba/cucumber'
+require 'methadone/cucumber'
+
+ENV['PATH'] = "#{File.expand_path(File.dirname(__FILE__) + '/../../bin')}#{File::PATH_SEPARATOR}#{ENV['PATH']}"
+LIB_DIR = File.join(File.expand_path(File.dirname(__FILE__)),'..','..','lib')
+
+Before do
+  # Using "announce" causes massive warnings on 1.9.2
+  @puts = true
+  @original_rubylib = ENV['RUBYLIB']
+  ENV['RUBYLIB'] = LIB_DIR + File::PATH_SEPARATOR + ENV['RUBYLIB'].to_s
+end
+
+After do
+  ENV['RUBYLIB'] = @original_rubylib
+end

data/ftl.gemspec

@@ -1,63 +1,22 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
 # -*- encoding: utf-8 -*-
+require File.expand_path('../lib/ftl/version', __FILE__)
 
-Gem::Specification.new do |s|
-  s.name = %q{ftl}
-  s.version = "0.1.1"
+Gem::Specification.new do |gem|
+  gem.authors       = ["Matt Petty"]
+  gem.email         = ["matt@kizmeta.com"]
+  gem.description   = %q{Ftl is a command line tool for Fog/AWS}
+  gem.summary       = %q{Ftl is a command line tool for Fog/AWS}
+  gem.homepage      = "http://github.com/lodestone/ftl"
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Matt Petty"]
-  s.date = %q{2010-08-16}
-  s.default_executable = %q{ftl}
-  s.description = %q{FTL spins up and down Amazon EC2 instances for pair programming}
-  s.email = %q{matt@kizmeta.com}
-  s.executables = ["ftl"]
-  s.extra_rdoc_files = [
-    "LICENSE",
-     "README.rdoc",
-     "TODO"
-  ]
-  s.files = [
-    ".document",
-     ".gems",
-     ".gitignore",
-     "LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "TODO",
-     "VERSION",
-     "bin/ftl",
-     "config.ru",
-     "ftl.gemspec",
-     "lib/ftl.rb",
-     "lib/ftl/client.rb",
-     "lib/ftl/server.rb",
-     "test/helper.rb",
-     "test/test_ftl.rb"
-  ]
-  s.homepage = %q{http://github.com/lodestone/ftl}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
-  s.summary = %q{Easily launch ec2 instances for pair programming}
-  s.test_files = [
-    "test/helper.rb",
-     "test/test_ftl.rb"
-  ]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-    else
-      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-    end
-  else
-    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
-  end
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "ftl"
+  gem.require_paths = ["lib"]
+  gem.version       = Ftl::VERSION
+  gem.add_development_dependency('rdoc')
+  gem.add_development_dependency('aruba')
+  gem.add_development_dependency('rake','~> 0.9.2')
+  gem.add_dependency('fog')
+  gem.add_dependency('formatador', '~> 0.2.2')
 end
-

data/lib/ftl.rb

@@ -1 +1,11 @@
-require 'ftl/client'
+require 'yaml'
+require "ftl/version"
+require "ftl/client"
+require "ftl/server"
+require "fog"
+require 'formatador'
+require 'ftl/fog_lights'
+
+module Ftl
+  # I'm a module!
+end

data/lib/ftl/client.rb

@@ -1,21 +1,49 @@
-require 'httparty'
-require 'json'
+module Ftl
+
+  def self.help_message
+    %Q{
+    Usage: [bold]ftl[/] \[<config-options>\] <command> \[<command-options>\]
+      commands: start, kill, list, connect, servers, tags, images, snapshots, volumes
+      examples:
+        ftl start ninja                    # starts an instance named 'ninja'
+        ftl up ninja                       # starts an instance named 'ninja'
+        ftl spinup ninja                   # starts an instance named 'ninja'
+        ftl launch ninja                   # starts an instance named 'ninja'
+        ftl start ninja                    # starts an instance named 'ninja'
+        ftl list                           # shows running instances and status
+        ftl l                              # shows running instances and status
+        ftl connect ninja                  # connects to instance named 'ninja'
+        ftl kill ninja                     # kills instance Named "ninja"
+        ftl kill i-123456                  # kills instance with id i-123456
+        ftl images                         # shows aws images
+        ftl snapshots                      # shows aws snapshots
+        ftl tags                           # shows aws tags
+        ftl volumes                        # shows aws volumes
+        ftl --config=~/ftl.yml servers     # Uses custom config file 
+        ftl -c=~/ftl.yml servers           # Uses custom config file 
+        ftl --headers=id,tags.Name servers # Uses headers 
+        ftl headers servers                # Show possible headers for servers
+    }
+  end
 
-module FTL
+  def self.help(*args)
+    Formatador.display_line help_message
+  end
 
   class Client
 
-    include HTTParty
-
-    CONFIG = YAML.load_file(ENV['HOME']+'/.ftl/ftl.yml')
-    ACCESS_KEY_ID     = CONFIG['ACCESS_KEY_ID']
-    SECRET_ACCESS_KEY = CONFIG['SECRET_ACCESS_KEY']
-
-    base_uri CONFIG['server']
-    format :json
-
-    def initialize(args={})
-      send(args.reverse!.pop, args)
+    attr_reader :con
+    attr_accessor :options
+
+    def initialize(args=nil, opts={})
+      load_config(opts)
+      @con = Fog::Compute.new(:provider => 'AWS', :aws_secret_access_key => options['SECRET_ACCESS_KEY'], :aws_access_key_id => options['ACCESS_KEY_ID'])
+      if args
+        arg = args.reverse.pop
+        send(arg, args - [arg])
+      else
+        Ftl.help
+      end
     end
 
     def start(args={})
@@ -23,33 +51,32 @@ module FTL
         puts "Please provide a short name for instance, like: ftl start ninjaserver"
         return
       end
-      puts "Spinning up FTL..."
-      self.class.post('/machines', :body => '', :query => {:name => args.first, :ami => CONFIG['ami']}, :instance_type => (CONFIG['type'] || 'c1.medium'))
+      display "Spinning up FTL..."
+      i = con.servers.create(:user_data => options[:user_data],
+                             :key_name  => options[:keypair], 
+                             :groups    => options[:groups], 
+                             :image_id  => options[:ami], 
+                             :flavor_id => options[:instance_type], 
+                             :username  => options[:username]
+                             )
+      tag = con.tags.new(:key => "Name", :value => args.first)
+      tag.resource_id = i.id
+      tag.resource_type = 'instance'
+      tag.save
+      display i
     end
-    alias :up :start 
+    alias :up     :start 
+    alias :launch :start 
     alias :spinup :start
     alias :create :start
-    alias :new :start
+    alias :new    :start
 
     def connect(args={})
-      # Do some monkeying with .ssh/known_hosts to clear ones we've seen before
-      response = self.class.get('/machines')
-      if response.length == 0
-        puts "No machines running. try: ftl start <servername>"
-      elsif response.length == 1
-        server = response.first
-      elsif response.length > 1 
-        if args.first.nil?
-          puts "Please provide the name (or partial name for the instance(s) you want to delete. For instance, like: ftl destroy ninja"
-        end
-        puts "Looking for connection to #{args.first}..."
-        server = response.detect{|r| r['name'].first[args.first] }
-        puts "Connecting to #{args.first}..."
-        if server.nil?
-          puts "Couldn't find that server name. try: ftl list"
-        end
+      if match = find_instance(args.first)
+        exec("ssh #{options[:username]||'root'}@#{match[:dns_name]}")
+      else
+        display "Typo alert! No server found!"
       end
-      exec("ssh dev@#{server['dns_name']}") if server['dns_name']
     end
     alias :c :connect
 
@@ -58,88 +85,121 @@ module FTL
         puts "Please provide the name (or partial name for the instance(s) you want to delete. For instance, like: ftl destroy ninja"
         return
       end
-      puts "Spinning down FTL..."
-      response = self.class.delete('/machines', :query => {:name => args.first}, :body => {:name => args.first})
-      puts response['message']
+      display "Spinning down FTL..."
+      instance = find_instance(args.first)
+      instance.destroy
     end
+    alias :d        :destroy 
     alias :kill     :destroy 
     alias :down     :destroy 
     alias :shutdown :destroy 
 
+    def info(args={})
+      display find_instance(args.first)
+    end
+    alias :i :info
 
-    def list(args={})
-      response = self.class.get('/machines')
-      column_widths = {'#' => 4}
-      if response.empty?
-        puts "No machines are running"
-        return
-      end
-      keys          = response.first.keys
-      display_keys  = ['#'] + keys
-      separator     = ' |'
-            
-                    
-      keys.each {|r|
-        widths = [r.length + separator.length]
-        widths = widths + response.collect {|pm|
-          # WOW right_aws sucks. Why is everything an array. BS
-          if pm[r].nil?
-            0
-          else
-            pm[r].first.length + separator.length
-          end
-        }
-        column_widths[r] = widths.max 
-      }
-
-      # Headers
-      display_keys.sort.each do |key|
-        print key.rjust(column_widths[key])
-        print separator 
-      end
-      print "\n"
-
-      # Machines
-      response.each_with_index do |r,idx|
-        r['#'] = "#{idx+1}"
-        display_keys.sort.each do |key|
-          value = r[key].nil? ? '-' : r[key].first
-          print value.rjust(column_widths[key])
-          print separator
+    def list(args=[:servers])
+      server_instances.table(_headers_for(args.first))
+    end
+    alias :l :list
+
+    def image(args={})
+      Formatador.display_table(con.images.find(:id => args.first))
+    end
+
+    def headers(args={})
+      display "Showing header options for #{args.first}"
+      display con.send(args.first).first.attributes.keys
+    end
+
+    def server_instances(args={})
+      @servers ||= @con.servers.all
+    end
+
+    ###########################################################################
+    private
+
+    def ftl_yml
+%Q%
+ACCESS_KEY_ID: 
+SECRET_ACCESS_KEY: 
+:ami: ami-a29943cb # Ubuntu 12.04 LTS Precise Pangolin
+:username: ubuntu
+:instance_type: c1.medium
+:default_username: ubuntu
+:instance_script: |
+  #!/bin/sh
+  touch file.touched
+:spinup_script: | 
+  class Samurai
+    def slice!
+      puts "slice"
+    end
+  end
+  Samurai.new.slice!
+%
+    end
+
+    def load_config(opts={})
+      # TODO Make this less shitty. Such a common pattern.
+      default_config_name = 'ftl.yml'
+      default_config_dir  = '/.ftl/'
+      default_config_home = "#{ENV['HOME']}#{default_config_dir}"
+      default_config_file = "#{default_config_home}#{default_config_name}"
+      if Dir.exist?(default_config_home) 
+        if !File.exist?(default_config_file)     
+          File.open(default_config_file, 'w') {|f| f << ftl_yml }
         end
-        print "\n"
+      else
+        Dir.mkdir(default_config_home)
+        File.open(default_config_file, 'w') {|f| f << ftl_yml }
       end
+      @options = YAML.load_file(default_config_file)
+      @options = @options.merge(opts)
+      puts "======Please open #{default_config_file} and set ACCESS_KEY_ID and SECRET_ACCESS_KEY====\n\n" if aws_credentials_absent?
     end
 
-    def help(*args)
-      puts "Usage: ftl <command> <options>"
-      puts "  commands: start kill list connect"
-      puts "  examples:"
-      puts "    ftl start ninja   # starts an instance named 'ninja'"
-      puts "    ftl list          # shows running instances and status"
-      puts "    ftl connect       # connects to instance if only one is running"
-      puts "    ftl connect ninja # connects to instance named 'ninja'"
-      puts "    ftl kill nin      # kills all instances matching /nin/"
+    def find_instance(name)
+      id_match  = server_instances.find{|i| i[:id] == name } if name[/^i-/]
+      tag_match = server_instances.find{|i| !i.tags.nil? && i.tags['Name'] == name }
+      id_match || tag_match
+    end
+
+    def _headers_for(object)
+      return options[:headers].map(&:to_sym) if options[:headers]
+      case object
+      when :snapshots
+        [:id, :volume_id, :state, :volume_size, :description, :"tags.Name"]
+      when :volumes
+        [:server_id, :id, :size, :snapshot_id, :availability_zone, :state, :"tags.Name"]
+      when nil
+        [:id, :image_id, :flavor_id, :availability_zone, :state, :"tags.Name"]
+      end
+    end
+
+    def aws_credentials_absent?
+      options['ACCESS_KEY_ID'].nil? || options['SECRET_ACCESS_KEY'].nil?
+    end
+
+    def display(message)
+      msg = message.is_a?(String) ? message : message.inspect
+      Formatador.display_line(msg)
     end
 
     def method_missing(*args)
-      help
+      begin
+        method = args.first
+        options = args[1]
+        if con.respond_to? method
+          display con.send(method).table(_headers_for(method))
+        else
+          Ftl.help
+        end
+      rescue 
+      end
     end
 
   end
 
 end
-
-# TODO:
-# Server:
-#   establish connection
-#   read config (what AMI)
-#   list available pairing instances
-#   start up instance
-#   kill instance
-#
-# Client
-#   list available pairing instances (via server call)
-#   create new instance
-#   connect to new instance
-#   destroy instance