ec2-instance-manager 0.3.1 → 0.4.0

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Oliver Kiessler
+Copyright (c) 2009-2011 Oliver Kiessler
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,112 @@
+ec2-instance-manager
+====================
+
+ec2-instance-manager is a command line utility written in ruby to manage Amazon EC2 instances and clusters (launchplan groups) for multiple AWS accounts (customer config keys).
+
+You can launch and terminate EC2 instances, create whole launchplans of instances divided into groups, start all launchplan groups or start a specific launchplan group, assign public IP's and attach volumes.
+
+
+Installation:
+-------------
+
+	[sudo] gem install amazon-ec2 ec2-instance-manager
+
+
+Configuration:
+--------------
+
+You can either run ec2-instance-manager from a local "config.yml" in your current work directory or use a global ".ec2_instance_manager_config.yml" in your home directory. If a local configuration file in the current work directory is found, it has precendence over the global configuration file.
+
+There are basically two types of launchplan instance definitions:
+
+1. Simple
+2. Detailed
+
+With the simple type you can quickly launch a number of instances by their AMI ID. This type uses the default settings for availability_zone, instance_type and architecture.
+
+If you need fine-grained control over each instance, you should go for the detailed launchplan instance definition. You can name each instance in a group. Make sure the instance nicknames are unique.
+
+Each definition consists of the following required values: 
+
+* AMI ID
+* Architecture (x86_64 or i386)
+* EC2 Instance Type
+
+You can also specify the following optional values:
+
+* Elastic IP to assign
+* Volumes to attach at a given mountpoint (Comma separated)
+
+The instances are created sequentially in order of their definition.
+
+Configuration example:
+
+	default: # Default customer config key
+  		amazon_access_key_id: YOUR_ACCESS_KEY
+  		amazon_secret_access_key: YOUR_SECRET
+  		amazon_account_number: YOUR_CUSTOMER_NUMBER
+  		ec2_server_region: "eu-west-1.ec2.amazonaws.com"
+  		key: YOUR_SSH_KEY
+  		availability_zone: eu-west-1a
+  		instance_type: t1.micro
+  		architecture: x86_64 #i386
+  		launch_plan:
+    		webservers:
+      			"ami_id_xxx1": 2
+    		dbservers:
+      			"ami_id_xxx2": 1
+			detailed:
+	  			"appserver1": "ami_id_xxx3;x86_64;t1.micro;"
+	  			"appserver2": "ami_id_xxx3;x86_64;t1.micro;192.168.1.1;vol-xxx1@/dev/sdf,vol-xxx2@/dev/sdg"
+	  			"appserver3": "ami_id_xxx3;x86_64;t1.micro;;vol-xxx3@/dev/sdf,vol-xxx4@/dev/sdg"
+
+
+Please have a look at the "config.yml.sample" for further configuration examples.
+
+
+Usage:
+------
+
+Run ec2-instance-manager --help for options and commands.
+
+	ec2-instance-manager 0.4.0 [options]
+		-s, --status                     Status only
+    	-t, --terminate-all              Terminates all instances running under a customer config key
+    	-l, --start-launch-plan          Starts a launch plan under a customer config key
+    	-g, --group LAUNCH_GROUP_NAME    Starts a launch plan group under a customer config key
+    	-c, --config CONFIG_KEY          Sets the customer config key
+    	-h, --help                       Display this screen
+
+
+Examples:
+---------
+
+Checking the status of your instances/cluster:
+
+	ec2-instance-manager -c YOUR_CONFIG_KEY -s
+
+Terminating all instances:
+
+	ec2-instance-manager -c YOUR_CONFIG_KEY -t
+	
+Terminating all instances of a launch group:
+	
+	ec2-instance-manager -c YOUR_CONFIG_KEY -g LAUNCH_GROUP_NAME -t
+
+Launching all groups of your launchplan:
+
+	ec2-instance-manager -c YOUR_CONFIG_KEY -l
+	
+Launching a specific group of your launchplan:
+
+	ec2-instance-manager -c YOUR_CONFIG_KEY -g LAUNCH_GROUP_NAME -l
+	
+Launching an individual instance without a definition (launch console):
+
+	ec2-instance-manager -c YOUR_CONFIG_KEY
+
+
+Copyright
+---------
+
+Copyright (c) 2009-2011 Oliver Kiessler. See LICENSE for details.

data/Rakefile

