Class: Git::Status

Inherits:

Object

• Object
• Git::Status

Includes:

Enumerable

Defined in:

lib/git/status.rb,
lib/git/status.rb,
lib/git/status.rb

Overview

The Status class gets the status of a git repository. It identifies which files have been modified, added, or deleted, including untracked files. The Status object is an Enumerable of StatusFile objects.

Defined Under Namespace

Classes: StatusFile, StatusFileFactory

Instance Method Summary

• #[](file) ⇒ Git::Status::StatusFile^?

  Return the StatusFile for the given path.

• #added ⇒ Hash{String => Git::Status::StatusFile}

  Return files added to the index that are not yet in HEAD.

• #added?(file) ⇒ Boolean

  Return true if file has been added to the index.

• #changed ⇒ Hash{String => Git::Status::StatusFile}

  Return files modified in the index and/or working tree.

• #changed?(file) ⇒ Boolean

  Return true if file has been modified in the index or working tree.

• #deleted ⇒ Hash{String => Git::Status::StatusFile}

  Return files deleted from the index.

• #deleted?(file) ⇒ Boolean

  Return true if file has been deleted from the index.

• #each {|file| ... } ⇒ Enumerator<Git::Status::StatusFile>, Array<Git::Status::StatusFile>

  Iterate over all status files.

• #initialize(base) ⇒ Status constructor

  Create a new Status for the given repository.

• #pretty ⇒ String

  Return a formatted multi-line string representation of the status.

• #untracked ⇒ Hash{String => Git::Status::StatusFile}

  Return files present in the working tree but not tracked by git.

• #untracked?(file) ⇒ Boolean

  Return true if file is not tracked by git.

Constructor Details

#initialize(base) ⇒ Status

Create a new Status for the given repository

Parameters:

• base (Git::Base, Git::Repository) —

  the git object backing this status

# File 'lib/git/status.rb', line 19

def initialize(base)
  @base = base
  # The factory returns a hash of file paths to StatusFile objects.
  @files = StatusFileFactory.new(base).construct_files
end

Instance Method Details

#[](file) ⇒ Git::Status::StatusFile^?

Return the StatusFile for the given path

Parameters:

• file (String) —

  the repository-relative path

Returns:

• (Git::Status::StatusFile, nil) —

  the status file, or nil if not found

# File 'lib/git/status.rb', line 90

def [](file) = @files[file]

#added ⇒ Hash{String => Git::Status::StatusFile}

Return files added to the index that are not yet in HEAD

Returns:

• (Hash{String => Git::Status::StatusFile}) —

  added files keyed by path

# File 'lib/git/status.rb', line 38

def added     = @added ||= select_files { |f| f.type == 'A' }

#added?(file) ⇒ Boolean

Return true if file has been added to the index

Parameters:

• file (String) —

  the repository-relative path to check

Returns:

• (Boolean) —

  true if the file has been added

# File 'lib/git/status.rb', line 66

def added?(file)     = file_in_collection?(:added, file)

#changed ⇒ Hash{String => Git::Status::StatusFile}

Return files modified in the index and/or working tree

Includes both staged modifications (index vs HEAD) and unstaged modifications (working tree vs index).

Returns:

• (Hash{String => Git::Status::StatusFile}) —

  changed files keyed by path

# File 'lib/git/status.rb', line 32

def changed   = @changed ||= select_files { |f| f.type == 'M' }

#changed?(file) ⇒ Boolean

Return true if file has been modified in the index or working tree

Parameters:

• file (String) —

  the repository-relative path to check

Returns:

• (Boolean) —

  true if the file has been modified

# File 'lib/git/status.rb', line 58

def changed?(file)   = file_in_collection?(:changed, file)

#deleted ⇒ Hash{String => Git::Status::StatusFile}

Return files deleted from the index

Returns:

• (Hash{String => Git::Status::StatusFile}) —

  deleted files keyed by path

# File 'lib/git/status.rb', line 44

def deleted   = @deleted ||= select_files { |f| f.type == 'D' }

#deleted?(file) ⇒ Boolean

Return true if file has been deleted from the index

Parameters:

• file (String) —

  the repository-relative path to check

Returns:

• (Boolean) —

  true if the file has been deleted

# File 'lib/git/status.rb', line 74

def deleted?(file)   = file_in_collection?(:deleted, file)

#each {|file| ... } ⇒ Enumerator<Git::Status::StatusFile>, Array<Git::Status::StatusFile>

Iterate over all status files

Yields:

• (file) —

  each StatusFile in the repository

Yield Parameters:

• file (Git::Status::StatusFile) —

  a single file's status

Returns:

• (Enumerator<Git::Status::StatusFile>) —

  if no block is given

• (Array<Git::Status::StatusFile>) —

  if a block is given

# File 'lib/git/status.rb', line 102

def each(&) = @files.values.each(&)

#pretty ⇒ String

Return a formatted multi-line string representation of the status

Returns:

• (String) —

  one indented block per file showing its SHA, mode, type, stage, and untracked flag

# File 'lib/git/status.rb', line 109

def pretty
  map { |file| pretty_file(file) }.join << "\n"
end

#untracked ⇒ Hash{String => Git::Status::StatusFile}

Return files present in the working tree but not tracked by git

Returns:

• (Hash{String => Git::Status::StatusFile}) —

  untracked files keyed by path

# File 'lib/git/status.rb', line 50

def untracked = @untracked ||= select_files(&:untracked)

#untracked?(file) ⇒ Boolean

Return true if file is not tracked by git

Parameters:

• file (String) —

  the repository-relative path to check

Returns:

• (Boolean) —

  true if the file is untracked

# File 'lib/git/status.rb', line 82

def untracked?(file) = file_in_collection?(:untracked, file)