Class: Git::Base

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

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Base

Returns a new instance of Base.



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

def initialize(options = {})
  if working_dir = options[:working_directory]
    options[:repository] ||= File.join(working_dir, '.git')
    options[:index] ||= File.join(working_dir, '.git', 'index')
  end
  if options[:log]
    @logger = options[:log]
    @logger.info("Starting Git")
  else
    @logger = nil
  end
 
  @working_directory = options[:working_directory] ? Git::WorkingDirectory.new(options[:working_directory]) : nil
  @repository = options[:repository] ? Git::Repository.new(options[:repository]) : nil 
  @index = options[:index] ? Git::Index.new(options[:index], false) : nil
end

Class Method Details

.bare(git_dir, opts = {}) ⇒ Object

opens a bare Git Repository - no working directory options



6
7
8
 
# File 'lib/git/base.rb', line 6

def self.bare(git_dir, opts = {})
  self.new({:repository => git_dir}.merge(opts))
end

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

clones a git repository locally

repository - http://repo.or.cz/w/sinatra.git
name - sinatra

options:

:repository

 :bare
or 
 :working_directory
 :index_file



49
50
51
52
 
# File 'lib/git/base.rb', line 49

def self.clone(repository, name, opts = {})
  # run git-clone 
  self.new(Git::Lib.new.clone(repository, name, opts))
end

.init(working_dir, opts = {}) ⇒ Object

initializes a git repository

options:

:repository
:index_file



22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/git/base.rb', line 22

def self.init(working_dir, opts = {})
  opts = {
    :working_directory => working_dir,
    :repository => File.join(working_dir, '.git')
  }.merge(opts)
  
  FileUtils.mkdir_p(opts[:working_directory]) if opts[:working_directory] && !File.directory?(opts[:working_directory])
  
  # run git_init there
  Git::Lib.new(opts).init
   
  self.new(opts)
end

.open(working_dir, opts = {}) ⇒ Object

opens a new Git Project from a working directory you can specify non-standard git_dir and index file in the options



12
13
14
 
# File 'lib/git/base.rb', line 12

def self.open(working_dir, opts={})
  self.new({:working_directory => working_dir}.merge(opts))
end

Instance Method Details

#add(path = '.') ⇒ Object

adds files from the working directory to the git repository



250
251
252
 
# File 'lib/git/base.rb', line 250

def add(path = '.')
  self.lib.add(path)
end

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

adds a new remote to this repository url can be a git url or a Git::Base object if it’s a local reference

@git.add_remote('scotts_git', 'git://repo.or.cz/rubygit.git')
@git.fetch('scotts_git')
@git.merge('scotts_git/master')



343
344
345
346
347
 
# File 'lib/git/base.rb', line 343

def add_remote(name, url, opts = {})
  url = url.repo.path if url.is_a?(Git::Base)
  self.lib.remote_add(name, url, opts)
  Git::Remote.new(self, name)
end

#add_tag(tag_name) ⇒ Object

creates a new git tag (Git::Tag)



360
361
362
363
 
# File 'lib/git/base.rb', line 360

def add_tag(tag_name)
  self.lib.tag(tag_name)
  tag(tag_name)
end

#apply(file) ⇒ Object 



379
380
381
382
383
 
# File 'lib/git/base.rb', line 379

def apply(file)
  if File.exists?(file)
    self.lib.apply(file)
  end
end

#apply_mail(file) ⇒ Object 



385
386
387
 
# File 'lib/git/base.rb', line 385

def apply_mail(file)
  self.lib.apply_mail(file) if File.exists?(file)
end

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

creates an archive file of the given tree-ish



366
367
368
 
# File 'lib/git/base.rb', line 366

def archive(treeish, file = nil, opts = {})
  self.object(treeish).archive(file, opts)
end

#branch(branch_name = 'master', options = {}) ⇒ Object

returns a Git::Branch object for branch_name – addition of options noticeably to implement

--t switch on 'git branch' command



186
187
188
189
 
# File 'lib/git/base.rb', line 186

def branch(branch_name = 'master', options={})
#
  Git::Branch.new(self, branch_name, options[:track])
end

#branches ⇒ Object

returns a Git::Branches object of all the Git::Branch objects for this repo



179
180
181
 
# File 'lib/git/base.rb', line 179

def branches
  Git::Branches.new(self)
end

#cat_file(objectish) ⇒ Object 



473
474
475
 
# File 'lib/git/base.rb', line 473

def cat_file(objectish)
  self.lib.object_contents(objectish)