@@ -11,7 +11,7 @@ begin
     gem.homepage = "http://github.com/okiess/ec2-instance-manager"
     gem.authors = ["Oliver Kiessler"]
     gem.add_dependency "amazon-ec2"
-    gem.add_development_dependency "thoughtbot-shoulda"
+    # gem.add_development_dependency "shoulda"
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
   end
 rescue LoadError

data/VERSION

@@ -1 +1 @@
-0.3.1
+0.4.0

data/bin/ec2-instance-manager

@@ -2,16 +2,6 @@
 
 require File.dirname(__FILE__) + '/../lib/ec2-instance-manager'
 
-if ENV['AMAZON_ACCESS_KEY_ID'].nil? or ENV['AMAZON_SECRET_ACCESS_KEY'].nil?
-  if ENV['AMAZON_ACCESS_KEY_ID'].nil?
-    puts "Please set your AMAZON_ACCESS_KEY_ID environment variable (for your default account)."
-  end
-  if ENV['AMAZON_SECRET_ACCESS_KEY'].nil?
-    puts "Please set your AMAZON_SECRET_ACCESS_KEY environment variable (for your default account)."
-  end
-  exit
-end
-
 # Create and run the application
 app = Ec2InstanceManager.new(ARGV, STDIN)
 app.run

data/config.yml.sample

@@ -1,31 +1,41 @@
-default:
+default: # Default customer config key
   amazon_access_key_id: 
   amazon_secret_access_key: 
   amazon_account_number: 
+  ec2_server_region: "eu-west-1.ec2.amazonaws.com"
   key: 
   availability_zone: eu-west-1a
-  instance_type: m1.small
+  instance_type: t1.micro
+  architecture: x86_64 #i386
   launch_plan:
-    group1:
-      "ami_id_xxx1": 1
-    group2:
-      "ami_id_xxx2": 1  
+    webservers:
+      "ami_id_xxx1": 2
+    dbservers:
+      "ami_id_xxx2": 1
+	detailed:
+	  "appserver1": "ami_id_xxx3;x86_64;t1.micro;"
+	  "appserver2": "ami_id_xxx3;x86_64;t1.micro;192.168.1.1;vol-xxx1@/dev/sdf,vol-xxx2@/dev/sdg"
+	  "appserver3": "ami_id_xxx3;x86_64;t1.micro;;vol-xxx3@/dev/sdf,vol-xxx4@/dev/sdg"
 
-customer1:
+customer1: # another AWS account
   amazon_access_key_id: 
   amazon_secret_access_key: 
   amazon_account_number: 
+  ec2_server_region: "eu-west-1.ec2.amazonaws.com"
   key: 
   availability_zone: eu-west-1a
   instance_type: m1.small
+  architecture: i386
   
 customer2:
   amazon_access_key_id: 
   amazon_secret_access_key: 
   amazon_account_number: 
+  ec2_server_region: "eu-west-1.ec2.amazonaws.com"
   key: 
   availability_zone: eu-west-1a
   instance_type: m1.small
+  architecture: i386
   launch_plan:
     group1:
       ami_id_xxx1: 1

data/ec2-instance-manager.gemspec

@@ -1,64 +1,60 @@
 # Generated by jeweler
