Class Git::Lib
In: lib/git/lib.rb
Parent: Object

Methods

Public Class methods

[Source]

# File lib/git/lib.rb, line 15
    def initialize(base = nil)
      if base.is_a?(Git::Base)
        @git_dir = base.repo.path
        @git_index_file = base.index.path if base.index
        @git_work_dir = base.dir.path if base.dir
      elsif base.is_a?(Hash)
        @git_dir = base[:repository]
        @git_index_file = base[:index] 
        @git_work_dir = base[:working_directory]
      end
    end

Public Instance methods

[Source]

# File lib/git/lib.rb, line 296
    def add(path = '.')
      path = path.join(' ') if path.is_a?(Array)
      command('add', path)
    end

creates an archive file

options

 :format  (zip, tar)
 :prefix
 :remote
 :path

[Source]

# File lib/git/lib.rb, line 438
    def archive(sha, file = nil, opts = {})
      opts[:format] = 'zip' if !opts[:format]
      
      if opts[:format] == 'tgz'
        opts[:format] = 'tar' 
        opts[:add_gzip] = true
      end
      
      if !file
        file = Tempfile.new('archive').path
      end
      
      arr_opts = []
      arr_opts << "--format=#{opts[:format]}" if opts[:format]
      arr_opts << "--prefix=#{opts[:prefix]}" if opts[:prefix]
      arr_opts << "--remote=#{opts[:remote]}" if opts[:remote]
      arr_opts << sha
      arr_opts << opts[:path] if opts[:path]
      arr_opts << '| gzip' if opts[:add_gzip]
      arr_opts << "> #{file.to_s}"
      command('archive', arr_opts)
      return file
    end

[Source]

# File lib/git/lib.rb, line 177
    def branch_current
      branches_all.select { |b| b[1] }.first[0] rescue nil
    end

[Source]

# File lib/git/lib.rb, line 329
    def branch_delete(branch)
      command('branch', ['-d', branch])
    end

[Source]

# File lib/git/lib.rb, line 325
    def branch_new(branch)
      command('branch', branch)
    end

[Source]

# File lib/git/lib.rb, line 167
    def branches_all
      arr = []
      command_lines('branch', '-a').each do |b| 
        current = false
        current = true if b[0, 2] == '* '
        arr << [b.gsub('* ', '').strip, current]
      end
      arr
    end

[Source]

