Class: Git::Lib

Inherits:
Object
  • Object
show all
Defined in:
lib/git/lib.rb

Instance Method Summary collapse

Constructor Details

#initialize(base = nil, logger = nil) ⇒ Lib

Returns a new instance of Lib.



10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# File 'lib/git/lib.rb', line 10

def initialize(base = nil, logger = nil)
  @git_dir = nil
  @git_index_file = nil
  @git_work_dir = nil
  @path = 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
  @logger = logger
end

Instance Method Details

#add(paths = '.', options = {}) ⇒ Object

updates the repository index using the workig dorectory content

lib.add('path/to/file')
lib.add(['path/to/file1','path/to/file2'])
lib.add(:all => true)

options:

:all => true
:force => true

Parameters:

  • paths (String, Array) (defaults to: '.')

    files paths to be added to the repository

  • options (Hash) (defaults to: {})


403
404
405
406
407
408
409
410
411
412
413
414
415
416
# File 'lib/git/lib.rb', line 403

def add(paths='.',options={})
  arr_opts = []
  
  arr_opts << '--all' if options[:all]
  arr_opts << '--force' if options[:force]

  arr_opts << '--' 

  arr_opts << paths
  
  arr_opts.flatten!

  command('add', arr_opts)
end

#apply(patch_file) ⇒ Object



469
470
471
472
473
# File 'lib/git/lib.rb', line 469

def apply(patch_file)
  arr_opts = []
  arr_opts << '--' << patch_file if patch_file
  command('apply', arr_opts)
end

#apply_mail(patch_file) ⇒ Object



475
476
477
478
479
# File 'lib/git/lib.rb', line 475

def apply_mail(patch_file)
  arr_opts = []
  arr_opts << '--' << patch_file if patch_file
  command('am', arr_opts)
end

#archive(sha, file = nil, opts = {}) ⇒ Object

creates an archive file

options

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


694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
# File 'lib/git/lib.rb', line 694

def archive(sha, file = nil, opts = {})
  opts[:format] ||= 'zip'
  
  if opts[:format] == 'tgz'
    opts[:format] = 'tar' 
    opts[:add_gzip] = true
  end
  
  file ||= Tempfile.new('archive').path
  
  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]
  command('archive', arr_opts, true, (opts[:add_gzip] ? '| gzip' : '') + " > #{escape file}")
  return file
end

#branch_currentObject



241
242
243
# File 'lib/git/lib.rb', line 241

def branch_current
  branches_all.select { |b| b[1] }.first[0] rescue nil
end

#branch_delete(branch) ⇒ Object



518
519
520
# File 'lib/git/lib.rb', line 518

def branch_delete(branch)
  command('branch', ['-D', branch])
end

#branch_new(branch) ⇒ Object



514
515
516
# File 'lib/git/lib.rb', line 514

def branch_new(branch)
  command('branch', branch)
end

#branches_allObject



225
226
227
228
229
230
231
232
# File 'lib/git/lib.rb', line 225

def branches_all
  arr = []
  command_lines('branch', '-a').each do |b| 
    current = (b[0, 2] == '* ')
    arr << [b.gsub('* ', '').strip, current]
  end
  arr
end

#change_head_branch(branch_name) ⇒ Object



221
222
223
# File 'lib/git/lib.rb', line 221

def change_head_branch(branch_name)
  command('symbolic-ref', ['HEAD', "refs/heads/#{branch_name}"])
end

#checkout(branch, opts = {}) ⇒ Object



522
523
524
525
526
527
528
529
# File 'lib/git/lib.rb', line 522

def checkout(branch, opts = {})
  arr_opts = []
  arr_opts << '-f' if opts[:force]
  arr_opts << '-b' << opts[:new_branch] if opts[:new_branch]
  arr_opts << branch
  
  command('checkout', arr_opts)
end

#checkout_file(version, file) ⇒ Object



531
532
533
534
535
536
# File 'lib/git/lib.rb', line 531

def checkout_file(version, file)
  arr_opts = []
  arr_opts << version
  arr_opts << file
  command('checkout', arr_opts)
end

#checkout_index(opts = {}) ⇒ Object