end

#chdir ⇒ Object

changes current working directory for a block to the git working directory

example

@git.chdir do 
  # write files
  @git.add
  @git.commit('message')
end



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

def chdir # :yields: the Git::Path
  Dir.chdir(dir.path) do
    yield dir.path
  end
end

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

checks out a branch as the new git working directory



289
290
291
 
# File 'lib/git/base.rb', line 289

def checkout(branch = 'master', opts = {})
  self.lib.checkout(branch, opts)
end

#checkout_file(version, file) ⇒ Object

checks out an old version of a file



294
295
296
 
# File 'lib/git/base.rb', line 294

def checkout_file(version, file)
  self.lib.checkout_file(version,file)
end

#checkout_index(opts = {}) ⇒ Object 



406
407
408
 
# File 'lib/git/base.rb', line 406

def checkout_index(opts = {})
  self.lib.checkout_index(opts)
end

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

commits all pending changes in the index file to the git repository

options:

:add_all
:allow_empty
:author



276
277
278
 
# File 'lib/git/base.rb', line 276

def commit(message, opts = {})
  self.lib.commit(message, opts)
end

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

commits all pending changes in the index file to the git repository, but automatically adds all modified files without having to explicitly calling @git.add() on them.



283
284
285
286
 
# File 'lib/git/base.rb', line 283

def commit_all(message, opts = {})
  opts = {:add_all => true}.merge(opts)
  self.lib.commit(message, opts)
end

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



418
419
420
 
# File 'lib/git/base.rb', line 418

def commit_tree(tree = nil, opts = {})
  Git::Object::Commit.new(self, self.lib.commit_tree(tree, opts))
end

#config(name = nil, value = nil) ⇒ Object

g.config(‘user.name’, ‘Scott Chacon’) # sets value g.config(‘user.email’, ‘[email protected]’) # sets value g.config(‘user.name’) # returns ‘Scott Chacon’ g.config # returns whole config hash



129
130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/git/base.rb', line 129

def config(name = nil, value = nil)
  if(name && value)
    # set value
    lib.config_set(name, value)
  elsif (name)
    # return value
    lib.config_get(name)
  else
    # return hash
    lib.config_list
  end
end

#current_branch ⇒ Object

returns the name of the branch the working directory is currently on



478
479
480
 
# File 'lib/git/base.rb', line 478

def current_branch
  self.lib.branch_current
end

#diff(objectish = 'HEAD', obj2 = nil) ⇒ Object

returns a Git::Diff object



245
246
247
 
# File 'lib/git/base.rb', line 245

def diff(objectish = 'HEAD', obj2 = nil)
  Git::Diff.new(self, objectish, obj2)
end

#dir ⇒ Object

returns a reference to the working directory

@git.dir.path
@git.dir.writeable?



75
76
77
 
# File 'lib/git/base.rb', line 75

def dir
  @working_directory
end

#each_conflict(&block) ⇒ Object

iterates over the files which are unmerged



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

def each_conflict(&block) # :yields: file, your_version, their_version
  self.lib.conflicts(&block)
end

#fetch(remote = 'origin') ⇒ Object

fetches changes from a remote branch - this does not modify the working directory, it just gets the changes from the remote if there are any



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

def fetch(remote = 'origin')
  self.lib.fetch(remote)
end

#gblob(objectish) ⇒ Object 



164
165
166
 
# File 'lib/git/base.rb', line 164

def gblob(objectish)
  Git::Object.new(self, objectish, 'blob')
end

#gc ⇒ Object 



375
376
377
 
# File 'lib/git/base.rb', line 375

def gc
  self.lib.gc
end

#gcommit(objectish) ⇒ Object 



160
161
162
 
# File 'lib/git/base.rb', line 160

def gcommit(objectish)
  Git::Object.new(self, objectish, 'commit')
end

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

will run a grep for ‘string’ on the HEAD of the git repository

to be more surgical in your grep, you can call grep() off a specific git object. for example:

@git.object("v2.3").grep('TODO')

in any case, it returns a hash of arrays of the type:

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

so you might use it like this:

@git.grep("TODO").each do |sha, arr|
  puts "in blob #{sha}:"
  arr.each do |match|
    puts "\t line #{match[0]}: '#{match[1]}'"
  end
end



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

def grep(string, path_limiter = nil, opts = {})
  self.object('HEAD').grep(string, path_limiter, opts)
end

#gtree(objectish) ⇒ Object 



156
157
158
 
# File 'lib/git/base.rb', line 156