# File lib/git/lib.rb, line 333
    def checkout(branch, opts = {})
      arr_opts = []
      arr_opts << '-f' if opts[:force]
      arr_opts << branch.to_s
      
      command('checkout', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 422
    def checkout_index(opts = {})
      arr_opts = []
      arr_opts << "--prefix=#{opts[:prefix]}" if opts[:prefix]
      arr_opts << "--force" if opts[:force]
      arr_opts << "--all" if opts[:all]
      arr_opts << ('-- ' + opts[:path_limiter]) if opts[:path_limiter].is_a? String
      command('checkout-index', arr_opts)
    end

tries to clone the given repo

returns {:repository} (if bare)

        {:working_directory} otherwise

accepts options:

 :remote - name of remote (rather than 'origin')
 :bare   - no working directory

TODO - make this work with SSH password or auth_key

[Source]

# File lib/git/lib.rb, line 42
    def clone(repository, name, opts = {})
      @path = opts[:path] || '.'
      opts[:path] ? clone_dir = File.join(@path, name) : clone_dir = name
      
      arr_opts = []
      arr_opts << "--bare" if opts[:bare]
      arr_opts << "-o #{opts[:remote]}" if opts[:remote]
      arr_opts << repository
      arr_opts << clone_dir
      
      command('clone', arr_opts)
      
      opts[:bare] ? {:repository => clone_dir} : {:working_directory => clone_dir}
    end

[Source]

# File lib/git/lib.rb, line 311
    def commit(message, opts = {})
      arr_opts = ["-m '#{message}'"]
      arr_opts << '-a' if opts[:add_all]
      command('commit', arr_opts)
    end

returns useful array of raw commit object data

[Source]

# File lib/git/lib.rb, line 104
    def commit_data(sha)
      sha = sha.to_s
      cdata = command_lines('cat-file', ['commit', sha])
      process_commit_data(cdata, sha)
    end

[Source]

# File lib/git/lib.rb, line 404
    def commit_tree(tree, opts = {})
      opts[:message] = "commit tree #{tree}" if !opts[:message]
      t = Tempfile.new('commit-message') do |t|
        t.write(opts[:message])
      end
      
      arr_opts = []
      arr_opts << tree
      arr_opts << "-p #{opts[:parent]}" if opts[:parent]
      opts[:parents].each { |p| arr_opts << "-p #{p.to_s}" } if opts[:parents]
      arr_opts << "< #{t.path}"
      command('commit-tree', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 277
    def config_get(name)
      command('config', ['--get', name])
    end

[Source]

# File lib/git/lib.rb, line 281
    def config_list
      hsh = {}
      command_lines('config', ['--list']).each do |line|
        (key, value) = line.split('=')
        hsh[key] = value
      end
      hsh
    end

[Source]

# File lib/git/lib.rb, line 268
    def config_remote(name)
      hsh = {}
      command_lines('config', ['--get-regexp', "remote.#{name}"]).each do |line|
        (key, value) = line.split
        hsh[key.gsub("remote.#{name}.", '')] = value
      end
      hsh
    end

WRITE COMMANDS ##

[Source]

# File lib/git/lib.rb, line 292
    def config_set(name, value)
      command('config', [name, "'#{value}'"])
    end

compares the index and the working directory

[Source]

# File lib/git/lib.rb, line 234
    def diff_files
      hsh = {}
      command_lines('diff-files').each do |line|
        (info, file) = line.split("\t")
        (mode_src, mode_dest, sha_src, sha_dest, type) = info.split
        hsh[file] = {:path => file, :mode_file => mode_src.to_s[1, 7], :mode_index => mode_dest, 
                      :sha_file => sha_src, :sha_index => sha_dest, :type => type}
      end
      hsh
    end

[Source]

# File lib/git/lib.rb, line 204
    def diff_full(obj1 = 'HEAD', obj2 = nil, opts = {})
      diff_opts = ['-p']
      diff_opts << obj1
      diff_opts << obj2 if obj2.is_a?(String)
      diff_opts << ('-- ' + opts[:path_limiter]) if opts[:path_limiter].is_a? String
      
      command('diff', diff_opts)
    end

compares the index and the repository

[Source]

# File lib/git/lib.rb, line 246
    def diff_index(treeish)
      hsh = {}
      command_lines('diff-index', treeish).each do |line|
        (info, file) = line.split("\t")
        (mode_src, mode_dest, sha_src, sha_dest, type) = info.split
        hsh[file] = {:path => file, :mode_repo => mode_src.to_s[1, 7], :mode_index => mode_dest, 
                      :sha_repo => sha_src, :sha_index => sha_dest, :type => type}
      end
      hsh
    end

[Source]

# File lib/git/lib.rb, line 213
    def diff_stats(obj1 = 'HEAD', obj2 = nil, opts = {})
      diff_opts = ['--numstat']
      diff_opts << obj1
      diff_opts << obj2 if obj2.is_a?(String)
      diff_opts << ('-- ' + opts[:path_limiter]) if opts[:path_limiter].is_a? String
      
      hsh = {:total => {:insertions => 0, :deletions => 0, :lines => 0, :files => 0}, :files => {}}
      
      command_lines('diff', diff_opts).each do |file|
        (insertions, deletions, filename) = file.split("\t")
        hsh[:total][:insertions] += insertions.to_i
        hsh[:total][:deletions] += deletions.to_i
        hsh[:total][:lines] = (hsh[:total][:deletions] + hsh[:total][:insertions])
        hsh[:total][:files] += 1
        hsh[:files][filename] = {:insertions => insertions.to_i, :deletions => deletions.to_i}
      end
            
      hsh
    end

[Source]

# File lib/git/lib.rb, line 376
    def fetch(remote)
      command('fetch', remote.to_s)
    end

[Source]

# File lib/git/lib.rb, line 72
    def full_log_commits(opts = {})
      arr_opts = ['--pretty=raw']
      arr_opts << "-#{opts[:count]}" if opts[:count]
      arr_opts << "--since=\"#{opts[:since]}\"" if opts[:since].is_a? String
      arr_opts << "#{opts[:between][0].to_s}..#{opts[:between][1].to_s}" if (opts[:between] && opts[:between].size == 2)
      arr_opts << opts[:object] if opts[:object].is_a? String
      arr_opts << '-- ' + opts[:path_limiter] if opts[:path_limiter].is_a? String
      
      full_log = command_lines('log', arr_opts, true)
      process_commit_data(full_log)
    end

returns hash

tree-ish
= [[line_no, match], [line_no, match2]]
tree-ish
= [[line_no, match], [line_no, match2]]

[Source]

# File lib/git/lib.rb, line 185
    def grep(string, opts = {})
      opts[:object] = 'HEAD' if !opts[:object]

      grep_opts = ['-n']
      grep_opts << '-i' if opts[:ignore_case]
      grep_opts << '-v' if opts[:invert_match]
      grep_opts << "-e '#{string}'"
      grep_opts << opts[:object] if opts[:object].is_a?(String)
      grep_opts << ('-- ' + opts[:path_limiter]) if opts[:path_limiter].is_a? String
      hsh = {}
      command_lines('grep', grep_opts).each do |line|
        if m = /(.*)\:(\d+)\:(.*)/.match(line)        
          hsh[m[1]] ||= []
          hsh[m[1]] << [m[2].to_i, m[3]] 
        end
      end
      hsh
    end

[Source]

# File lib/git/lib.rb, line 27
    def init
      command('init')
    end

READ COMMANDS ##

[Source]

# File lib/git/lib.rb, line 61
    def log_commits(opts = {})
      arr_opts = ['--pretty=oneline']
      arr_opts << "-#{opts[:count]}" if opts[:count]
      arr_opts << "--since=\"#{opts[:since]}\"" if opts[:since].is_a? String
      arr_opts << "#{opts[:between][0].to_s}..#{opts[:between][1].to_s}" if (opts[:between] && opts[:between].size == 2)
      arr_opts << opts[:object] if opts[:object].is_a? String
      arr_opts << '-- ' + opts[:path_limiter] if opts[:path_limiter].is_a? String
      
      command_lines('log', arr_opts, true).map { |l| l.split.first }
    end

[Source]

# File lib/git/lib.rb, line 257
    def ls_files
      hsh = {}
      command_lines('ls-files', '--stage').each do |line|
        (info, file) = line.split("\t")
        (mode, sha, stage) = info.split
        hsh[file] = {:path => file, :mode_index => mode, :sha_index => sha, :stage => stage}
      end
      hsh
    end

[Source]

# File lib/git/lib.rb, line 157
    def ls_tree(sha)
      data = {'blob' => {}, 'tree' => {}}
      command_lines('ls-tree', sha.to_s).each do |line|
        (info, filenm) = line.split("\t")
        (mode, type, sha) = info.split
        data[type][filenm] = {:mode => mode, :sha => sha}
      end
      data
    end

[Source]

# File lib/git/lib.rb, line 341
    def merge(branch, message = nil)      
      arr_opts = []
      arr_opts << ["-m '#{message}'"] if message
      arr_opts << branch.to_a.join(' ')
      command('merge', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 91
    def namerev(string)
      command('name-rev', string).split[1]
    end

[Source]

# File lib/git/lib.rb, line 153
    def object_contents(sha)
      command('cat-file', ['-p', sha])
    end

[Source]

# File lib/git/lib.rb, line 99
    def object_size(sha)
      command('cat-file', ['-s', sha]).to_i
    end

[Source]

# File lib/git/lib.rb, line 95
    def object_type(sha)
      command('cat-file', ['-t', sha])
    end

[Source]

# File lib/git/lib.rb, line 110
    def process_commit_data(data, sha = nil)
      in_message = false
      
      if sha
        hsh = {'sha' => sha, 'message' => '', 'parent' => []}
      else
        hsh_array = []        
      end
    
      data.each do |line|
        if in_message && line != ''
          hsh['message'] += line + "\n"
        end

        if (line != '') && !in_message
          data = line.split
          key = data.shift
          value = data.join(' ')
          if key == 'commit'
            sha = value
            hsh_array << hsh if hsh
            hsh = {'sha' => sha, 'message' => '', 'parent' => []}
          end
          if key == 'parent'
            hsh[key] << value
          else
            hsh[key] = value
          end
        elsif in_message && line == ''
          in_message = false
        else
          in_message = true
        end
      end
      
      if hsh_array
        hsh_array << hsh if hsh
        hsh_array
      else
        hsh
      end
    end

[Source]

# File lib/git/lib.rb, line 380
    def push(remote, branch = 'master')
      command('push', [remote.to_s, branch.to_s])
    end

reads a tree into the current index file

[Source]

# File lib/git/lib.rb, line 393
    def read_tree(treeish, opts = {})
      arr_opts = []
      arr_opts << "--prefix=#{opts[:prefix]}" if opts[:prefix]
      arr_opts << treeish.to_a.join(' ')
      command('read-tree', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 348
    def remote_add(name, url, opts = {})
      arr_opts = ['add']
      arr_opts << '-f' if opts[:with_fetch]
      arr_opts << name
      arr_opts << url
      
      command('remote', arr_opts)
    end

this is documented as such, but seems broken for some reason i’ll try to get around it some other way later

[Source]

# File lib/git/lib.rb, line 359
    def remote_remove(name)
      command('remote', ['rm', name])
    end

[Source]

# File lib/git/lib.rb, line 363
    def remotes
      command_lines('remote')
    end

[Source]

# File lib/git/lib.rb, line 301
    def remove(path = '.', opts = {})
      path = path.join(' ') if path.is_a?(Array)

      arr_opts = ['-f']  # overrides the up-to-date check by default
      arr_opts << ['-r'] if opts[:recursive]
      arr_opts << path

      command('rm', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 388
    def repack
      command('repack', ['-a', '-d'])
    end

[Source]

# File lib/git/lib.rb, line 317
    def reset(commit, opts = {})
      arr_opts = []
      arr_opts << '--hard' if opts[:hard]
      arr_opts << commit.to_s if commit
      command('reset', arr_opts)
    end

[Source]

# File lib/git/lib.rb, line 84
    def revparse(string)
      if /\w{40}/.match(string)  # passing in a sha - just no-op it
        return string
      end
      command('rev-parse', string)
    end

[Source]

# File lib/git/lib.rb, line 371
    def tag(tag)
      command('tag', tag)
    end

[Source]

# File lib/git/lib.rb, line 384
    def tag_sha(tag_name)
      command('show-ref',  ['--tags', '-s', tag_name])
    end

[Source]

# File lib/git/lib.rb, line 367
    def tags
      command_lines('tag')
    end

[Source]

# File lib/git/lib.rb, line 418
    def update_ref(branch, commit)
      command('update-ref', [branch.to_s, commit.to_s])
    end

[Source]

# File lib/git/lib.rb, line 400
    def write_tree
      command('write-tree')
    end

[Validate]