vlad-rainbows 0.1.3 → 0.1.4

data/README.md

@@ -1,4 +1,10 @@
-# Rainbows for Vlad
+# An opinionated Rainbows for Vlad
+
+This plugin assumes the following:
+
+* You have existing rake tasks to start/stop [Rainbows](http://rainbows.rubyforge.org/).
+* Your target system(s) have a [system wide](http://rvm.beginrescueend.com/deployment/system-wide/) install of [RVM](http://rvm.beginrescueend.com/).
+* Your application is [Rack](http://rack.rubyforge.org/) based, and makes use of the 'RACK_ENV' environment variable.
 
 ## Description
 
@@ -10,7 +16,7 @@ A [Vlad](http://rubyhitsquad.com/Vlad_the_Deployer.html) plugin for controlling
 
 Add the following to your Gemfile.
 
-    gem "vlad-rainbows", "~> 0.1.0"
+    gem "vlad-rainbows", "~> 0.1.4"
 
 ## Usage
 
@@ -28,23 +34,27 @@ This plugin assumes you have rake tasks to handle stopping/starting Rainbows.  B
 * app:start
 * app:stop
 
-The tasks invoked can be overriden by updating deploy.rb with:
+The tasks can be overriden by updating deploy.rb with:
 
     set :app_start_task, "task_name"
     set :app_stop_task, "task_name"
 
-The plugin provides a run_rake method for executing rake tasks remotely.  If you wish to override the methods
-implementation, simply provide a block to the :run_rake_proc variable.
+The plugin provides a run_rake method for executing rake tasks remotely.  If you wish to override the method's
+implementation, provide a block to :run_rake_proc in deploy.rb.
 
-    set :rake_cmd, "bundle exec rake"
     set :run_rake_proc, Proc.new {
       run [
-        "source /usr/local/lib/rvm",
         "cd #{current_path}",
         "#{rake_cmd} RACK_ENV=#{rack_env} #{task}",
       ]
     }
 
+You can also override the following defaults in deploy.rb:
+
+* :rvmrc
+* :rack_env
+* :rake_cmd
+
 ## Credits
 
 John Barnette's [vlad-git](https://github.com/jbarnette/vlad-git), for which this was based on.

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

data/lib/vlad/rainbows.rb

@@ -1,3 +1,6 @@
+##
+# Recipe to start/stop Rainbows.
+
 require "vlad"
 require "vlad/utils"
 

data/lib/vlad/utils.rb

@@ -1,8 +1,15 @@
+##
+# Utility Class which provides basic support to Vlad::Rainbows.
+# If tasks tend to call these methods directly, it should probably
+# spawn into it's own gem.
+
 class Vlad::Utils
+  set :rake_cmd, Rake::RemoteTask.fetch(:rake_cmd, "bundle exec rake")
+  set :rvmrc, Rake::RemoteTask.fetch(:rvmrc, "/usr/local/lib/rvm")
 
   ##
   # Invokes the given rake task remotely; setting up the proper environment.
-  # If a block is provided, it will be excuted instead.
+  # If :run_rake_proc is provided it's proc will be called.
   #
   # +task+ is the fully qualified task name.
   # +rake_cmd+ is the rake command to execute remotely.
@@ -11,10 +18,21 @@ class Vlad::Utils
     if defined? run_rake_proc
       run_rake_proc.call
     else
-      run [
+      rvm_run [
         "cd #{current_path}",
         "#{rake_cmd} RACK_ENV=#{rack_env} #{task}",
-      ].join " && "
+      ]
     end
   end
+
+  ##
+  # A wrapper to rake-remote_task's +run+, making sure to setup
+  # rvm's environment.
+  #
+  # +cmds+ is expected to be an array.
+
+  def self.rvm_run cmds
+    cmds.unshift "source #{rvmrc}"
+    run cmds.join " && "
+  end
 end

data/vlad-rainbows.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{vlad-rainbows}
-  s.version = "0.1.3"
+  s.version = "0.1.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["retr0h"]

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: vlad-rainbows
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 19
   prerelease: false
   segments: 
   - 0
   - 1
-  - 3
-  version: 0.1.3
+  - 4
+  version: 0.1.4
 platform: ruby
 authors: 
 - retr0h