rubygems-update 0.8.3

data/README

@@ -0,0 +1,54 @@
+= RubyGems
+
+(See Releases for release-specific information)
+
+== For user documentation (and installation instructions) see
+
+* {Quick Introduction}[http://rubygems.rubyforge.org/wiki/wiki.pl?Quick_Introduction]
+* {User Guide}[http://rubygems.rubyforge.org/wiki/wiki.pl?UserGuide]
+
+== For developer docs see
+
+* {Create a Gem in Ten Minutes}[http://rubygems.rubyforge.org/wiki/wiki.pl?CreateAGemInTenMinutes]
+* {Developers Guide}[http://rubygems.rubyforge.org/wiki/wiki.pl?DeveloperGuide]
+* {GEM Specification}[http://rubygems.rubyforge.org/wiki/wiki.pl?GemSpecification]
+
+== The home page of the RubyGems wiki
+
+* {RubyGems Home}[http://rubygems.rubyforge.org]
+
+== Additional directories
+
+[./bin/...]       binary commands (gem, gem_server, etc)
+[./lib/...]       the RubyGems library
+[./packages/...]  default RubyGems packages (currently only 'sources')
+[./test/...]      unit and functional tests
+[./examples/...]  example library w/gemspec for generating and installing gems
+[./gemspecs/...]  example gemspecs
+
+== Credits
+
+RubyGems was originally developed at RubyConf 2003 by:
+
+* Rich Kilmer -- rich(at)infoether.com
+* Chad Fowler -- chad(at)chadfowler.com
+* David Black -- dblack(at)wobblini.net
+* Paul Brannan -- paul(at)atdesk.com
+* Jim Weirch -- {jim(at)weirichhouse.org}[mailto:jim@weirichhouse.org]
+
+== Contributors since then
+
+* Gavin Sinclair -- gsinclair(at)soyabean.com.au
+* George Marrows-- george.marrows(at)ntlworld.com
+* Dick Davies -- rasputnik(at)hellooperator.net
+* Mauricio Fernandez -- batsman.geo(at)yahoo.com
+* Simon Strandgaard -- neoneye(at)adslhome.dk
+* Ville Aine -- vaine(at)cs.helsinki.fi
+
+== Feedback
+
+Please provide us feedback at http://rubyforge.org/projects/rubygems
+
+Thanks!
+
+-The RubyGems Team

data/Rakefile

@@ -0,0 +1,293 @@
+# Rakefile for RubyGems      -*- ruby -*-
+
+require 'rubygems'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+
+PKG_NAME = 'rubygems'
+PKG_VERSION = `ruby -Ilib bin/gem environment packageversion`.chomp
+
+CLEAN.include("COMMENTS")
+CLOBBER.include(
+  "test/data/one/one-*0.0.1.gem",
+  "test/temp",
+  'test/data/gemhome',
+  'test/data/*.gem',
+  'scripts/*.wiki',
+  'data__',
+  'html',
+  'pkgs/sources/sources*.gem',
+  '.config',
+  '**/debug.log'
+  )
+
+task :default => [:test]
+
+desc "Run unit tests"
+task :test do
+  test_name = ENV['TEST'] || 'test/test*.rb'
+  ruby %{-Ilib -rscripts/runtest -e 'run_tests("#{test_name}", true)'}
+end
+
+desc "Run Functional Tests"
+task :functional do
+  test_name = ENV['TEST'] || 'test/functional.rb'
+  ruby %{-Ilib -rscripts/runtest -e 'run_tests("#{test_name}", true)'}
+end
+
+desc "Run All Tests"
+task :alltests do
+  test_name = ENV['TEST'] || 'test/{test,functional}*.rb'
+  ruby %{-Ilib -rscripts/runtest -e 'run_tests("#{test_name}", true)'}
+end
+
+desc "Run the tests for a build"
+task :build_tests do
+  html_dir = ENV['TESTRESULTS'] || 'html/tests'
+  ruby %{-Ilib scripts/buildtests.rb #{html_dir}}
+  open("#{html_dir}/summary.html") do |inf|
+    open("#{html_dir}/summary.new", "w") do |outf|
+      inf.each do |line|
+	if line =~ /td align/
+	  line = "    <td align=\"left\">#{Time.now}</td><td align=\"right\">"
+	end
+	outf.puts line
+      end
+    end
+  end
+  mv "#{html_dir}/summary.html", "#{html_dir}/summary.old"
+  mv "#{html_dir}/summary.new", "#{html_dir}/summary.html"      
+end
+
+# Shortcuts for test targets
+task :ft => [:functional]
+task :ut => [:test]
+task :at => [:alltests]
+
+task :gemtest do
+  ruby %{-Ilib -rscripts/runtest -e 'run_tests("test/test_gempaths.rb", true)'}
+end
+
+# --------------------------------------------------------------------
+# Creating a release
+
+def announce(msg='')
+  STDERR.puts msg
+end
+
+desc "Make a new release"
+task :release => [
+  :prerelease,
+  :clobber,
+  :alltests,
+  :update_version,
+  :package,
+  :tag] do
+  
+  announce 
+  announce "**************************************************************"
+  announce "* Release #{ENV['REL']} Complete."
+  announce "* Packages ready to upload."
+  announce "**************************************************************"
+  announce 
+end
+
+# Validate that everything is ready to go for a release.
+task :prerelease do
+  announce 
+  announce "**************************************************************"
+  announce "* Making RubyGem Release #{ENV['REL']}"
+  announce "* (current version #{PKG_VERSION})"
+  announce "**************************************************************"
+  announce  
+
+  # Is a release number supplied?
+  unless ENV['REL']
+    fail "Usage: rake release REL=x.y.z [REUSE=tag_suffix]"
+  end
+
+  # Is the release different than the current release.
+  # (or is REUSE set?)
+  if PKG_VERSION == ENV['REL'] && ! ENV['REUSE']
+    fail "Current version is #{PKG_VERSION}, must specify REUSE=tag_suffix to reuse version"
+  end
+
+  # Are all source files checked in?
+  if ENV['RELTEST']
+    announce "Release Task Testing, skipping checked-in file test"
+  else
+    announce "Checking for unchecked-in files..."
+    data = `cvs -q update`
+    unless data =~ /^$/
+      fail "CVS update is not clean ... do you have unchecked-in files?"
+    end
+    announce "No outstanding checkins found ... OK"
+  end
+end
+
+task :update_version => [:prerelease] do
+  if PKG_VERSION == ENV['REL']
+    announce "No version change ... skipping version update"
+  else
+    announce "Updating RubyGem version to #{ENV['REL']}"
+    open("lib/rubygems/rubygems_version.rb", "w") do |f|
+      f.puts "# DO NOT EDIT"
+      f.puts "# This file is auto-generated by build scripts."
+      f.puts "# See:  rake update_version"
+      f.puts "module Gem"
+      f.puts "  RubyGemsVersion = '#{ENV['REL']}'"
+      f.puts "end"
+    end
+    sh %{cvs commit -m "Updated to version #{ENV['REL']}" lib/rubygems/rubygems_version.rb}
+  end
+end
+
+task :tag => [:prerelease] do
+  reltag = "REL_#{ENV['REL'].gsub(/\./, '_')}"
+  reltag << ENV['REUSE'] if ENV['REUSE']
+  announce "Tagging CVS with [#{reltag}]"
+  sh %{cvs tag #{reltag}}
+end
+
+# --------------------------------------------------------------------
+# Create a task to build the RDOC documentation tree.
+
+desc "Create the RDOC html files"
+rd = Rake::RDocTask.new("rdoc") { |rdoc|
+  rdoc.rdoc_dir = 'html'
+#  rdoc.template = 'kilmer'
+#  rdoc.template = 'css2'
+  rdoc.template = 'jamis'
+  rdoc.title    = "RubyGems"
+  rdoc.options << '--line-numbers' << '--inline-source' << '--main' << 'README'
+  rdoc.rdoc_files.include('README', 'TODO', 'Releases')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include('test/**/*.rb')
+}
+
+file "html/index.html" => [:rdoc]
+
+desc "Publish the RDOCs on RubyForge"
+task :publish_rdoc => ["html/index.html"] do
+  # NOTE: This task assumes that you have an SSH alias setup for rubyforge.
+  mkdir_p "emptydir"
+  sh "scp -rq emptydir rubyforge:/var/www/gforge-projects/rubygems/rdoc"
+  sh "scp -rq html/* rubyforge:/var/www/gforge-projects/rubygems/rdoc"
+  rm_r "emptydir"
+end
+
+# Wiki Doc Targets
+
+desc "Build the Wiki documentation"
+task :wiki => ['scripts/gemdoc.wiki', 'scripts/specdoc.wiki']
+
+file 'scripts/gemdoc.wiki' => ['scripts/gemdoc.rb', 'scripts/gemdoc.data'] do
+  chdir('scripts') do
+    ruby %{-I../lib gemdoc.rb <gemdoc.data >gemdoc.wiki}
+  end
+end
+
+file 'scripts/specdoc.wiki' =>
+  ['scripts/specdoc.rb', 'scripts/specdoc.data', 'scripts/specdoc.yaml'] do
+  chdir('scripts') do
+    ruby %{-I../lib specdoc.rb >specdoc.wiki}
+  end
+end
+
+# Package tasks
+
+PKG_FILES = FileList[
+  "Rakefile", "ChangeLog", "Releases", "TODO", "README", 
+  "setup.rb",
+  "post-install.rb",
+  "bin/*",
+  "doc/*.css", "doc/*.rb",
+  "examples/**/*",
+  "gemspecs/**/*",
+  "lib/**/*.rb",
+  "pkgs/**/*",
+  "redist/*.gem",
+  "scripts/*.rb",
+  "test/**/*"
+]
+PKG_FILES.exclude(%r(^test/temp(/|$)))
+
+Rake::PackageTask.new("package") do |p|
+  p.name = PKG_NAME
+  p.version = PKG_VERSION
+  p.need_tar = true
+  p.need_zip = true
+  p.package_files = PKG_FILES
+end
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME + "-update"  
+  s.version = PKG_VERSION
+  s.summary = "RubyGems Update GEM"
+  s.description = %{RubyGems is a package management framework for Ruby.  This Gem
+is a update for the base RubyGems software.  You must have a base
+installation of RubyGems before this update can be applied.
+}
+  s.files = PKG_FILES.to_a
+  s.require_path = 'lib'
+  s.author = "RubyGems Team"
+  s.email = "rubygems-developers@rubyforge.org"
+  s.homepage = "http://rubygems.rubyforge.org"
+  s.rubyforge_project = "rubygems"
+  s.bindir = "bin"                               # Use these for applications.
+  s.executables = ["update_rubygems"]
+end
+
+Rake::GemPackageTask.new(spec) do |p| end
+
+# Install RubyGems
+
+desc "Install RubyGems"
+task :install do
+  ruby 'install.rb'
+end
+
+# Run 'gem' (using local bin and lib directories).
+# e.g.
+#     rake rungem -- install -r blahblah --test
+
+desc "Run local 'gem'"
+task :rungem do
+  ARGV.shift
+  exec "ruby -Ilib bin/gem #{ARGV.join(' ')}"
+end
+
+# Misc Tasks ---------------------------------------------------------
+
+def egrep(pattern)
+  Dir['**/*.rb'].each do |fn|
+    count = 0
+    open(fn) do |f|
+      while line = f.gets
+	count += 1
+	if line =~ pattern
+	  puts "#{fn}:#{count}:#{line}"
+	end
+      end
+    end
+  end
+end
+
+desc "Look for TODO and FIXME tags in the code"
+task :todo do
+  egrep /#.*(FIXME|TODO|TBD)/
+end
+
+desc "Look for Debugging print lines"
+task :dbg do
+  egrep /\bDBG|\bbreakpoint\b/
+end
+
+desc "List all ruby files"
+task :rubyfiles do 
+  puts Dir['**/*.rb'].reject { |fn| fn =~ /^pkg/ }
+  puts Dir['bin/*'].reject { |fn| fn =~ /CVS|(~$)|(\.rb$)/ }
+end

data/Releases

@@ -0,0 +1,98 @@
+= RubyGems Release History
+
+== Release 0.8.0: Sep 12, 2004
+
+* Remove need for library stubs.  Set the RUBYOPT environment variable
+  to include "rrubygems", and a normal require will find gem files.
+  Continue to use 'require_gem gem_name, version' to specify gem
+  versions.
+* Deprecated "test_suite_file" gemspec attribute in favor of "test_files" array.
+* Generates rdoc by default on installs.
+* Adopted tar/gzip file format, thanks to Mauricio Fernandez.
+* "gem rdoc" allows generation of rdoc after gem installation (will add a "gem test" 
+* Application stubs can now accept an optional parameter of _VERSION_ that will run
+  an arbitrary version of the application requested.
+* Various bug fixes
+* Various platform-independency improvements
+* "gem spec --all" displays spec info for all installed version of a given gem.
+* Dynamic caching of sources
+* Support for user-definable sources on the command line (thanks Assaph Mehr)
+* More intelligent support for platform-dependent gems.  Use Platform::CURRENT when
+  building a gem to set its platform to the one you're building on.  Installation
+  displays a choice of platform-dependent gems, allowing the user to pick.
+* Added "gem unpack" for "unpacking" a gem to the current directory
+
+== Release 0.7.0: Jul 9, 2004
+
+* See ChangeLog. 
+
+== Release 0.6.0: Jun 8, 2004
+* Collapse output of --search and --list (and gem_server) operations so 
+  that each gem is listed only once, with each of its versions listed 
+  on the same line.
+  
+* bin/gem: new --upgrade-all option allows one to upgrade every
+  installed gem
+
+* new #required_ruby_version attribute added to gem specification for
+  specifying a dependency on which version of ruby the gem needs.
+  Format it accepts is the same as the Gem::Version::Requirement
+  format:
+     spec.required_ruby_version = "> 1.8.0" 
+
+* --install-stub defaults to true, so library stubs are created 
+
+== Release 0.5.0: Jun 6, 2004
+
+* Jim added the ability to specify version constraints to avoid API
+  incompatibilities.  This has been the subject of much debate for
+  the past couple of months, with many ideas and code contributed by
+  Eivind Eklund and Mauricio Fernandez.  The following set of
+  assertions shows how it works:
+
+    assert_inadequate("1.3", "~> 1.4")
+    assert_adequate(  "1.4", "~> 1.4")
+    assert_adequate(  "1.5", "~> 1.4")
+    assert_inadequate("2.0", "~> 1.4") # This one is key--the new operator disallows major version number differences.
+
+* Group gem search output when multiple versions exist for a given gem:
+
+    activerecord (0.7.8, 0.7.7, 0.7.6, 0.7.5)
+      Implements the ActiveRecord pattern for ORM.
+
+* Add arbitrary RDoc-able files via gemspec (not just Ruby source
+  files) for people who have, for example, README.rdoc in their
+  distributions.  Add to gemspec via: spec.extra_rdoc_files = ["list",
+  "of", "files"].  Ruby files are automatically included.
+
+* Some small bug fixes
+
+  
+== Release 0.4.0: May 31, 2004
+
+* Minor bug fixes including Windows compatability issues
+
+== Release 0.3.0: April 30, 2004
+
+* Cleanup of command-line arguments and handling.  Most commands
+  accept a --local or --remote modifier.
+* Creation of Application Gems (packages that include executable
+  programs).  See
+  http://rubygems.rubyforge.org/wiki/wiki.pl?DeveloperGuide for
+  information on how to use it.
+* Basic functionality for installing binary gems from source
+  (:extensions property of gem specification holds an array of paths
+  to extconf.rb files to be used for compilation)
+* Install library "stub" allowing a normal 'require' to work (which then does the rubygems require and 'require_gem'
+* --run-tests runs the test suite specified by the "test_suite_file"
+  property of a gem specification
+  * HTTP Proxy support works.  Rewrite of HTTP code.
+  * Unit and functional tests added (see Rakefile).
+  * Prompt before remote-installing dependencies during gem installation.
+  * Config file for storing preferences for 'gem' command usage.
+  * Generally improved error messages (still more work to do)
+  * Rearranged gem directory structure for cleanliness.
+  
+== Release 0.2.0: March 14, 2004
+
+* Initial public release

data/TODO

@@ -0,0 +1,7 @@
+* support for installing binary (pre-compiled), platform-dependent gems.  This already works as long as you pick the right gem manually, but I'd like the remote installer to intelligently select the right one and for the installer to throw an error (or a warning) if you attempt o install (e.g.) a Windows gem on a linux system.  Requires a lot of data to be collected on platform dependency fulfillment.
+* syncing gem repositories
+* optional dependencies: "semitar can use REXML, but it works better if you have the ruby raptor library installed",  or not so optional as in: "you need Ruby/RSS > = 1.0 OR rss > 0.91 for this library to work"
+* ri data generation
+* Integration with platform-native packaging systems
+* MD5 summing stuff doesn't work right on the new format (0.8.0+)
+* Rethink testing strategy.  May need to write a document describing how to avoid doing things in unit tests that won't work outside of `pwd`