geminstaller 0.5.4 → 0.5.5

data/History.txt

@@ -1,3 +1,6 @@
+== 0.5.5 / 2010-03-25
+* Add source to --bundler-export option.  Handle Rubygems errors when parsing gem prerelease versions in older Rubygems versions.
+
 == 0.5.4 / 2009-11-15
 * Add -b / --bundler-export option to create bundler Gemfile - but make sure you only include direct dependencies, and let bundler handle the rest!
 

data/README.txt

@@ -5,6 +5,15 @@
 * mailto:"GemInstaller Development" <geminstaller-development@rubyforge.org>
 * mailto:"Chad Woolley" <thewoolleyman@gmail.com>
 
+
+== UPDATE - READ THIS
+
+* GemInstaller is being deprecated in favor of Bundler: http://github.com/carlhuda/bundler
+* There is a --bundler-export option on geminstaller to help GemInstaller users migrate to Bundler.
+* This site is outdated, and will remain that way.  I'll try to keep GemInstaller working with new RubyGems releases for as long as I can, but I won't do much else.  I've also given up on testing older Rubygems versions and Windows (although they should still work, feel free to open a bug if they don't).
+* Why Bundler instead of (some other tool)?  Dependency Management is a hard problem to solve properly.  Bundler does the right things.
+* If you think Bundler is too complex, then you probably don't understand the problem, or have never dealt (properly) with long-term or complex dependency management issues in the real world, or just like to be contrary.  Bundler resolves your entire Gem dependency graph and freezes it in your app.  If your tool of choice doesn't do this, it is inferior.  Perhaps very usable (like GemInstaller), but still inferior.  If you have problems with Bundler, I'd recommend opening an issue: http://github.com/carlhuda/bundler/issues
+
 == DESCRIPTION:
 
 Automated Gem installation, activation, and much more!

data/Rakefile

@@ -77,6 +77,9 @@ task :diff_manifest => :clean do
     next if path =~ /\.\/pkg/
     next if path =~ /\.\/out/
     next if path =~ /\.\/website\/out/
+    next if path =~ /\.DS_Store/
+    next if path =~ /\.rvmrc/
+    next if path =~ /Gemfile/
     files << path[2..-1]
   end
   files = files.sort.join "\n"

data/TODO.txt

@@ -1,81 +1,35 @@
 =============== Unfiled =============
-* Tagline: "It's not just for installing gems!" - "removes the drudgery of installing, activating, and requiring gems"
-* move to Github
-  * autoupdate of rails trunk
-  * redirection of links to old svn
-* Rename autogem to activate
-* add GemInstaller.require
-* Replace Tagline / Summary / Readme with "Install, Activate, and Require"
-* Big Quick Start Link on homepage
-* Update config.gems faq item with link to rails tutorial
+* Pointers to Bundler in Readme, homepage, etc
+* Update config.gems faq item with link to bundler info
 * rename sample app to rails_fixture_app, update important files with comments pointing to fixture app
 * examples dir
-  * geminstaller_merb_example_app
   * geminstaller_rails_example_app
 * Update Rails tutorial link with link to example app
-================ 0.6.0 release ===================
+* docs - add example of using environment variable to control gem version without changing code (Rails)
+================ 0.x.0 release ===================
+* cryptic message if "name:" is left off in yaml
 * fix smoke tests on CI
-* Investigate error when installing and loading gem in same session (like rails preinitializer) - Not reproducible - fixed in >1.1.0???
-================ 0.7.0 release ===================
-* If permission error, auto-install under writable_gem_home ~/gems/1.8 (configurable), Gem.clear_paths, set ENV['GEM_HOME'] and ENV['GEM_PATH'] to ENV['HOME']pathsepGem::ConfigMap[:ruby_version], and issue warning (saying in order to prevent warning, a) set gem_home and gem_path: in ~/.gemrc, b) invoke via sudo (only if command line), c) make (and keep) current Gem.dir writeable, or d) add geminstaller (and ruby?) to sudoers file (security hole).  Properties: "[no_]use_writable_gem_home" and "writable_gem_home".
-* For RubyGems >=1.0.1, look at using Gem::SourceInfoCache instead of SourceIndex or --list command
-* Move classes which are unused against current RubyGems into Legacy module.
-* Speed! What can be done to speed things up?
-* performance improvement: first try cache hit without all option, then with if not found.
-* add command line tool to automatically generate files - default file, rake task (geminstaller:run, geminstaller:install, geminstaller:autogem), and preinit hook.  Auto-detect rails vs. non-rails project and generate stuff accordingly.  --setup, --setup-rails.  Check for new-style boot.rb, fail if missing, check for RAILS_GEM_VERSION in environment.rb, warn if present.
-* Merb support.  init.rb.  See lightning talk.
-* Change 'run' to automatically automatically calls both 'install' and 'autogem', add 'no-install' and 'no-autogem' option (only applicable when invoked programatically) to suppress if desired
-* auto-install on app startup should not be the default unless use_writable_gem_home is implemented, because of sudo/rake doublerun/speed issues.  Update autogem missing gem error message accordingly.
 * also look for config file under RAILS_ROOT/config, if RAILS_ROOT is defined (somehow fails under textmate, if working dir is wrong)