677
678
679
680
681
682
683
684
685
# File 'lib/git/lib.rb', line 677

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

#clean(opts = {}) ⇒ Object



449
450
451
452
453
454
455
456
# File 'lib/git/lib.rb', line 449

def clean(opts = {})
  arr_opts = [] 
  arr_opts << '--force' if opts[:force]
  arr_opts << '-d' if opts[:d]
  arr_opts << '-x' if opts[:x]

  command('clean', arr_opts)
end

#clone(repository, name, opts = {}) ⇒ Object

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
:recursive:: after the clone is created, initialize all submodules within, using their default settings.
:depth::     the number of commits back to pull

TODO - make this work with SSH password or auth_key



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# File 'lib/git/lib.rb', line 54

def clone(repository, name, opts = {})
  @path = opts[:path] || '.'
  clone_dir = opts[:path] ? File.join(@path, name) : name
  
  arr_opts = []
  arr_opts << "--bare" if opts[:bare]
  arr_opts << "--recursive" if opts[:recursive]
  arr_opts << "-o" << opts[:remote] if opts[:remote]
  arr_opts << "--depth" << opts[:depth].to_i if opts[:depth] && opts[:depth].to_i > 0
  arr_opts << "--config" << opts[:config] if opts[:config]

  arr_opts << '--'
  arr_opts << repository
  arr_opts << clone_dir
  
  command('clone', arr_opts)
  
  opts[:bare] ? {:repository => clone_dir} : {:working_directory => clone_dir}
end

#commit(message, opts = {}) ⇒ Object



431
432
433
434
435
436
437
438
439
440
# File 'lib/git/lib.rb', line 431

def commit(message, opts = {})
  arr_opts = []
  arr_opts << "--message=#{message}" if message
  arr_opts << '--amend' << '--no-edit' if opts[:amend]
  arr_opts << '--all' if opts[:add_all] || opts[:all] 
  arr_opts << '--allow-empty' if opts[:allow_empty]
  arr_opts << "--author=#{opts[:author]}" if opts[:author]
  
  command('commit', arr_opts)
end

#commit_data(sha) ⇒ Object

returns useful array of raw commit object data



124
125
126
127
128
# File 'lib/git/lib.rb', line 124

def commit_data(sha)
  sha = sha.to_s
  cdata = command_lines('cat-file', ['commit', sha])
  process_commit_data(cdata, sha, 0)
end

#commit_tree(tree, opts = {}) ⇒ Object



660
661
662
663
664
665
666
667
668
669
670
671
# File 'lib/git/lib.rb', line 660

def commit_tree(tree, opts = {})
  opts[:message] ||= "commit tree #{tree}"
  t = Tempfile.new('commit-message')
  t.write(opts[:message])
  t.close
  
  arr_opts = []
  arr_opts << tree
  arr_opts << '-p' << opts[:parent] if opts[:parent]
  arr_opts += [opts[:parents]].map { |p| ['-p', p] }.flatten if opts[:parents]
  command('commit-tree', arr_opts, true, "< #{escape t.path}")
end

#config_get(name) ⇒ Object



336
337
338
339
340
341
342
343
344
345
346
# File 'lib/git/lib.rb', line 336

def config_get(name)
  do_get = lambda do |path|
    command('config', ['--get', name])
  end

  if @git_dir
    Dir.chdir(@git_dir, &do_get)
  else
    build_list.call
  end
end

#config_listObject



352
353
354
355
356
357
358
359
360
361
362
# File 'lib/git/lib.rb', line 352

def config_list
  build_list = lambda do |path|
    parse_config_list command_lines('config', ['--list'])
  end
  
  if @git_dir
    Dir.chdir(@git_dir, &build_list)
  else
    build_list.call
  end
end

#config_remote(name) ⇒ Object



326
327
328
329
330
331
332
333
334
# File 'lib/git/lib.rb', line 326

def config_remote(name)
  hsh = {}
  config_list.each do |key, value|
    if /remote.#{name}/.match(key)
      hsh[key.gsub("remote.#{name}.", '')] = value
    end
  end
  hsh
end

#config_set(name, value) ⇒ Object

WRITE COMMANDS ##