-# DO NOT EDIT THIS FILE
-# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{ec2-instance-manager}
-  s.version = "0.3.1"
+  s.version = "0.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Oliver Kiessler"]
-  s.date = %q{2009-10-17}
+  s.date = %q{2011-02-05}
   s.default_executable = %q{ec2-instance-manager}
   s.description = %q{Launches EC2 instances for multiple AWS accounts}
   s.email = %q{kiessler@inceedo.com}
   s.executables = ["ec2-instance-manager"]
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
-     ".gitignore",
-     "LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION",
-     "bin/ec2-instance-manager",
-     "config.yml.sample",
-     "ec2-instance-manager.gemspec",
-     "lib/ec2-instance-manager.rb",
-     "lib/ec2-instance-manager/ec2_instance_manager.rb",
-     "lib/ec2-instance-manager/launch.rb",
-     "lib/ec2-instance-manager/output.rb",
-     "lib/ec2-instance-manager/status.rb",
-     "test/ec2-instance-manager_test.rb",
-     "test/test_helper.rb"
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "bin/ec2-instance-manager",
+    "config.yml.sample",
+    "ec2-instance-manager.gemspec",
+    "lib/ec2-instance-manager.rb",
+    "lib/ec2-instance-manager/ec2_instance_manager.rb",
+    "lib/ec2-instance-manager/launch.rb",
+    "lib/ec2-instance-manager/output.rb",
+    "lib/ec2-instance-manager/status.rb",
+    "test/ec2-instance-manager_test.rb",
+    "test/test_helper.rb"
   ]
   s.homepage = %q{http://github.com/okiess/ec2-instance-manager}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.5}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Simple EC2 Instance Manager}
   s.test_files = [
     "test/ec2-instance-manager_test.rb",
-     "test/test_helper.rb"
+    "test/test_helper.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
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<amazon-ec2>, [">= 0"])
-      s.add_development_dependency(%q<thoughtbot-shoulda>, [">= 0"])
     else
       s.add_dependency(%q<amazon-ec2>, [">= 0"])
-      s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
     end
   else
     s.add_dependency(%q<amazon-ec2>, [">= 0"])
-    s.add_dependency(%q<thoughtbot-shoulda>, [">= 0"])
   end
 end
+

data/lib/ec2-instance-manager.rb

@@ -2,6 +2,7 @@
 
 require "rubygems"
 require 'optparse'
+require 'yaml'
 
 gem 'amazon-ec2'
 require 'AWS'

data/lib/ec2-instance-manager/ec2_instance_manager.rb

@@ -4,7 +4,7 @@ require File.dirname(__FILE__) + '/output'
 
 class Ec2InstanceManager
   include Status, Launch, Output
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
   
   attr_reader :config, :customer_key, :options
 
@@ -22,22 +22,22 @@ class Ec2InstanceManager
       end
       
       options[:terminate] = false
-      opts.on( '-t', '--terminate-all', 'Terminates all instances running under a config key' ) do
+      opts.on( '-t', '--terminate-all', 'Terminates all instances running under a customer config key' ) do
         options[:terminate] = true
       end
 
       options[:start_launch_plan] = false
-      opts.on( '-l', '--start-launch-plan', 'Starts a launch plan under a config key' ) do
+      opts.on( '-l', '--start-launch-plan', 'Starts a launch plan under a customer config key' ) do
         options[:start_launch_plan] = true
       end
       
       options[:group] = nil
-      opts.on( '-g', '--group LAUNCH_GROUP_NAME', 'Starts a launch plan group under a config key' ) do |group|
+      opts.on( '-g', '--group LAUNCH_GROUP_NAME', 'Starts a launch plan group under a customer config key' ) do |group|
         options[:group] = group
       end
 
       options[:config] = nil
-      opts.on( '-c', '--config CONFIG_KEY', 'Sets the config key' ) do |key|
+      opts.on( '-c', '--config CONFIG_KEY', 'Sets the customer config key' ) do |key|
         options[:config] = key
       end
 
@@ -67,8 +67,9 @@ class Ec2InstanceManager
   end
 
   def ec2
-    @ec2 ||= AWS::EC2::Base.new(:access_key_id => config[@customer_key]['amazon_access_key_id'],
-      :secret_access_key => config[@customer_key]['amazon_secret_access_key'])
+    @ec2 = AWS::EC2::Base.new(:access_key_id => config[@customer_key]['amazon_access_key_id'],
+      :secret_access_key => config[@customer_key]['amazon_secret_access_key'],
+      :server => config[@customer_key]['ec2_server_region'])
   end
 
   def run

data/lib/ec2-instance-manager/launch.rb

@@ -61,21 +61,26 @@ module Launch
   end
 
   def start_launch_plan
-    ami_ids_to_launch = []
+    ami_ids_to_launch = []; detailed_ami_ids_to_launch = []
     puts
     puts "Your Launch Plan:"
     if config[@customer_key]["launch_plan"] and config[@customer_key]["launch_plan"].any?
-      
+
       launch_plan_groups = config[@customer_key]["launch_plan"].keys.sort
-      
+
       if self.options[:group]
         puts 
         puts "Existing groups: #{launch_plan_groups.join(", ")}"
         if launch_plan_groups.include?(self.options[:group])
           puts "Targeted Group: #{self.options[:group]}"
           config[@customer_key]["launch_plan"][self.options[:group]].each do |ami_id|
-            puts "#{ami_id[0]} => #{ami_id[1]} Instances to launch"
-            ami_ids_to_launch << [ami_id[0], ami_id[1]]
+            if (ami_id[1].is_a?(Fixnum))
+              puts "#{ami_id[0]} => #{ami_id[1]} Instances to launch"
+              ami_ids_to_launch << [ami_id[0], ami_id[1]]
+            else
+              puts "#{ami_id[0]} => Detailed launch: #{ami_id[1]}"
+              detailed_ami_ids_to_launch << [ami_id[0], ami_id[1]]
+            end
           end
         else
           puts white("Targeted Launch plan group '#{self.options[:group]}' not found.")
@@ -86,8 +91,13 @@ module Launch
           puts "Group: #{launch_plan_group}"
           if config[@customer_key]["launch_plan"][launch_plan_group] and config[@customer_key]["launch_plan"][launch_plan_group].any?
             config[@customer_key]["launch_plan"][launch_plan_group].keys.each do |ami_id|
-              puts "#{ami_id} => #{config[@customer_key]["launch_plan"][launch_plan_group][ami_id]} Instances to launch"
-              ami_ids_to_launch << [ami_id, config[@customer_key]["launch_plan"][launch_plan_group][ami_id]]
+              if (config[@customer_key]["launch_plan"][launch_plan_group][ami_id].is_a?(Fixnum))
+                puts "#{ami_id} => #{config[@customer_key]["launch_plan"][launch_plan_group][ami_id]} Instances to launch"
+                ami_ids_to_launch << [ami_id, config[@customer_key]["launch_plan"][launch_plan_group][ami_id]]
+              else
+                puts "#{ami_id} => Detailed launch: #{config[@customer_key]["launch_plan"][launch_plan_group][ami_id]}"
+                detailed_ami_ids_to_launch << [ami_id, config[@customer_key]["launch_plan"][launch_plan_group][ami_id]]
+              end
             end
           else
             puts white("No Ami Id's to launch defined.")
@@ -97,7 +107,7 @@ module Launch
       
       puts
       puts red("Warning: Now launching your plan...")
-      puts red("Please cancel within the next 5 seconds if this isn't want you want...")
+      puts red("Please press CTRL-C to cancel within the next 5 seconds if this isn't what you want...")
       puts
       sleep 5
       
@@ -107,20 +117,61 @@ module Launch
           result = launch_ami(group_ami_id_pair[0])
         }
       end
