kibo 0.1.2

data/.gitignore

@@ -0,0 +1,2 @@
+spec.old
+pkg

data/Gemfile

@@ -0,0 +1,15 @@
+source "http://rubygems.org"
+
+gem "heroku"
+gem "trollop"
+gem 'rake'
+
+group :development do
+  gem 'ronn'
+  gem 'fakefs', '~> 0.3.2'
+  gem 'rr',     '~> 1.0.2'
+  gem 'rspec',  '~> 2.0'
+  gem "simplecov", :require => false
+  gem 'timecop'
+  # gem 'yard'
+end

data/README.md

@@ -0,0 +1,14 @@
+# Kibo
+
+Manage heroku instances with ease.
+
+## Getting started
+
+    git clone https://github.com/radiospiel/kibo.git
+    cd kibo
+    gem build kibo.gemspec
+    gem install kibo-*.gem
+    
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/setup"
+require "bundler/gem_tasks"
+
+$:.unshift File.expand_path("../lib", __FILE__)
+
+Dir[File.expand_path("../tasks/*.rake", __FILE__)].each do |task|
+  load task
+end
+
+task :release => "doc:commit"

data/bin/kibo

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/kibo"
+Kibo.run

data/kibo.gemspec

@@ -0,0 +1,46 @@
+$:.unshift File.expand_path("../lib", __FILE__)
+require "kibo/version"
+
+class Gem::Specification
+  class GemfileEvaluator
+    def initialize(scope)
+      @scope = scope
+    end
+    
+    def load_dependencies(path)
+      instance_eval File.read(path) 
+    end
+    
+    def source(*args); end
+    def group(*args); end
+
+    def gem(name, options = {})
+      @scope.add_dependency(name)
+    end
+  end
+  
+  def load_dependencies(file)
+    GemfileEvaluator.new(self).load_dependencies(file)
+  end
+end
+
+Gem::Specification.new do |gem|
+  gem.name     = "kibo"
+  gem.version  = Kibo::VERSION
+
+  gem.authors   = ["radiospiel"]
+  gem.email     = ["eno@radiospiel.org"]
+  gem.homepage  = "http://github.com/radiospiel/kibo"
+  gem.summary   = "Manage heroku instances with ease"
+
+  gem.description = gem.summary
+
+  gem.load_dependencies "Gemfile"
+  
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'heroku'
+end

data/lib/kibo/commandline.rb

@@ -0,0 +1,92 @@
+require "trollop"
+
+module Kibo::CommandLine
+  def self.method_missing(sym, *args, &block)
+    if block_given? || !args.empty?
+      super
+    elsif options.key?(sym)
+      options[sym]
+    elsif (sym.to_s =~ /(.*)\?/) && options.key?($1.to_sym)
+      !! options[$1.to_sym]
+    else
+      super
+    end 
+  end
+  
+  def self.options
+    parse unless @options
+    @options
+  end
+
+  def self.subcommand
+    parse unless @options
+    @subcommand
+  end
+
+  def self.args
+    parse unless @options
+    @args
+  end
+  
+  def self.parse_and_get(name)
+    parse unless @options
+    instance_variable_get "@#{name}"
+  end
+  
+  SUBCOMMANDS = %w(create deploy spinup spindown reconfigure)
+  
+  def self.parse
+    @options = Trollop::options do
+       version "test 1.2.3 (c) 2008 William Morgan"
+        banner <<-EOS
+kibo is an awesome program that does something very, very important.
+
+Usage:
+
+  kibo [options] create                     ... create missing targets
+  kibo [options] deploy                     ... updates all remote instances
+  kibo [options] spinup                     ... starts all remote instances
+  kibo [options] spindown                   ... stops all remote instances
+  kibo [options] reconfigure                ... reconfigure all existing targets
+
+where [options] are:
+ 
+EOS
+
+      opt :environment, "Set environment", :short => 'e', :type => String, :default => "staging"
+      opt :kibofile, "Set Kibofile name", :short => 'k', :type => String, :default => "Kibofile"
+      opt :procfile, "Set Procfile name", :short => 'p', :type => String, :default => "Procfile"
+      opt :dry, "Do nothing", :short => 'n'
+
+      stop_on SUBCOMMANDS
+    end
+
+    @subcommand = ARGV.shift # get the subcommand
+
+    unless SUBCOMMANDS.include?(@subcommand)
+      Trollop::die(@subcommand ? "Unknown subcommand #{@subcommand.inspect}" : "Missing subcommand")
+    end
+
+    # Is there a specific subcommand options configuration?
+     
+    subcommand_options = 
+      case @subcommand
+      when "spinup" 
+        Trollop::options do
+          opt :force, "Ignore missing targets.", :short => "f"
+        end
+      when "deploy" 
+        Trollop::options do
+          opt :force, "Ignore outstanding changes.", :short => "f"
+        end
+      when "create" 
+        Trollop::options do
+          opt :all, "Create all missing targets.", :short => "a"
+        end
+      end
+    
+    @options.update subcommand_options if subcommand_options
+
+    @args = ARGV.dup
+  end
+end

