felixclack-cijoe 0.9.1

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.md

@@ -0,0 +1,175 @@
+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)](http://nerduo.com/thebattle/)
+
+([Buy the shirt](http://nerduo.com/thebattle/))
+
+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:
+
+* [Jenkins](http://jenkins-ci.org/)
+* [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)
+
+
+Does GitHub use cijoe?
+---------------------------------
+
+No. We use [Jenkins](http://jenkins-ci.org/).
+
+
+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)

data/Rakefile

@@ -0,0 +1,31 @@
+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 :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,50 @@
+#!/usr/bin/env ruby
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+
+require 'choice'
+require 'cijoe'
+
+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
+
+CIJoe::Server.start(options[:host], options[:port], File.expand_path(Choice.rest[0].to_s))

data/lib/cijoe.rb

@@ -0,0 +1,233 @@
+##
+# CI Joe.
+# Because knowing is half the battle.
+#
+# This is a stupid simple CI server. It can build one (1)
+# git-based project only.
+#
+# It only remembers the last build.
+#
+# It only notifies to Campfire.
+#
+# It's a RAH (Real American Hero).
+#
+# Seriously, I'm gonna be nuts about keeping this simple.
+
+require 'cijoe/version'
+require 'cijoe/config'
+require 'cijoe/commit'
+require 'cijoe/build'
+require 'cijoe/campfire'
+require 'cijoe/server'
+
+class CIJoe
+  attr_reader :user, :project, :url, :current_build, :last_build
+
+  def initialize(project_path)
+    @project_path = File.expand_path(project_path)
+
+    @user, @project = git_user_and_project
+    @url = "http://github.com/#{@user}/#{@project}"
+
+    @last_build = nil
+    @current_build = nil
+
+    trap("INT") { stop }
+  end
+
+  # is a build running?
+  def building?
+    !!@current_build
+  end
+
+  # the pid of the running child process
+  def pid
+    building? and current_build.pid
+  end
+
+  # kill the child and exit
+  def stop
+    # another build waits
+    if !repo_config.buildallfile.to_s.empty? && File.exist?(repo_config.buildallfile.to_s)
+      # clean out on stop
+      FileUtils.rm(repo_config.buildallfile.to_s)
+    end
+
+    Process.kill(9, pid) if pid
+    exit!
+  end
+
+  # build callbacks
+  def build_failed(output, error)
+    finish_build :failed, "#{error}\n\n#{output}"
+    run_hook "build-failed"
+  end
+
+  def build_worked(output)
+    finish_build :worked, output
+    run_hook "build-worked"
+  end
+
+  def finish_build(status, output)
+    @current_build.finished_at = Time.now
+    @current_build.status = status
+    @current_build.output = output
+    @last_build = @current_build
+
+    @current_build = nil
+    write_build 'current', @current_build
+    write_build 'last', @last_build
+    @last_build.notify if @last_build.respond_to? :notify
+
+    # another build waits
+    if !repo_config.buildallfile.to_s.empty? && File.exist?(repo_config.buildallfile.to_s)
+      # clean out before new build
+      FileUtils.rm(repo_config.buildallfile.to_s)
+      build
+    end
+  end
+
+  # run the build but make sure only one is running
+  # at a time (if new one comes in we will park it)
+  def build(branch=nil)
+    if building?
+      # only if switched on to build all incoming requests
+      if !repo_config.buildallfile.to_s.empty?
+        # and there is no previous request
+        return if File.exist?(repo_config.buildallfile.to_s)
+        # we will mark awaiting builds
+        FileUtils.touch(repo_config.buildallfile.to_s)
+      end
+      # leave anyway because a current build runs
+      return
+    end
+    @current_build = Build.new(@project_path, @user, @project)
+    write_build 'current', @current_build
+    Thread.new { build!(branch) }
+  end
+
+  def open_pipe(cmd)
+    read, write = IO.pipe
+
+    pid = fork do
+      read.close
+      $stdout.reopen write
+      exec cmd
+    end
+
+    write.close
+
+    yield read, pid
+  end
+
+  # update git then run the build
+  def build!(branch=nil)
+    @git_branch = branch
+    build = @current_build
+    output = ''
+    git_update
+    build.sha = git_sha
+    build.branch = git_branch
+    write_build 'current', build
+
+    open_pipe("cd #{@project_path} && #{runner_command} 2>&1") do |pipe, pid|
+      puts "#{Time.now.to_i}: Building #{build.branch} at #{build.short_sha}: pid=#{pid}"
+
+      build.pid = pid
+      write_build 'current', build
+      output = pipe.read
+    end
+
+    Process.waitpid(build.pid, 1)
+    status = $?.exitstatus.to_i
+    @current_build = build
+    puts "#{Time.now.to_i}: Built #{build.short_sha}: status=#{status}"
+
+    status == 0 ? build_worked(output) : build_failed('', output)
+  rescue Object => e
+    puts "Exception building: #{e.message} (#{e.class})"
+    build_failed('', e.to_s)
+  end
+
+  # shellin' out
+  def runner_command
+    runner = repo_config.runner.to_s
+    runner == '' ? "rake -s test:units" : runner
+  end
+
+  def git_sha
+    `cd #{@project_path} && git rev-parse origin/#{git_branch}`.chomp
+  end
+
+  def git_update
+    `cd #{@project_path} && git fetch origin && git reset --hard origin/#{git_branch}`
+    run_hook "after-reset"
+  end
+
+  def git_user_and_project
+    Config.remote(@project_path).origin.url.to_s.chomp('.git').split(':')[-1].split('/')[-2, 2]
+  end
+
+  def git_branch
+    return @git_branch if @git_branch
+    branch = repo_config.branch.to_s
+    @git_branch = branch == '' ? "master" : branch
+  end
+
+  # massage our repo
+  def run_hook(hook)
+    if File.exists?(file=path_in_project(".git/hooks/#{hook}")) && File.executable?(file)
+      data =
+        if @last_build && @last_build.commit
+          {
+            "MESSAGE" => @last_build.commit.message,
+            "AUTHOR" => @last_build.commit.author,
+            "SHA" => @last_build.commit.sha,
+            "OUTPUT" => @last_build.env_output
+          }
+        else
+          {}
+        end
+
+      ENV.clear
+      data.each{ |k, v| ENV[k] = v }
+      `cd #{@project_path} && sh #{file}`
+    end
+  end
+
+  # restore current / last build state from disk.
+  def restore
+    @last_build = read_build('last')
+    @current_build = read_build('current')
+
+    Process.kill(0, @current_build.pid) if @current_build && @current_build.pid
+  rescue Errno::ESRCH
+    # build pid isn't running anymore. assume previous
+    # server died and reset.
+    @current_build = nil
+  end
+
+  def path_in_project(path)
+    File.join(@project_path, path)
+  end
+
+  # write build info for build to file.
+  def write_build(name, build)
+    filename = path_in_project(".git/builds/#{name}")
+    Dir.mkdir path_in_project('.git/builds') unless File.directory?(path_in_project('.git/builds'))
+    if build
+      build.dump filename
+    elsif File.exist?(filename)
+      File.unlink filename
+    end
+  end
+
+  def repo_config
+    Config.cijoe(@project_path)
+  end
+
+  # load build info from file.
+  def read_build(name)
+    Build.load(path_in_project(".git/builds/#{name}"), @project_path)
+  end
+end