383
384
385
# File 'lib/git/lib.rb', line 383

def config_set(name, value)
  command('config', [name, value])
end

#conflictsObject

:yields: file, your, their



553
554
555
556
557
558
559
560
561
562
# File 'lib/git/lib.rb', line 553

def conflicts # :yields: file, your, their
  self.unmerged.each do |f|
    your = Tempfile.new("YOUR-#{File.basename(f)}").path
    command('show', ":2:#{f}", true, "> #{escape your}") 

    their = Tempfile.new("THEIR-#{File.basename(f)}").path
    command('show', ":3:#{f}", true, "> #{escape their}") 
    yield(f, your, their)
  end
end

#current_command_versionObject

returns the current version of git, as an Array of Fixnums.



715
716
717
718
719
# File 'lib/git/lib.rb', line 715

def current_command_version
  output = command('version', [], false)
  version = output[/\d+\.\d+(\.\d+)+/]
  version.split('.').collect {|i| i.to_i}
end

#diff_filesObject

compares the index and the working directory



300
301
302
# File 'lib/git/lib.rb', line 300

def diff_files
  diff_as_hash('diff-files')
end

#diff_full(obj1 = 'HEAD', obj2 = nil, opts = {}) ⇒ Object



270
271
272
273
274
275
276
277
# File 'lib/git/lib.rb', line 270

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

#diff_index(treeish) ⇒ Object

compares the index and the repository



305
306
307
# File 'lib/git/lib.rb', line 305

def diff_index(treeish)
  diff_as_hash('diff-index', treeish)
end

#diff_stats(obj1 = 'HEAD', obj2 = nil, opts = {}) ⇒ Object



279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
# File 'lib/git/lib.rb', line 279

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

#fetch(remote, opts) ⇒ Object



610
611
612
613
614
615
# File 'lib/git/lib.rb', line 610

def fetch(remote, opts)
  arr_opts = [remote]
  arr_opts << '--tags' if opts[:t] || opts[:tags]

  command('fetch', arr_opts)
end

#full_log_commits(opts = {}) ⇒ Object



87
88
89
90
91
92
93
94
95
96
97
98
# File 'lib/git/lib.rb', line 87

def full_log_commits(opts={})
  arr_opts = log_common_options(opts)

  arr_opts << '--pretty=raw'
  arr_opts << "--skip=#{opts[:skip]}" if opts[:skip]
   
  arr_opts += log_path_options(opts)
  
  full_log = command_lines('log', arr_opts, true)

  process_commit_log_data(full_log)
end

#full_tree(sha) ⇒ Object



213
214
215
# File 'lib/git/lib.rb', line 213

def full_tree(sha)
  command_lines('ls-tree', ['-r', sha])
end

#gcObject



644
645
646
# File 'lib/git/lib.rb', line 644

def gc
  command('gc', ['--prune', '--aggressive', '--auto'])
end

#global_config_get(name) ⇒ Object



348
349
350
# File 'lib/git/lib.rb', line 348

def global_config_get(name)
  command('config', ['--global', '--get', name], false)
end

#global_config_listObject



364
365
366
# File 'lib/git/lib.rb', line 364

def global_config_list
  parse_config_list command_lines('config', ['--global', '--list'], false)
end

#global_config_set(name, value) ⇒ Object



387
388
389
# File 'lib/git/lib.rb', line 387

def global_config_set(name, value)
  command('config', ['--global', name, value], false)
end

#grep(string, opts = {}) ⇒ Object

returns hash

tree-ish

[[line_no, match], [line_no, match2]]

tree-ish

[[line_no, match], [line_no, match2]]



249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
# File 'lib/git/lib.rb', line 249

def grep(string, opts = {})
  opts[:object] ||= 'HEAD'

  grep_opts = ['-n']
  grep_opts << '-i' if opts[:ignore_case]
  grep_opts << '-v' if opts[:invert_match]
  grep_opts << '-e'
  grep_opts << 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

#ignored_filesObject



321
322
323
# File 'lib/git/lib.rb', line 321

def ignored_files
  command_lines('ls-files', ['--others', '-i', '--exclude-standard'])
end

#init(opts = {}) ⇒ Object

creates or reinitializes the repository