data/lib/kibo/config.rb

@@ -0,0 +1,95 @@
+require "yaml"
+
+class Kibo::Configfile < Hash
+  attr :path
+  
+  def initialize(path)
+    @path = path
+    
+    File.read(path).
+      split("\n").
+      each_with_index do |line, lineno|
+        next if line =~ /^\s*#/
+        die(lineno, "Can't parse line: #{line.inspect}") unless line =~ /\s*([a-z]+):\s*(.*)$/
+        key, value = $1, $2.gsub(/\s+$/, "")
+        
+        die(lineno, "Multiple entries for #{key.inspect}") if key?(key)
+
+        update key => value
+      end
+  end
+
+  def die(lineno, msg)
+    E "#{path}:#{lineno}", msg
+  end
+end
+
+class Kibo::Config
+  attr :procfile
+
+  DEFAULTS = {
+    "procfile" => "Procfile"
+  }
+  
+  def [](key)
+    @data[key]
+  end
+  
+  def environment
+    Kibo.environment
+  end
+  
+  def initialize(path)
+    super()
+
+    @data = Hash.new do |hash, key|
+      W "#{key}: missing setting for #{environment.inspect} environment, using default."
+      hash[key] = DEFAULTS[key]
+    end
+
+    begin
+      kibo = YAML.load File.read(path)
+      @data.update(kibo["defaults"] || {})
+      @data.update(kibo[environment] || {})
+    rescue Errno::ENOENT
+      W "No such file", path
+      @data = DEFAULTS
+    end
+    
+    @procfile = Kibo::Configfile.new(self["procfile"] || "Procfile")
+  end
+  
+  # processes are defined in the Procfile. The scaling, however, is defined in 
+  # the Kibofile.
+  def processes
+    @processes ||= procfile.keys.inject({}) do |hash, key|
+      hash.update key => (self[key] || 1)
+    end
+  end
+
+  #
+  # we need namespace-ENVIRONMENT-process<1>
+  
+  def namespace
+    self["namespace"] || raise("Please define a namespace in your Kibofile.")
+  end
+
+  def heroku
+    self["heroku"] || raise("Please defined the heroku entry in your Kibofile")
+  end
+
+  def remotes_by_process
+    remotes = Kibo.git("remote", :quiet).split("\n")
+    
+    @remotes_by_process ||= remotes.group_by do |remote| 
+      case remote
+      when /^#{namespace}-#{environment}-(\w+)(\d+)/
+        $1
+      when /^#{namespace}-#{environment}-/ 
+        W "#{remote.inspect}: Ignoring target..."
+        nil
+      else
+      end
+    end.tap { |hash| hash.delete(nil) }
+  end
+end

data/lib/kibo/log.rb

@@ -0,0 +1,18 @@
+def log_message(msg, *args)
+  return msg if args.empty?
+  "#{msg}: " + args.map(&:inspect).join(", ")
+end
+
+def D(*args)
+  STDERR.puts log_message(*args)
+end
+
+def W(*args)
+  STDERR.puts log_message(*args)
+end
+
+def E(*args)
+  STDERR.puts log_message(*args)
+  exit 1
+end
+

