relex-specjour 0.2.6

data/.dev

@@ -0,0 +1,3 @@
+export RUBYLIB=`pwd`/lib
+export RUBYOPT=rubygems
+export PATH=`pwd`/bin:$PATH

data/.document

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

data/.gitignore

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

data/History.markdown

@@ -0,0 +1,48 @@
+History
+=======
+0.2.5
+-----
+*2010-05-13*
+
+* [changed] The rails plugin now runs in a Rails.configuration.after_intialize
+  block
+
+0.2.4
+-----
+*2010-05-10*
+
+* [added] Correct exit status
+* [fixed] Will reconnect when connection is lost while requesting tests
+
+0.2.3
+-----
+*2010-04-25*
+
+* [fixed] Absolute paths in rsyncd.conf restrict portability. The rsync daemon
+  completely fails when it can't find the path to serve which typically happens
+  running specjour on another computer. Remove your rsyncd.conf to regenerate a
+  new one. Back it up first if you've made changes to it.
+  **Backwards Incompatible**
+
+* [fixed] CPU core detection works on OSX Core i7 (thanks Hashrocket!)
+
+0.2.2
+-----
+*2010-04-22*
+
+* [added] Backtrace for cucumber failures
+
+0.2.1
+-----
+*2010-04-21*
+
+* [added] The rsync daemon configuration file now lives in
+  project_path/.specjour/rsyncd.conf. Edit your rsync exclusions there.
+* [fixed] Don't report connection errors when CTRL-C is sent.
+
+0.2.0
+-----
+*2010-04-20*
+
+* [added] Cucumber support. `rake specjour:cucumber`
+* [added] CPU Core detection, use -w to override with less or more workers

