cukeq 0.0.1.dev

data/.autotest

@@ -0,0 +1 @@
+require "autotest/redgreen"

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2010 Jari Bakken
+
+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.rdoc

@@ -0,0 +1,73 @@
+= cukeq
+
+This code is not in a usable state yet, contributions welcome!
+
+This project will some time in the future provide a simple way of distributing
+Cucumber features across machines and collect the results.
+
+= Dependencies
+
+You need to have an AMQP broker (like RabbitMQ) installed and running:
+
+  $ brew install rabbitmq
+  $ ruby -rubygems bin/cukeq setup
+  $ rabbitmq-server
+
+If you want to use CukeQ with Subversion, you'll need to install the Ruby bindings:
+
+  $ sudo apt-get install libsvn-ruby
+
+= Interface
+
+  $ cukeq master --broker URI --report-to URI --scm URI
+  $ cukeq slave --broker URI
+
+= Master
+
+1. REST service to trigger runs, payload:
+  {:features => ["file:line", "file:line", ...]}
+2. Update from SCM.
+3. Call Cucumber to get «exploded scenarios» (JSON) - (shell out to cucumber with custom formatter + --dry-run ??).
+4. Create JSON payload
+  [
+    {
+      :run_id => id,
+      :scm    => {:revision => 1234, :url => "git://..."}
+      :exploded_scenario => ast(?)
+    },
+  ...
+  ]
+5. Put payload on jobs queue.
+6. Pull step result from result queue.
+7. POST step result to --report-to URL, and/or let several reporters register themselves with the Master webapp (webhookish)
+
+= Slave
+
+1. Pull job from job queue.
+2. If job revision != last revision
+    * Update/checkout from SCM.
+    * Restart Cucumber process with updated code files.
+3. Invoke steps (through wire protocol?)
+4. Put step/scenario/unit (undecided) result on result queue.
+
+= Other
+
+- All parsing is done on the master - the slave shouldn't have to parse .feature files.
+- The slave should be able to invoke cucumber steps implemented in any of the supported languages
+- Need a (separate?) webapp to select which features to run and show the results as the step results come in. (a --report-to recipient)
+- Should also be able to trigger runs from command line (`cukeq-runner file:line file:line`, prints `http://app/runs/«run id»`)
+
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Jari Bakken. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,68 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |g|
+    g.name        = "cukeq"
+    g.summary     = %Q{Distributed cucumbers}
+    g.description = %Q{Cucumber features distributed using AMQP.}
+    g.email       = "jari.bakken@gmail.com"
+    g.homepage    = "http://github.com/jarib/cukeq"
+    g.authors     = ["Jari Bakken"]
+
+    g.add_dependency "amqp"
+    g.add_dependency "thin"
+    g.add_dependency "json"
+    g.add_dependency "git"
+
+    g.add_development_dependency "rspec", ">= 2.0.0"
+    g.add_development_dependency "yard", ">= 0"
+    g.add_development_dependency "cucumber", ">= 0"
+    g.add_development_dependency "rack-test", ">= 0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+
+task :default => ["spec:coverage", "spec:coverage:verify"]
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ["--color", "--format", "progress"]
+  t.pattern = 'spec/**/*_spec.rb'
+  t.rcov = false
+end
+
+namespace :spec do
+  RSpec::Core::RakeTask.new(:coverage) do |t|
+    t.rspec_opts = ["--color", "--format", "progress"]
+    t.pattern = 'spec/**/*_spec.rb'
+    t.rcov = true
+    t.rcov_opts = ['--exclude-only', '".*"', '--include-file', '^lib']
+  end
+end
+
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1.dev

data/bin/cukeq

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib') # TODO: remove this
+require 'cukeq'
+
+case ARGV.shift
+when 'slave'
+  CukeQ::Slave.execute(ARGV.dup)
+when 'master'
+  CukeQ::Master.execute(ARGV.dup)
+when 'run'
+  CukeQ::Runner.execute(ARGV.dup)
+when 'clear-jobs'
+  CukeQ::JobClearer.execute(ARGV.dup)
+when 'setup'
+  # TODO - make password configurable
+
+  puts `rabbitmqctl add_vhost /cukeq`
+
+  # create users with password 'cukeq123'
+  %w[cukeq-master cukeq-slave].each do |user|
+    puts `rabbitmqctl add_user #{user} cukeq123`
+    # puts `rabbitmqctl map_user_vhost #{user} /cukeq`
+
+    # the three regex's map to config, write, read permissions respectively
+    puts `rabbitmqctl set_permissions -p /cukeq #{user} ".*" ".*" ".*"`
+  end
+
+  puts `rabbitmqctl list_users`
+  puts `rabbitmqctl list_vhosts`
+  puts `rabbitmqctl list_permissions -p /cukeq`
+else
+  abort "USAGE: #{File.basename $0} [slave|master|run|setup]"
+end

data/features/cukeq.feature

