RubyGems - libgems - Versions diffs - 0.0.1 - Mend

libgems 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (177) hide show

data/ChangeLog +5811 -0
data/History.txt +887 -0
data/LICENSE.txt +51 -0
data/README.md +87 -0
data/Rakefile +113 -0
data/lib/gauntlet_libgems.rb +50 -0
data/lib/libgems.rb +1246 -0
data/lib/libgems/builder.rb +102 -0
data/lib/libgems/command.rb +534 -0
data/lib/libgems/command_manager.rb +182 -0
data/lib/libgems/commands/build_command.rb +53 -0
data/lib/libgems/commands/cert_command.rb +86 -0
data/lib/libgems/commands/check_command.rb +80 -0
data/lib/libgems/commands/cleanup_command.rb +106 -0
data/lib/libgems/commands/contents_command.rb +98 -0
data/lib/libgems/commands/dependency_command.rb +195 -0
data/lib/libgems/commands/environment_command.rb +133 -0
data/lib/libgems/commands/fetch_command.rb +67 -0
data/lib/libgems/commands/generate_index_command.rb +133 -0
data/lib/libgems/commands/help_command.rb +172 -0
data/lib/libgems/commands/install_command.rb +178 -0
data/lib/libgems/commands/list_command.rb +35 -0
data/lib/libgems/commands/lock_command.rb +110 -0
data/lib/libgems/commands/mirror_command.rb +111 -0
data/lib/libgems/commands/outdated_command.rb +33 -0
data/lib/libgems/commands/owner_command.rb +75 -0
data/lib/libgems/commands/pristine_command.rb +93 -0
data/lib/libgems/commands/push_command.rb +56 -0
data/lib/libgems/commands/query_command.rb +280 -0
data/lib/libgems/commands/rdoc_command.rb +91 -0
data/lib/libgems/commands/search_command.rb +31 -0
data/lib/libgems/commands/server_command.rb +86 -0
data/lib/libgems/commands/sources_command.rb +157 -0
data/lib/libgems/commands/specification_command.rb +125 -0
data/lib/libgems/commands/stale_command.rb +27 -0
data/lib/libgems/commands/uninstall_command.rb +83 -0
data/lib/libgems/commands/unpack_command.rb +121 -0
data/lib/libgems/commands/update_command.rb +160 -0
data/lib/libgems/commands/which_command.rb +86 -0
data/lib/libgems/config_file.rb +345 -0
data/lib/libgems/custom_require.rb +44 -0
data/lib/libgems/defaults.rb +101 -0
data/lib/libgems/dependency.rb +227 -0
data/lib/libgems/dependency_installer.rb +286 -0
data/lib/libgems/dependency_list.rb +208 -0
data/lib/libgems/doc_manager.rb +242 -0
data/lib/libgems/errors.rb +35 -0
data/lib/libgems/exceptions.rb +91 -0
data/lib/libgems/ext.rb +18 -0
data/lib/libgems/ext/builder.rb +56 -0
data/lib/libgems/ext/configure_builder.rb +25 -0
data/lib/libgems/ext/ext_conf_builder.rb +24 -0
data/lib/libgems/ext/rake_builder.rb +39 -0
data/lib/libgems/format.rb +81 -0
data/lib/libgems/gem_openssl.rb +92 -0
data/lib/libgems/gem_path_searcher.rb +100 -0
data/lib/libgems/gem_runner.rb +79 -0
data/lib/libgems/gemcutter_utilities.rb +49 -0
data/lib/libgems/indexer.rb +720 -0
data/lib/libgems/install_update_options.rb +125 -0
data/lib/libgems/installer.rb +604 -0
data/lib/libgems/local_remote_options.rb +135 -0
data/lib/libgems/old_format.rb +153 -0
data/lib/libgems/package.rb +97 -0
data/lib/libgems/package/f_sync_dir.rb +23 -0
data/lib/libgems/package/tar_header.rb +266 -0
data/lib/libgems/package/tar_input.rb +222 -0
data/lib/libgems/package/tar_output.rb +144 -0
data/lib/libgems/package/tar_reader.rb +106 -0
data/lib/libgems/package/tar_reader/entry.rb +141 -0
data/lib/libgems/package/tar_writer.rb +241 -0
data/lib/libgems/package_task.rb +126 -0
data/lib/libgems/platform.rb +183 -0
data/lib/libgems/remote_fetcher.rb +414 -0
data/lib/libgems/require_paths_builder.rb +18 -0
data/lib/libgems/requirement.rb +153 -0
data/lib/libgems/security.rb +814 -0
data/lib/libgems/server.rb +872 -0
data/lib/libgems/source_index.rb +597 -0
data/lib/libgems/source_info_cache.rb +395 -0
data/lib/libgems/source_info_cache_entry.rb +56 -0
data/lib/libgems/spec_fetcher.rb +337 -0
data/lib/libgems/specification.rb +1487 -0
data/lib/libgems/test_utilities.rb +147 -0
data/lib/libgems/text.rb +65 -0
data/lib/libgems/uninstaller.rb +278 -0
data/lib/libgems/user_interaction.rb +527 -0
data/lib/libgems/validator.rb +240 -0
data/lib/libgems/version.rb +316 -0
data/lib/libgems/version_option.rb +65 -0
data/lib/rbconfig/datadir.rb +20 -0
data/test/bogussources.rb +8 -0
data/test/data/gem-private_key.pem +27 -0
data/test/data/gem-public_cert.pem +20 -0
data/test/fake_certlib/openssl.rb +7 -0
data/test/foo/discover.rb +0 -0
data/test/gem_installer_test_case.rb +97 -0
data/test/gem_package_tar_test_case.rb +132 -0
data/test/gemutilities.rb +605 -0
data/test/insure_session.rb +43 -0
data/test/mockgemui.rb +56 -0
data/test/plugin/exception/libgems_plugin.rb +2 -0
data/test/plugin/load/libgems_plugin.rb +1 -0
data/test/plugin/standarderror/libgems_plugin.rb +2 -0
data/test/private_key.pem +27 -0
data/test/public_cert.pem +20 -0
data/test/rubygems_plugin.rb +21 -0
data/test/simple_gem.rb +66 -0
data/test/test_config.rb +12 -0
data/test/test_gem.rb +780 -0
data/test/test_gem_builder.rb +27 -0
data/test/test_gem_command.rb +178 -0
data/test/test_gem_command_manager.rb +207 -0
data/test/test_gem_commands_build_command.rb +74 -0
data/test/test_gem_commands_cert_command.rb +124 -0
data/test/test_gem_commands_check_command.rb +18 -0
data/test/test_gem_commands_contents_command.rb +156 -0
data/test/test_gem_commands_dependency_command.rb +216 -0
data/test/test_gem_commands_environment_command.rb +144 -0
data/test/test_gem_commands_fetch_command.rb +76 -0
data/test/test_gem_commands_generate_index_command.rb +135 -0
data/test/test_gem_commands_install_command.rb +315 -0
data/test/test_gem_commands_list_command.rb +36 -0
data/test/test_gem_commands_lock_command.rb +68 -0
data/test/test_gem_commands_mirror_command.rb +60 -0
data/test/test_gem_commands_outdated_command.rb +40 -0
data/test/test_gem_commands_owner_command.rb +105 -0
data/test/test_gem_commands_pristine_command.rb +108 -0
data/test/test_gem_commands_push_command.rb +81 -0
data/test/test_gem_commands_query_command.rb +426 -0
data/test/test_gem_commands_server_command.rb +59 -0
data/test/test_gem_commands_sources_command.rb +209 -0
data/test/test_gem_commands_specification_command.rb +139 -0
data/test/test_gem_commands_stale_command.rb +38 -0
data/test/test_gem_commands_uninstall_command.rb +83 -0
data/test/test_gem_commands_unpack_command.rb +199 -0
data/test/test_gem_commands_update_command.rb +207 -0
data/test/test_gem_commands_which_command.rb +66 -0
data/test/test_gem_config_file.rb +287 -0
data/test/test_gem_dependency.rb +149 -0
data/test/test_gem_dependency_installer.rb +661 -0
data/test/test_gem_dependency_list.rb +230 -0
data/test/test_gem_doc_manager.rb +31 -0
data/test/test_gem_ext_configure_builder.rb +84 -0
data/test/test_gem_ext_ext_conf_builder.rb +173 -0
data/test/test_gem_ext_rake_builder.rb +81 -0
data/test/test_gem_format.rb +70 -0
data/test/test_gem_gem_path_searcher.rb +78 -0
data/test/test_gem_gem_runner.rb +45 -0
data/test/test_gem_gemcutter_utilities.rb +103 -0
data/test/test_gem_indexer.rb +673 -0
data/test/test_gem_install_update_options.rb +68 -0
data/test/test_gem_installer.rb +857 -0
data/test/test_gem_local_remote_options.rb +97 -0
data/test/test_gem_package_tar_header.rb +130 -0
data/test/test_gem_package_tar_input.rb +112 -0
data/test/test_gem_package_tar_output.rb +97 -0
data/test/test_gem_package_tar_reader.rb +46 -0
data/test/test_gem_package_tar_reader_entry.rb +109 -0
data/test/test_gem_package_tar_writer.rb +144 -0
data/test/test_gem_package_task.rb +59 -0
data/test/test_gem_platform.rb +264 -0
data/test/test_gem_remote_fetcher.rb +740 -0
data/test/test_gem_requirement.rb +292 -0
data/test/test_gem_server.rb +356 -0
data/test/test_gem_silent_ui.rb +113 -0
data/test/test_gem_source_index.rb +461 -0
data/test/test_gem_spec_fetcher.rb +410 -0
data/test/test_gem_specification.rb +1334 -0
data/test/test_gem_stream_ui.rb +218 -0
data/test/test_gem_text.rb +43 -0
data/test/test_gem_uninstaller.rb +146 -0
data/test/test_gem_validator.rb +63 -0
data/test/test_gem_version.rb +181 -0
data/test/test_gem_version_option.rb +89 -0
data/test/test_kernel.rb +59 -0
metadata +402 -0