def gtree(objectish)
  Git::Object.new(self, objectish, 'tree')
end

#index ⇒ Object

returns reference to the git index file



86
87
88
 
# File 'lib/git/base.rb', line 86

def index
  @index
end

#is_branch?(branch) ⇒ Boolean

returns true if the branch exists

Returns:

  • (Boolean) 


204
205
206
207
 
# File 'lib/git/base.rb', line 204

def is_branch?(branch)
  branch_names = self.branches.map {|b| b.name}
  branch_names.include?(branch)
end

#is_local_branch?(branch) ⇒ Boolean

returns true if the branch exists locally

Returns:

  • (Boolean) 


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

def is_local_branch?(branch)
  branch_names = self.branches.local.map {|b| b.name}
  branch_names.include?(branch)
end

#is_remote_branch?(branch) ⇒ Boolean

returns true if the branch exists remotely

Returns:

  • (Boolean) 


198
199
200
201
 
# File 'lib/git/base.rb', line 198

def is_remote_branch?(branch)
  branch_names = self.branches.local.map {|b| b.name}
  branch_names.include?(branch)
end

#lib ⇒ Object

this is a convenience method for accessing the class that wraps all the actual ‘git’ forked system calls. At some point I hope to replace the Git::Lib class with one that uses native methods or libgit C bindings



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

def lib
  @lib ||= Git::Lib.new(self, @logger)
end

#log(count = 30) ⇒ Object

returns a Git::Log object with count commits



169
170
171
 
# File 'lib/git/base.rb', line 169

def log(count = 30)
  Git::Log.new(self, count)
end

#ls_files(location = nil) ⇒ Object 



432
433
434
 
# File 'lib/git/base.rb', line 432

def ls_files(location=nil)
  self.lib.ls_files(location)
end

#ls_tree(objectish, options = {}) ⇒ Object

– addition of options noticeably to implement

a recursive ls_tree



468
469
470
471
 
# File 'lib/git/base.rb', line 468

def ls_tree(objectish, options={})
#
  self.lib.ls_tree(objectish, options)
end

#merge(branch, message = 'merge') ⇒ Object

merges one or more branches into the current working branch

you can specify more than one branch to merge by passing an array of branches



316
317
318
 
# File 'lib/git/base.rb', line 316

def merge(branch, message = 'merge')
  self.lib.merge(branch, message)
end

#object(objectish) ⇒ Object

returns a Git::Object of the appropriate type you can also call @git.gtree(‘tree’), but that’s just for readability. If you call @git.gtree(‘HEAD’) it will still return a Git::Object::Commit object.

on the objectish and determine the type of the object and return an appropriate object for that type



152
153
154
 
# File 'lib/git/base.rb', line 152

def object(objectish)
  Git::Object.new(self, objectish)
end

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

fetches a branch from a remote and merges it into the current working branch



326
327
328
329
 
# File 'lib/git/base.rb', line 326

def pull(remote = 'origin', branch = 'master', message = 'origin pull')
  fetch(remote)
  merge(branch, message)
end

#push(remote = 'origin', branch = 'master', tags = false) ⇒ Object

pushes changes to a remote repository - easiest if this is a cloned repository, otherwise you may have to run something like this first to setup the push parameters:

@git.config('remote.remote-name.push', 'refs/heads/master:refs/heads/master')



309
310
311
 
# File 'lib/git/base.rb', line 309

def push(remote = 'origin', branch = 'master', tags = false)
  self.lib.push(remote, branch, tags)
end

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



410
411
412
 
# File 'lib/git/base.rb', line 410

def read_tree(treeish, opts = {})
  self.lib.read_tree(treeish, opts)
end

#remote(remote_name = 'origin') ⇒ Object

returns a Git::Remote object



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

def remote(remote_name = 'origin')
  Git::Remote.new(self, remote_name)
end

#remotes ⇒ Object

returns an array of Git:Remote objects



332
333
334
 
# File 'lib/git/base.rb', line 332

def remotes
  self.lib.remotes.map { |r| Git::Remote.new(self, r) }
end

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

removes file(s) from the git repository



255
256
257
 
# File 'lib/git/base.rb', line 255

def remove(path = '.', opts = {})
  self.lib.remove(path, opts)
end

#repack ⇒ Object

repacks the repository



371
372
373
 
# File 'lib/git/base.rb', line 371

def repack
  self.lib.repack
end

#repo ⇒ Object

returns reference to the git repository directory

@git.dir.path



81
82
83
 
