saving man page to github docs

.gitignore

@@ -1,5 +1,4 @@
-coverage
-example/log/*
-man/*.html
-man/*.markdown
-pkg
+/.bundle
+/coverage
+/man
+/pkg

README.rdoc

@@ -1,85 +0,0 @@
-= Foreman
-
-== Procfile
-
-    alpha ./bin/alpha
-    bravo ./bin/bravo some args
-    charlie ./bin/charlie -n 5
-
-== Development mode
-
-=== Running
-
-Log files will be output to standard out, colorized to aid in visual separation.
-
-    $ foreman start
-    [01:27:08] [alpha] started with pid 4393
-    [01:27:08] [bravo] started with pid 4394
-    [01:27:08] [charlie] started with pid 4395
-    [01:27:08] [bravo] initializing...
-    [01:27:08] [bravo] complete
-
-=== Using Screen
-
-Launch the processes in a screen session in indivudal windows
-
-    $ foreman screen
-
-== Single Process Execution
-
-    $ foreman execute alpha
-
-== Exporting to Upstart
-
-=== Export to upstart scripts
-
-    $ foreman export sampleapp
-
-    $ initctl list | grep sampleapp
-    sampleapp start/running
-    sampleapp-alpha (1) start/running, process 4204
-    sampleapp-bravo (1) start/running, process 4589
-    sampleapp-charlie (1) start/running, process 4597
-
-=== Change process concurrency levels
-
-    $ foreman scale sampleapp alpha 4
-    sampleapp-alpha (2) start/running, process 4164
-    sampleapp-alpha (3) start/running, process 4166
-    sampleapp-alpha (4) start/running, process 4168
-
-    $ initctl list | grep sampleapp
-    sampleapp start/running
-    sampleapp-alpha (4) start/running, process 4168
-    sampleapp-alpha (3) start/running, process 4166
-    sampleapp-alpha (2) start/running, process 4164
-    sampleapp-alpha (1) start/running, process 4204
-    sampleapp-bravo (1) start/running, process 4589
-    sampleapp-charlie (1) start/running, process 4597
-
-    $ foreman scale sampleapp alpha 1
-    sampleapp-alpha stop/waiting
-    sampleapp-alpha stop/waiting
-    sampleapp-alpha stop/waiting
-
-=== Good Upstart citizen
-
-All Upstart commands work as expected
-
-    $ start sampleapp
-    $ stop sampleapp
-    $ restart sampleapp
-
-=== Standardized Logging
-
-    /var/log/sampleapp/alpha.log
-    /var/log/sampleapp/bravo.log
-    /var/log/sampleapp/charlie.log
-
-== License
-
-MIT
-
-== Copyright
-
-(c) 2010 David Dollar

Rakefile

@@ -1,73 +0,0 @@
-require "rake"
-require "rspec"
-require "rspec/core/rake_task"
-
-$:.unshift File.expand_path("../lib", __FILE__)
-require "foreman"
-
-task :default => :spec
-task :release => :man
-
-desc "Run all specs"
-Rspec::Core::RakeTask.new(:spec) do |t|
-  t.pattern = 'spec/**/*_spec.rb'
-end
-
-desc "Generate RCov code coverage report"
-task :rcov => "rcov:build" do
-  %x{ open coverage/index.html }
-end
-
-Rspec::Core::RakeTask.new("rcov:build") do |t|
-  t.pattern = 'spec/**/*_spec.rb'
-  t.rcov = true
-  t.rcov_opts = [ "--exclude", Gem.default_dir , "--exclude", "spec" ]
-end
-
-desc 'Build the manual'
-task :man do
-  require 'ronn'
-  ENV['RONN_MANUAL']  = "Foreman Manual"
-  ENV['RONN_ORGANIZATION'] = "Foreman #{Foreman::VERSION}"
-  sh "ronn -w -s toc -r5 --markdown man/*.ronn"
-  sh "git add man/*.?"
-  sh "git commit -m \"updating man pages\""
-end
-
-######################################################
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |s|
-    s.name    = "foreman"
-    s.version = Foreman::VERSION
-
-    s.summary     = "Process manager for applications with multiple components"
-    s.description = s.summary
-    s.author      = "David Dollar"
-    s.email       = "ddollar@gmail.com"
-    s.homepage    = "http://github.com/ddollar/foreman"
-
-    s.platform = Gem::Platform::RUBY
-    s.has_rdoc = false
-
-    s.files = %w(Rakefile README.md) + Dir["{bin,lib,spec}/**/*"]
-    s.require_path = "lib"
-
-    # #s.bindir             = "bin"
-    # s.executables        = Dir["bin/*"]
-    s.default_executable = "foreman"
-
-    s.add_development_dependency 'fakefs', '~> 0.2.1'
-    s.add_development_dependency 'rake',   '~> 0.8.7'
-    s.add_development_dependency 'rcov',   '~> 0.9.8'
-    s.add_development_dependency 'rr',     '~> 0.10.11'
-    s.add_development_dependency 'rspec',  '~> 2.0.0'
-
-    s.add_dependency 'term-ansicolor', '~> 1.0.5'
-    s.add_dependency 'thor', '~> 0.13.6'
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler not available. Install it with: sudo gem install jeweler"
-end