-================ 0.x.0 release ===================
 * Change option handling to accept hashes in addition to strings when invoked programatically
 * rails_smoketest.rb is not working, always reinstalls existing gems
-* add option to use frozen edge rails before rails gem, understand the implications
-* add auto-install option if gem version error is detected, update error message saying to set option
-* cryptic message if "name:" is left off in yaml
-* Add option to auto-update rubygems to specified version.  See rubygems mailing list thread for details
-* set up sample rails project with geminstaller hook and sample test under CI.  Have cruise_config uninstall a dummy gem before rails tests, then have rails test ensure it was installed and loaded. (done but not running under CI yet)
-================ 0.x.x release ===================
-* turn smoketest into rake task, with correct return code handling, and hook up to cruise
-* look into and explain mongrel/webrick installation errors
-* add top-level method for uninstall of gems, and document (requested by Alex Chaffee and others)
-* docs - add example of using environment variable to control gem version without changing code (Rails)
 * docs - document and add sample file for preinitializer boot hook.  Explain why it can't be in environment.rb vs boot.rb or prinitializer (bottom line: env is not processed before Initializer, so can't be used to load rails gems)
-* tutorial: using common or shared config files, with different configs for different environments - test (rspec) vs. dev (capistrano) vs. demo/staging/prod, mention include_config option and pros/cons of different approaches
 * docs - rename "Documentation" page to "Manual"
-* rogue gems config generation - add warning and instructions for cleaning up auto-generated file.  For example, deleting rails dependencies
 * faq - mention 'cannot load error' from load, and why it happens (rubygems can only load one version)
 * faq - mention tradeoffs of optimistic version requirement (>=) vs pessimistic (=), specifically how mongrel specifies its dependencies
 * put mongrel/rails startup bug in tracker, add link in "known bugs" section on home page.
-* tutorial: running via capistrano
 * crossreference front page, tutorials, and docs
-================ 0.x.x release ===================
 * Namespace remaining un-namespaced constants
-* Allow array or eval'able string of gems to be passed as --gems arg or instead of args
-* Add @options[:gems], should be parsed from command line* root-owned gems: add -S | --sudo-only-if-allowed option, will only invoke sudo if GEMINSTALLER_ALLOW(S)_SUDO env var is set
-* root-owned gems: add automatic re-invoke with sudo option (with warning message) if permission error is caught
-* root-owned gems: Dynamically detect posix platform and check if gem repo is completely writeable.  Ignorable prompt?
 * docs - clean up sudo section.  Should be clearer about sudoers entry, and make sure that NOPASSWD is the last entry.  Rename from #dealing_with_sudo to #dealing_with_root_owned_gems, rewrite to reflect new best practices (different GEM_PATH or auto-sudo via capistrano)
 * tutorial: update running via capistrano to reference new sudo docs
-================ 0.x.x release ===================
 * handle installation of gem from file (requested by Alex Chaffee)
-* Investigate gem_plugin.  Plugin for mongrel???
-* Investigate making a Rails plugin
-================ 0.x.x release ===================
 * Why does RubyGems reinstall BlueCloth even though it is already installed?!?!? (remove from FAQ after solved)
 * Figure out how to suppress webrick messages from embedded gem server
 * add option to warn if any rogue gems are found
-================ 0.x.x release =====================
-================ 0.x.x finishing website ===================
 * autogem and run args can be passed as string or array
