class Gollum::GitAccess
Controls all access to the Git objects from Gollum. Extend this class to add custom caching for special cases.
Attributes
Gets a Hash cache of commit SHAs to the Gollum::Git::Commit instance.
{"abcd123" => <Gollum::Git::Commit>}
Gets the String path to the Git repository.
Gets a Hash cache of refs to commit SHAs.
{"master" => "abc123", ...}
Gets the Gollum::Git::Repo instance for the Git repository.
Gets a Hash cache of commit SHAs to a recursive tree of blobs.
{"abc123" => [<BlobEntry>, <BlobEntry>]}
Public Class Methods
Initializes the GitAccess instance.
path - The String path to the Git repository that holds the
Gollum site.
page_file_dir - String the directory in which all page files reside
Returns this instance.
# File lib/gollum-lib/git_access.rb, line 12 def initialize(path, page_file_dir = nil, bare = nil) @page_file_dir = page_file_dir @path = path @repo = Gollum::Git::Repo.new(path, { :is_bare => bare }) clear end
Public Instance Methods
Public: Fetches the contents of the Git blob at the given SHA.
sha - A String Git SHA.
Returns the String content of the blob.
# File lib/gollum-lib/git_access.rb, line 63 def blob(sha) cat_file!(sha) end
Reads the content from the Git db at the given SHA.
sha - The String SHA.
Returns the String content of the Git object.
# File lib/gollum-lib/git_access.rb, line 179 def cat_file!(sha) @repo.git.cat_file({ :p => true }, sha) end
Public: Clears all of the cached data that this GitAccess is tracking.
Returns nothing.
# File lib/gollum-lib/git_access.rb, line 90 def clear @ref_map = {} @tree_map = {} @commit_map = {} end
Public: Looks up the Git commit using the given Git SHA or ref.
ref - A String Git SHA or ref.
Returns a Gollum::Git::Commit.
# File lib/gollum-lib/git_access.rb, line 72 def commit(ref) if sha?(ref) get_cache(:commit, ref) { commit!(ref) } else if (sha = get_cache(:ref, ref)) commit(sha) else if (cm = commit!(ref)) set_cache(:ref, ref, cm.id) set_cache(:commit, cm.id, cm) end end end end
Reads a Git commit.
sha - The string SHA of the Git commit.
Returns a Gollum::Git::Commit.
# File lib/gollum-lib/git_access.rb, line 188 def commit!(sha) @repo.commit(sha) end
Decode octal sequences (NNN) in tree path names.
path - String path name.
Returns a decoded String.
# File lib/gollum-lib/git_access.rb, line 237 def decode_git_path(path) if path[0] == ?" && path[-1] == ?" path = path[1...-1] path.gsub!(/\\d{3}/) { |m| m[1..-1].to_i(8).chr } end path.gsub!(/\[rn"\]/) { |m| eval(%Q("#{m}")) } path end
Public: Determines whether the Git repository exists on disk.
Returns true if it exists, or false.
# File lib/gollum-lib/git_access.rb, line 22 def exist? @repo.git.exist? end
Attempts to get the given data from a cache. If it doesn't exist, it'll pass the results of the yielded block to the cache for future accesses.
name - The cache prefix used in building the full cache key. key - The unique cache key suffix, usually a String Git SHA.
Yields a block to pass to the cache. Returns the cached result.
# File lib/gollum-lib/git_access.rb, line 200 def get_cache(name, key) cache = instance_variable_get("@#{name}_map") value = cache[key] if value.nil? && block_given? set_cache(name, key, value = yield) end value == :_nil ? nil : value end
Parses a line of output from the `ls-tree` command.
line - A String line of output:
"100644 blob 839c2291b30495b9a882c17d08254d3c90d8fb53 Home.md"
Returns an Array of BlobEntry instances.
# File lib/gollum-lib/git_access.rb, line 227 def parse_tree_line(line) mode, _type, sha, size, *name = line.split(/\s+/) BlobEntry.new(sha, name.join(' '), size.to_i, mode.to_i(8)) end
Public: Converts a given Git reference to a SHA, using the cache if available.
ref - a String Git reference (ex: “master”)
Returns a String, or nil if the ref isn't found.
# File lib/gollum-lib/git_access.rb, line 32 def ref_to_sha(ref) ref = ref.to_s return if ref.empty? sha = if sha?(ref) ref else get_cache(:ref, ref) { ref_to_sha!(ref) } end.to_s sha.empty? ? nil : sha end
Looks up the Git SHA for the given Git ref.
ref - String Git ref.
Returns a String SHA.
# File lib/gollum-lib/git_access.rb, line 148 def ref_to_sha!(ref) commit = @repo.commit(ref) commit ? commit.id : nil end
Public: Refreshes just the cached Git reference data. This should be called after every Gollum update.
Returns nothing.
# File lib/gollum-lib/git_access.rb, line 100 def refresh @ref_map.clear end
Writes some data to the internal cache.
name - The cache prefix used in building the full cache key. key - The unique cache key suffix, usually a String Git SHA. value - The value to write to the cache.
Returns nothing.
# File lib/gollum-lib/git_access.rb, line 216 def set_cache(name, key, value) cache = instance_variable_get("@#{name}_map") cache[key] = value || :_nil end
Checks to see if the given String is a 40 character hex SHA.
str - Possible String SHA.
Returns true if the String is a SHA, or false.
# File lib/gollum-lib/git_access.rb, line 139 def sha?(str) !!(str =~ /^[0-9a-f]{40}$/) end
Public: Gets a recursive list of Git blobs for the whole tree at the given commit.
ref - A String Git reference or Git SHA to a commit.
Returns an Array of BlobEntry instances.
# File lib/gollum-lib/git_access.rb, line 50 def tree(ref) if (sha = ref_to_sha(ref)) get_cache(:tree, sha) { tree!(sha) } else [] end end
Looks up the Git blobs for a given commit.
sha - String commit SHA.
Returns an Array of BlobEntry instances.
# File lib/gollum-lib/git_access.rb, line 158 def tree!(sha) tree = @repo.lstree(sha, { :recursive => true }) items = [] tree.each do |entry| if entry[:type] == 'blob' items << BlobEntry.new(entry[:sha], entry[:path], entry[:size], entry[:mode].to_i(8)) end end if (dir = @page_file_dir) regex = /^#{dir}\// items.select { |i| i.path =~ regex } else items end end