options:

:bare
:working_directory


34
35
36
37
38
39
# File 'lib/git/lib.rb', line 34

def init(opts={})
  arr_opts = []
  arr_opts << '--bare' if opts[:bare]

  command('init', arr_opts, false)
end

#list_files(ref_dir) ⇒ Object



234
235
236
237
238
239
# File 'lib/git/lib.rb', line 234

def list_files(ref_dir)
  dir = File.join(@git_dir, 'refs', ref_dir)
  files = []
  Dir.chdir(dir) { files = Dir.glob('**/*').select { |f| File.file?(f) } } rescue nil
  files
end

#log_commits(opts = {}) ⇒ Object

READ COMMANDS ##



77
78
79
80
81
82
83
84
85
# File 'lib/git/lib.rb', line 77

def log_commits(opts={})
  arr_opts = log_common_options(opts)

  arr_opts << '--pretty=oneline'
 
  arr_opts += log_path_options(opts)

  command_lines('log', arr_opts, true).map { |l| l.split.first }
end

#ls_files(location = nil) ⇒ Object



309
310
311
312
313
314
315
316
317
318
# File 'lib/git/lib.rb', line 309

def ls_files(location=nil)
  hsh = {}
  command_lines('ls-files', ['--stage', location]).each do |line|
    (info, file) = line.split("\t")
    (mode, sha, stage) = info.split
    file = eval(file) if file =~ /^\".*\"$/ # This takes care of quoted strings returned from git
    hsh[file] = {:path => file, :mode_index => mode, :sha_index => sha, :stage => stage}
  end
  hsh
end

#ls_tree(sha) ⇒ Object



197
198
199
200
201
202
203
204
205
206
207
# File 'lib/git/lib.rb', line 197

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

#meets_required_version?Boolean

Returns:

  • (Boolean)


725
726
727
# File 'lib/git/lib.rb', line 725

def meets_required_version?
  (self.current_command_version <=>  self.required_command_version) >= 0
end

#merge(branch, message = nil) ⇒ Object



538
539
540
541
542
543
# File 'lib/git/lib.rb', line 538

def merge(branch, message = nil)      
  arr_opts = []
  arr_opts << '-m' << message if message
  arr_opts += [branch]
  command('merge', arr_opts)
end

#mv(file1, file2) ⇒ Object



209
210
211
# File 'lib/git/lib.rb', line 209

def mv(file1, file2)
  command_lines('mv', ['--', file1, file2])
end

#namerev(string) ⇒ Object



111
112
113
# File 'lib/git/lib.rb', line 111

def namerev(string)
  command('name-rev', string).split[1]
end

#object_contents(sha, &block) ⇒ Object



193
194
195
# File 'lib/git/lib.rb', line 193

def object_contents(sha, &block)
  command('cat-file', ['-p', sha], &block)
end

#object_size(sha) ⇒ Object



119
120
121
# File 'lib/git/lib.rb', line 119

def object_size(sha)
  command('cat-file', ['-s', sha]).to_i
end

#object_type(sha) ⇒ Object



115
116
117
# File 'lib/git/lib.rb', line 115

def object_type(sha)
  command('cat-file', ['-t', sha])
end

#parse_config(file) ⇒ Object



377
378
379
# File 'lib/git/lib.rb', line 377

def parse_config(file)
  parse_config_list command_lines('config', ['--list', '--file', file], false)
end

#parse_config_list(lines) ⇒ Object



368
369
370
371
372
373
374
375
# File 'lib/git/lib.rb', line 368

def parse_config_list(lines)
  hsh = {}
  lines.each do |line|
    (key, *values) = line.split('=')
    hsh[key] = values.join('=')
  end
  hsh
end

#process_commit_data(data, sha = nil, indent = 4) ⇒ Object



130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
# File 'lib/git/lib.rb', line 130

def process_commit_data(data, sha = nil, indent = 4)
  hsh = {
    'sha'     => sha,
    'message' => '',
    'parent'  => []
  }
  
  loop do
    key, *value = data.shift.split

    break if key.nil?

    if key == 'parent'
      hsh['parent'] << value.join(' ')
    else
      hsh[key] = value.join(' ')
    end
  end
  
  hsh['message'] = data.collect {|line| line[indent..-1]}.join("\n") + "\n"

  return hsh