-* better test coverage for --sudo and --exception options
 * use rspec context_setup
 * split out geminstaller_spec into application_spec and geminstaller_spec.  Fix reference in docs / design
 * newlines printed between dots when "updating" message is included in error message
-* Error on activerecord for brand-new rubygems installation - couldn't find gem.  Did a gem list --remote activerecord, then it went away (got sudo error), then happened again, then worked when I passed -gall -rall options.
-* Fastthread = only shows version 0.6.2 on windows, rubygems 0.9 ???
 * geminstaller_spec autogem spec must have the GemRunner "initialized" or else the stub gem in test_gem_home won't be found by autogem.
-* fix_dependencies=true takes FOREVER on windows
 * echo stdin, lists presented for debug output levels
 * Just ignore sudo option on windows, rather than throwing an error
 * why does windows try to reinstall fxruby 1.6.6 when it is already installed???
@@ -87,7 +41,6 @@
 * Can GemInstaller handle multiple gem server sources via multiple config files?
 * Handle default gems that come with ruby/rubygems windows distro. 
 * refactor enhanced_stream_ui.ask_yes_no - does it need to catch the exception?  Also review context name (no OutputProxy) and use of StringIO, and exception tests.
-* rename enhanced_stream_ui to noninteractive_stream_ug
 * add multilevel dependency smoketests for autogem (old rails version)
 * refactor duplication in autogem/rogue_gem_finder using blocks
 * rubygems stdout - don't print prefix for single dot
@@ -96,19 +49,14 @@
 * Rails integration doesn't work under mongrel when invoked via executable (e.g, actionmailer gem not recognized after install, only after mongrel restart).  Does't occur under webrick, or if geminstaller is invoked programatically via class.
 * rails example doesn't print any warning if geminstaller is not installed
 * "Installing gem" messages are duplicated if info message is specified, one from rubygems, one from geminstaller.  See todo in install_processor.rb
-* boot.rb parsed twice under webrick?
 * commandecho doesn't print regexps correctly
 * code coverage for logic paths supporting old rubygems versions
 * spec_utils - use extend+include ClassAndInstanceMethods approach
 * clean up registry - third-party first, no dependency next, alphabetized
 * review/clean up ri/rdoc
 * Better errors for invalid yaml (unsupported keys)
-========= 0.x.0 release ==============
-* patch hoe to install_gem without sudo on windows
 * understand why '> 1' must be quoted to be a valid yaml value - see yaml_loader_spec.rb
-* tests failed when "partially" connected to network? (wireless at office)
 * tests fail with timeouts intermittently on windows
-* add more tests for dependencies to geminstaller_spec
 * reconcile methods for testing error messages - manually vs proc_should_raise_with_message.  Probably should patch rspec.
 * remove test_gem_home.reset from geminstaller_spec.rb WITHOUT breaking the test suite.
 * tests fail on windows - seems to be related to test_gem_home running twice.  smoketest still passes.
@@ -116,7 +64,6 @@
 * running binary via ruby out of bin dir will pick up gem first on load path if it is installed
 * verify that >= version spec works with a specific platform, if that platform is not available for the highest version
 * Check for write access, and exit with warning to use sudo if there is no write access.
-* store rubygems dist as a tar, and untar it on demand
 * Add spec file name to all contexts (or see if rspec can do it automatically)
 * Embedded gem_server process doesn't get killed on windows during tests - need to use ruby services, see comment in embedded_gem_server.rb
 * Embedded gem_server ports aren't handled correctly on linux during tests - port conflict on startup, open ports die off slowly after tests finish
@@ -135,4 +82,3 @@
 * make verbose option specify --backtrace on all gem commands
 * Add support, syntax, and options for uninstalling gems - completely, or down to highest specified version.
 * add feature to automatically warn if there is a more recent version of the gem available and check_for_upgrade == false.  Use "gem outdated" command 
-================ 0.later.1 Unprioritized ===================

data/bin/geminstaller

@@ -3,7 +3,7 @@
 dir = File.dirname(__FILE__)
 
 begin
-  require ' geminstaller'
+  require 'geminstaller'
 rescue LoadError
   require 'rubygems'
   begin

data/geminstaller.yml

@@ -31,6 +31,8 @@ gems:
   version: '>= 0.9.3'
 - name: webgen
   version: '= 0.5.5'
+- name: minitest
+  version: '1.5.0'
 # - name: gettalong-webgen
 #   version: '>= 0.5.5.20081001'
 <% if RUBY_PLATFORM =~ /mswin/ %>

