gorgon 0.4.1.rc1 → 0.4.1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    gorgon (0.4.1.rc1)
+    gorgon (0.4.1)
       amqp (~> 0.9.7)
       awesome_print
       bunny (~> 0.8.0)

data/README.md

@@ -6,12 +6,52 @@ About
 
 Gorgon provides a method for distributing the workload of running ruby test suites. It relies on amqp for message passing, and rsync for the synchronization of source code.
 
+Installing Gorgon
+-----------------
+1. `sudo apt-get install rabbitmq-server`
+1. When you run gorgon, every listener will use rsync to pull the directory tree from origin; therefore, you need passwordless ssh login from every listener to origin (even if origin and listener are on the same host). Follow [these steps](http://linuxconfig.org/Passwordless_ssh).
+1. cd to your project
+1. `gem install gorgon`
+1. if using rails, `gorgon init rails` will create initial files for a typical rails project. Otherwise, you can use `gorgon init`
+1. check gorgon.json to see and modify any necessary setting
+1. add the following lines to your _database.yml_ file
+
+```yaml
+remote_test: &remote_test
+  <<: *defaults
+  database: <my-app>_remote_test_<%=ENV['TEST_ENV_NUMBER']%>
+  min_messages: warning
+```
+
+Where `<<: *defaults` are the default values used in _database.yml_, like for example, adapter, username, password, and host. Replace <my-app> with a name to identify this application's dbs
+
+Installing listener as a Daemon process (Ubuntu 9.10 or later)
+----------------------------------------------------------------
+1. run `gorgon install_listener` from the directory where gorgon.json is
+1. run `gorgon ping` to check if the listener is running
+
+Try it out!
+-----------
+1. run `gorgon` to run all the tests.
+
+**NOTE:** if you get `cannot load such file -- qrack/qrack (LoadError)`, just add `gem 'gorgon', '~> 0.4.1' , :group => :remote_test` to your Gemfile, and run tests using `bundle exec gorgon`
+
+Also note that these steps are **not** meant to work on every project, they will only give you initial settings. You will probably have to modify the following files:
+* gorgon.json
+* test/gorgon_callbacks/after\_sync.rb
+* test/gorgon_callbacks/before\_creating\_workers.rb
+* test/gorgon_callbacks/before\_start.rb
+* test/gorgon_callbacks/after\_complete.rb
+* ~/.gorgon/gorgon_listener.json
+
+If you modify ~/.gorgon/gorgon_listener.json, make sure you restart the listener by running `sudo restart gorgon`
+
 Usage
 ---------------------
 
 To queue the current test suite, run `gorgon start`, or `gorgon`. _gorgon_ will read the application configuration out of _gorgon.json_, connect to the AMQP server, and publish the job.
 
-In order for the job to run, _gorgon job listeners_ must be started that can process the job. To start a gorgon listener, run `gorgon listen`. This command will read the listener configuration out of _gorgon\_listener.json_, then start the listener process in the background.
+If you want to run the listener manually (didn't install Daemon process), you must run _gorgon job listeners_. To start a gorgon listener, run `gorgon listen`. This command will read the listener configuration out of _gorgon\_listener.json_, then start the listener process in the background.
 
 Configuration
 ---------------------
@@ -37,8 +77,8 @@ This file contains the listener-specific settings, such as:
 
 See [gorgon_listener.json example](/Fitzsimmons/Gorgon/blob/master/gorgon_listener.json.sample) for more details.
 
-### Setting up gorgon listener as a daemon process using Upstart
-For an example on how to run listener as a daemon process, follow [these steps](/Fitzsimmons/Gorgon/blob/master/daemon_with_upstart_and_rvm.md)
+### Manually setting up gorgon listener as a daemon process (Ubuntu 9.10 or later)
+If `gorgon install_listener` didn't work for you, you can try [these steps](/Fitzsimmons/Gorgon/blob/master/daemon_with_upstart_and_rvm.md)
 
 Contributing
 ---------------------

data/bin/gorgon

@@ -51,6 +51,7 @@ def usage
   puts "\tstart - remotely runs all tests specified in gorgon.json"
   puts "\tlisten - starts a listener process using the settings in gorgon_listener.json"
   puts "\tping - pings listeners and shows hosts and gorgon's version they are running"
+  puts "\tinit [rails] - create initial files for current project
   puts "\tinstall_listener - runs gorgon listener as a daemon process"
   puts "\tgem command [options...] - execute the gem command on every listener and shutdown listener. e.g. 'gorgon gem install --version 1.0.0'"
 end

data/lib/gorgon/version.rb

@@ -1,3 +1,3 @@
 module Gorgon
-  VERSION = "0.4.1.rc1"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: gorgon
 version: !ruby/object:Gem::Version
-  version: 0.4.1.rc1
-  prerelease: 6
+  version: 0.4.1
+  prerelease: 
 platform: ruby
 authors:
 - Justin Fitzsimmons
@@ -13,7 +13,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-18 00:00:00.000000000 Z
+date: 2012-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -284,9 +284,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: gorgon
 rubygems_version: 1.8.24