end

#process_commit_log_data(data) ⇒ Object



154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
# File 'lib/git/lib.rb', line 154

def process_commit_log_data(data)
  in_message = false
        
  hsh_array = []       

  hsh = nil

  data.each do |line|
    line = line.chomp
    
    if line[0].nil?
      in_message = !in_message 
      next
    end
   
    if in_message
      hsh['message'] << "#{line[4..-1]}\n"
      next
    end

    key, *value = line.split
    value = value.join(' ')
    
    case key
      when 'commit'
        hsh_array << hsh if hsh
        hsh = {'sha' => value, 'message' => '', 'parent' => []}
      when 'parent'
        hsh['parent'] << value
      else
        hsh[key] = value
    end
  end
  
  hsh_array << hsh if hsh
    
  return hsh_array
end

#pull(remote = 'origin', branch = 'master') ⇒ Object



629
630
631
# File 'lib/git/lib.rb', line 629

def pull(remote='origin', branch='master')
  command('pull', [remote, branch])
end

#push(remote, branch = 'master', opts = {}) ⇒ Object



617
618
619
620
621
622
623
624
625
626
627
# File 'lib/git/lib.rb', line 617

def push(remote, branch = 'master', opts = {})
  # Small hack to keep backwards compatibility with the 'push(remote, branch, tags)' method signature.
  opts = {:tags => opts} if [true, false].include?(opts) 
  
  arr_opts = []
  arr_opts << '--force'  if opts[:force] || opts[:f]
  arr_opts << remote

  command('push', arr_opts + [branch])
  command('push', ['--tags'] + arr_opts) if opts[:tags]
end

#read_tree(treeish, opts = {}) ⇒ Object

reads a tree into the current index file



649
650
651
652
653
654
# File 'lib/git/lib.rb', line 649

def read_tree(treeish, opts = {})
  arr_opts = []
  arr_opts << "--prefix=#{opts[:prefix]}" if opts[:prefix]
  arr_opts += [treeish]
  command('read-tree', arr_opts)
end

#remote_add(name, url, opts = {}) ⇒ Object



564
565
566
567
568
569
570
571
572
573
# File 'lib/git/lib.rb', line 564

def remote_add(name, url, opts = {})
  arr_opts = ['add']
  arr_opts << '-f' if opts[:with_fetch] || opts[:fetch]
  arr_opts << '-t' << opts[:track] if opts[:track]
  arr_opts << '--'
  arr_opts << name
  arr_opts << url
  
  command('remote', arr_opts)
end

#remote_remove(name) ⇒ Object



575
576
577
# File 'lib/git/lib.rb', line 575

def remote_remove(name)
  command('remote', ['rm', name])
end

#remotesObject



579
580
581
# File 'lib/git/lib.rb', line 579

def remotes
  command_lines('remote')
end

#remove(path = '.', opts = {}) ⇒ Object



418
419
420
421
422
423
424
425
426
427
428
429
# File 'lib/git/lib.rb', line 418

def remove(path = '.', opts = {})
  arr_opts = ['-f']  # overrides the up-to-date check by default
  arr_opts << ['-r'] if opts[:recursive]
  arr_opts << '--'
  if path.is_a?(Array)
    arr_opts += path
  else
    arr_opts << path
  end

  command('rm', arr_opts)
end

#repackObject



640
641
642
# File 'lib/git/lib.rb', line 640

def repack
  command('repack', ['-a', '-d'])
end

#required_command_versionObject



721
722
723
# File 'lib/git/lib.rb', line 721

def required_command_version
  [1, 6]
end

#reset(commit, opts = {}) ⇒ Object



442
443
444
445
446
447
# File 'lib/git/lib.rb', line 442

def reset(commit, opts = {})
  arr_opts = []
  arr_opts << '--hard' if opts[:hard]
  arr_opts << commit if commit
  command('reset', arr_opts)
end

#revert(commitish, opts = {}) ⇒ Object



458
459
460
461
462
463
464
465
466
467
# File 'lib/git/lib.rb', line 458

