EXAMPLES

   1 require 'git'
   2
   3 # needs read permission only
   4
   5 g = Git.open (working_dir = '.')
   6         (git_dir, index_file)
   7
   8 g.index
   9 g.index.readable?
  10 g.index.writable?
  11 g.repo
  12 g.dir
  13
  14 g.log   # returns array of Git::Commit objects
  15 g.log.since('2 weeks ago')
  16 g.log.between('v2.5', 'v2.6')
  17 g.log.each {|l| puts l.sha }
  18 g.gblob('v2.5:Makefile').log.since('2 weeks ago')
  19
  20 g.object('HEAD^').to_s  # git show / git rev-parse
  21 g.object('HEAD^').contents
  22 g.object('v2.5:Makefile').size
  23 g.object('v2.5:Makefile').sha
  24
  25 g.gtree(treeish)
  26 g.gblob(treeish)
  27 g.gcommit(treeish)
  28
  29 g.revparse('v2.5:Makefile')
  30
  31 g.branches # returns Git::Branch objects
  32 g.branches.local
  33 g.branches.remote
  34 g.branches[:master].commit
  35 g.branches['origin/master'].commit
  36
  37 g.grep('hello')  # implies HEAD
  38 g.blob('v2.5:Makefile').grep('hello')
  39 g.tag('v2.5').grep('hello', 'docs/')
  40
  41 g.diff(commit1, commit2).size
  42 g.diff(commit1, commit2).stats
  43 g.gtree('v2.5').diff('v2.6').insertions
  44 g.diff('gitsearch1', 'v2.5').path('lib/')
  45 g.diff('gitsearch1', @git.gtree('v2.5'))
  46 g.diff('gitsearch1', 'v2.5').path('docs/').patch
  47 g.gtree('v2.5').diff('v2.6').patch
  48
  49 g.gtree('v2.5').diff('v2.6').each do |file_diff|
  50   puts file_diff.path
  51   puts file_diff.patch
  52   puts file_diff.blob(:src).contents
  53 end
  54
  55 g.config('user.name')  # returns 'Scott Chacon'
  56 g.config # returns whole config hash
  57
  58 ***** IMPLEMENTED *****
  59
  60 g.tag # returns array of Git::Tag objects
  61
  62
  63
  64
  65 # needs write permission
  66
  67
  68 g = Git.init
  69   Git.init('project')
  70   Git.init('/home/schacon/proj',
  71                 { :git_dir => '/opt/git/proj.git',
  72                   :index_file => '/tmp/index'} )
  73
  74 g = Git.clone(URI, :name => 'name', :path => '/tmp/checkout'
  75         (git_dir, index_file)
  76
  77 g.config('user.name', 'Scott Chacon')
  78 g.config('user.email', 'email@email.com')
  79
  80 g.add('.')
  81 g.add([file1, file2])
  82
  83 g.commit('message')
  84 g.commit_all('message')
  85
  86
  87 ***** IMPLEMENTED *****
  88
  89 g.remove('file.txt').and_file
  90
  91 g.reset # defaults to HEAD
  92 g.reset_hard(Git::Commit)
  93
  94 g.branch('new_branch')
  95 g.branch('new_branch').delete
  96
  97 g.checkout('new_branch')
  98 g.checkout('new_branch', :create_branch => true)
  99 g.checkout_b('new_branch')
 100
 101 g.merge('new_branch')
 102 g.merge(Git::Branch)
 103 g.merge(Git::Branch, Git::Branch)
 104
 105 g.fetch
 106 g.fetch(Git::Repo)
 107
 108 g.pull
 109 g.pull(Git::Repo, Git::Branch) # fetch and a merge
 110
 111 g.tag('tag_name') # returns Git::Tag
 112
 113 g.pack