+      puts if ami_ids_to_launch.any?
+      
+      detailed_ami_ids_to_launch.each do |group_ami_id_pair|
+        your_instance_name = group_ami_id_pair[0]
+        instance_assignments = group_ami_id_pair[1].split(";")
+        ami_id = instance_assignments[0]
+        raise "Incomplete detailed launchplan definition." if instance_assignments.size < 3
+        
+        puts "Launching '#{your_instance_name}'..."
+        architecture = instance_assignments[1]; instance_type = instance_assignments[2]
+        result = launch_ami(ami_id, {:instance_type => instance_type, :architecture => architecture})
+        
+        if result and result["instancesSet"]["item"] and (instance_id = result["instancesSet"]["item"][0]["instanceId"])
+          instance_state = ''
+          while(instance_state != 'running') do
+            instance_state, dns_name = get_instance_state(instance_id)
+            puts "Running state of instance #{instance_id}: #{output_running_state(instance_state)}"
+            sleep 5
+          end
+
+          if instance_assignments[3] and not instance_assignments[3].empty?
+            puts "Associating IP #{instance_assignments[3]}..."
+            result = ec2.associate_address(:instance_id => instance_id, :public_ip => instance_assignments[3])
+          end
+          
+          if instance_assignments[4] and not instance_assignments[4].empty?
+            volumes = instance_assignments[4].split(",")
+            volumes.each do |volume_pair|
+              volume = volume_pair.split("@")
+              puts "Attaching volume #{volume[0]} at mount point #{volume[1]}..."
+              result = ec2.attach_volume(:volume_id => volume[0], :instance_id => instance_id, :device => volume[1])
+            end
+          end
+        end
+        puts
+      end
 
-      puts white("All instances are launching now...")
+      puts white("Launchplan executed!")
     else
       puts white("No launch plan groups defined.")
     end
   end
   