def revert(commitish, opts = {})
  # Forcing --no-edit as default since it's not an interactive session.
  opts = {:no_edit => true}.merge(opts)
  
  arr_opts = []
  arr_opts << '--no-edit' if opts[:no_edit] 
  arr_opts << commitish

  command('revert', arr_opts)
end

#revparse(string) ⇒ Object



100
101
102
103
104
105
106
107
108
109
# File 'lib/git/lib.rb', line 100

def revparse(string)
  return string if string =~ /^[A-Fa-f0-9]{40}$/  # passing in a sha - just no-op it
  rev = ['head', 'remotes', 'tags'].map do |d|
    File.join(@git_dir, 'refs', d, string)
  end.find do |path|
    File.file?(path)
  end
  return File.read(rev).chomp if rev
  command('rev-parse', string)
end

#stash_apply(id = nil) ⇒ Object



498
499
500
501
502
503
504
# File 'lib/git/lib.rb', line 498

def stash_apply(id = nil)
  if id
    command('stash apply', [id])
  else
    command('stash apply')
  end
end

#stash_clearObject



506
507
508
# File 'lib/git/lib.rb', line 506

def stash_clear
  command('stash clear')
end

#stash_listObject



510
511
512
# File 'lib/git/lib.rb', line 510

def stash_list
  command('stash list')
end

#stash_save(message) ⇒ Object



493
494
495
496
# File 'lib/git/lib.rb', line 493

def stash_save(message)
  output = command('stash save', ['--', message])
  output =~ /HEAD is now at/
end

#stashes_allObject



481
482
483
484
485
486
487
488
489
490
491
# File 'lib/git/lib.rb', line 481

def stashes_all
  arr = []
  filename = File.join(@git_dir, 'logs/refs/stash')
  if File.exist?(filename)
    File.open(filename).each_with_index { |line, i|
      m = line.match(/:(.*)$/)
      arr << [i, m[1].strip]
    }
  end
  arr
end

#tag(name, *opts) ⇒ Object



587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
# File 'lib/git/lib.rb', line 587

def tag(name, *opts)
  target = opts[0].instance_of?(String) ? opts[0] : nil
  
  opts = opts.last.instance_of?(Hash) ? opts.last : {}

  if (opts[:a] || opts[:annotate]) && !(opts[:m] || opts[:message])
    raise  "Can not create an [:a|:annotate] tag without the precense of [:m|:message]."
  end

  arr_opts = []

  arr_opts << '-f' if opts[:force] || opts[:f]
  arr_opts << '-a' if opts[:a] || opts[:annotate]
  arr_opts << '-s' if opts[:s] || opts[:sign]
  arr_opts << '-d' if opts[:d] || opts[:delete]
  arr_opts << name
  arr_opts << target if target
  arr_opts << "-m #{opts[:m] || opts[:message]}" if opts[:m] || opts[:message]
  
  command('tag', arr_opts)
end

#tag_sha(tag_name) ⇒ Object



633
634
635
636
637
638
# File 'lib/git/lib.rb', line 633

def tag_sha(tag_name)
  head = File.join(@git_dir, 'refs', 'tags', tag_name)
  return File.read(head).chomp if File.exist?(head)
  
  command('show-ref',  ['--tags', '-s', tag_name])
end

#tagsObject



583
584
585
# File 'lib/git/lib.rb', line 583

def tags
  command_lines('tag')
end

#tree_depth(sha) ⇒ Object



217
218
219
# File 'lib/git/lib.rb', line 217

def tree_depth(sha)
  full_tree(sha).size
end

#unmergedObject



545
546
547
548
549
550
551
# File 'lib/git/lib.rb', line 545

def unmerged
  unmerged = []
  command_lines('diff', ["--cached"]).each do |line|
    unmerged << $1 if line =~ /^\* Unmerged path (.*)/
  end
  unmerged
end

#update_ref(branch, commit) ⇒ Object



673
674
675
# File 'lib/git/lib.rb', line 673

def update_ref(branch, commit)
  command('update-ref', [branch, commit])
end

#write_treeObject



656
657
658
# File 'lib/git/lib.rb', line 656

def write_tree
  command('write-tree')
end