data/lib/geminstaller.rb

@@ -34,7 +34,7 @@ module GemInstaller
   end
 
   def self.version
-    "0.5.4"
+    "0.5.5"
   end
 
   def self.create_application(args = [], registry = nil)

data/lib/geminstaller/bundler_exporter.rb

@@ -9,7 +9,7 @@ module GemInstaller
     end
 
     def convert(config)
-      manifest = ""
+      manifest = "source :gemcutter\n"
       config.gems.each do |gem|
         manifest += %Q{gem "#{gem.name}", "#{gem.version}"\n}
       end

data/lib/geminstaller/gem_list_checker.rb

@@ -23,7 +23,7 @@ module GemInstaller
       end
 
       if matched_lines.size == 0
-        error_message = "Error: Could not find remote gem to install.  Gem name = '#{gem.name}', Gem version = '#{gem.version}', install options = '#{gem.install_options.join(' ')}'.  Your remote gem server may be having problems.  You should try to list the remote gem yourself:  'gem list -r -v '#{gem.version}' #{common_args.join(' ')} #{gem.name}'.  If it exists on the server, try running geminstaller again and report your experience here: http://thewoolleyweb.lighthouseapp.com/projects/11580-geminstaller/tickets/5-sometimes-installing-fails.  Output of remote gem list command: \n#{remote_list}"
+        error_message = "Error: Could not find remote gem to install.  Gem name = '#{gem.name}', Gem version = '#{gem.version}', install options = '#{gem.install_options.join(' ')}'.  Your remote gem server may be having problems.  You should try to list the remote gem yourself:  'gem list -r -v '#{gem.version}' #{common_args.join(' ')} #{gem.name}'.  If it exists on the server, try running geminstaller again and open a ticket here: http://thewoolleyweb.lighthouseapp.com/projects/11580-geminstaller.  Output of remote gem list command: \n#{remote_list}"
         raise GemInstaller::GemInstallerError.new(error_message)
       end
 

data/lib/geminstaller/source_index_search_adapter.rb

@@ -27,7 +27,15 @@ module GemInstaller
     end
     
     def search_greater_than_0_9_4(gem, version_requirement, platform_only = false)
-      dependency = Gem::Dependency.new(gem.name, version_requirement)
+      dependency = nil
+      begin
+        dependency = Gem::Dependency.new(gem.name, version_requirement)
+      rescue => e
+        msg = "Rubygems failed to parse gem: name='#{gem.name}', version='#{version_requirement}'.  Original Error:\n" +
+              "  #{e.inspect}\n" +
+              "If you are having problems with prerelease gems or non-numeric versions, please upgrade to the latest Rubygems."
+        raise GemInstaller::GemInstallerError.new(msg)
+      end
       @gem_source_index_proxy.refresh!
       @gem_source_index_proxy.search(dependency, platform_only)
     end

data/website/src/documentation/documentation.page

@@ -12,6 +12,7 @@ h2. Table of Contents
 ** "<code>--redirect-stderr-to-stdout</code> option":#redirect_stderr_to_stdout_option
 ** "<code>--geminstaller-output</code> option":#geminstaller_output_option
 ** "<code>--rubygems-output</code> option":#rubygems_output_option
+** "<code>--bundler-export</code> option":#bundler_export_option
 ** "<code>--print-rogue-gems</code> option":#print_rogue_gems_option
 ** "<code>--sudo</code> option":#sudo_option
 ** "<code>--silent</code> option":#silent_option
@@ -143,6 +144,10 @@ GemInstaller works by automatically invoking RubyGems commands.  The <code>--rub
 * stderr: Prints standard error stream from RubyGems.
 * all: Prints all messages.  This is the same as specifying all of the other types (except 'none')
 