-  def launch_ami(ami_id)
-    ec2.run_instances(
-    	:image_id => ami_id,
-    	:instance_type => config[@customer_key]['instance_type'],
+  def launch_ami(ami_id, options = {})
+    default_options = {
+      :instance_type => config[@customer_key]['instance_type'],
     	:key_name => config[@customer_key]['key'],
-    	:availability_zone => config[@customer_key]['availability_zone']
-    )
+    	:availability_zone => config[@customer_key]['availability_zone'],
+    	:architecture => config[@customer_key]['architecture'],
+    	:image_id => ami_id
+    }
+    
+    run_options = default_options.merge(options)
+    puts "Launch Options: #{run_options.inspect}"
+    ec2.run_instances(run_options)
   end
 
   private

data/lib/ec2-instance-manager/output.rb

@@ -13,7 +13,7 @@ module Output
   
   def cancel_message(instances)
     puts red("Warning: Terminating all instances: #{instances.join(", ")}")
-    puts red("Please cancel within the next 5 seconds if this isn't want you want...")
+    puts red("Please press CTRL-C to cancel within the next 5 seconds if this isn't what you want...")
   end
   
   def green(str)

data/lib/ec2-instance-manager/status.rb

@@ -49,7 +49,11 @@ module Status
         if vol["attachmentSet"]
           instance_id = vol["attachmentSet"]["item"].first["instanceId"]
         end
-        puts "#{white(vol["volumeId"])} (Size: #{vol["size"]} / Zone: #{vol["availabilityZone"]}) - #{vol["status"]} => #{instance_id.nil? ? 'unassigned' : instance_id}"
+        if vol["status"] == 'deleting'
+          puts "#{white(vol["volumeId"])} (Size: #{vol["size"]} / Zone: #{vol["availabilityZone"]}) - #{vol["status"]}"
+        else
+          puts "#{white(vol["volumeId"])} (Size: #{vol["size"]} / Zone: #{vol["availabilityZone"]}) - #{vol["status"]} => #{instance_id.nil? ? 'unassigned' : instance_id}"
+        end
       end
     else
       puts white("No volumes.")

data/test/ec2-instance-manager_test.rb

@@ -1,7 +1,7 @@
 require 'test_helper'
 
 class Ec2InstanceManagerTest < Test::Unit::TestCase
-  should "test" do
+  def test_truth
     assert true
   end
 end

data/test/test_helper.rb

@@ -1,6 +1,5 @@
 require 'rubygems'
 require 'test/unit'
-require 'shoulda'
 
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 $LOAD_PATH.unshift(File.dirname(__FILE__))

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ec2-instance-manager
 version: !ruby/object:Gem::Version 
-  version: 0.3.1
+  hash: 15
+  prerelease: false
+  segments: 
+  - 0
+  - 4
+  - 0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Oliver Kiessler
@@ -9,29 +15,23 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-17 00:00:00 +02:00
+date: 2011-02-05 00:00:00 +01:00
 default_executable: ec2-instance-manager
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: amazon-ec2
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: thoughtbot-shoulda
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
         version: "0"
-    version: 
+  type: :runtime
+  version_requirements: *id001
 description: Launches EC2 instances for multiple AWS accounts
 email: kiessler@inceedo.com
 executables: 
@@ -40,12 +40,11 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE
-- README.rdoc
+- README.md
 files: 
 - .document
-- .gitignore
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/ec2-instance-manager
@@ -63,26 +62,32 @@ homepage: http://github.com/okiess/ec2-instance-manager
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Simple EC2 Instance Manager

data/.gitignore

@@ -1,5 +0,0 @@
-*.sw?
-.DS_Store
-coverage
-rdoc
-pkg

data/README.rdoc

@@ -1,34 +0,0 @@
-= ec2-instance-manager
-
-Simple EC2 Instance Manager that is able to work with multiple AWS accounts (in config.yml). See config.yml.sample.
-
-Create a "config.yml" in the current directory and run "ec2_instance_manager". You can launch & terminate instances, create whole launch plans, start all launch plan groups or start an individual launch plan group, assign public IP's and attach volumes.
-
-Run ec2-instance-manager --help for options and commands.
-
-This gem should be considered ALPHA! More features to come...
-
-== Installation
-
-sudo gem install amazon-ec2
-
-sudo gem install ec2-instance-manager (Gemcutter)
-
-or
-
-sudo gem install okiess-ec2-instance-manager (Github)
-
-== Note on Patches/Pull Requests
- 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but
-   bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
-
-== Copyright
-
-Copyright (c) 2009 Oliver Kiessler. See LICENSE for details.