data/lib/libgems/server.rb ADDED

@@ -0,0 +1,872 @@
+require 'webrick'
+require 'yaml'
+require 'zlib'
+require 'erb'
+require 'libgems'
+require 'libgems/doc_manager'
+##
+# LibGems::Server and allows users to serve gems for consumption by
+# `gem --remote-install`.
+#
+# gem_server starts an HTTP server on the given port and serves the following:
+# * "/" - Browsing of gem spec files for installed gems
+# * "/specs.#{LibGems.marshal_version}.gz" - specs name/version/platform index
+# * "/latest_specs.#{LibGems.marshal_version}.gz" - latest specs
+#   name/version/platform index
+# * "/quick/" - Individual gemspecs
+# * "/gems" - Direct access to download the installable gems
+# * "/rdoc?q=" - Search for installed rdoc documentation
+# * legacy indexes:
+#   * "/Marshal.#{LibGems.marshal_version}" - Full SourceIndex dump of metadata
+#     for installed gems
+#   * "/yaml" - YAML dump of metadata for installed gems - deprecated
+#
+# == Usage
+#
+#   gem_server = LibGems::Server.new LibGems.dir, 8089, false
+#   gem_server.run
+#
+#--
+# TODO Refactor into a real WEBrick servlet to remove code duplication.
+class LibGems::Server
+  attr_reader :spec_dirs
+  include ERB::Util
+  include LibGems::UserInteraction
+  SEARCH = <<-SEARCH
+      <form class="headerSearch" name="headerSearchForm" method="get" action="/rdoc">
+        <div id="search" style="float:right">
+          <label for="q">Filter/Search</label>
+          <input id="q" type="text" style="width:10em" name="q">
+          <button type="submit" style="display:none"></button>
+        </div>
+      </form>
+  SEARCH
+  DOC_TEMPLATE = <<-'DOC_TEMPLATE'
+  <?xml version="1.0" encoding="iso-8859-1"?>
+  <!DOCTYPE html
+       PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+  <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <title>#{LibGems::NAME} Documentation Index</title>
+    <link rel="stylesheet" href="gem-server-rdoc-style.css" type="text/css" media="screen" />
+  </head>
+  <body>
+    <div id="fileHeader">
+<%= SEARCH %>
+      <h1>#{LibGems::NAME} Documentation Index</h1>
+    </div>
+    <!-- banner header -->
+  <div id="bodyContent">
+    <div id="contextContent">
+      <div id="description">
+        <h1>Summary</h1>
+  <p>There are <%=values["gem_count"]%> gems installed:</p>
+  <p>
+  <%= values["specs"].map { |v| "<a href=\"##{v["name"]}\">#{v["name"]}</a>" }.join ', ' %>.
+  <h1>Gems</h1>
+  <dl>
+  <% values["specs"].each do |spec| %>
+  	<dt>
+  	<% if spec["first_name_entry"] then %>
+  	  <a name="<%=spec["name"]%>"></a>
+  	<% end %>
+  	<b><%=spec["name"]%> <%=spec["version"]%></b>
+  	<% if spec["rdoc_installed"] then %>
+  	  <a href="<%=spec["doc_path"]%>">[rdoc]</a>
+  	<% else %>
+  	  <span title="rdoc not installed">[rdoc]</span>
+  	<% end %>
+  	<% if spec["homepage"] then %>
+  		<a href="<%=spec["homepage"]%>" title="<%=spec["homepage"]%>">[www]</a>
+  	<% else %>
+  		<span title="no homepage available">[www]</span>
+  	<% end %>
+  	<% if spec["has_deps"] then %>
+  	 - depends on
+  		<%= spec["dependencies"].map { |v| "<a href=\"##{v["name"]}\">#{v["name"]}</a>" }.join ', ' %>.
+  	<% end %>
+  	</dt>
+  	<dd>
+  	<%=spec["summary"]%>
+  	<% if spec["executables"] then %>
+  	  <br/>
+  		<% if spec["only_one_executable"] then %>
+  		    Executable is
+  		<% else %>
+  		    Executables are
+  		<%end%>
+  		<%= spec["executables"].map { |v| "<span class=\"context-item-name\">#{v["executable"]}</span>"}.join ', ' %>.
+  	<%end%>
+  	<br/>
+  	<br/>
+  	</dd>
+  <% end %>
+  </dl>
+      </div>
+     </div>
+    </div>
+  <div id="validator-badges">
+    <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+  </div>
+  </body>
+  </html>
+  DOC_TEMPLATE
+  # CSS is copy & paste from rdoc-style.css, RDoc V1.0.1 - 20041108
+  RDOC_CSS = <<-RDOC_CSS
+body {
+    font-family: Verdana,Arial,Helvetica,sans-serif;
+    font-size:   90%;
+    margin: 0;
+    margin-left: 40px;
+    padding: 0;
+    background: white;
+}
+h1,h2,h3,h4 { margin: 0; color: #efefef; background: transparent; }
+h1 { font-size: 150%; }
+h2,h3,h4 { margin-top: 1em; }
+a { background: #eef; color: #039; text-decoration: none; }
+a:hover { background: #039; color: #eef; }
+/* Override the base stylesheets Anchor inside a table cell */
+td > a {
+  background: transparent;
+  color: #039;
+  text-decoration: none;
+}
+/* and inside a section title */
+.section-title > a {
+  background: transparent;
+  color: #eee;
+  text-decoration: none;
+}
+/* === Structural elements =================================== */
+div#index {
+    margin: 0;
+    margin-left: -40px;
+    padding: 0;
+    font-size: 90%;
+}
+div#index a {
+    margin-left: 0.7em;
+}
+div#index .section-bar {
+   margin-left: 0px;
+   padding-left: 0.7em;
+   background: #ccc;
+   font-size: small;
+}
+div#classHeader, div#fileHeader {
+    width: auto;
+    color: white;
+    padding: 0.5em 1.5em 0.5em 1.5em;
+    margin: 0;
+    margin-left: -40px;
+    border-bottom: 3px solid #006;
+}
+div#classHeader a, div#fileHeader a {
+    background: inherit;
+    color: white;
+}
+div#classHeader td, div#fileHeader td {
+    background: inherit;
+    color: white;
+}
+div#fileHeader {
+    background: #057;
+}
+div#classHeader {
+    background: #048;
+}
+.class-name-in-header {
+  font-size:  180%;
+  font-weight: bold;
+}
+div#bodyContent {
+    padding: 0 1.5em 0 1.5em;
+}
+div#description {
+    padding: 0.5em 1.5em;
+    background: #efefef;
+    border: 1px dotted #999;
+}
+div#description h1,h2,h3,h4,h5,h6 {
+    color: #125;;
+    background: transparent;
+}
+div#validator-badges {
+    text-align: center;
+}
+div#validator-badges img { border: 0; }
+div#copyright {
+    color: #333;
+    background: #efefef;
+    font: 0.75em sans-serif;
+    margin-top: 5em;
+    margin-bottom: 0;
+    padding: 0.5em 2em;
+}
+/* === Classes =================================== */
+table.header-table {
+    color: white;
+    font-size: small;
+}
+.type-note {
+    font-size: small;
+    color: #DEDEDE;
+}
+.xxsection-bar {
+    background: #eee;
+    color: #333;
+    padding: 3px;
+}
+.section-bar {
+   color: #333;
+   border-bottom: 1px solid #999;
+    margin-left: -20px;
+}
+.section-title {
+    background: #79a;
+    color: #eee;
+    padding: 3px;
+    margin-top: 2em;
+    margin-left: -30px;
+    border: 1px solid #999;
+}
+.top-aligned-row {  vertical-align: top }
+.bottom-aligned-row { vertical-align: bottom }
+/* --- Context section classes ----------------------- */
+.context-row { }
+.context-item-name { font-family: monospace; font-weight: bold; color: black; }
+.context-item-value { font-size: small; color: #448; }
+.context-item-desc { color: #333; padding-left: 2em; }
+/* --- Method classes -------------------------- */
+.method-detail {
+    background: #efefef;
+    padding: 0;
+    margin-top: 0.5em;
+    margin-bottom: 1em;
+    border: 1px dotted #ccc;
+}
+.method-heading {
+  color: black;
+  background: #ccc;
+  border-bottom: 1px solid #666;
+  padding: 0.2em 0.5em 0 0.5em;
+}
+.method-signature { color: black; background: inherit; }
+.method-name { font-weight: bold; }
+.method-args { font-style: italic; }
+.method-description { padding: 0 0.5em 0 0.5em; }
+/* --- Source code sections -------------------- */
+a.source-toggle { font-size: 90%; }
+div.method-source-code {
+    background: #262626;
+    color: #ffdead;
+    margin: 1em;
+    padding: 0.5em;
+    border: 1px dashed #999;
+    overflow: hidden;
+}
+div.method-source-code pre { color: #ffdead; overflow: hidden; }
+/* --- Ruby keyword styles --------------------- */
+.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
+.ruby-constant  { color: #7fffd4; background: transparent; }
+.ruby-keyword { color: #00ffff; background: transparent; }
+.ruby-ivar    { color: #eedd82; background: transparent; }
+.ruby-operator  { color: #00ffee; background: transparent; }
+.ruby-identifier { color: #ffdead; background: transparent; }
+.ruby-node    { color: #ffa07a; background: transparent; }
+.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
+.ruby-regexp  { color: #ffa07a; background: transparent; }
+.ruby-value   { color: #7fffd4; background: transparent; }
+  RDOC_CSS
+  RDOC_NO_DOCUMENTATION = <<-'NO_DOC'
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <title>Found documentation</title>
+    <link rel="stylesheet" href="gem-server-rdoc-style.css" type="text/css" media="screen" />
+  </head>
+  <body>
+    <div id="fileHeader">
+<%= SEARCH %>
+      <h1>No documentation found</h1>
+    </div>
+    <div id="bodyContent">
+      <div id="contextContent">
+        <div id="description">
+          <p>No gems matched <%= h query.inspect %></p>
+          <p>
+            Back to <a href="/">complete gem index</a>
+          </p>
+        </div>
+      </div>
+    </div>
+    <div id="validator-badges">
+      <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+    </div>
+  </body>
+</html>
+  NO_DOC
+  RDOC_SEARCH_TEMPLATE = <<-'RDOC_SEARCH'
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <title>Found documentation</title>
+    <link rel="stylesheet" href="gem-server-rdoc-style.css" type="text/css" media="screen" />
+  </head>
+  <body>
+    <div id="fileHeader">
+<%= SEARCH %>
+      <h1>Found documentation</h1>
+    </div>
+    <!-- banner header -->
+    <div id="bodyContent">
+      <div id="contextContent">
+        <div id="description">
+          <h1>Summary</h1>
+          <p><%=doc_items.length%> documentation topics found.</p>
+          <h1>Topics</h1>
+          <dl>
+          <% doc_items.each do |doc_item| %>
+            <dt>
+              <b><%=doc_item[:name]%></b>
+              <a href="<%=doc_item[:url]%>">[rdoc]</a>
+            </dt>
+            <dd>
+              <%=doc_item[:summary]%>
+              <br/>
+              <br/>
+            </dd>
+          <% end %>
+          </dl>
+          <p>
+            Back to <a href="/">complete gem index</a>
+          </p>
+        </div>
+      </div>
+    </div>
+    <div id="validator-badges">
+      <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+    </div>
+  </body>
+</html>
+  RDOC_SEARCH
+  def self.run(options)
+    new(options[:gemdir], options[:port], options[:daemon],
+        options[:launch], options[:addresses]).run
+  end
+  ##
+  # Only the first directory in gem_dirs is used for serving gems
+  def initialize(gem_dirs, port, daemon, launch = nil, addresses = nil)
+    Socket.do_not_reverse_lookup = true
+    @gem_dirs = Array gem_dirs
+    @port = port
+    @daemon = daemon
+    @launch = launch
+    @addresses = addresses
+    logger = WEBrick::Log.new nil, WEBrick::BasicLog::FATAL
+    @server = WEBrick::HTTPServer.new :DoNotListen => true, :Logger => logger
+    @spec_dirs = @gem_dirs.map do |gem_dir|
+      spec_dir = File.join gem_dir, 'specifications'
+      unless File.directory? spec_dir then
+        raise ArgumentError, "#{gem_dir} does not appear to be a gem repository"
+      end
+      spec_dir
+    end
+    @source_index = LibGems::SourceIndex.from_gems_in(*@spec_dirs)
+  end
+  def Marshal(req, res)
+    @source_index.refresh!
+    add_date res
+    index = Marshal.dump @source_index
+    if req.request_method == 'HEAD' then
+      res['content-length'] = index.length
+      return
+    end
+    if req.path =~ /Z$/ then
+      res['content-type'] = 'application/x-deflate'
+      index = LibGems.deflate index
+    else
+      res['content-type'] = 'application/octet-stream'
+    end
+    res.body << index
+  end
+  def add_date res
+    res['date'] = @spec_dirs.map do |spec_dir|
+      File.stat(spec_dir).mtime
+    end.max
+  end
+  def latest_specs(req, res)
+    @source_index.refresh!
+    res['content-type'] = 'application/x-gzip'
+    add_date res
+    specs = @source_index.latest_specs.sort.map do |spec|
+      platform = spec.original_platform
+      platform = LibGems::Platform::RUBY if platform.nil?
+      [spec.name, spec.version, platform]
+    end
+    specs = Marshal.dump specs
+    if req.path =~ /\.gz$/ then
+      specs = LibGems.gzip specs
+      res['content-type'] = 'application/x-gzip'
+    else
+      res['content-type'] = 'application/octet-stream'
+    end
+    if req.request_method == 'HEAD' then
+      res['content-length'] = specs.length
+    else
+      res.body << specs
+    end
+  end
+  ##
+  # Creates server sockets based on the addresses option.  If no addresses
+  # were given a server socket for all interfaces is created.
+  def listen addresses = @addresses
+    addresses = [nil] unless addresses
+    listeners = 0
+    addresses.each do |address|
+      begin
+        @server.listen address, @port
+        @server.listeners[listeners..-1].each do |listener|
+          host, port = listener.addr.values_at 2, 1
+          host = "[#{host}]" if host =~ /:/ # we don't reverse lookup
+          say "Server started at http://#{host}:#{port}"
+        end
+        listeners = @server.listeners.length
+      rescue SystemCallError
+        next
+      end
+    end
+    if @server.listeners.empty? then
+      say "Unable to start a server."
+      say "Check for running servers or your --bind and --port arguments"
+      terminate_interaction 1
+    end
+  end
+  def quick(req, res)
+    @source_index.refresh!
+    res['content-type'] = 'text/plain'
+    add_date res
+    case req.request_uri.path
+    when '/quick/index' then
+      res.body << @source_index.map { |name,| name }.sort.join("\n")
+    when '/quick/index.rz' then
+      index = @source_index.map { |name,| name }.sort.join("\n")
+      res['content-type'] = 'application/x-deflate'
+      res.body << LibGems.deflate(index)
+    when '/quick/latest_index' then
+      index = @source_index.latest_specs.map { |spec| spec.full_name }
+      res.body << index.sort.join("\n")
+    when '/quick/latest_index.rz' then
+      index = @source_index.latest_specs.map { |spec| spec.full_name }
+      res['content-type'] = 'application/x-deflate'
+      res.body << LibGems.deflate(index.sort.join("\n"))
+    when %r|^/quick/(Marshal.#{Regexp.escape LibGems.marshal_version}/)?(.*?)-([0-9.]+)(-.*?)?\.gemspec\.rz$| then
+      dep = LibGems::Dependency.new $2, $3
+      specs = @source_index.search dep
+      marshal_format = $1
+      selector = [$2, $3, $4].map { |s| s.inspect }.join ' '
+      platform = if $4 then
+                   LibGems::Platform.new $4.sub(/^-/, '')
+                 else
+                   LibGems::Platform::RUBY
+                 end
+      specs = specs.select { |s| s.platform == platform }
+      if specs.empty? then
+        res.status = 404
+        res.body = "No gems found matching #{selector}"
+      elsif specs.length > 1 then
+        res.status = 500
+        res.body = "Multiple gems found matching #{selector}"
+      elsif marshal_format then
+        res['content-type'] = 'application/x-deflate'
+        res.body << LibGems.deflate(Marshal.dump(specs.first))
+      else # deprecated YAML format
+        res['content-type'] = 'application/x-deflate'
+        res.body << LibGems.deflate(specs.first.to_yaml)
+      end
+    else
+      raise WEBrick::HTTPStatus::NotFound, "`#{req.path}' not found."
+    end
+  end
+  def root(req, res)
+    @source_index.refresh!
+    add_date res
+    raise WEBrick::HTTPStatus::NotFound, "`#{req.path}' not found." unless
+      req.path == '/'
+    specs = []
+    total_file_count = 0
+    @source_index.each do |path, spec|
+      total_file_count += spec.files.size
+      deps = spec.dependencies.map do |dep|
+        { "name"    => dep.name,
+          "type"    => dep.type,
+          "version" => dep.requirement.to_s, }
+      end
+      deps = deps.sort_by { |dep| [dep["name"].downcase, dep["version"]] }
+      deps.last["is_last"] = true unless deps.empty?
+      # executables
+      executables = spec.executables.sort.collect { |exec| {"executable" => exec} }
+      executables = nil if executables.empty?
+      executables.last["is_last"] = true if executables
+      specs << {
+        "authors"             => spec.authors.sort.join(", "),
+        "date"                => spec.date.to_s,
+        "dependencies"        => deps,
+        "doc_path"            => "/doc_root/#{spec.full_name}/rdoc/index.html",
+        "executables"         => executables,
+        "only_one_executable" => (executables && executables.size == 1),
+        "full_name"           => spec.full_name,
+        "has_deps"            => !deps.empty?,
+        "homepage"            => spec.homepage,
+        "name"                => spec.name,
+        "rdoc_installed"      => LibGems::DocManager.new(spec).rdoc_installed?,
+        "summary"             => spec.summary,
+        "version"             => spec.version.to_s,
+      }
+    end
+    specs << {
+      "authors" => "Chad Fowler, Rich Kilmer, Jim Weirich, Eric Hodel and others",
+      "dependencies" => [],
+      "doc_path" => "/doc_root/rubygems-#{LibGems::GEM_VERSION}/rdoc/index.html",
+      "executables" => [{"executable" => 'gem', "is_last" => true}],
+      "only_one_executable" => true,
+      "full_name" => "libgems-#{LibGems::VERSION}",
+      "has_deps" => false,
+      "homepage" => "http://docs.rubygems.org/",
+      "name" => 'rubygems',
+      "rdoc_installed" => true,
+      "summary" => "#{LibGems::NAME} itself",
+      "version" => LibGems::VERSION,
+    }
+    specs = specs.sort_by { |spec| [spec["name"].downcase, spec["version"]] }
+    specs.last["is_last"] = true
+    # tag all specs with first_name_entry
+    last_spec = nil
+    specs.each do |spec|
+      is_first = last_spec.nil? || (last_spec["name"].downcase != spec["name"].downcase)
+      spec["first_name_entry"] = is_first
+      last_spec = spec
+    end
+    # create page from template
+    template = ERB.new(DOC_TEMPLATE)
+    res['content-type'] = 'text/html'
+    values = { "gem_count" => specs.size.to_s, "specs" => specs,
+               "total_file_count" => total_file_count.to_s }
+    result = template.result binding
+    res.body = result
+  end
+  ##
+  # Can be used for quick navigation to the rdoc documentation.  You can then
+  # define a search shortcut for your browser.  E.g. in Firefox connect
+  # 'shortcut:rdoc' to http://localhost:8808/rdoc?q=%s template. Then you can
+  # directly open the ActionPack documentation by typing 'rdoc actionp'. If
+  # there are multiple hits for the search term, they are presented as a list
+  # with links.
+  #
+  # Search algorithm aims for an intuitive search:
+  # 1. first try to find the gems and documentation folders which name
+  #    starts with the search term
+  # 2. search for entries, that *contain* the search term
+  # 3. show all the gems
+  #
+  # If there is only one search hit, user is immediately redirected to the
+  # documentation for the particular gem, otherwise a list with results is
+  # shown.
+  #
+  # === Additional trick - install documentation for ruby core
+  #
+  # Note: please adjust paths accordingly use for example 'locate yaml.rb' and
+  # 'gem environment' to identify directories, that are specific for your
+  # local installation
+  #
+  # 1. install ruby sources
+  #      cd /usr/src
+  #      sudo apt-get source ruby
+  #
+  # 2. generate documentation
+  #      rdoc -o /usr/lib/ruby/gems/1.8/doc/core/rdoc \
+  #        /usr/lib/ruby/1.8 ruby1.8-1.8.7.72
+  #
+  # By typing 'rdoc core' you can now access the core documentation
+  def rdoc(req, res)
+    query = req.query['q']
+    show_rdoc_for_pattern("#{query}*", res) && return
+    show_rdoc_for_pattern("*#{query}*", res) && return
+    template = ERB.new RDOC_NO_DOCUMENTATION
+    res['content-type'] = 'text/html'
+    res.body = template.result binding
+  end
+  ##
+  # Returns true and prepares http response, if rdoc for the requested gem
+  # name pattern was found.
+  #
+  # The search is based on the file system content, not on the gems metadata.
+  # This allows additional documentation folders like 'core' for the ruby core
+  # documentation - just put it underneath the main doc folder.
+  def show_rdoc_for_pattern(pattern, res)
+    found_gems = Dir.glob("{#{@gem_dirs.join ','}}/doc/#{pattern}").select {|path|
+      File.exist? File.join(path, 'rdoc/index.html')
+    }
+    case found_gems.length
+    when 0
+      return false
+    when 1
+      new_path = File.basename(found_gems[0])
+      res.status = 302
+      res['Location'] = "/doc_root/#{new_path}/rdoc/index.html"
+      return true
+    else
+      doc_items = []
+      found_gems.each do |file_name|
+        base_name = File.basename(file_name)
+        doc_items << {
+          :name => base_name,
+          :url => "/doc_root/#{base_name}/rdoc/index.html",
+          :summary => ''
+        }
+      end
+      template = ERB.new(RDOC_SEARCH_TEMPLATE)
+      res['content-type'] = 'text/html'
+      result = template.result binding
+      res.body = result
+      return true
+    end
+  end
+  def run
+    listen
+    WEBrick::Daemon.start if @daemon
+    @server.mount_proc "/yaml", method(:yaml)
+    @server.mount_proc "/yaml.Z", method(:yaml)
+    @server.mount_proc "/Marshal.#{LibGems.marshal_version}", method(:Marshal)
+    @server.mount_proc "/Marshal.#{LibGems.marshal_version}.Z", method(:Marshal)
+    @server.mount_proc "/specs.#{LibGems.marshal_version}", method(:specs)
+    @server.mount_proc "/specs.#{LibGems.marshal_version}.gz", method(:specs)
+    @server.mount_proc "/latest_specs.#{LibGems.marshal_version}",
+                       method(:latest_specs)
+    @server.mount_proc "/latest_specs.#{LibGems.marshal_version}.gz",
+                       method(:latest_specs)
+    @server.mount_proc "/quick/", method(:quick)
+    @server.mount_proc("/gem-server-rdoc-style.css") do |req, res|
+      res['content-type'] = 'text/css'
+      add_date res
+      res.body << RDOC_CSS
+    end
+    @server.mount_proc "/", method(:root)
+    @server.mount_proc "/rdoc", method(:rdoc)
+    paths = { "/gems" => "/cache/", "/doc_root" => "/doc/" }
+    paths.each do |mount_point, mount_dir|
+      @server.mount(mount_point, WEBrick::HTTPServlet::FileHandler,
+                    File.join(@gem_dirs.first, mount_dir), true)
+    end
+    trap("INT") { @server.shutdown; exit! }
+    trap("TERM") { @server.shutdown; exit! }
+    launch if @launch
+    @server.start
+  end
+  def specs(req, res)
+    @source_index.refresh!
+    add_date res
+    specs = @source_index.sort.map do |_, spec|
+      platform = spec.original_platform
+      platform = LibGems::Platform::RUBY if platform.nil?
+      [spec.name, spec.version, platform]
+    end
+    specs = Marshal.dump specs
+    if req.path =~ /\.gz$/ then
+      specs = LibGems.gzip specs
+      res['content-type'] = 'application/x-gzip'
+    else
+      res['content-type'] = 'application/octet-stream'
+    end
+    if req.request_method == 'HEAD' then
+      res['content-length'] = specs.length
+    else
+      res.body << specs
+    end
+  end
+  def yaml(req, res)
+    @source_index.refresh!
+    add_date res
+    index = @source_index.to_yaml
+    if req.path =~ /Z$/ then
+      res['content-type'] = 'application/x-deflate'
+      index = LibGems.deflate index
+    else
+      res['content-type'] = 'text/plain'
+    end
+    if req.request_method == 'HEAD' then
+      res['content-length'] = index.length
+      return
+    end
+    res.body << index
+  end
+  def launch
+    listeners = @server.listeners.map{|l| l.addr[2] }
+    host = listeners.any?{|l| l == '0.0.0.0'} ? 'localhost' : listeners.first
+    say "Launching browser to http://#{host}:#{@port}"
+    system("#{@launch} http://#{host}:#{@port}")
+  end
+end