gemsonrails 0.5.0 → 0.6.0

data/History.txt

@@ -1,3 +1,11 @@
++++ 0.6.0 2007-05-11
+
++ 1 major enhancement:
+  + Linked/frozen gems can be loaded only for certain RAILS_ENVs using ONLY env variable, e.g.
+    rake gems:freeze GEM=helper ONLY=development,test
++ 1 minor enhancement:
+  + Reinstalling gemsonrails does not delete the original (and its svn meta-data), just overwrites the files
+
 +++ 0.5.0 2007-05-06
 
 + 1 major enhancement:

data/README.txt

@@ -8,3 +8,8 @@ Then run either:
 'rake gems:freeze GEM=<gemname> [VERSION=<versionnum>]' to freeze a gem, or 
 'rake gems:link GEM=<gemname>' to link to whatever latest gem release is available at runtime.
 
+You can restrict which RAILS_ENVs the gem will be loaded for, using ONLY; e.g.
+
+'rake gems:freeze GEM=<gemname> ONLY=development' only in 'development' mode will the gem be loaded, or
+'rake gems:link GEM=<gemname> ONLY=production,staging' only in 'production' or 'staging' mode will the gem be loaded from the deployment gem server
+	

data/Rakefile

@@ -77,6 +77,8 @@ task :website => [:website_generate, :website_upload]
 desc 'Release the website and new gem version'
 task :deploy => [:check_version, :website, :release]
 
+task :local_deploy => [:website_generate, :install_gem]
+
 task :check_version do
   unless ENV['VERSION']
     puts 'Must pass a VERSION=x.y.z release version'

data/bin/gemsonrails

@@ -32,20 +32,19 @@ gems_path  = File.join(plugins, 'gemsonrails')
 tasks_path = File.join(gems_path, 'tasks')
 task_templates = Dir[File.join(templates, '*.rake')]
 
-FileUtils.rm_rf gems_path
+FileUtils.mkdir_p gems_path
 
-Dir.mkdir gems_path
 Dir.chdir gems_path do
   template = File.open(templates + 'init.rb','r') {|f| f.readlines.join}
   File.open('init.rb', 'w') {|file| file << template }
 end
 
-Dir.mkdir tasks_path
+FileUtils.mkdir_p tasks_path
 Dir.chdir tasks_path do
   task_templates.each do |template_name|
     task_name = File.basename(template_name).sub(/\Atasks_/,'')
     template = File.open(template_name,'r') {|f| f.readlines.join}
-    File.open(task_name, 'w') {|file| file << template }
+    File.open(task_name, 'w') { |file| file << template }
   end
 end
 

data/lib/gemsonrails/version.rb

@@ -1,7 +1,7 @@
 module GemsOnRails #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 5
+    MINOR = 6
     TINY  = 0
     
     STRING = [MAJOR, MINOR, TINY].join('.')

data/templates/init.rb

@@ -1,4 +1,4 @@
-gems          = Dir[File.join(RAILS_ROOT, "vendor/gems/*")]
+gems = Dir[File.join(RAILS_ROOT, "vendor/gems/*")]
 if gems.any?
   gems.each do |dir|
     lib = File.join(dir, 'lib')

data/templates/tasks_gems_freeze.rake

@@ -6,11 +6,17 @@ namespace :gems do
 Parameters:
   GEM      Name of gem (required)
   VERSION  Version of gem to freeze (optional)
+  ONLY     RAILS_ENVs for which the GEM will be active (optional)
   
 eos
       break
     end
     
+    # ONLY=development[,test] etc
+    only_list = (ENV['ONLY'] || "").split(',')
+    only_if_begin = only_list.size == 0 ? "" : "if %w[#{only_list.join(' ')}].include?(ENV['RAILS_ENV'])"
+    only_if_end   = only_list.size == 0 ? "" : "end"
+
     require 'rubygems'
     Gem.manage_gems
     