data/lib/kibo/system.rb

@@ -0,0 +1,35 @@
+module Kibo::System
+  extend self
+  
+  def heroku(*args)
+    sys! "heroku", *args
+  end
+
+  def git(*args)
+    sys! "git", *args
+  end
+
+  def sys(*args)
+    quiet = args.pop if args.last == :quiet
+    cmd = args.map(&:to_s).join(" ") 
+    W cmd unless quiet
+    
+    # A command is run because it either is "quiet", i.e. is non-obstrusive anyway,
+    # or we are not in a dry. Dry run mode could go with some improvements, though.
+    if quiet || !Kibo::CommandLine.dry?
+      stdout = Kernel.send "`", "bash -c \"#{cmd}\""
+      stdout.chomp if $?.exitstatus == 0
+    else
+      ""
+    end
+  end
+
+  def sys!(*args)
+    sys(*args) || E("Command failed: " + args.join(" "))
+  end
+end
+
+module Kibo
+  extend System
+end
+

data/lib/kibo/version.rb

@@ -0,0 +1,3 @@
+module Kibo
+  VERSION = "0.1.2"
+end

data/lib/kibo.rb

@@ -0,0 +1,221 @@
+require "pp"
+require "heroku"
+
+module Kibo
+end
+
+require_relative "kibo/log"
+require_relative "kibo/system"
+require_relative "kibo/config"
+require_relative "kibo/commandline"
+
+module Kibo
+  extend self
+
+  def config
+    @config ||= Config.new(CommandLine.kibofile)
+  end
+
+  def environment
+    Kibo::CommandLine.environment
+  end
+  
+  def expected_remotes
+    config.processes.inject([]) do |ary, (name, count)|
+      ary.concat 1.upto(count).map { |idx| "#{config.namespace}-#{environment}-#{name}#{idx}" }
+    end
+  end
+
+  def configured_remotes
+    config.remotes_by_process.values.flatten
+  end
+
+  def missing_remotes
+    expected_remotes - configured_remotes
+  end
+  
+  # -- configure a remote
+  
+  private
+  
+  def instance_for_remote(remote)
+    remote[config.namespace.length + 1 .. -1]
+  end
+  
+  public
+  
+  def configure_remote!(remote)
+    heroku "config:set", 
+      "RACK_ENV=#{environment}", 
+      "RAILS_ENV=#{environment}", 
+      "INSTANCE=#{instance_for_remote(remote)}", 
+      "--app", remote
+  end
+  
+  def configure_remote(remote)
+    # the correct value for the INSTANCE configuration setting is the 
+    # name of the of the remote without the namespace part; e.g. the 
+    # INSTANCE for the remote named "bountyhill-staging-twirl2" is 
+    # "staging-twirl2".
+    instance = remote[config.namespace.length + 1 .. -1]
+    current_instance = heroku "config:get", "INSTANCE", "--app", remote
+    return if instance == current_instance
+  end
+  
+  # --spin up/spin down remotes
+  
+  private
+  
+  def spin(processes)
+    config.remotes_by_process.each do |name, remotes|
+      number_of_processes = processes[name] || 0
+      
+      remotes.each do |remote|
+        if number_of_processes > 0
+          configure_remote remote 
+          heroku "ps:scale", "#{name}=1", "--app", remote
+          number_of_processes -= 1
+        else
+          heroku "ps:scale", "#{name}=0", "--app", remote
+        end
+      end
+      
+      if number_of_processes > 0
+        W "Missing #{name} remote(s)", number_of_processes
+      end
+    end
+  end
+  
+  public
+  
+  def spinup
+    check_missing_remotes(CommandLine.force? ? :warn : :error)
+    spin config.processes
+  end
+
+  def spindown
+    spin({})
+  end
+  
+  # reconfigure existing remotes
+  public 
+
+  # kibo [options] reconfigure                ... reconfigure all existing remotes
+  def reconfigure
+    check_missing_remotes :warn
+    
+    configured_remotes.each do |remote| 
+      configure_remote! remote
+    end
+  end
+
+  private
+  
+  def prepare_deployment
+  end
+  
+  def deploy_remote!(remote)
+    git "push", remote, "master"
+  end
+  
+  public
+  
+  def deploy
+    check_missing_remotes(CommandLine.force? ? :warn : :error)
+    
+    prepare_deployment
+    configured_remotes.each do |remote| 
+      deploy_remote! remote
+    end
+    
+    W "Deployment succeeded."
+  end
+  
+  private
+  
+  def check_missing_remotes(mode = :warn)
+    return if missing_remotes.empty?
+    
+    if mode == :warn
+      W  "Ignoring missing remote(s)", *missing_remotes
+      return
+    end
+
+    E <<-MSG
+Missing remote(s): #{missing_remotes.map(&:inspect).join(", ")}. Run
+
+  kibo --environment #{environment} create --all              # ... to create all missing remotes.
+  kibo --environment #{environment} spinup --force            # ... to ignore missing remotes.
+
+    MSG
+  end
+  
+  public
+  
+  def create
+    verify_heroku_login
+    
+    if CommandLine.all? 
+      instances = missing_remotes
+      if instances.empty?
+        W "Nothing to do."
+        exit 0
+      end
+    else
+      instances = CommandLine.args
+      if instances.empty?
+        W "Add the names of the remotes to create on the command line or use the --all parameter."
+        exit 0
+      end
+
+      # only create instances that are actually missing.
+      extra_instances = instances - missing_remotes
+      unless extra_instances.empty?
+        E <<-MSG
+kibo cannot create these instances for you: #{extra_instances.map(&:inspect).join(", ")}, because I don't not know anything about these.
+MSG
+      end
+    end
+  
+    confirm! <<-MSG
+I am going to create these instances: #{instances.map(&:inspect).join(", ")}. Is this what you want? Note:
+You are logged in at heroku as #{config.heroku}.
+MSG
+
+    instances.each do |instance|
+      create_instance(instance)
+    end
+  end
+
+  def confirm!(msg)
+    puts msg
+    puts "\n\nPress ^C to abort or return to continue."
+    
+    STDIN.read
+  end
+  
+  private
+  
+  def verify_heroku_login
+    (Heroku::Auth.read_credentials || []).first.tap do |whoami|
+      msg = if !whoami
+        "Please log into heroku as #{config.heroku.inspect}."
+      elsif whoami != config.heroku
+        "You are currently logged into heroku as #{whoami.inspect}; please log in as #{config.heroku.inspect}."
+      end
+      
+      E "#{msg}\n\n\theroku auth:login" if msg
+    end
+  end
+  
+  def create_instance(remote)
+    # TODO: Test whether these instances already exist, using `heroku apps`
+    heroku "apps:create", remote, "--remote", remote
+  end
+  
+  public
+  
+  def run
+    self.send CommandLine.subcommand
+  end
+end