# File 'lib/git/base.rb', line 81

def repo
  @repository
end

#repo_size ⇒ Object

returns the repository size in bytes



117
118
119
120
121
122
123
 
# File 'lib/git/base.rb', line 117

def repo_size
  size = 0
  Dir.chdir(repo.path) do
    (size, dot) = `du -s`.chomp.split
  end
  size.to_i
end

#reset(commitish = nil, opts = {}) ⇒ Object

resets the working directory to the provided commitish



260
261
262
 
# File 'lib/git/base.rb', line 260

def reset(commitish = nil, opts = {})
  self.lib.reset(commitish, opts)
end

#reset_hard(commitish = nil, opts = {}) ⇒ Object

resets the working directory to the commitish with ‘–hard’



265
266
267
268
 
# File 'lib/git/base.rb', line 265

def reset_hard(commitish = nil, opts = {})
  opts = {:hard => true}.merge(opts)
  self.lib.reset(commitish, opts)
end

#revparse(objectish) ⇒ Object

runs git rev-parse to convert the objectish to a full sha

@git.revparse("HEAD^^")
@git.revparse('v2.4^{tree}')
@git.revparse('v2.4:/doc/index.html')



462
463
464
 
# File 'lib/git/base.rb', line 462

def revparse(objectish)
  self.lib.revparse(objectish)
end

#set_index(index_file, check = true) ⇒ Object 



96
97
98
99
 
# File 'lib/git/base.rb', line 96

def set_index(index_file, check = true)
  @lib = nil
  @index = Git::Index.new(index_file.to_s, check)
end

#set_working(work_dir, check = true) ⇒ Object 



91
92
93
94
 
# File 'lib/git/base.rb', line 91

def set_working(work_dir, check = true)
  @lib = nil
  @working_directory = Git::WorkingDirectory.new(work_dir.to_s, check)
end

#status ⇒ Object

returns a Git::Status object



174
175
176
 
# File 'lib/git/base.rb', line 174

def status
  Git::Status.new(self)
end

#tag(tag_name) ⇒ Object

returns a Git::Tag object



355
356
357
 
# File 'lib/git/base.rb', line 355

def tag(tag_name)
  Git::Object.new(self, tag_name, 'tag', true)
end

#tags ⇒ Object

returns an array of all Git::Tag objects for this repository



350
351
352
 
# File 'lib/git/base.rb', line 350

def tags
  self.lib.tags.map { |r| tag(r) }
end

#update_ref(branch, commit) ⇒ Object 



427
428
429
 
# File 'lib/git/base.rb', line 427

def update_ref(branch, commit)
  branch(branch).update_ref(commit)
end

#with_index(new_index) ⇒ Object

LOWER LEVEL INDEX OPERATIONS ##



391
392
393
394
395
396
397
 
# File 'lib/git/base.rb', line 391

def with_index(new_index) # :yields: new_index
  old_index = @index
  set_index(new_index, false)
  return_value = yield @index
  set_index(old_index)
  return_value
end

#with_temp_index(&blk) ⇒ Object 



399
400
401
402
403
404
 
# File 'lib/git/base.rb', line 399

def with_temp_index &blk
  tempfile = Tempfile.new('temp-index')
  temp_path = tempfile.path
  tempfile.unlink
  with_index(temp_path, &blk)
end

#with_temp_working(&blk) ⇒ Object 



447
448
449
450
451
452
453
 
# File 'lib/git/base.rb', line 447

def with_temp_working &blk
  tempfile = Tempfile.new("temp-workdir")
  temp_dir = tempfile.path
  tempfile.unlink
  Dir.mkdir(temp_dir, 0700)
  with_working(temp_dir, &blk)
end

#with_working(work_dir) ⇒ Object

:yields: the Git::WorkingDirectory



436
437
438
439
440
441
442
443
444
445
 
# File 'lib/git/base.rb', line 436

def with_working(work_dir) # :yields: the Git::WorkingDirectory
  return_value = false
  old_working = @working_directory
  set_working(work_dir) 
  Dir.chdir work_dir do
    return_value = yield @working_directory
  end
  set_working(old_working)
  return_value
end

#write_and_commit_tree(opts = {}) ⇒ Object 



422
423
424
425
 
# File 'lib/git/base.rb', line 422

def write_and_commit_tree(opts = {})
  tree = write_tree
  commit_tree(tree, opts)
end

#write_tree ⇒ Object 



414
415
416
 
# File 'lib/git/base.rb', line 414

def write_tree
  self.lib.write_tree
end