@@ -39,8 +45,9 @@ eos
         if !File.exists?('init.rb')
           File.open('init.rb', 'w') do |file|
             file << <<-eos
-#require something
-require File.join(File.dirname(__FILE__), 'lib', '#{gem_name}')
+#{only_if_begin}
+  require File.join(File.dirname(__FILE__), 'lib', '#{gem_name}')
+#{only_if_end}
 eos
           end
         end

data/templates/tasks_gems_link.rake

@@ -5,12 +5,17 @@ namespace :gems do
 		  puts <<-eos
 Parameters:
   GEM      Name of gem (required)
-
+  ONLY     RAILS_ENVs for which the GEM will be active (optional)
   
 eos
       break
 		end
 
+    # ONLY=development[,test] etc
+    only_list = (ENV['ONLY'] || "").split(',')
+    only_if_begin = only_list.size == 0 ? "" : "if %w[#{only_list.join(' ')}].include?(ENV['RAILS_ENV'])"
+    only_if_end   = only_list.size == 0 ? "" : "end"
+
     require 'rubygems'
     Gem.manage_gems
     
@@ -32,26 +37,30 @@ eos
       chdir target_dir, :verbose => false do
         File.open('init.rb', 'w') do |file|
           file << <<-eos
-require 'rubygems'
-Gem.manage_gems
-gem = Gem.cache.search('#{gem.name}').sort_by { |g| g.version }.last
-if gem.autorequire
-  require gem.autorequire
-else
-  require '#{gem.name}'
-end
+#{only_if_begin}
+  require 'rubygems'
+  Gem.manage_gems
+  gem = Gem.cache.search('#{gem.name}').sort_by { |g| g.version }.last
+  if gem.autorequire
+    require gem.autorequire
+  else
+    require '#{gem.name}'
+  end
+#{only_if_end}
 eos
         end
         File.open(File.join('tasks', 'load_tasks.rake'), 'w') do |file|
           file << <<-eos
 # This file does not include any Rake files, but loads up the 
 # tasks in the /vendor/gems/ folders
-require 'rubygems'
-Gem.manage_gems
-gem = Gem.cache.search('#{gem.name}').sort_by { |g| g.version }.last
-raise \"Gem '#{gem.name}' is not installed\" if gem.nil?
-path = gem.full_gem_path
-Dir[File.join(path, "/**/tasks/**/*.rake")].sort.each { |ext| load ext }
+#{only_if_begin}
+  require 'rubygems'
+  Gem.manage_gems
+  gem = Gem.cache.search('#{gem.name}').sort_by { |g| g.version }.last
+  raise \"Gem '#{gem.name}' is not installed\" if gem.nil?
+  path = gem.full_gem_path
+  Dir[File.join(path, "/**/tasks/**/*.rake")].sort.each { |ext| load ext }
+#{only_if_end}
 eos
         end
         puts "Linked #{gem_name} (currently #{version}) via 'vendor/gems/#{target_dir}'"

data/website/index.html

@@ -64,7 +64,7 @@ $ gemsonrails</pre>
 	<p>This installs some rake tasks into your app to help you freeze or link gems:</p>
 
 
-<pre>$ rake -T | grep "gems:" 
+<pre syntax="ruby">$ rake -T | grep "gems:" 
 rake gems:freeze    # Freeze a RubyGem into this Rails application; init.rb will be loaded on startup.
 rake gems:link      # Link a RubyGem into this Rails application; init.rb will be loaded on startup.
 rake gems:unfreeze  # Unfreeze/unlink a RubyGem from this Rails application
@@ -73,7 +73,7 @@ rake gems:unfreeze  # Unfreeze/unlink a RubyGem from this Rails application
 	<p>Finally, for each gem your application uses you can either freeze a version into the app (only for gems that do not require native compilation), or link a gem with your app (useful for gems that require native compilation)</p>
 
 
