# class Gem::Source::Git

A git gem for use in a gem dependencies file.

Example:

    source =
      Gem::Source::Git.new 'rake', 'git@example:rake.git', 'rake-10.1.0', false

    source.specs

### Attributes

name[R]

The name of the gem created by this git gem.

need_submodules[R]

Does this repository need submodules checked out too?

reference[R]

The commit reference used for checking out this git gem.

remote[RW]

When false the cache for this repository will not be updated.

repository[R]

The git repository this gem is sourced from.

root_dir[RW]

The directory for cache and git gem installation

### Public Class Methods

new(name, repository, reference, submodules = false) click to toggle source

Creates a new git gem source for a gems from loaded from `repository` at the given `reference`. The `name` is only used to track the repository back to a gem dependencies file, it has no real significance as a git repository may contain multiple gems. If `submodules` is true, submodules will be checked out when the gem is installed.

Calls superclass method `Gem::Source::new`

    # File lib/rubygems/source/git.rb, line 53
    def initialize(name, repository, reference, submodules = false)
      super repository

      @name            = name
      @repository      = repository
      @reference       = reference
      @need_submodules = submodules

      @remote   = true
      @root_dir = Gem.dir
      @git      = ENV['git'] || 'git'
    end

### Public Instance Methods

<=>(other) click to toggle source

    # File lib/rubygems/source/git.rb, line 66
    def <=>(other)
      case other
      when Gem::Source::Git then
        0
      when Gem::Source::Vendor,
           Gem::Source::Lock then
        -1
      when Gem::Source then
        1
      else
        nil
      end
    end

specs() click to toggle source

Loads all gemspecs in the repository

    # File lib/rubygems/source/git.rb, line 197
    def specs
      checkout

      return [] unless install_dir

      Dir.chdir install_dir do
        Dir['{,*,*/*}.gemspec'].map do |spec_file|
          directory = File.dirname spec_file
          file      = File.basename spec_file

          Dir.chdir directory do
            spec = Gem::Specification.load file
            if spec
              spec.base_dir = base_dir

              spec.extension_dir =
                File.join base_dir, 'extensions', Gem::Platform.local.to_s,
                  Gem.extension_api_version, "#{name}-#{dir_shortref}"

              spec.full_gem_path = File.dirname spec.loaded_from if spec
            end
            spec
          end
        end.compact
      end
    end