@@ -0,0 +1,15 @@
+Feature: Distributed cucumber
+  In order run my cukes quickly
+  As a Cucumber user
+  I want to distribute my cukes
+
+  Background:
+    Given I have a master and 2 slaves running
+    And a report app is running
+
+  Scenario: Distribute 2 features
+    When I POST the following list to the master web service:
+      | features/example1.feature |
+      | features/example2.feature |
+    Then the report app should know when the run has finished
+    And I should be able to GET the results

data/features/example1.feature

@@ -0,0 +1 @@
+Feature: feature 1

data/features/example2.feature

@@ -0,0 +1 @@
+Feature: feature 2

data/features/step_definitions/cukeq_steps.rb

@@ -0,0 +1,22 @@
+Given /^I have a master and (\d+) slaves running$/ do |n|
+  start_master
+  n.to_i.times { start_slave }
+end
+
+Given /^a report app is running$/ do
+  start_report_app
+end
+
+Given /^I POST the following list to the master web service:$/ do |table|
+  features = table.raw.flatten
+  post(master_url, features.to_json)
+end
+
+Then /^the report app should know when the run has finished$/ do
+  sleep 5 # heh.
+end
+
+Then /^I should be able to GET the results$/ do
+  json = get(report_app.url + "/results")
+  JSON.parse(json).size.should == 2
+end

data/features/support/cukeq_helper.rb

@@ -0,0 +1,73 @@
+require "net/http"
+
+module CukeQHelper
+
+  MASTER_ARGS = %w[--scm git://github.com/jarib/cukeq.git --report-to http://localhost:1212]
+
+  def cleanup
+    pids.each { |pid| Process.kill(:KILL, pid) }
+    Process.wait
+  end
+
+  def start_master
+    pids << fork { CukeQ::Master.execute(MASTER_ARGS) }
+    ensure_running
+  end
+
+  def start_slave
+    pids << fork { CukeQ::Slave.execute }
+    ensure_running
+  end
+
+  def start_report_app
+    app = report_app()
+
+    pids << fork { app.start }
+    ensure_running
+  end
+
+  def post(url, data)
+    uri = URI.parse(url)
+    req = Net::HTTP::Post.new(uri.path)
+    req.body = data
+
+    execute_request uri, req
+  end
+
+  def get(url)
+    uri = URI.parse(url)
+    execute_request uri, Net::HTTP::Get.new(uri.path)
+  end
+
+  def master_url
+    "http://localhost:9292/"
+  end
+
+  def ensure_running
+    3.times do
+      pid, status = Process.waitpid2(pids.last, Process::WNOHANG)
+      raise "process died: #{status.inspect}" if pid
+      sleep 0.5
+    end
+  end
+
+  def report_app
+    @report_app ||= ReportApp.new
+  end
+
+  def pids
+    @pids ||= []
+  end
+
+  def execute_request(url, req)
+    res = Net::HTTP.new(url.host, url.port).start {|http| http.request(req) }
+
+    case res
+    when Net::HTTPSuccess
+      res.body
+    else
+      res.error!
+    end
+  end
+
+end

data/features/support/env.rb

@@ -0,0 +1,13 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../lib')
+
+require 'rubygems'
+require 'cukeq'
+require 'spec/expectations'
+require File.dirname(__FILE__) + "/report_app"
+require File.dirname(__FILE__) + "/cukeq_helper"
+
+World(CukeQHelper)
+
+After do
+  cleanup
+end

data/features/support/report_app.rb

@@ -0,0 +1,36 @@
+class ReportApp
+
+  def url
+    "http://localhost:#{port}"
+  end
+
+  def port
+    1212
+  end
+
+  def start
+    Rack::Handler::Thin.run(self, :Port => port)
+  end
+
+  def results
+    @results ||= []
+  end
+
+  def call(env)
+    r = Rack::Request.new(env)
+    if r.post?
+      results << JSON.parse(r.body.read)
+    elsif r.get?
+      case r.path
+      when "/results"
+        return [200, {}, [results.to_json]]
+      when "/clear"
+        results.clear
+      else
+        return [404, {}, []]
+      end
+    end
+
+    [200, {}, []]
+  end
+end

data/lib/cukeq.rb

@@ -0,0 +1,45 @@
+require "amqp"
+require "mq"
+require "rack/handler/thin"
+require "json"
+
+require "uri"
+require "etc"
+require "pp"
+require "optparse"
+require "socket"
+
+require "cukeq/em/system3"
+
+require "cukeq/broker"
+require "cukeq/webapp"
+require "cukeq/scm"
+require "cukeq/scm/git_bridge"
+
+begin
+  require "cukeq/scm/svn_bridge"
+rescue LoadError
+  require "cukeq/scm/shell_svn_bridge"
+end
+
+require "cukeq/reporter"
+require "cukeq/scenario_exploder"
+require "cukeq/scenario_runner"
+
+require "cukeq/master"
+require "cukeq/slave"
+require "cukeq/job_clearer"
+require "cukeq/runner"
+
+module CukeQ
+  def self.identifier
+    @identifier ||= "#{Socket.gethostname}-#{Etc.getlogin}"
+  end
+end
+
+def log(*args)
+  str = [Time.now, *args].map { |e| e.inspect }.join "  |  "
+
+  $stdout.puts str
+  $stdout.flush
+end