-<pre>$ rake gems:freeze GEM=map_by_method
+<pre syntax="ruby">$ rake gems:freeze GEM=map_by_method
 Unpacked map_by_method 0.6.0 to 'map_by_method-0.6.0'
 
 $ ls vendor/gems/map_by_method-0.6.0/
@@ -83,6 +83,19 @@ $ cat vendor/gems/map_by_method-0.6.0/init.rb
 require File.join(File.dirname(__FILE__), 'lib', 'map_by_method')
 </pre>
 
+	<h2>Restricting which environments a gem is loaded into</h2>
+
+
+	<p>You can restrict which <span class="caps">RAILS</span>_ENVs the gem will be loaded for, using <span class="caps">ONLY</span>; e.g.</p>
+
+
+<pre syntax="ruby">$ rake gems:freeze GEM=&lt;gemname&gt; ONLY=development
+$ rake gems:link GEM=&lt;gemname&gt; ONLY=production,staging
+</pre>
+
+	<p>In the former, only in <strong>development</strong> mode will the gem be loaded. In the latter, only in <strong>production</strong> or <strong>staging</strong> mode will the gem be loaded from the deployment gem server</p>
+
+
 	<h2>Upgrading from old GemsOnRails versions</h2>
 
 
@@ -106,7 +119,7 @@ require File.join(File.dirname(__FILE__), 'lib', 'map_by_method')
 
 	<p>Comments are welcome. Send an email to <a href="mailto:drnicwilliams@gmail.com">Dr Nic Williams</a>.</p>
     <p class="coda">
-      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 6th May 2007<br>
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 11th May 2007<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -21,7 +21,7 @@ $ gemsonrails</pre>
 
 This installs some rake tasks into your app to help you freeze or link gems:
 
-<pre>$ rake -T | grep "gems:"
+<pre syntax="ruby">$ rake -T | grep "gems:"
 rake gems:freeze    # Freeze a RubyGem into this Rails application; init.rb will be loaded on startup.
 rake gems:link      # Link a RubyGem into this Rails application; init.rb will be loaded on startup.
 rake gems:unfreeze  # Unfreeze/unlink a RubyGem from this Rails application
@@ -29,7 +29,7 @@ rake gems:unfreeze  # Unfreeze/unlink a RubyGem from this Rails application
 
 Finally, for each gem your application uses you can either freeze a version into the app (only for gems that do not require native compilation), or link a gem with your app (useful for gems that require native compilation)
 
-<pre>$ rake gems:freeze GEM=map_by_method
+<pre syntax="ruby">$ rake gems:freeze GEM=map_by_method
 Unpacked map_by_method 0.6.0 to 'map_by_method-0.6.0'
 
 $ ls vendor/gems/map_by_method-0.6.0/
@@ -39,6 +39,16 @@ $ cat vendor/gems/map_by_method-0.6.0/init.rb
 require File.join(File.dirname(__FILE__), 'lib', 'map_by_method')
 </pre>
 
+h2. Restricting which environments a gem is loaded into
+
+You can restrict which RAILS_ENVs the gem will be loaded for, using ONLY; e.g.
+
+<pre syntax="ruby">$ rake gems:freeze GEM=<gemname> ONLY=development
+$ rake gems:link GEM=<gemname> ONLY=production,staging
+</pre>
+
+In the former, only in *development* mode will the gem be loaded. In the latter, only in *production* or *staging* mode will the gem be loaded from the deployment gem server
+
 h2. Upgrading from old GemsOnRails versions
 
 All the freezing and linking functionality is in the plugin installed by the <code>gemsonrails</code> command. To upgrade, simple install the new gem version, and re-run the <code>gemsonrails</code> command. You application will now have the newest rake tasks and functionality.

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: gemsonrails
 version: !ruby/object:Gem::Version 
-  version: 0.5.0
-date: 2007-05-06 00:00:00 +02:00
+  version: 0.6.0
+date: 2007-05-11 00:00:00 +02:00
 summary: Link or freeze RubyGems into your rails apps, instead of plugins
 require_paths: 
 - lib