autotest/discover.rb

@@ -1 +0,0 @@
-Autotest.add_discovery { "rspec2" }

bin/foreman

@@ -1,7 +0,0 @@
-#!/usr/bin/env ruby
-
-$:.unshift File.expand_path("../../lib", __FILE__)
-
-require "foreman/cli"
-
-Foreman::CLI.start

example/Procfile

@@ -1,2 +0,0 @@
-ticker ./ticker
-error  ./error

example/error

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-
-puts "will error in 10s"
-sleep 5
-raise "Dying"

example/ticker

@@ -1,6 +0,0 @@
-#!/usr/bin/env ruby
-
-while true
-  puts "tick"
-  sleep 1
-end

export/upstart/master.conf.erb

@@ -1,13 +0,0 @@
-pre-start script
-
-bash << "EOF"
-  mkdir -p /var/log/<%= app %>
-
-  <% engine.processes.keys.sort.each do |process| %>
-    <% 1.upto(concurrency[process]).each do |num| %>
-      start <%=app%>-<%=process%>-<%=num%>
-    <% end %>
-  <% end %>
-EOF
-
-end script

export/upstart/process.conf.erb

@@ -1,5 +0,0 @@
-stop on stopping <%= app %>
-respawn
-
-chdir <%= engine.directory %>
-exec <%= process.command %> >> /var/log/<%=app%>/<%=process.name%>-<%=num%>.log 2>&1

foreman.gemspec