+h3(#bundler_export_option). <code>--bundler-export</code> option
+
+The <code>--bundler-export</code> writes a "Bundler":http://github.com/wycats/bundler ("http://github.com/carlhuda/bundler":http://github.com/carlhuda/bundler) Gemfile based on your Geminstaller config(s).  However, be aware that you may have unnecessary entries in your config, because Bundler resolves the entire dependency tree for you.  So, make sure you ONLY specify your application's DIRECT dependencies in your Bundler Gemfile.
+
 h3(#print_rogue_gems_option). <code>--print-rogue-gems</code> option
 
 The <code>--print-rogue-gems</code> option prints a report of all locally installed gems which are not specified in the active loaded GemInstaller config file(s).  GemInstaller, being "Narcissistic Software" (tm), considers these "rogue gems".  The output format is in YAML, so it can be cut and pasted or piped directly into a new or existing config file.  This allows you to bootstrap a new system, by creating an empty config file with no gems specified, and running geminstaller with the <code>--print-rogue-gems</code> option to identify all gems which are currently installed on the system.  It can also be used to identify gems which were manually installed without being entered into a GemInstaller config.

data/website/src/index.page

@@ -1,6 +1,14 @@
 ---
 title: Overview
 ---
+h1. UPDATE - READ THIS
+
+* GemInstaller is being deprecated in favor of "Bundler":http://github.com/carlhuda/bundler
+* There is a "--bundler-export option":documentation/documentation.html#bundler_export_option on geminstaller to help GemInstaller users migrate to Bundler.
+* This site is outdated, and will remain that way.  I'll try to keep GemInstaller working with new RubyGems releases for as long as I can, but I won't do much else.  I've also given up on testing older Rubygems versions and Windows (although they should still work, feel free to open a bug if they don't).
+* Why Bundler instead of (some other tool)?  Dependency Management is a hard problem to solve properly.  Bundler does the right things.
+* If you think Bundler is too complex, then you probably don't understand the problem, or have never dealt (properly) with long-term or complex dependency management issues in the real world, or just like to be contrary.  Bundler resolves your entire Gem dependency graph and freezes it in your app.  If your tool of choice doesn't do this, it is inferior.  Perhaps very usable (like GemInstaller), but still inferior.  If you have problems with Bundler, I'd recommend "opening an issue":http://github.com/carlhuda/bundler/issues
+
 h1. Overview
 
 h2. What is GemInstaller?
@@ -16,7 +24,6 @@ GemInstaller provides automated installation, loading and activation of RubyGems
 * Allow for common configs to be reused across projects or environments by supporting multiple config files, including common config file snippets, and defaults with overrides.
 * Allow for dynamic selection of gems, versions, and platforms to be used based on environment vars or any other logic.
 * Avoid the "works on demo, breaks on production" syndrome.
-* Find lost socks.
 
 GemInstaller can be used from the command line, or embedded to run automatically on startup for a Rails app or any other Ruby program.
 
@@ -34,10 +41,6 @@ h2. Who is responsible for GemInstaller?
 
 GemInstaller was created by "Chad Woolley":http://www.thewoolleyweb.com.
 
-h2. Why not just use Rails' config.gems?
-
-GemInstaller "has advantages":faq.html#rails_config_gems over Rails' config.gems.
-
 h2(#known_issues). Known Issues
 
 I have a "list of high priority bugs and features":http://thewoolleyweb.lighthouseapp.com/projects/11580-geminstaller/tickets?q=tagged%3Ahigh_priority that need to be addressed before a 1.0 release.
@@ -46,8 +49,10 @@ Please "report any others that you find":http://thewoolleyweb.lighthouseapp.com/
 
 h2(#history). History
 
+* 0.5.5
+** Add source to --bundler-export option.  Handle Rubygems errors when parsing gem prerelease versions in older Rubygems versions.
 * 0.5.4
-** Add -b / --bundler-export option to create bundler Gemfile - but make sure you only include direct dependencies, and let bundler handle the rest!
+** Add -b / "--bundler-export option":documentation/documentation.html#bundler_export_option to create bundler Gemfile - but make sure you only include direct dependencies, and let bundler handle the rest!
 * 0.5.3
 ** Many long overdue bugfixes and patches, see http://tinyurl.com/geminstaller-0-5-3-release for details.
 ** Thanks to Greg Fitzgerald, Britt Crawford, John Trupiano, Gabriel Gironda, and Eric Hodel for patches and assistance.

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 5
-  - 4
-  version: 0.5.4
+  - 5
+  version: 0.5.5
 platform: ruby
 authors: 
 - Chad Woolley
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-15 00:00:00 -07:00
+date: 2010-03-25 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -135,7 +135,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: geminstaller
-rubygems_version: 1.3.5.1
+rubygems_version: 1.3.6.1
 signing_key: 
 specification_version: 3
 summary: See http://geminstaller.rubyforge.org