ssp-cijoe 0.4.1

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+rdoc
+pkg
+*.tmproj
+tmp/**/*
+tmp/*

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Chris Wanstrath
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+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.

data/README.markdown

@@ -0,0 +1,169 @@
+CI Joe
+======
+
+Joe is a [Continuous
+Integration](http://en.wikipedia.org/wiki/Continuous_integration)
+server that'll run your tests on demand and report their pass/fail status.
+
+Because knowing is half the battle.
+
+![The Battle](http://img.skitch.com/20090805-g4a2qhttwij8n2jr9t552efn3k.png)
+
+Quickstart
+----------
+
+RubyGems:
+
+    $ gem install cijoe
+    $ git clone git://github.com/you/yourrepo.git
+    $ cijoe yourrepo
+
+Boom. Navigate to <http://localhost:4567> to see Joe in action.
+Check `cijoe -h` for other options.
+
+Basically you need to run `cijoe` and hand it the path to a git
+repo. Make sure this isn't a shared repo: Joe needs to own it.
+
+Joe looks for various git config settings in the repo you hand it. For
+instance, you can tell Joe what command to run by setting
+`cijoe.runner`:
+
+    $ git config --add cijoe.runner "rake -s test:units"
+
+Joe doesn't care about Ruby, Python, or whatever. As long as the
+runner returns a non-zero exit status on fail and a zero on success,
+everyone is happy.
+
+Need to do some massaging of your repo before the tests run, like
+maybe swapping in a new database.yml? No problem - Joe will try to
+run `.git/hooks/after-reset` if it exists before each build phase.
+Do it in there. Just make sure it's executable.
+
+Want to notify IRC or email on test pass or failure? Joe will run
+`.git/hooks/build-failed` or `.git/hooks/build-worked` if they exist
+and are executable on build pass / fail. They're just shell scripts -
+put whatever you want in there.
+
+Tip: your repo's `HEAD` will point to the commit used to run the
+build. Pull any metadata you want out of that scro.
+
+
+Other Branches
+----------------------
+
+Want joe to run against a branch other than `master`? No problem:
+
+    $ git config --add cijoe.branch deploy
+
+
+Concurrent Push's - a kind of "queueing"
+----------------------------------------
+
+Joe runs just one build at the time. If you expect concurrent push's
+to your repo and want joe to build each in a kind of queue, just set:
+
+    $ git config --add cijoe.buildallfile tmp/cijoe.txt
+
+Joe will save requests while another build runs. If more than one push
+hits joe, he just picks the last after finishing the prior.
+
+
+Campfire
+-------------
+
+Campfire notification is included, because it's what we use. Want Joe
+notify your Campfire? Put this in your repo's `.git/config`:
+
+    [campfire]
+    	user = your@campfire.email
+    	pass = passw0rd
+    	subdomain = whatever
+    	room = Awesomeness
+    	ssl = false
+
+Or do it the old fashion way:
+
+    $ cd yourrepo
+    $ git config --add campfire.user chris@ozmm.org
+    $ git config --add campfire.subdomain github
+    etc.
+
+
+Checkin' Status
+----------------------
+
+Want to see how your build's doing without any of this fancy UI crap?
+Ping Joe for the lowdown:
+
+    curl http://localhost:4567/ping
+
+Joe will return `200 OK` if all is quiet on the Western Front. If
+Joe's busy building or your last build failed, you'll get `412
+PRECONDITION FAILED`.
+
+
+Multiple Projects
+------------------------
+
+Want CI for multiple projects? Just start multiple instances of Joe!
+He can run on any port - try `cijoe -h` for more options.
+
+If you're using Passenger, see [this blog post](http://chrismdp.github.com/2010/03/multiple-ci-joes-with-rack-and-passenger/).
+
+
+HTTP Auth
+----------------
+
+Worried about people triggering your builds? Setup HTTP auth:
+
+    $ git config --add cijoe.user chris
+    $ git config --add cijoe.pass secret
+
+
+GitHub Integration
+--------------------------
+
+Any POST to Joe will trigger a build. If you are hiding Joe behind
+HTTP auth, that's okay - GitHub knows how to authenticate properly.
+
+![Post-Receive URL](http://img.skitch.com/20090806-d2bxrk733gqu8m11tf4kyir5d8.png)
+
+You can find the Post-Receive option under the 'Service Hooks' subtab
+of your project's "Admin" tab.
+
+
+Daemonize
+----------------
+
+Want to run Joe as a daemon? Use `nohup`:
+
+    $ nohup cijoe -p 4444 repo &
+
+
+Other CI Servers
+------------------------
+
+Need more features? More notifiers? Check out one of these bad boys:
+
+* [Cerberus](http://cerberus.rubyforge.org/)
+* [Integrity](http://integrityapp.com/)
+* [CruiseControl.rb](http://cruisecontrolrb.thoughtworks.com/)
+* [BuildBot](http://buildbot.net/trac)
+* [Signal](http://www.github.com/dcrec1/signal)
+
+
+Screenshots
+------------------
+
+![Building](http://img.skitch.com/20090806-ryw34ksi5ixnrdwxcptqy28iy7.png)
+
+![Built](http://img.skitch.com/20090806-f7j3r65yecaq13hdcxqwtc5krd.)
+
+
+Questions? Concerns?
+---------------------------------
+
+[Issues](http://github.com/defunkt/cijoe/issues) or [the mailing list](http://groups.google.com/group/cijoe).
+
+
+( Chris Wanstrath :: chris@ozmm.org )

data/Rakefile

@@ -0,0 +1,67 @@
+desc "Build a gem"
+task :gem => [ :gemspec, :build ]
+
+begin
+  require 'jeweler'
+
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/lib'
+  require 'cijoe/version'
+
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "ssp-cijoe"
+    gemspec.summary = "CI Joe is a simple Continuous Integration server."
+    gemspec.description = "CI Joe is a simple Continuous Integration server."
+    gemspec.email = "chris@ozmm.org"
+    gemspec.homepage = "http://github.com/defunkt/cijoe"
+    gemspec.authors = ["Chris Wanstrath", "András Tarsoly", "Secret Sauce Partners, Inc."]
+    gemspec.add_dependency 'choice'
+    gemspec.add_dependency 'sinatra'
+    gemspec.add_development_dependency 'rack-test'
+    gemspec.version = CIJoe::Version.to_s
+  end
+rescue LoadError
+  puts "Jeweler not available."
+  puts "Install it with: gem install jeweler"
+end
+
+desc "Publish a RubyGem"
+task :publish => :gem do
+  $LOAD_PATH.unshift File.dirname(__FILE__) + '/lib'
+  require 'cijoe/version'
+
+  sh "gem push pkg/ssp-cijoe-#{CIJoe::Version}.gem"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+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
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "someproject #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/bin/cijoe

@@ -0,0 +1,52 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'choice'
+
+Choice.options do
+  banner "Usage: #{File.basename(__FILE__)} [-hpv] path_to_git_repo"
+  header ''
+  header 'Server options:'
+
+  option :host do
+    d = "0.0.0.0"
+    short '-h'
+    long '--host=HOST'
+    desc "The hostname or ip of the host to bind to (default #{d})"
+    default d
+  end
+
+  option :port do
+    d = 4567
+    short '-p'
+    long '--port=PORT'
+    desc "The port to listen on (default #{d})"
+    cast Integer
+    default d
+  end
+
+  separator ''
+  separator 'Common options: '
+
+  option :help do
+    long '--help'
+    desc 'Show this message'
+  end
+
+  option :version do
+    short '-v'
+    long '--version'
+    desc 'Show version'
+    action do
+      puts "#{File.basename(__FILE__)} v#{CIJoe::Version}"
+      exit
+    end
+  end
+end
+
+options = Choice.choices
+$project_path = File.expand_path(Choice.rest[0])
+
+require 'cijoe'
+
+CIJoe::Server.start(options[:host], options[:port], $project_path)

data/deps.rip

@@ -0,0 +1,4 @@
+git://github.com/collectiveidea/tinder.git 1.2.0
+git://github.com/sinatra/sinatra.git 0.9.4
+git://github.com/rack/rack.git 1.0
+git://github.com/defunkt/choice.git 8b125564

data/examples/build-failed

@@ -0,0 +1,22 @@
+#!/bin/sh
+#
+# Put this file to $PROJECT/.git/hooks/ for email notifications.
+#
+# You should have mail command provided by mailutils package on Debian
+# based systems.
+#
+# sudo apt-get install mailutils
+#
+# You should have mail server running
+#
+# Do not forget: chmod +x build-failed
+#
+echo "
+Visit http://ci.example.org/ for details
+
+Author:  $AUTHOR
+Message:
+$MESSAGE
+
+$OUTPUT
+" | mail -s "[example.org] BUILD FAILED $SHA" --to first@gmail.com second@gmail.com

data/examples/build-worked

@@ -0,0 +1,22 @@
+#!/bin/sh
+#
+# Put this file to $PROJECT/.git/hooks/ for email notifications.
+#
+# You should have mail command provided by mailutils package on Debian
+# based systems.
+#
+# sudo apt-get install mailutils
+#
+# You should have mail server running
+#
+# Do not forget: chmod +x build-worked
+#
+echo "
+Visit http://ci.example.org/ for details
+
+Author: $AUTHOR
+Message:
+$MESSAGE
+
+" | mail -s "[example.org] build OK"  --to first@gmail.com second@gmail.com
+

data/examples/cijoe.ru

@@ -0,0 +1,15 @@
+# Example CI Joe rackup config. Drop a cijoe.ru file
+# in your projects direct
+require 'cijoe'
+
+# setup middleware
+use Rack::CommonLogger
+
+# configure joe
+CIJoe::Server.configure do |config|
+  config.set :project_path, File.dirname(__FILE__)
+  config.set :show_exceptions, true
+  config.set :lock, true
+end
+
+run CIJoe::Server

data/examples/cijoed

@@ -0,0 +1,53 @@
+#!/bin/sh
+### BEGIN INIT INFO
+# Provides:          cijoe
+# Required-Start:    $syslog $local_fs $network
+# Required-Stop:     $syslog $local_fs $network
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 
+# Description:       Run the CIJoe CI server.  Yo Joe!!
+### END INIT INFO
+
+. /lib/lsb/init-functions
+
+REPO=/path/to/your/git/repository
+PORT=4567
+
+NAME=cijoe
+INSTALL_DIR=/usr/sbin
+DAEMON=$INSTALL_DIR/$NAME
+DAEMON_ARGS="-p $PORT $REPO"
+PIDFILE=/var/run/$NAME.pid
+DAEMON_USER=www-data
+DAEMON_GROUP=$DAEMON_USER
+
+# test -f $DAEMON || exit 0
+# test -f $PROJECT_DIR || exit 0
+
+case "$1" in
+start)
+	log_daemon_msg "Starting cijoe" "cijoe"
+	start-stop-daemon --background --make-pidfile --exec $DAEMON --start --name $NAME --pidfile $PIDFILE --chuid $DAEMON_USER:$DAEMON_GROUP -- $DAEMON_ARGS
+	log_end_msg $?
+	;;
+stop)
+	log_daemon_msg "Stopping cijoe" "cijoe"
+	start-stop-daemon --stop --pidfile $PIDFILE --quiet --retry 10
+	log_end_msg $?
+	;;
+restart)
+	log_daemon_msg "Restarting cijoe" "cijoe"
+	start-stop-daemon --stop --pidfile $PIDFILE --quiet --retry 10
+	start-stop-daemon --background --make-pidfile --exec $DAEMON --start --name $NAME --pidfile $PIDFILE --chuid $DAEMON_USER:$DAEMON_GROUP -- $DAEMON_ARGS
+	log_end_msg $?
+	;;
+status)
+	status_of_proc $DAEMON $NAME && exit 0 || exit $?
+	;;
+*)
+	log_action_msg "Usage: /etc/init.d/cijoe (start|stop|restart)"
+	exit 2
+	;;
+esac
+
+exit 0

data/lib/cijoe/build.rb

@@ -0,0 +1,74 @@
+require 'yaml'
+
+class CIJoe
+  class Build < Struct.new(:user, :project, :started_at, :finished_at, :sha, :status, :output, :pid)
+    def initialize(*args)
+      super
+      self.started_at ||= Time.now
+    end
+
+    def status
+      return super if started_at && finished_at
+      :building
+    end
+
+    def failed?
+      status == :failed
+    end
+
+    def worked?
+      status == :worked
+    end
+
+    def building?
+      status == :building
+    end
+
+    def duration
+      return if building?
+      finished_at - started_at
+    end
+
+    def short_sha
+      if sha
+        sha[0,7]
+      else
+        "<unknown>"
+      end
+    end
+    
+    def full_id
+      "#{short_sha}.#{finished_at.to_i.to_s}"
+    end
+    
+    def metrics_url
+      "#{Config.cijoe.metricshost}/#{full_id}/metrics/index.html"
+    end
+    
+    def coverage_url
+      "#{Config.cijoe.metricshost}/#{full_id}/coverage/index.html"
+    end
+
+    def clean_output
+      output.gsub(/\e\[.+?m/, '').strip
+    end
+
+    def commit
+      return if sha.nil?
+      @commit ||= Commit.new(sha, user, project)
+    end
+
+    def dump(file)
+      config = [user, project, started_at, finished_at, sha, status, output, pid]
+      data = YAML.dump(config)
+      File.open(file, 'wb') { |io| io.write(data) }
+    end
+
+    def self.load(file)
+      if File.exist?(file)
+        config = YAML.load(File.read(file))
+        new *config
+      end
+    end
+  end
+end

data/lib/cijoe/campfire.rb

@@ -0,0 +1,72 @@
+class CIJoe
+  module Campfire
+    def self.activate
+      if valid_config?
+        require 'tinder'
+
+        CIJoe::Build.class_eval do
+          include CIJoe::Campfire
+        end
+
+        puts "Loaded Campfire notifier"
+      else
+        puts "Can't load Campfire notifier."
+        puts "Please add the following to your project's .git/config:"
+        puts "[campfire]"
+        puts "\tuser = your@campfire.email"
+        puts "\tpass = passw0rd"
+        puts "\tsubdomain = whatever"
+        puts "\troom = Awesomeness"
+        puts "\tssl = false"
+      end
+    end
+
+    def self.config
+      @config ||= {
+        :subdomain => Config.campfire.subdomain.to_s,
+        :user      => Config.campfire.user.to_s,
+        :pass      => Config.campfire.pass.to_s,
+        :room      => Config.campfire.room.to_s,
+        :ssl       => Config.campfire.ssl.to_s.strip == 'true'
+      }
+    end
+
+    def self.valid_config?
+      %w( subdomain user pass room ).all? do |key|
+        !config[key.intern].empty?
+      end
+    end
+
+    def notify
+      room.speak "#{short_message}. #{commit.url}"
+      room.paste full_message if failed?
+      room.leave
+    end
+
+  private
+    def room
+      @room ||= begin
+        config = Campfire.config
+        options = {}
+        options[:ssl] = config[:ssl] ? true : false
+        campfire = Tinder::Campfire.new(config[:subdomain], options)
+        campfire.login(config[:user], config[:pass])
+        campfire.find_room_by_name(config[:room])
+      end
+    end
+
+    def short_message
+      "Build #{short_sha} of #{project} #{worked? ? "was successful" : "failed"}"
+    end
+
+    def full_message
+      <<-EOM
+Commit Message: #{commit.message}
+Commit Date: #{commit.committed_at}
+Commit Author: #{commit.author}
+
+#{clean_output}
+EOM
+    end
+  end
+end

data/lib/cijoe/commit.rb

@@ -0,0 +1,27 @@
+class CIJoe
+  class Commit < Struct.new(:sha, :user, :project)
+    def url
+      "http://github.com/#{user}/#{project}/commit/#{sha}"
+    end
+
+    def author
+      raw_commit_lines.grep(/Author:/).first.split(':', 2)[-1]
+    end
+
+    def committed_at
+      raw_commit_lines.grep(/Date:/).first.split(':', 2)[-1]
+    end
+
+    def message
+      raw_commit.split("\n\n", 3)[1].to_s.strip
+    end
+
+    def raw_commit
+      @raw_commit ||= `git show #{sha}`.chomp
+    end
+
+    def raw_commit_lines
+      @raw_commit_lines ||= raw_commit.split("\n")
+    end
+  end
+end

data/lib/cijoe/config.rb

@@ -0,0 +1,43 @@
+class CIJoe
+  class Config
+    def self.method_missing(command, *args)
+      new(command)
+    end
+
+    def initialize(command, parent = nil)
+      @command  = command
+      @parent   = parent
+      @project_path = $project_path || File.join(File.dirname(__FILE__), '../../')
+    end
+
+    def method_missing(command, *args)
+      Config.new(command, self)
+    end
+
+    def to_s
+      git_command = "cd #{@project_path} && git config #{config_string}"
+      result = `#{git_command} 2>&1`.chomp
+      process_status = $?
+
+      if successful_command?(process_status) || config_command_with_empty_value?(result,process_status)
+        return result
+      else
+        raise "Error calling git config, is a recent version of git installed? Command: #{git_command}, Error: #{result}"
+      end
+    end
+
+    def config_string
+      @parent ? "#{@parent.config_string}.#{@command}" : @command
+    end
+
+    private
+
+    def successful_command?(process_status)
+      process_status.exitstatus.to_i == 0
+    end
+
+    def config_command_with_empty_value?(result, process_status)
+      process_status.exitstatus.to_i == 1 && result.empty?
+    end
+  end
+end

data/lib/cijoe/partials.rb

@@ -0,0 +1,16 @@
+module Sinatra::Partials
+  def partial(template, *args)
+    template_array = template.to_s.split('/')
+    template = template_array[0..-2].join('/') + "/_#{template_array[-1]}"
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options.merge!(:layout => false)
+    if collection = options.delete(:collection) then
+      collection.inject([]) do |buffer, member|
+        buffer << erb(:"#{template}", options.merge(:layout =>
+        false, :locals => {template_array[-1].to_sym => member}))
+      end.join("\n")
+    else
+      erb(:"#{template}", options)
+    end
+  end
+end