@@ -1,88 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{foreman}
-  s.version = "0.4.1"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["David Dollar"]
-  s.date = %q{2010-06-23}
-  s.default_executable = %q{foreman}
-  s.description = %q{Process manager for applications with multiple components}
-  s.email = %q{ddollar@gmail.com}
-  s.executables = ["foreman"]
-  s.extra_rdoc_files = [
-    "README.rdoc"
-  ]
-  s.files = [
-    "Rakefile",
-     "bin/foreman",
-     "lib/foreman.rb",
-     "lib/foreman/cli.rb",
-     "lib/foreman/configuration.rb",
-     "lib/foreman/engine.rb",
-     "lib/foreman/export.rb",
-     "lib/foreman/export/base.rb",
-     "lib/foreman/export/upstart.rb",
-     "lib/foreman/process.rb",
-     "spec/foreman/cli_spec.rb",
-     "spec/foreman/configuration_spec.rb",
-     "spec/foreman/engine_spec.rb",
-     "spec/foreman/export/upstart_spec.rb",
-     "spec/foreman/export_spec.rb",
-     "spec/foreman/process_spec.rb",
-     "spec/foreman_spec.rb",
-     "spec/spec_helper.rb"
-  ]
-  s.has_rdoc = false
-  s.homepage = %q{http://github.com/ddollar/foreman}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Process manager for applications with multiple components}
-  s.test_files = [
-    "spec/foreman/cli_spec.rb",
-     "spec/foreman/configuration_spec.rb",
-     "spec/foreman/engine_spec.rb",
-     "spec/foreman/export/upstart_spec.rb",
-     "spec/foreman/export_spec.rb",
-     "spec/foreman/process_spec.rb",
-     "spec/foreman_spec.rb",
-     "spec/spec_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::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<fakefs>, ["~> 0.2.1"])
-      s.add_development_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_development_dependency(%q<rcov>, ["~> 0.9.8"])
-      s.add_development_dependency(%q<rr>, ["~> 0.10.11"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_runtime_dependency(%q<term-ansicolor>, ["~> 1.0.5"])
-      s.add_runtime_dependency(%q<thor>, ["~> 0.13.6"])
-    else
-      s.add_dependency(%q<fakefs>, ["~> 0.2.1"])
-      s.add_dependency(%q<rake>, ["~> 0.8.7"])
-      s.add_dependency(%q<rcov>, ["~> 0.9.8"])
-      s.add_dependency(%q<rr>, ["~> 0.10.11"])
-      s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-      s.add_dependency(%q<term-ansicolor>, ["~> 1.0.5"])
-      s.add_dependency(%q<thor>, ["~> 0.13.6"])
-    end
-  else
-    s.add_dependency(%q<fakefs>, ["~> 0.2.1"])
-    s.add_dependency(%q<rake>, ["~> 0.8.7"])
-    s.add_dependency(%q<rcov>, ["~> 0.9.8"])
-    s.add_dependency(%q<rr>, ["~> 0.10.11"])
-    s.add_dependency(%q<rspec>, ["~> 2.0.0"])
-    s.add_dependency(%q<term-ansicolor>, ["~> 1.0.5"])
-    s.add_dependency(%q<thor>, ["~> 0.13.6"])
-  end
-end
-

index.html

@@ -0,0 +1,265 @@
+<!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>foreman(1) - manage Procfile-based 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="#RUNNING">RUNNING</a>
+    <a href="#EXPORTING">EXPORTING</a>
+    <a href="#GLOBAL-OPTIONS">GLOBAL OPTIONS</a>
+    <a href="#EXPORT-FORMATS">EXPORT FORMATS</a>
+    <a href="#INITTAB-EXPORT">INITTAB EXPORT</a>
+    <a href="#UPSTART-EXPORT">UPSTART EXPORT</a>
+    <a href="#PROCFILE">PROCFILE</a>
+    <a href="#ENVIRONMENT">ENVIRONMENT</a>
+    <a href="#DEFAULT-OPTIONS">DEFAULT OPTIONS</a>
+    <a href="#EXAMPLES">EXAMPLES</a>
+    <a href="#COPYRIGHT">COPYRIGHT</a>
+    </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>foreman(1)</li>
+    <li class='tc'>Foreman Manual</li>
+    <li class='tr'>foreman(1)</li>
+  </ol>
+
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>foreman</code> - <span class="man-whatis">manage Procfile-based applications</span>
+</p>
+
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+
+<p><code>foreman start [process]</code><br />
+<code>foreman run &lt;command></code><br />
+<code>foreman export &lt;format> [location]</code></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="RUNNING">RUNNING</h2>
+
+<p><code>foreman start</code> is used to run your application directly from the command line.</p>
+
+<p>If no additional parameters are passed, foreman will run one instance of each
+type of process defined in your Procfile.</p>
+
+<p>If a parameter is passed, foreman will run one instance of the specified
+application type.</p>
+
+<p>The following options control how the application is run:</p>
+
+<dl>
+<dt><code>-c</code>, <code>--concurrency</code></dt><dd><p>Specify the number of each process type to run. The value passed in
+should be in the format <code>process=num,process=num</code></p></dd>
+<dt><code>-e</code>, <code>--env</code></dt><dd><p>Specify one or more .env files to load</p></dd>
+<dt><code>-f</code>, <code>--procfile</code></dt><dd><p>Specify an alternate Procfile to load, implies <code>-d</code> at the Procfile root.</p></dd>
+<dt><code>-p</code>, <code>--port</code></dt><dd><p>Specify which port to use as the base for this application. Should be
+a multiple of 1000.</p></dd>
+</dl>
+
+
+<p><code>foreman run</code> is used to run one-off commands using the same environment
+as your defined processes.</p>
+
+<h2 id="EXPORTING">EXPORTING</h2>
+
+<p><code>foreman export</code> is used to export your application to another process
+management format.</p>
+
+<p>An location to export can be passed as an argument. This argument may be
+either required or optional depending on the export format.</p>
+
+<p>The following options control how the application is run:</p>
+
+<dl>
+<dt><code>-a</code>, <code>--app</code></dt><dd><p>Use this name rather than the application's root directory name as the
+name of the application when exporting.</p></dd>
+<dt><code>-c</code>, <code>--concurrency</code></dt><dd><p>Specify the number of each process type to run. The value passed in
+should be in the format <code>process=num,process=num</code></p></dd>
+<dt><code>-l</code>, <code>--log</code></dt><dd><p>Specify the directory to place process logs in.</p></dd>
+<dt><code>-p</code>, <code>--port</code></dt><dd><p>Specify which port to use as the base for this application. Should be
+a multiple of 1000.</p></dd>
+<dt><code>-t</code>, <code>--template</code></dt><dd><p>Specify an alternate template to use for creating export files.
+See <a href="https://github.com/ddollar/foreman/tree/master/data/export" data-bare-link="true">https://github.com/ddollar/foreman/tree/master/data/export</a> for examples.</p></dd>
+<dt><code>-u</code>, <code>--user</code></dt><dd><p>Specify the user the application should be run as. Defaults to the
+app name</p></dd>
+</dl>
+
+
+<h2 id="GLOBAL-OPTIONS">GLOBAL OPTIONS</h2>
+
+<p>These options control all modes of foreman's operation.</p>
+
+<dl>
+<dt><code>-d</code>, <code>--root</code></dt><dd><p>Specify an alternate application root. This defaults to the directory
+containing the Procfile.</p></dd>
+<dt><code>-e</code>, <code>--env</code></dt><dd><p>Specify an alternate environment file. You can specify more than one
+file by using: <code>--env file1,file2</code>.</p></dd>
+<dt><code>-f</code>, <code>--procfile</code></dt><dd><p>Specify an alternate location for the application's Procfile. This file's
+containing directory will be assumed to be the root directory of the
+application.</p></dd>
+</dl>
+
+
+<h2 id="EXPORT-FORMATS">EXPORT FORMATS</h2>
+
+<p>foreman currently supports the following output formats:</p>
+
+<ul>
+<li><p>bluepill</p></li>
+<li><p>inittab</p></li>
+<li><p>runit</p></li>
+<li><p>upstart</p></li>
+</ul>
+
+
+<h2 id="INITTAB-EXPORT">INITTAB EXPORT</h2>
+
+<p>Will export a chunk of inittab-compatible configuration:</p>
+
+<pre><code># ----- foreman example processes -----
+EX01:4:respawn:/bin/su - example -c 'PORT=5000 bundle exec thin start &gt;&gt; /var/log/web-1.log 2&gt;&amp;1'
+EX02:4:respawn:/bin/su - example -c 'PORT=5100 bundle exec rake jobs:work &gt;&gt; /var/log/job-1.log 2&gt;&amp;1'
+# ----- end foreman example processes -----
+</code></pre>
+
+<h2 id="UPSTART-EXPORT">UPSTART EXPORT</h2>
+
+<p>Will create a series of upstart scripts in the location you specify. Scripts
+will be structured to make the following commands valid:</p>
+
+<p>  <code>start appname</code></p>
+
+<p>  <code>stop appname-processname</code></p>
+
+<p>  <code>restart appname-processname-3</code></p>
+
+<h2 id="PROCFILE">PROCFILE</h2>
+
+<p>A Procfile should contain both a name for the process and the command used
+to run it.</p>
+
+<pre><code>web: bundle exec thin start
+job: bundle exec rake jobs:work
+</code></pre>
+
+<p>A process name may contain letters, numbers amd the underscore character.
+You can validate your Procfile format using the <code>check</code> command:</p>
+
+<pre><code>$ foreman check
+</code></pre>
+
+<h2 id="ENVIRONMENT">ENVIRONMENT</h2>
+
+<p>If a <code>.env</code> file exists in the current directory, the default environment will
+be read from it. This file should contain key/value pairs, separated by <code>=</code>, with
+one key/value pair per line.</p>
+
+<pre><code>FOO=bar
+BAZ=qux
+</code></pre>
+
+<h2 id="DEFAULT-OPTIONS">DEFAULT OPTIONS</h2>
+
+<p>If a <code>.foreman</code> file exists in the current directory, default options will
+be read from it. This file should be in YAML format with the long option
+name as keys. Example:</p>
+
+<pre><code>concurrency: alpha=0,bravo=1
+port: 15000
+</code></pre>
+
+<h2 id="EXAMPLES">EXAMPLES</h2>
+
+<p>Start one instance of each process type, interleave the output on stdout:</p>
+
+<pre><code>$ foreman start
+</code></pre>
+
+<p>Export the application in upstart format:</p>
+
+<pre><code>$ foreman export upstart /etc/init
+</code></pre>
+
+<p>Run one process type from the application defined in a specific Procfile:</p>
+
+<pre><code>$ foreman start alpha -p ~/myapp/Procfile
+</code></pre>
+
+<h2 id="COPYRIGHT">COPYRIGHT</h2>
+
+<p>Foreman is Copyright (C) 2010 David Dollar <a href="http://daviddollar.org" data-bare-link="true">http://daviddollar.org</a></p>
+
+
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'>Foreman 0.63.0</li>
+    <li class='tc'>April 2013</li>
+    <li class='tr'>foreman(1)</li>
+  </ol>
+
+  </div>
+</body>
+</html>

lib/foreman.rb

@@ -1,8 +0,0 @@
-module Foreman
-
-  VERSION = "0.4.1"
-
-  class AppDoesNotExist < Exception; end
-
-end
-

lib/foreman/cli.rb

@@ -1,74 +0,0 @@
-require "foreman"
-require "foreman/configuration"
-require "foreman/engine"
-require "foreman/export"
-require "thor"
-
-class Foreman::CLI < Thor
-
-  class_option :procfile, :type => :string, :aliases => "-p", :desc => "Default: ./Procfile"
-
-  desc "start [PROCESS]", "Start the application, or a specific process"
-
-  method_option :screen,   :type => :boolean, :aliases => "-s"
-
-  def start(process=nil)
-    check_procfile!
-    
-    if process
-      engine.execute(process)
-    elsif options[:screen]
-      engine.screen
-    else
-      engine.start
-    end
-  end
-
-  desc "export FORMAT LOCATION", "Export the application to another process management format"
-
-  method_option :app,         :type => :string, :aliases => "-a"
-  method_option :concurrency, :type => :string, :aliases => "-c",
-    :banner => '"alpha=5,bar=3"'
-
-  def export(format, location=nil)
-    check_procfile!
-
-    formatter = case format
-      when "upstart" then Foreman::Export::Upstart
-      else error "Unknown export format: #{format}."
-    end
-
-    formatter.new(engine).export(location,
-      :name        => options[:app],
-      :concurrency => options[:concurrency]
-    )
-  rescue Foreman::Export::Exception => ex
-    error ex.message
-  end
-
-private ######################################################################
-
-  def check_procfile!
-    error("Procfile does not exist.") unless File.exist?(procfile)
-  end
-
-  def engine
-    @engine ||= Foreman::Engine.new(procfile)
-  end
-
-  def procfile
-    options[:procfile] || "./Procfile"
-  end
-
-private ######################################################################
-
-  def error(message)
-    puts "ERROR: #{message}"
-    exit 1
-  end
-
-  def procfile_exists?(procfile)
-    File.exist?(procfile)
-  end
-
-end

lib/foreman/configuration.rb

@@ -1,55 +0,0 @@
-require "foreman"
-
-class Foreman::Configuration
-
-  attr_reader :app
-  attr_reader :processes
-
-  def initialize(app)
-    @app = app
-    @processes = {}
-    read_initial_config
-  end
-
-  def scale(process, amount)
-    old_amount = processes[process].to_i
-    processes[process] = amount.to_i
-    amount = amount.to_i
-
-    if (old_amount < amount)
-      ((old_amount + 1) .. amount).each { |num| system "start #{app}-#{process} NUM=#{num}" }
-    elsif (amount < old_amount)
-      ((amount + 1) .. old_amount).each { |num| system "stop #{app}-#{process} NUM=#{num}" }
-    end
-
-    write
-  end
-
-  def write
-    write_file "/etc/foreman/#{app}.conf", <<-UPSTART_CONFIG
-#{app}_processes="#{processes.keys.sort.join(' ')}"
-#{processes.keys.sort.map { |k| "#{app}_#{k}=\"#{processes[k]}\"" }.join("\n")}
-    UPSTART_CONFIG
-  end
-
-private ######################################################################
-
-  def read_initial_config
-    config = File.read("/etc/foreman/#{app}.conf").split("\n").inject({}) do |accum, line|
-      key, value = line.match(/^(.+?)\s*=\s*"(.+?)"\s*$/).captures
-      #accum.update(parts(1) => parts(2))
-      accum.update(key => value)
-    end
-    config["#{app}_processes"].split(" ").each do |process|
-      processes[process] = config["#{app}_#{process}"].to_i
-    end
-  rescue Errno::ENOENT
-  end
-
-  def write_file(filename, contents)
-    File.open(filename, "w") do |file|
-      file.puts contents
-    end
-  end
-
-end

lib/foreman/engine.rb

@@ -1,154 +0,0 @@
-require "foreman"
-require "foreman/process"
-require "pty"
-require "tempfile"
-require "term/ansicolor"
-
-class Foreman::Engine
-
-  attr_reader :procfile
-  attr_reader :directory
-
-  extend Term::ANSIColor
-
-  COLORS = [ cyan, yellow, green, magenta, on_blue ]
-
-  def initialize(procfile)
-    @procfile  = read_procfile(procfile)
-    @directory = File.expand_path(File.dirname(procfile))
-  end
-
-  def processes
-    @processes ||= begin
-      procfile.split("\n").inject({}) do |hash, line|
-        next if line.strip == ""
-        process = Foreman::Process.new(*line.split(" ", 2))
-        process.color = next_color
-        hash.update(process.name => process)
-      end
-    end
-  end
-
-  def start
-    proctitle "ruby: foreman master"
-
-    processes.each do |name, process|
-      fork process
-    end
-
-    trap("TERM") { kill_and_exit("TERM") }
-    trap("INT")  { kill_and_exit("INT")  }
-
-    watch_for_termination
-  end
-
-  def screen
-    tempfile = Tempfile.new("foreman")
-    tempfile.puts "sessionname foreman"
-    processes.each do |name, process|
-      tempfile.puts "screen -t #{name} #{process.command}"
-    end
-    tempfile.close
-
-    system "screen -c #{tempfile.path}"
-
-    tempfile.delete
-  end
-
-  def execute(name)
-    run(processes[name], false)
-  end
-
-private ######################################################################
-
-  def fork(process)
-    pid = Process.fork do
-      run(process)
-    end
-
-    info "started with pid #{pid}", process
-    running_processes[pid] = process
-  end
-
-  def run(process, log_to_file=true)
-    proctitle "ruby: foreman #{process.name}"
-
-    Dir.chdir directory do
-      FileUtils.mkdir_p "log"
-      command = process.command
-
-      begin
-        PTY.spawn("#{process.command} 2>&1") do |stdin, stdout, pid|
-          until stdin.eof?
-            info stdin.gets, process
-          end
-        end
-      rescue PTY::ChildExited, Interrupt
-        info "process exiting", process
-      end
-    end
-  end
-
-  def kill_and_exit(signal="TERM")
-    info "terminating"
-    running_processes.each do |pid, process|
-      info "killing #{process.name} in pid #{pid}"
-      Process.kill(signal, pid)
-    end
-    exit 0
-  end
-
-  def info(message, process=nil)
-    print process.color if process
-    print "#{Time.now.strftime("%H:%M:%S")} #{pad_process_name(process)} | "
-    print Term::ANSIColor.reset
-    print message.chomp
-    puts
-  end
-
-  def longest_process_name
-    @longest_process_name ||= begin
-      longest = processes.keys.map { |name| name.length }.sort.last
-      longest = 6 if longest < 6 # system
-      longest
-    end
-  end
-
-  def pad_process_name(process)
-    name = process ? process.name : "system"
-    name.ljust(longest_process_name)
-  end
-
-  def print_info
-    info "currently running processes:"
-    running_processes.each do |pid, process|
-      info "pid #{pid}", process
-    end
-  end
-
-  def proctitle(title)
-    $0 = title
-  end
-
-  def read_procfile(procfile)
-    File.read(procfile)
-  end
-
-  def watch_for_termination
-    pid, status = Process.wait2
-    process = running_processes.delete(pid)
-    info "process terminated", process
-    kill_and_exit
-  end
-
-  def running_processes
-    @running_processes ||= {}
-  end
-
-  def next_color
-    @current_color ||= -1
-    @current_color  +=  1
-    @current_color >= COLORS.length ? "" : COLORS[@current_color]
-  end
-
-end

lib/foreman/export.rb

@@ -1,7 +0,0 @@
-require "foreman"
-
-module Foreman::Export
-  class Exception < ::Exception; end
-end
-
-require "foreman/export/upstart"

lib/foreman/export/base.rb

@@ -1,48 +0,0 @@
-require "foreman/configuration"
-require "foreman/export"
-
-class Foreman::Export::Base
-
-  attr_reader :engine
-
-  def initialize(engine)
-    @engine = engine
-  end
-
-  def export
-    raise "export method must be overridden"
-  end
-
-private ######################################################################
-
-  def error(message)
-    raise Foreman::Export::Exception.new(message)
-  end
-
-  def say(message)
-    puts "[foreman export] %s" % message
-  end
-
-  def export_template(name)
-    File.read(File.expand_path("../../../../export/#{name}", __FILE__))
-  end
-
-  def parse_concurrency(concurrency)
-    @concurrency ||= begin
-      pairs = concurrency.to_s.gsub(/\s/, "").split(",")
-      pairs.inject(Hash.new(1)) do |hash, pair|
-        process, amount = pair.split("=")
-        hash.update(process => amount.to_i)        
-      end
-    end
-  end
-
-  def write_file(filename, contents)
-    say "writing: #{filename}"
-
-    File.open(filename, "w") do |file|
-      file.puts contents
-    end
-  end
-
-end

lib/foreman/export/upstart.rb

@@ -1,49 +0,0 @@
-require "erb"
-require "foreman/configuration"
-require "foreman/export/base"
-
-class Foreman::Export::Upstart < Foreman::Export::Base
-
-  def export(location, options={})
-    error("Must specify a location") unless location
-
-    FileUtils.mkdir_p location
-
-    app = options[:app] || File.basename(engine.directory)
-
-    Dir["#{location}/#{app}*.conf"].each do |file|
-      say "cleaning up: #{file}"
-      FileUtils.rm(file)
-    end
-
-    concurrency = parse_concurrency(options[:concurrency])
-
-    master_template = export_template("upstart/master.conf.erb")
-    master_config   = ERB.new(master_template).result(binding)
-    write_file "#{location}/#{app}.conf", master_config
-
-    process_template = export_template("upstart/process.conf.erb")
-    
-    engine.processes.values.each do |process|
-      1.upto(concurrency[process.name]) do |num|
-        process_config = ERB.new(process_template).result(binding)
-        write_file "#{location}/#{app}-#{process.name}-#{num}.conf", process_config
-      end
-    end
-
-    return
-    write_file "#{location}/#{app}.conf", <<-UPSTART_MASTER
-    UPSTART_MASTER
-
-    engine.processes.each do |process|
-      write_file process_conf, <<-UPSTART_CHILD
-      UPSTART_CHILD
-    end
-
-    engine.processes.each do |name, process|
-      config.processes[name] ||= 1
-    end
-    config.write
-  end
-
-end

lib/foreman/process.rb

@@ -1,14 +0,0 @@
-require "foreman"
-
-class Foreman::Process
-
-  attr_reader :name
-  attr_reader :command
-  attr_accessor :color
-
-  def initialize(name, command)
-    @name    = name
-    @command = command
-  end
-
-end

man/foreman.1

@@ -1,99 +0,0 @@
-.\" generated with Ronn/v0.7.0
-.\" http://github.com/rtomayko/ronn/tree/0.7.0
-.
-.TH "FOREMAN" "1" "June 2010" "Foreman 0.4.1" "Foreman Manual"
-.
-.SH "NAME"
-\fBforeman\fR \- manage Procfile\-based applications
-.
-.SH "SYNOPSIS"
-\fBforeman\fR start [process]
-.
-.br
-\fBforeman\fR export \fIformat\fR [location]
-.
-.SH "DESCRIPTION"
-\fBForeman\fR 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 "RUNNING"
-\fBforeman start\fR is used to run your application directly from the command line\.
-.
-.P
-If no additional parameters are passed, foreman will run one instance of each type of process defined in your Procfile\.
-.
-.P
-If a parameter is passed, foreman will run one instance of the specified application type\.
-.
-.P
-The following options control how the application is run:
-.
-.TP
-\fB\-s\fR, \fB\-\-screen\fR
-Run the application as a series of screen windows rather than interleaved in stdout\.
-.
-.SH "EXPORTING"
-\fBforeman export\fR is used to export your application to another process management format\.
-.
-.P
-An location to export can be passed as an argument\. This argument may be either required or optional depending on the export format\.
-.
-.P
-The following options control how the application is run:
-.
-.TP
-\fB\-a\fR, \fB\-\-app\fR
-Use this name rather than the application\'s root directory name as the name of the application when exporting\.
-.
-.TP
-\fB\-c\fR, \fB\-\-concurrency\fR
-Specify the number of each process type to run\. The value passed in should be in the format \fBprocess=num,process=num\fR\.
-.
-.SH "OPTIONS"
-These options control all modes of foreman\'s operation\.
-.
-.IP "\(bu" 4
-\fB\-p\fR, \fB\-\-procfile\fR Specify an alternate location for the application\'s Procfile\. This file\'s containing directory will be assumed to be the root directory of the application\.
-.
-.IP "" 0
-.
-.SH "EXAMPLES"
-Start one instance of each process type, interleave the output on stdout:
-.
-.IP "" 4
-.
-.nf
-
-$ foreman start
-.
-.fi
-.
-.IP "" 0
-.
-.P
-Export the application in upstart format:
-.
-.IP "" 4
-.
-.nf
-
-$ foreman export upstart /etc/init
-.
-.fi
-.
-.IP "" 0
-.
-.P
-Run one process type from the application defined in a specific Procfile:
-.
-.IP "" 4
-.
-.nf
-
-$ foreman start alpha \-p ~/app/Procfile
-.
-.fi
-.
-.IP "" 0
-.
-.SH "COPYRIGHT"
-Foreman is Copyright (C) 2010 David Dollar \fIhttp://daviddollar\.org\fR

man/foreman.1.ronn

@@ -1,75 +0,0 @@
-foreman(1) -- manage Procfile-based applications
-================================================
-
-## SYNOPSIS
-
-`foreman` start [process]<br>
-`foreman` export <format> [location]
-
-## 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.
-
-## RUNNING
-
-`foreman start` is used to run your application directly from the command line. 
-
-If no additional parameters are passed, foreman will run one instance of each
-type of process defined in your Procfile.
-
-If a parameter is passed, foreman will run one instance of the specified
-application type.
-
-The following options control how the application is run:
-
-  * `-s`, `--screen`:
-    Run the application as a series of screen windows rather than interleaved
-    in stdout.
-
-## EXPORTING
-
-`foreman export` is used to export your application to another process
-management format.
-
-An location to export can be passed as an argument. This argument may be
-either required or optional depending on the export format.
-
-The following options control how the application is run:
-
-  * `-a`, `--app`:
-    Use this name rather than the application's root directory name as the
-    name of the application when exporting.
-    
-  * `-c`, `--concurrency`:
-    Specify the number of each process type to run. The value passed in
-    should be in the format `process=num,process=num`.
-
-## OPTIONS
-
-These options control all modes of foreman's operation.
-
-  * `-p`, `--procfile`
-    Specify an alternate location for the application's Procfile. This file's
-    containing directory will be assumed to be the root directory of the
-    application.
-
-## EXAMPLES
-
-Start one instance of each process type, interleave the output on stdout:
-
-    $ foreman start
-
-Export the application in upstart format:
-
-    $ foreman export upstart /etc/init
-    
-Run one process type from the application defined in a specific Procfile:
-
-    $ foreman start alpha -p ~/app/Procfile
-
-## COPYRIGHT
-
-Foreman is Copyright (C) 2010 David Dollar <http://daviddollar.org>

spec/foreman/cli_spec.rb

@@ -1,64 +0,0 @@
-require "spec_helper"
-require "foreman/cli"
-
-describe "Foreman::CLI" do
-  subject { Foreman::CLI.new }
-
-  describe "start" do
-    describe "with a non-existent Procfile" do
-      it "prints an error" do
-        mock_error(subject, "Procfile does not exist.") do
-          dont_allow.instance_of(Foreman::Engine).start
-          subject.start
-        end
-      end
-    end
-
-    describe "with a Procfile" do
-      before(:each) { write_procfile }
-
-      it "runs successfully" do
-        dont_allow(subject).error
-        mock.instance_of(Foreman::Engine).start
-        subject.start
-      end
-    end
-  end
-
-  describe "export" do
-    describe "with a non-existent Procfile" do
-      it "prints an error" do
-        mock_error(subject, "Procfile does not exist.") do
-          dont_allow.instance_of(Foreman::Engine).export
-          subject.export("testapp")
-        end
-      end
-    end
-
-    describe "with a Procfile" do
-      before(:each) { write_procfile }
-
-      describe "with an invalid formatter" do
-        it "prints an error" do
-          mock_error(subject, "Unknown export format: invalidformatter.") do
-            subject.export("invalidformatter")
-          end
-        end
-      end
-
-      describe "with a valid config" do
-        before(:each) { write_foreman_config("testapp") }
-
-        it "runs successfully" do
-          dont_allow(subject).error
-          mock.instance_of(Foreman::Export::Upstart).export("/tmp/foo", {
-            :concurrency => nil,
-            :name => nil
-          })
-          subject.export("upstart", "/tmp/foo")
-        end
-      end
-    end
-  end
-
-end

spec/foreman/configuration_spec.rb

@@ -1,49 +0,0 @@
-require "spec_helper"
-require "foreman/configuration"
-
-describe "Foreman::Configuration" do
-  subject { Foreman::Configuration.new("testapp") }
-
-  describe "initialize" do
-    describe "without an existing config" do
-      it "has no processes" do
-        subject.processes.length.should == 0
-      end
-    end
-
-    describe "with an existing config" do
-      it "has processes" do
-        write_foreman_config("testapp")
-        subject.processes["alpha"].should == 1
-        subject.processes["bravo"].should == 2
-      end
-    end
-  end
-
-  describe "scale" do
-    before(:each) { write_foreman_config("testapp") }
-
-    it "can scale up" do
-      mock(subject).system("start testapp-alpha NUM=2")
-      mock(subject).system("start testapp-alpha NUM=3")
-      subject.scale("alpha", 3)
-    end
-
-    it "can scale down" do
-      mock(subject).system("stop testapp-bravo NUM=2")
-      subject.scale("bravo", 1)
-    end
-  end
-  
-  describe "wite" do
-    it "can write a configuration file" do
-      subject.scale("charlie", 3)
-      subject.scale("delta", 4)
-      File.read("/etc/foreman/testapp.conf").should == <<-FOREMAN_CONFIG
-testapp_processes="charlie delta"
-testapp_charlie="3"
-testapp_delta="4"
-      FOREMAN_CONFIG
-    end
-  end
-end

spec/foreman/engine_spec.rb

@@ -1,40 +0,0 @@
-require "spec_helper"
-require "foreman/engine"
-
-describe "Foreman::Engine" do
-  subject { Foreman::Engine.new("Procfile") }
-
-  describe "initialize" do
-    describe "without an existing Procfile" do
-      it "raises an error" do
-        lambda { subject }.should raise_error
-      end
-    end
-    
-    describe "with a Procfile" do
-      it "reads the processes" do
-        write_procfile
-        subject.processes["alpha"].command.should == "./alpha"
-        subject.processes["bravo"].command.should == "./bravo"
-      end
-    end
-  end
-  
-  describe "start" do
-    it "forks the processes" do
-      write_procfile
-      mock(subject).fork(subject.processes["alpha"])
-      mock(subject).fork(subject.processes["bravo"])
-      mock(subject).watch_for_termination
-      subject.start
-    end
-  end
-
-  describe "execute" do
-    it "runs the processes" do
-      write_procfile
-      mock(subject).run(subject.processes["alpha"], false)
-      subject.execute("alpha")
-    end
-  end
-end

spec/foreman/export/upstart_spec.rb

@@ -1,2 +0,0 @@
-require "spec_helper"
-require "foreman/export/upstart"

spec/foreman/export_spec.rb

@@ -1,2 +0,0 @@
-require "spec_helper"
-require "foreman/export"

spec/foreman/process_spec.rb

@@ -1,2 +0,0 @@
-require "spec_helper"
-require "foreman/process"

spec/foreman_spec.rb

@@ -1,11 +0,0 @@
-require "spec_helper"
-require "foreman"
-
-describe Foreman do
-
-  describe "VERSION" do
-    subject { Foreman::VERSION }
-    it { should be_a String }
-  end
-
-end

spec/spec_helper.rb

@@ -1,38 +0,0 @@
-require "rubygems"
-require "rspec"
-require "fakefs/safe"
-require "fakefs/spec_helpers"
-
-$:.unshift "lib"
-
-def mock_error(subject, message)
-  mock_exit do
-    mock(subject).puts("ERROR: #{message}")
-    yield
-  end
-end
-
-def mock_exit(&block)
-  block.should raise_error(SystemExit)
-end
-
-def write_foreman_config(app)
-  File.open("/etc/foreman/#{app}.conf", "w") do |file|
-    file.puts %{#{app}_processes="alpha bravo"}
-    file.puts %{#{app}_alpha="1"}
-    file.puts %{#{app}_bravo="2"}
-  end
-end
-
-def write_procfile(procfile="Procfile")
-  File.open(procfile, "w") do |file|
-    file.puts "alpha ./alpha"
-    file.puts "bravo ./bravo"
-  end
-end
-
-Rspec.configure do |config|
-  config.color_enabled = true
-  config.include FakeFS::SpecHelpers
-  config.mock_with :rr
-end