data/man/kibo.1

@@ -0,0 +1,65 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "KIBO" "1" "August 2012" "Kibo 0.1.2" "Kibo Manual"
+.
+.SH "NAME"
+\fBkibo\fR \- manage heroku applications
+.
+.SH "SYNOPSIS"
+\fBkibo [options] create\fR
+.
+.br
+\fBkibo [options] deploy\fR
+.
+.br
+\fBkibo [options] spinup\fR
+.
+.br
+\fBkibo [options] spindown\fR
+.
+.br
+\fBkibo [options] reconfigure\fR
+.
+.SH "DESCRIPTION"
+kibo is an awesome program that does something very, very important\.
+.
+.SH "DESCRIPTION"
+Foreman is a manager for Procfile\-based applications\. Its aim is to abstract away the details of the Procfile format, and allow you to either run your application directly or export it to some other process management format\.
+.
+.SH "GLOBAL OPTIONS"
+The following options control how kibo is run:
+.
+.TP
+\fB\-e\fR, \fB\-\-environment\fR
+Set the target environment\.
+.
+.TP
+\fB\-k\fR, \fB\-\-kibofile\fR
+Specify the Kibofile to use\.
+.
+.TP
+\fB\-p\fR, \fB\-\-procfile\fR
+Specify an alternate Procfile to load\.
+.
+.SH "Kibofile"
+An example Kibofile is this:
+.
+.IP "" 4
+.
+.nf
+
+defaults:
+    procfile: Procfile
+    namespace: radiospiel
+staging:
+    twirl: 1
+production:
+    twirl: 2
+.
+.fi
+.
+.IP "" 0
+.
+.SH "COPYRIGHT"
+Kibo is Copyright (C) 2012 Enrico Thierbach \fIhttp://radiospiel\.org\fR

