Module: Licensed::Git

Defined in:
lib/licensed/git.rb

Class Method Summary collapse

Class Method Details

.available? ⇒ Boolean

Returns whether git commands are available

Returns:

  • (Boolean) 


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

def available?
  @git ||= Licensed::Shell.tool_available?("git")
end

.commit_date(sha) ⇒ Object

Returns the commit date for the provided SHA as a timestamp

sha - commit sha to retrieve date



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

def commit_date(sha)
  return unless git_repo? && sha
  Licensed::Shell.execute("git", "show", "-s", "-1", "--format=%ct", sha)
end

.files ⇒ Object

Returns the files in the git repository from ‘git ls-files –recurse-submodules`



42
43
44
45
46
 
# File 'lib/licensed/git.rb', line 42

def files
  return unless git_repo?
  output = Licensed::Shell.execute("git", "ls-files", "--full-name", "--recurse-submodules")
  output.lines.map(&:strip)
end

.git_repo? ⇒ Boolean

Returns true if a git repository is found, false otherwise

Returns:

  • (Boolean) 


20
21
22
 
# File 'lib/licensed/git.rb', line 20

def git_repo?
  !repository_root.to_s.empty?
end

.repository_root ⇒ Object

Returns the root of the current git repository or nil if not in a git repository.



12
13
14
15
16
17
 
# File 'lib/licensed/git.rb', line 12

def repository_root
  return unless available?
  root = Licensed::Shell.execute("git", "rev-parse", "--show-toplevel", allow_failure: true)
  return nil if root.empty?
  root
end

.version(descriptor) ⇒ Object

Returns the most recent git SHA for a file or directory or nil if SHA is not available

descriptor - file or directory to retrieve latest SHA for



28
29
30
31
 
# File 'lib/licensed/git.rb', line 28

def version(descriptor)
  return unless git_repo? && descriptor
  Licensed::Shell.execute("git", "rev-list", "-1", "HEAD", "--", descriptor, allow_failure: true)
end