data/MIT_LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Sandro Turriate
+
+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,104 @@
+# Specjour
+
+## FUCK SETI. Run specs with your spare CPU cycles.
+
+_Distribute your spec suite amongst your LAN via Bonjour._
+
+1. Spin up a manager on each machine that can run your specs.
+2. Start a dispatcher in your project directory.
+3. Say farewell to your long coffee breaks.
+
+## Requirements
+* Bonjour or DNSSD (the capability and the gem)
+* Rsync (system command used)
+* Rspec (officially v1.3.0)
+
+## Installation
+    gem install specjour
+
+## Start a manager
+Running `specjour` on the command-line will start a manager which advertises that it's ready to run specs. By default, the manager will use your system cores to determine the number of workers to use. Two cores equals two workers. If you only want to dedicate 1 core to running specs, use `$ specjour --workers 1`.
+
+    $ specjour
+
+## Setup the dispatcher
+Require specjour's rake tasks in your project's `Rakefile`.
+
+    require 'specjour/tasks/specjour'
+
+## Distribute the specs
+Run the rake task to distribute the specs among the managers you started.
+
+    $ rake specjour
+
+## Distribute the features
+Run the rake task to distribute the features among the managers you started.
+
+    $ rake specjour:cucumber
+
+## Rails
+Each worker should run their specs in an isolated database. Modify the test database name in your `config/database.yml` to include the following environment variable (Influenced by [parallel\_tests](http://github.com/grosser/parallel_tests)):
+
+    test:
+      database: blog_test<%=ENV['TEST_ENV_NUMBER']%>
+
+Add the specjour gem to your project:
+
+    config.gem 'specjour'
+
+Doing this enables a rails plugin wherein each worker will attempt to clear its database tables before running any specs via `DELETE FROM <table_name>;`. Additionally, test databases will be created if they don't exist (i.e. `CREATE DATABASE blog_test8` for the 8th worker) and your schema will be loaded when the database is out of date.
+
+### Customizing database setup
+If the plugin doesn't set up the database properly for your test suite, bypass it entirely. Remove specjour as a project gem and create your own initializer to setup the database. Specjour sets the environment variable PREPARE\_DB when it runs your specs so you can look for that when setting up the database.
+
+    # config/initializers/specjour.rb
+
+    if ENV['PREPARE_DB']
+      load 'Rakefile'
+
+      # clear the db and load db/seeds.rb
+      Rake::Task['db:reset'].invoke
+    end
+
+## Only listen to supported projects
+By default, a manager will listen to all projects trying to distribute specs over the network. Sometimes you'll only want a manager to respond to one specific spec suite. You can accomplish this with the `--projects` flag.
+
+    $ specjour --projects bizconf # only run specs for the bizconf project
+
+You could also listen to multiple projects:
+
+    $ specjour --projects bizconf,workbeast # only run specs for the bizconf and workbeast projects
+
+## Customize what gets rsync'd
+The standard rsync configuration file may be too broad for your
+project. If you find you're rsyncing gigs of extraneous data from your public
+directory, add an exclusion to your projects rsyncd.conf file.
+
+    $ vi workbeast/.specjour/rsyncd.conf
+
+## Use one machine
+Distributed testing doesn't have to happen over multiple machines, just multiple processes. Specjour is an excellent candidiate for running 4 tests at once on one machine with 4 cores. Just run `$ specjour` in one window and `$ rake specjour` in another.
+
+## Thanks
+
+* shayarnett - Cucumber support, pairing and other various patches
+* voxdolo - Endless support, alpha testing, various patches
+* leshill - Made rsync daemon configurable
+* testjour - Ripped off your name
+* parallel\_tests - Made my test suite twice as fast
+
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* `$ source .dev` to ensure you're using the local specjour binary, not the
+  rubygems version
+* 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) 2010 Sandro Turriate. See MIT\_LICENSE for details.

data/Rakefile

@@ -0,0 +1,51 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "relex-specjour"
+    gem.summary = %Q{Distribute your spec suite amongst your LAN via Bonjour.}
+    gem.description = %Q{Distribute your spec suite amongst your LAN via Bonjour.}
+    gem.email = "colintimmermans@gmail.com"
+    gem.homepage = "http://github.com/sandro/specjour"
+    gem.authors = ["Sandro Turriate", "Colin Timmermans"]
+    gem.add_dependency "dnssd", "1.3.1"
+    gem.add_dependency "rspec"
+    gem.add_development_dependency "rspec", "1.3.0"
+    gem.add_development_dependency "rr", "0.10.11"
+    gem.add_development_dependency "yard", "0.5.3"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+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
+
+$:.unshift(File.dirname(__FILE__) + "/lib")
+require 'specjour/tasks/specjour'

data/VERSION

@@ -0,0 +1 @@
+0.2.6

data/bin/specjour

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'specjour'
+
+options = {:batch_size => 1}
+
+optparse = OptionParser.new do |opts|
+  opts.banner = "Usage: specjour [options]"
+
+  opts.on('-w', '--workers WORKERS', Numeric, "Number of WORKERS to spin up, defaults to available cores") do |n|
+    options[:worker_size] = n
+  end
+
+  opts.on('-b', '--batch-size [SIZE]', Integer, "Number of specs to run before reporting back to the dispatcher, defaults to #{options[:batch_size]}") do |n|
+    options[:batch_size] = n
+  end
+
+  opts.on('-p', '--projects PROJECTS', Array, "Only run specs for these comma delimited project names, i.e. workbeast,taigan") do |project_names|
+    options[:registered_projects] = project_names
+  end
+
+  opts.on('--do-work OPTIONS', Array, 'INTERNAL USE ONLY') do |args|
+    options[:worker_args] = args[0], args[1], args[2]
+  end
+
+  opts.on('--log', TrueClass, 'print debug messages to stdout') do |val|
+    Specjour.new_logger Logger::DEBUG
+  end
+
+  opts.on_tail('-v', '--version', 'Show the version of specjour') do
+    abort Specjour::VERSION
+  end
+
+  opts.on_tail("-h", "--help", "Show this message") do
+    summary = opts.to_a
+    summary.first << "\n"
+    abort summary.reject {|s| s =~ /INTERNAL/}.join
+  end
+end
+
+optparse.parse!
+
+abort(%(ERROR: I don't understand the following flags: "#{ARGV.join(', ')}")) if ARGV.any?
+
+if options[:worker_args]
+  options[:worker_args] << options[:batch_size]
+  Specjour::Worker.new(*options[:worker_args]).run
+else
+  options[:worker_size] ||= Specjour::CPU.cores
+  Specjour::Manager.new(options).start
+end

data/lib/specjour.rb

@@ -0,0 +1,43 @@
+require 'drb'
+
+autoload :URI, 'uri'
+autoload :Forwardable, 'forwardable'
+autoload :GServer, 'gserver'
+autoload :Timeout, 'timeout'
+autoload :Benchmark, 'benchmark'
+autoload :Logger, 'logger'
+autoload :Socket, 'socket'
+
+module Specjour
+  autoload :CPU, 'specjour/cpu'
+  autoload :Connection, 'specjour/connection'
+  autoload :Dispatcher, 'specjour/dispatcher'
+  autoload :Manager, 'specjour/manager'
+  autoload :OpenStruct, 'ostruct'
+  autoload :Printer, 'specjour/printer'
+  autoload :Protocol, 'specjour/protocol'
+  autoload :RsyncDaemon, 'specjour/rsync_daemon'
+  autoload :SocketHelpers, 'specjour/socket_helpers'
+  autoload :Worker, 'specjour/worker'
+
+  autoload :Cucumber, 'specjour/cucumber'
+  autoload :Rspec, 'specjour/rspec'
+
+  VERSION = "0.2.5".freeze
+
+  class Error < StandardError; end
+
+  def self.logger
+    @logger ||= new_logger
+  end
+
+  def self.new_logger(level = Logger::UNKNOWN)
+    @logger = Logger.new $stdout
+    @logger.level = level
+    @logger
+  end
+
+  def self.log?
+    logger.level != Logger::UNKNOWN
+  end
+end

data/lib/specjour/connection.rb

@@ -0,0 +1,85 @@
+module Specjour
+  class Connection
+    include Protocol
+    extend Forwardable
+
+    attr_reader :uri
+    attr_writer :socket
+
+    def_delegators :socket, :flush, :closed?, :gets, :each
+
+    def self.wrap(established_connection)
+      host, port = established_connection.peeraddr.values_at(3,1)
+      connection = new URI::Generic.build(:host => host, :port => port)
+      connection.socket = established_connection
+      connection
+    end
+
+    def initialize(uri)
+      @uri = uri
+    end
+
+    alias to_str to_s
+
+    def connect
+      timeout { connect_socket }
+    end
+
+    def disconnect
+      socket.close
+    end
+
+    def socket
+      @socket ||= connect
+    end
+
+    def timeout(&block)
+      Timeout.timeout(2, &block)
+    rescue Timeout::Error
+      raise Error, "Connection to dispatcher timed out"
+    end
+
+    def next_test
+      will_reconnect do
+        send_message(:ready)
+        load_object socket.gets(TERMINATOR)
+      end
+    end
+
+    def print(arg)
+      will_reconnect do
+        socket.print dump_object(arg)
+      end
+    end
+
+    def puts(arg)
+      print(arg << "\n")
+    end
+
+    def send_message(method_name, *args)
+      print([method_name, *args])
+      flush
+    end
+
+    protected
+
+    def connect_socket
+      @socket = TCPSocket.open(uri.host, uri.port)
+    rescue Errno::ECONNREFUSED => error
+      Specjour.logger.debug "Could not connect to #{uri.to_s}\n#{error.inspect}"
+      retry
+    end
+
+    def reconnect
+      socket.close unless socket.closed?
+      connect
+    end
+
+    def will_reconnect(&block)
+      block.call
+    rescue SystemCallError => error
+      reconnect
+      retry
+    end
+  end
+end