module Git::Repository::StatusOperations

Returns ‘true` if the repository has no commits yet

@example Check whether a repository is empty

repo.empty? #=> true   # freshly initialized, no commits yet
repo.empty? #=> false  # at least one commit exists

@return [Boolean] ‘true` when the repository has no commits, `false` otherwise

@raise [Git::FailedError] if git exits with a non-zero exit status other

than when the repository has no commits

@deprecated Use {#no_commits?} instead

List all files tracked in the index

Runs ‘git ls-files –stage` under the given `location` and returns a hash keyed by file path with per-file index metadata.

@example List all indexed files in the working tree

repo.ls_files
#=> { "README.md" => { path: "README.md", mode_index: "100644",
#=>                    sha_index: "abc123...", stage: "0" }, ... }

@example List indexed files under a specific directory

repo.ls_files('lib/')
#=> { "lib/git.rb" => { path: "lib/git.rb", ... }, ... }

@param location [String, nil] the path to restrict the listing to;

defaults to `'.'` (all tracked files) when `nil`

@return [Hash{String => Hash}] a hash of index entries keyed by file path

Each value is a Hash with the following keys:
* `:path` [String] the file path
* `:mode_index` [String] the file's index mode (e.g. `"100644"`)
* `:sha_index` [String] the file's index SHA
* `:stage` [String] the merge stage (`"0"` for normal entries)

@raise [Git::FailedError] if git exits with a non-zero exit status

Returns ‘true` if the repository has no commits yet

Checks whether ‘HEAD` can be resolved to a commit object. A brand-new repository (or one created with `git checkout –orphan`) where no commit has been made yet will have no commits.

@example Check whether a repository is empty

repo.no_commits? #=> true   # freshly initialized, no commits yet
repo.no_commits? #=> false  # at least one commit exists

@return [Boolean] ‘true` when the repository has no commits, `false` otherwise

@raise [Git::FailedError] if git exits with a non-zero exit status other

than when the repository has no commits

Returns a {Git::Status} object describing the working tree and index state

Constructs a {Git::Status} for this repository by collecting information from ‘git ls-files –stage`, `git ls-files –others`, `git diff-files`, and `git diff-index HEAD` (the last only when at least one commit exists). The result identifies which files have been modified, added, deleted, or are untracked.

Emits one deprecation warning per call. The {Git::Status} it constructs is built with warnings silenced so the caller does not see a second one.

@example Check which files are modified (deprecated; use status_info)

repo.status.changed.keys      #=> ["lib/foo.rb"]
repo.status_info.changed.keys #=> ["lib/foo.rb"]

@return [Git::Status] the status of the repository

@raise [Git::FailedError] if any underlying git command exits with a

non-zero exit status

@deprecated Use {#status_info} instead

Returns a {Git::StatusInfo} describing the index and working tree state

Runs ‘git status` in porcelain v2 format with NUL-separated entries and every untracked file listed individually, then reads `core.ignoreCase` as a boolean so that the path predicates on the result compare paths the way git does in this repository. Every entry type git reports is represented, including renames, copies, and merge conflicts. Clean tracked paths are not reported by `git status`, so they are absent from the result; the deprecated {#status} listed them, and {#ls_files} still does.

@example Check which files are modified

repo.status_info.changed
#=> { "lib/foo.rb" => #<data Git::StatusFileInfo path="lib/foo.rb", ...> }

@example Check for untracked files

repo.status_info.untracked.keys #=> ["new_file.rb"]

@example Check one path

repo.status_info.changed?('lib/foo.rb') #=> true

@example Iterate over every entry

repo.status_info.files.each do |file|
  puts "#{file.index_status}#{file.worktree_status} #{file.path}"
end

@return [Git::StatusInfo] the status of the repository

@raise [Git::FailedError] if git exits with a non-zero exit status

@see git-scm.com/docs/git-status git-status

List all files in the working tree that are not tracked by git

Runs ‘git ls-files –others –exclude-standard` from the working tree root and returns an array of repository-relative file paths. Files that match `.gitignore` or other standard exclusion rules are omitted.

@example Get untracked files

repo.untracked_files #=> ["new_feature.rb", "tmp/debug.log"]

@example No untracked files

repo.untracked_files #=> []

@return [Array<String>] repository-relative paths of untracked,

non-ignored files; empty when there are none

@raise [Git::FailedError] if git exits with a non-zero exit status