data/man/kibo.1.html

@@ -0,0 +1,138 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <title>kibo(1) - manage heroku applications</title>
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:0 4ex}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
+  </style>
+  <style type='text/css' media='all'>
+  /* style: toc */
+  .man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
+  .man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
+  .man-navigation a:hover {color:#111;text-decoration:underline}
+  </style>
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#GLOBAL-OPTIONS">GLOBAL OPTIONS</a>
+    <a href="#Kibofile">Kibofile</a>
+    <a href="#COPYRIGHT">COPYRIGHT</a>
+  </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>kibo(1)</li>
+    <li class='tc'>Kibo Manual</li>
+    <li class='tr'>kibo(1)</li>
+  </ol>
+
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>kibo</code> - <span class="man-whatis">manage heroku applications</span>
+</p>
+
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+
+<p><code>kibo [options] create</code><br />
+<code>kibo [options] deploy</code><br />
+<code>kibo [options] spinup</code><br />
+<code>kibo [options] spindown</code><br />
+<code>kibo [options] reconfigure</code></p>
+
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>kibo is an awesome program that does something very, very important.</p>
+
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>Foreman is a manager for Procfile-based applications. Its aim is to
+abstract away the details of the Procfile format, and allow you to either run
+your application directly or export it to some other process management
+format.</p>
+
+<h2 id="GLOBAL-OPTIONS">GLOBAL OPTIONS</h2>
+
+<p>The following options control how kibo is run:</p>
+
+<dl>
+<dt><code>-e</code>, <code>--environment</code></dt><dd><p>Set the target environment.</p></dd>
+<dt><code>-k</code>, <code>--kibofile</code></dt><dd><p>Specify the Kibofile to use.</p></dd>
+<dt><code>-p</code>, <code>--procfile</code></dt><dd><p>Specify an alternate Procfile to load.</p></dd>
+</dl>
+
+
+<h2 id="Kibofile">Kibofile</h2>
+
+<p>An example Kibofile is this:</p>
+
+<pre><code>defaults:
+    procfile: Procfile
+    namespace: radiospiel
+staging:
+    twirl: 1
+production:
+    twirl: 2
+</code></pre>
+
+<h2 id="COPYRIGHT">COPYRIGHT</h2>
+
+<p>Kibo is Copyright (C) 2012 Enrico Thierbach <a href="http://radiospiel.org" data-bare-link="true">http://radiospiel.org</a></p>
+
+
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'>Kibo 0.1.2</li>
+    <li class='tc'>August 2012</li>
+    <li class='tr'>kibo(1)</li>
+  </ol>
+
+  </div>
+</body>
+</html>

data/man/kibo.1.markdown

@@ -0,0 +1,63 @@
+kibo(1) -- manage heroku applications
+================================================
+
+## SYNOPSIS
+
+`kibo [options] create`<br>
+`kibo [options] deploy`<br>
+`kibo [options] spinup`<br>
+`kibo [options] spindown`<br>
+`kibo [options] reconfigure`
+
+## DESCRIPTION
+
+kibo is an awesome program that does something very, very important.
+
+## DESCRIPTION
+
+Foreman is a manager for Procfile-based applications. Its aim is to
+abstract away the details of the Procfile format, and allow you to either run
+your application directly or export it to some other process management
+format.
+
+## GLOBAL OPTIONS
+
+
+The following options control how kibo is run:
+
+  * `-e`, `--environment`:
+    Set the target environment.
+
+  * `-k`, `--kibofile`:
+    Specify the Kibofile to use.
+
+  * `-p`, `--procfile`:
+    Specify an alternate Procfile to load.
+
+
+## Kibofile
+
+An example Kibofile is this:
+
+    defaults:
+        procfile: Procfile
+        namespace: radiospiel
+    staging:
+        twirl: 1
+    production:
+        twirl: 2
+
+## COPYRIGHT
+
+Kibo is Copyright (C) 2012 Enrico Thierbach <http://radiospiel.org>
+
+
+[SYNOPSIS]: #SYNOPSIS "SYNOPSIS"
+[DESCRIPTION]: #DESCRIPTION "DESCRIPTION"
+[DESCRIPTION]: #DESCRIPTION "DESCRIPTION"
+[GLOBAL OPTIONS]: #GLOBAL-OPTIONS "GLOBAL OPTIONS"
+[Kibofile]: #Kibofile "Kibofile"
+[COPYRIGHT]: #COPYRIGHT "COPYRIGHT"
+
+
+[kibo(1)]: kibo.1.html

data/man/kibo.1.ronn

@@ -0,0 +1,52 @@
+kibo(1) -- manage heroku applications
+================================================
+
+## SYNOPSIS
+
+`kibo [options] create`<br>
+`kibo [options] deploy`<br>
+`kibo [options] spinup`<br>
+`kibo [options] spindown`<br>
+`kibo [options] reconfigure`
+
+## DESCRIPTION
+
+kibo is an awesome program that does something very, very important.
+
+## DESCRIPTION
+
+Foreman is a manager for Procfile-based applications. Its aim is to
+abstract away the details of the Procfile format, and allow you to either run
+your application directly or export it to some other process management
+format.
+
+## GLOBAL OPTIONS
+
+
+The following options control how kibo is run:
+
+  * `-e`, `--environment`:
+    Set the target environment.
+
+  * `-k`, `--kibofile`:
+    Specify the Kibofile to use.
+
+  * `-p`, `--procfile`:
+    Specify an alternate Procfile to load.
+
+
+## Kibofile
+
+An example Kibofile is this:
+
+    defaults:
+        procfile: Procfile
+        namespace: radiospiel
+    staging:
+        twirl: 1
+    production:
+        twirl: 2
+
+## COPYRIGHT
+
+Kibo is Copyright (C) 2012 Enrico Thierbach <http://radiospiel.org>

data/tasks/doc.rake

@@ -0,0 +1,30 @@
+require "time"
+
+namespace :doc do
+  desc "Build the manual"
+  task :build do
+    ENV['RONN_MANUAL']  = "Kibo Manual"
+    ENV['RONN_ORGANIZATION'] = "Kibo #{Kibo::VERSION}"
+    sh "ronn -w -s toc -r5 --markdown man/*.ronn"
+  end
+
+  desc "Commit the manual to git"
+  task :commit => :build do
+    sh "git add README.md"
+    sh "git commit -am 'update docs' || echo 'nothing to commit'"
+  end
+
+  desc "Generate the Github docs"
+  task :gh_pages => :commit do
+    sh %{
+      cp man/foreman.1.html /tmp/foreman.1.html
+      git checkout gh-pages
+      rm ./index.html
+      cp /tmp/foreman.1.html ./index.html
+      git add -u index.html
+      git commit -m "saving man page to github docs"
+      git push origin -f gh-pages
+      git checkout master
+    }
+  end
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: kibo
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+  prerelease: 
+platform: ruby
+authors:
+- radiospiel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: heroku
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: heroku
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Manage heroku instances with ease
+email:
+- eno@radiospiel.org
+executables:
+- kibo
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- bin/kibo
+- kibo.gemspec
+- lib/kibo.rb
+- lib/kibo/commandline.rb
+- lib/kibo/config.rb
+- lib/kibo/log.rb
+- lib/kibo/system.rb
+- lib/kibo/version.rb
+- man/kibo.1
+- man/kibo.1.html
+- man/kibo.1.markdown
+- man/kibo.1.ronn
+- tasks/doc.rake
+homepage: http://github.com/radiospiel/kibo
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1679562379441555646
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Manage heroku instances with ease
+test_files: []