carat 1.9.9.pre1

data/lib/carat/source/git/git_proxy.rb

@@ -0,0 +1,162 @@
+module Carat
+  class Source
+    class Git < Path
+
+      class GitNotInstalledError < GitError
+        def initialize
+          msg =  "You need to install git to be able to use gems from git repositories. "
+          msg << "For help installing git, please refer to GitHub's tutorial at https://help.github.com/articles/set-up-git"
+          super msg
+        end
+      end
+
+      class GitNotAllowedError < GitError
+        def initialize(command)
+          msg =  "Carat is trying to run a `git #{command}` at runtime. You probably need to run `carat install`. However, "
+          msg << "this error message could probably be more useful. Please submit a ticket at http://github.com/caratrb/carat/issues "
+          msg << "with steps to reproduce as well as the following\n\nCALLER: #{caller.join("\n")}"
+          super msg
+        end
+      end
+
+      class GitCommandError < GitError
+        def initialize(command, path = nil)
+          msg =  "Git error: command `git #{command}` in directory #{Dir.pwd} has failed."
+          msg << "\nIf this error persists you could try removing the cache directory '#{path}'" if path && path.exist?
+          super msg
+        end
+      end
+
+      # The GitProxy is responsible to interact with git repositories.
+      # All actions required by the Git source is encapsulated in this
+      # object.
+      class GitProxy
+        attr_accessor :path, :uri, :ref
+        attr_writer :revision
+
+        def initialize(path, uri, ref, revision = nil, git = nil)
+          @path     = path
+          @uri      = uri
+          @ref      = ref
+          @revision = revision
+          @git      = git
+          raise GitNotInstalledError.new if allow? && !Carat.git_present?
+        end
+
+        def revision
+          @revision ||= allowed_in_path { git("rev-parse #{ref}").strip }
+        end
+
+        def branch
+          @branch ||= allowed_in_path do
+            git("branch") =~ /^\* (.*)$/ && $1.strip
+          end
+        end
+
+        def contains?(commit)
+          allowed_in_path do
+            result = git_null("branch --contains #{commit}")
+            $? == 0 && result =~ /^\* (.*)$/
+          end
+        end
+
+        def version
+          git("--version").sub("git version", "").strip
+        end
+
+        def checkout
+          if path.exist?
+            return if has_revision_cached?
+            Carat.ui.confirm "Updating #{uri}"
+            in_path do
+              git_retry %|fetch --force --quiet --tags #{uri_escaped} "refs/heads/*:refs/heads/*"|
+            end
+          else
+            Carat.ui.info "Fetching #{uri}"
+            FileUtils.mkdir_p(path.dirname)
+            git_retry %|clone #{uri_escaped} "#{path}" --bare --no-hardlinks --quiet|
+          end
+        end
+
+        def copy_to(destination, submodules=false)
+          unless File.exist?(destination.join(".git"))
+            FileUtils.mkdir_p(destination.dirname)
+            FileUtils.rm_rf(destination)
+            git_retry %|clone --no-checkout --quiet "#{path}" "#{destination}"|
+            File.chmod((0777 & ~File.umask), destination)
+          end
+
+          SharedHelpers.chdir(destination) do
+            git_retry %|fetch --force --quiet --tags "#{path}"|
+            git "reset --hard #{@revision}"
+
+            if submodules
+              git_retry "submodule update --init --recursive"
+            end
+          end
+        end
+
+      private
+
+        # TODO: Do not rely on /dev/null.
+        # Given that open3 is not cross platform until Ruby 1.9.3,
+        # the best solution is to pipe to /dev/null if it exists.
+        # If it doesn't, everything will work fine, but the user
+        # will get the $stderr messages as well.
+        def git_null(command)
+          git("#{command} 2>#{Carat::NULL}", false)
+        end
+
+        def git_retry(command)
+          Carat::Retry.new("git #{command}", GitNotAllowedError).attempts do
+            git(command)
+          end
+        end
+
+        def git(command, check_errors=true)
+          raise GitNotAllowedError.new(command) unless allow?
+          out = SharedHelpers.with_clean_git_env { %x{git #{command}} }
+          raise GitCommandError.new(command, path) if check_errors && !$?.success?
+          out
+        end
+
+        def has_revision_cached?
+          return unless @revision
+          in_path { git("cat-file -e #{@revision}") }
+          true
+        rescue GitError
+          false
+        end
+
+        # Escape the URI for git commands
+        def uri_escaped
+          if Carat::WINDOWS
+            # Windows quoting requires double quotes only, with double quotes
+            # inside the string escaped by being doubled.
+            '"' + uri.gsub('"') {|s| '""'} + '"'
+          else
+            # Bash requires single quoted strings, with the single quotes escaped
+            # by ending the string, escaping the quote, and restarting the string.
+            "'" + uri.gsub("'") {|s| "'\\''"} + "'"
+          end
+        end
+
+        def allow?
+          @git ? @git.allow_git_ops? : true
+        end
+
+        def in_path(&blk)
+          checkout unless path.exist?
+          SharedHelpers.chdir(path, &blk)
+        end
+
+        def allowed_in_path
+          return in_path { yield } if allow?
+          raise GitError, "The git source #{uri} is not yet checked out. Please run `carat install` before trying to start your application"
+        end
+
+      end
+
+    end
+  end
+end

data/lib/carat/source/path.rb

@@ -0,0 +1,226 @@
+module Carat
+  class Source
+
+    class Path < Source
+      autoload :Installer, 'carat/source/path/installer'
+
+      attr_reader   :path, :options
+      attr_writer   :name
+      attr_accessor :version
+
+      DEFAULT_GLOB = "{,*,*/*}.gemspec"
+
+      def initialize(options)
+        @options = options
+        @glob = options["glob"] || DEFAULT_GLOB
+
+        @allow_cached = false
+        @allow_remote = false
+
+        if options["path"]
+          @path = Pathname.new(options["path"])
+          @path = expand(@path) unless @path.relative?
+        end
+
+        @name    = options["name"]
+        @version = options["version"]
+
+        # Stores the original path. If at any point we move to the
+        # cached directory, we still have the original path to copy from.
+        @original_path = @path
+      end
+
+      def remote!
+        @allow_remote = true
+      end
+
+      def cached!
+        @allow_cached = true
+      end
+
+      def self.from_lock(options)
+        new(options.merge("path" => options.delete("remote")))
+      end
+
+      def to_lock
+        out = "PATH\n"
+        out << "  remote: #{relative_path}\n"
+        out << "  glob: #{@glob}\n" unless @glob == DEFAULT_GLOB
+        out << "  specs:\n"
+      end
+
+      def to_s
+        "source at #{@path}"
+      end
+
+      def hash
+        [self.class, expanded_path, version].hash
+      end
+
+      def eql?(o)
+        o.instance_of?(Path) &&
+        expanded_path == expand(o.path) &&
+        version == o.version
+      end
+
+      alias == eql?
+
+      def name
+        File.basename(expanded_path.to_s)
+      end
+
+      def install(spec)
+        generate_bin(spec, :disable_extensions)
+        ["Using #{version_message(spec)} from #{to_s}", nil]
+      end
+
+      def cache(spec, custom_path = nil)
+        app_cache_path = app_cache_path(custom_path)
+        return unless Carat.settings[:cache_all]
+        return if expand(@original_path).to_s.index(Carat.root.to_s) == 0
+
+        unless @original_path.exist?
+          raise GemNotFound, "Can't cache gem #{version_message(spec)} because #{to_s} is missing!"
+        end
+
+        FileUtils.rm_rf(app_cache_path)
+        FileUtils.cp_r("#{@original_path}/.", app_cache_path)
+        FileUtils.touch(app_cache_path.join(".caratcache"))
+      end
+
+      def local_specs(*)
+        @local_specs ||= load_spec_files
+      end
+
+      def specs
+        if has_app_cache?
+          @path = app_cache_path
+          @expanded_path = nil # Invalidate
+        end
+        local_specs
+      end
+
+      def app_cache_dirname
+        name
+      end
+
+    private
+
+      def expanded_path
+        @expanded_path ||= expand(path)
+      end
+
+      def expand(somepath)
+        somepath.expand_path(Carat.root)
+      rescue ArgumentError => e
+        Carat.ui.debug(e)
+        raise PathError, "There was an error while trying to use the path " \
+          "`#{somepath}`.\nThe error message was: #{e.message}."
+      end
+
+      def app_cache_path(custom_path = nil)
+        @app_cache_path ||= Carat.app_cache(custom_path).join(app_cache_dirname)
+      end
+
+      def has_app_cache?
+        SharedHelpers.in_bundle? && app_cache_path.exist?
+      end
+
+      def load_spec_files
+        index = Index.new
+
+        if File.directory?(expanded_path)
+          # We sort depth-first since `<<` will override the earlier-found specs
+          Dir["#{expanded_path}/#{@glob}"].sort_by { |p| -p.split(File::SEPARATOR).size }.each do |file|
+            spec = Carat.load_gemspec(file)
+            if spec
+              spec.loaded_from = file.to_s
+              spec.source = self
+              index << spec
+            end
+          end
+
+          if index.empty? && @name && @version
+            index << Gem::Specification.new do |s|
+              s.name     = @name
+              s.source   = self
+              s.version  = Gem::Version.new(@version)
+              s.platform = Gem::Platform::RUBY
+              s.summary  = "Fake gemspec for #{@name}"
+              s.relative_loaded_from = "#{@name}.gemspec"
+              s.authors  = ["no one"]
+              if expanded_path.join("bin").exist?
+                executables = expanded_path.join("bin").children
+                executables.reject!{|p| File.directory?(p) }
+                s.executables = executables.map{|c| c.basename.to_s }
+              end
+            end
+          end
+        elsif File.exist?(expanded_path)
+          raise PathError, "The path `#{expanded_path}` is not a directory."
+        else
+          raise PathError, "The path `#{expanded_path}` does not exist."
+        end
+
+        index
+      end
+
+      def relative_path
+        if path.to_s.match(%r{^#{Regexp.escape Carat.root.to_s}})
+          return path.relative_path_from(Carat.root)
+        end
+        path
+      end
+
+      def generate_bin(spec, disable_extensions = false)
+        gem_dir = Pathname.new(spec.full_gem_path)
+
+        # Some gem authors put absolute paths in their gemspec
+        # and we have to save them from themselves
+        spec.files = spec.files.map do |p|
+          next if File.directory?(p)
+          begin
+            Pathname.new(p).relative_path_from(gem_dir).to_s
+          rescue ArgumentError
+            p
+          end
+        end.compact
+
+        SharedHelpers.chdir(gem_dir) do
+          installer = Path::Installer.new(spec, :env_shebang => false)
+          run_hooks(:pre_install, installer)
+          installer.build_extensions unless disable_extensions
+          run_hooks(:post_build, installer)
+          installer.generate_bin
+          run_hooks(:post_install, installer)
+        end
+      rescue Gem::InvalidSpecificationException => e
+        Carat.ui.warn "\n#{spec.name} at #{spec.full_gem_path} did not have a valid gemspec.\n" \
+                        "This prevents carat from installing bins or native extensions, but " \
+                        "that may not affect its functionality."
+
+        if !spec.extensions.empty? && !spec.email.empty?
+          Carat.ui.warn "If you need to use this package without installing it from a gem " \
+                          "repository, please contact #{spec.email} and ask them " \
+                          "to modify their .gemspec so it can work with `gem build`."
+        end
+
+        Carat.ui.warn "The validation message from Rubygems was:\n  #{e.message}"
+      end
+
+      def run_hooks(type, installer)
+        hooks_meth = "#{type}_hooks"
+        return unless Gem.respond_to?(hooks_meth)
+        Gem.send(hooks_meth).each do |hook|
+          result = hook.call(installer)
+          if result == false
+            location = " at #{$1}" if hook.inspect =~ /@(.*:\d+)/
+            message = "#{type} hook#{location} failed for #{installer.spec.full_name}"
+            raise InstallHookError, message
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/carat/source/path/installer.rb

@@ -0,0 +1,43 @@
+module Carat
+  class Source
+    class Path
+
+      class Installer < Carat::GemInstaller
+        attr_reader :spec
+
+        def initialize(spec, options = {})
+          @spec              = spec
+          @gem_dir           = Carat.rubygems.path(spec.full_gem_path)
+          @wrappers          = options[:wrappers] || true
+          @env_shebang       = options[:env_shebang] || true
+          @format_executable = options[:format_executable] || false
+          @build_args        = options[:build_args] || Carat.rubygems.build_args
+          @gem_bin_dir       = "#{Carat.rubygems.gem_dir}/bin"
+
+          if Carat.requires_sudo?
+            @tmp_dir = Carat.tmp(spec.full_name).to_s
+            @bin_dir = "#{@tmp_dir}/bin"
+          else
+            @bin_dir = @gem_bin_dir
+          end
+        end
+
+        def generate_bin
+          return if spec.executables.nil? || spec.executables.empty?
+
+          super
+
+          if Carat.requires_sudo?
+            Carat.mkdir_p @gem_bin_dir
+            spec.executables.each do |exe|
+              Carat.sudo "cp -R #{@bin_dir}/#{exe} #{@gem_bin_dir}"
+            end
+          end
+        ensure
+          Carat.rm_rf(@tmp_dir) if Carat.requires_sudo?
+        end
+      end
+
+    end
+  end
+end

data/lib/carat/source/rubygems.rb

@@ -0,0 +1,381 @@
+require 'uri'
+require 'rubygems/user_interaction'
+require 'rubygems/spec_fetcher'
+
+module Carat
+  class Source
+    class Rubygems < Source
+      # Use the API when installing less than X gems
+      API_REQUEST_LIMIT = 500
+      # Ask for X gems per API request
+      API_REQUEST_SIZE = 50
+
+      attr_reader :remotes, :caches
+
+      def initialize(options = {})
+        @options = options
+        @remotes = []
+        @dependency_names = []
+        @allow_remote = false
+        @allow_cached = false
+        @caches = [Carat.app_cache, *Carat.rubygems.gem_cache]
+
+        Array(options["remotes"] || []).reverse_each{|r| add_remote(r) }
+      end
+
+      def remote!
+        @allow_remote = true
+      end
+
+      def cached!
+        @allow_cached = true
+      end
+
+      def hash
+        @remotes.hash
+      end
+
+      def eql?(o)
+        o.is_a?(Rubygems) && o.credless_remotes == credless_remotes
+      end
+
+      alias == eql?
+
+      def include?(o)
+        o.is_a?(Rubygems) && (o.credless_remotes - credless_remotes).empty?
+      end
+
+      def can_lock?(spec)
+        spec.source.is_a?(Rubygems)
+      end
+
+      def options
+        { "remotes" => @remotes.map { |r| r.to_s } }
+      end
+
+      def self.from_lock(options)
+        new(options)
+      end
+
+      def to_lock
+        out = "GEM\n"
+        remotes.reverse_each do |remote|
+          out << "  remote: #{suppress_configured_credentials remote}\n"
+        end
+        out << "  specs:\n"
+      end
+
+      def to_s
+        remote_names = self.remotes.map { |r| r.to_s }.join(', ')
+        "rubygems repository #{remote_names}"
+      end
+      alias_method :name, :to_s
+
+      def specs
+        @specs ||= begin
+          # remote_specs usually generates a way larger Index than the other
+          # sources, and large_idx.use small_idx is way faster than
+          # small_idx.use large_idx.
+          idx = @allow_remote ? remote_specs.dup : Index.new
+          idx.use(cached_specs, :override_dupes) if @allow_cached || @allow_remote
+          idx.use(installed_specs, :override_dupes)
+          idx
+        end
+      end
+
+      def install(spec)
+        return ["Using #{version_message(spec)}", nil] if installed_specs[spec].any?
+
+        # Download the gem to get the spec, because some specs that are returned
+        # by rubygems.org are broken and wrong.
+        if spec.source_uri
+          # Check for this spec from other sources
+          uris = [spec.source_uri.without_credentials]
+          uris += source_uris_for_spec(spec)
+          uris.uniq!
+          Installer.ambiguous_gems << [spec.name, *uris] if uris.length > 1
+
+          s = Carat.rubygems.spec_from_gem(fetch_gem(spec), Carat.settings["trust-policy"])
+          spec.__swap__(s)
+        end
+
+        unless Carat.settings[:no_install]
+          path = cached_gem(spec)
+          if Carat.requires_sudo?
+            install_path = Carat.tmp(spec.full_name)
+            bin_path     = install_path.join("bin")
+          else
+            install_path = Carat.rubygems.gem_dir
+            bin_path     = Carat.system_bindir
+          end
+
+          installed_spec = nil
+          Carat.rubygems.preserve_paths do
+            installed_spec = Carat::GemInstaller.new(path,
+              :install_dir         => install_path.to_s,
+              :bin_dir             => bin_path.to_s,
+              :ignore_dependencies => true,
+              :wrappers            => true,
+              :env_shebang         => true
+            ).install
+          end
+
+          # SUDO HAX
+          if Carat.requires_sudo?
+            Carat.rubygems.repository_subdirectories.each do |name|
+              src = File.join(install_path, name, "*")
+              dst = File.join(Carat.rubygems.gem_dir, name)
+              if name == "extensions" && Dir.glob(src).any?
+                src = File.join(src, "*/*")
+                ext_src = Dir.glob(src).first
+                ext_src.gsub!(src[0..-6], '')
+                dst = File.dirname(File.join(dst, ext_src))
+              end
+              Carat.mkdir_p dst
+              Carat.sudo "cp -R #{src} #{dst}" if Dir[src].any?
+            end
+
+            spec.executables.each do |exe|
+              Carat.mkdir_p Carat.system_bindir
+              Carat.sudo "cp -R #{install_path}/bin/#{exe} #{Carat.system_bindir}/"
+            end
+          end
+          installed_spec.loaded_from = loaded_from(spec)
+        end
+        spec.loaded_from = loaded_from(spec)
+        ["Installing #{version_message(spec)}", spec.post_install_message]
+      ensure
+        Carat.rm_rf(install_path) if Carat.requires_sudo?
+      end
+
+      def cache(spec, custom_path = nil)
+        if builtin_gem?(spec)
+          cached_path = cached_built_in_gem(spec)
+        else
+          cached_path = cached_gem(spec)
+        end
+        raise GemNotFound, "Missing gem file '#{spec.full_name}.gem'." unless cached_path
+        return if File.dirname(cached_path) == Carat.app_cache.to_s
+        Carat.ui.info "  * #{File.basename(cached_path)}"
+        FileUtils.cp(cached_path, Carat.app_cache(custom_path))
+      rescue Errno::EACCES => e
+        Carat.ui.debug(e)
+        raise InstallError, e.message
+      end
+
+      def cached_built_in_gem(spec)
+        cached_path = cached_path(spec)
+        if cached_path.nil?
+          remote_spec = remote_specs.search(spec).first
+          cached_path = fetch_gem(remote_spec)
+        end
+        cached_path
+      end
+
+      def add_remote(source)
+        uri = normalize_uri(source)
+        @remotes.unshift(uri) unless @remotes.include?(uri)
+      end
+
+      def replace_remotes(other_remotes)
+        return false if other_remotes == @remotes
+
+        @remotes = []
+        other_remotes.reverse_each do |r|
+          add_remote r.to_s
+        end
+      end
+
+      def unmet_deps
+        if @allow_remote && api_fetchers.any?
+          remote_specs.unmet_dependency_names
+        else
+          []
+        end
+      end
+
+      def fetchers
+        @fetchers ||= remotes.map do |uri|
+            Carat::Fetcher.new(uri)
+        end
+      end
+
+    protected
+
+      def credless_remotes
+        remotes.map(&method(:suppress_configured_credentials))
+      end
+
+    private
+
+      def source_uris_for_spec(spec)
+        specs.search_all(spec.name).inject([]) do |uris, s|
+          uris << s.source_uri.without_credentials if s.source_uri
+          uris
+        end
+      end
+
+      def loaded_from(spec)
+        "#{Carat.rubygems.gem_dir}/specifications/#{spec.full_name}.gemspec"
+      end
+
+      def cached_gem(spec)
+        cached_gem = cached_path(spec)
+        unless cached_gem
+          raise Carat::GemNotFound, "Could not find #{spec.file_name} for installation"
+        end
+        cached_gem
+      end
+
+      def cached_path(spec)
+        possibilities = @caches.map { |p| "#{p}/#{spec.file_name}" }
+        possibilities.find { |p| File.exist?(p) }
+      end
+
+      def normalize_uri(uri)
+        uri = uri.to_s
+        uri = "#{uri}/" unless uri =~ %r'/$'
+        uri = URI(uri)
+        raise ArgumentError, "The source must be an absolute URI" unless uri.absolute?
+        uri
+      end
+
+      def suppress_configured_credentials(remote)
+        remote_nouser = remote.dup.tap { |uri| uri.user = uri.password = nil }.to_s
+        if remote.userinfo && remote.userinfo == Carat.settings[remote_nouser]
+          remote_nouser
+        else
+          remote
+        end
+      end
+
+      def installed_specs
+        @installed_specs ||= begin
+          idx = Index.new
+          have_carat = false
+          Carat.rubygems.all_specs.reverse.each do |spec|
+            next if spec.name == 'carat' && spec.version.to_s != VERSION
+            have_carat = true if spec.name == 'carat'
+            spec.source = self
+            idx << spec
+          end
+
+          # Always have carat locally
+          unless have_carat
+           # We're running carat directly from the source
+           # so, let's create a fake gemspec for it (it's a path)
+           # gemspec
+           carat = Gem::Specification.new do |s|
+             s.name     = 'carat'
+             s.version  = VERSION
+             s.platform = Gem::Platform::RUBY
+             s.source   = self
+             s.authors  = ["carat team"]
+             s.loaded_from = File.expand_path("..", __FILE__)
+           end
+           idx << carat
+          end
+          idx
+        end
+      end
+
+      def cached_specs
+        @cached_specs ||= begin
+          idx = installed_specs.dup
+
+          path = Carat.app_cache
+          Dir["#{path}/*.gem"].each do |gemfile|
+            next if gemfile =~ /^carat\-[\d\.]+?\.gem/
+            s ||= Carat.rubygems.spec_from_gem(gemfile)
+            s.source = self
+            idx << s
+          end
+        end
+
+        idx
+      end
+
+      def api_fetchers
+        fetchers.select{|f| f.use_api }
+      end
+
+      def remote_specs
+        @remote_specs ||= Index.build do |idx|
+          index_fetchers = fetchers - api_fetchers
+
+          # gather lists from non-api sites
+          index_fetchers.each do |f|
+            Carat.ui.info "Fetching source index from #{f.uri}"
+            idx.use f.specs(nil, self)
+          end
+
+          # because ensuring we have all the gems we need involves downloading
+          # the gemspecs of those gems, if the non-api sites contain more than
+          # about 100 gems, we just treat all sites as non-api for speed.
+          allow_api = idx.size < API_REQUEST_LIMIT && dependency_names.size < API_REQUEST_LIMIT
+          Carat.ui.debug "Need to query more than #{API_REQUEST_LIMIT} gems." \
+            " Downloading full index instead..." unless allow_api
+
+          if allow_api
+            api_fetchers.each do |f|
+              Carat.ui.info "Fetching gem metadata from #{f.uri}", Carat.ui.debug?
+              idx.use f.specs(dependency_names, self)
+              Carat.ui.info "" if !Carat.ui.debug? # new line now that the dots are over
+            end
+
+            # Suppose the gem Foo depends on the gem Bar.  Foo exists in Source A.  Bar has some versions that exist in both
+            # sources A and B.  At this point, the API request will have found all the versions of Bar in source A,
+            # but will not have found any versions of Bar from source B, which is a problem if the requested version
+            # of Foo specifically depends on a version of Bar that is only found in source B. This ensures that for
+            # each spec we found, we add all possible versions from all sources to the index.
+            begin
+              idxcount = idx.size
+              api_fetchers.each do |f|
+                Carat.ui.info "Fetching version metadata from #{f.uri}", Carat.ui.debug?
+                idx.use f.specs(idx.dependency_names, self), true
+                Carat.ui.info "" if !Carat.ui.debug? # new line now that the dots are over
+              end
+            end until idxcount == idx.size
+
+            if api_fetchers.any? && api_fetchers.all?{|f| f.use_api }
+              # it's possible that gems from one source depend on gems from some
+              # other source, so now we download gemspecs and iterate over those
+              # dependencies, looking for gems we don't have info on yet.
+              unmet = idx.unmet_dependency_names
+
+              # if there are any cross-site gems we missed, get them now
+              api_fetchers.each do |f|
+                Carat.ui.info "Fetching dependency metadata from #{f.uri}", Carat.ui.debug?
+                idx.use f.specs(unmet, self)
+                Carat.ui.info "" if !Carat.ui.debug? # new line now that the dots are over
+              end if unmet.any?
+            else
+              allow_api = false
+            end
+          end
+
+          if !allow_api
+            api_fetchers.each do |f|
+              Carat.ui.info "Fetching source index from #{f.uri}"
+              idx.use f.specs(nil, self)
+            end
+          end
+        end
+      end
+
+      def fetch_gem(spec)
+        return false unless spec.source_uri
+        Fetcher.download_gem_from_uri(spec, spec.source_uri.original_uri)
+      end
+
+      def builtin_gem?(spec)
+        # Ruby 2.1, where all included gems have this summary
+        return true if spec.summary =~ /is bundled with Ruby/
+
+        # Ruby 2.0, where gemspecs are stored in specifications/default/
+        spec.loaded_from && spec.loaded_from.include?("specifications/default/")
+      end
+
+    end
+  end
+end