Class: Git::Commands::Branch::Copy Private

Inherits:
Git::Commands::Base show all
Defined in:
lib/git/commands/branch/copy.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Note:

arguments block audited against https://git-scm.com/docs/git-branch/2.53.0

Implements the git branch --copy command for copying branches

This command copies a branch, together with its config and reflog. If the old branch name is omitted, copies the current branch.

Examples:

Copy the current branch

copy = Git::Commands::Branch::Copy.new(execution_context)
copy.call('new-branch-name')

Copy a specific branch

copy = Git::Commands::Branch::Copy.new(execution_context)
copy.call('old-branch-name', 'new-branch-name')

Force copy (overwrite existing branch)

copy = Git::Commands::Branch::Copy.new(execution_context)
copy.call('old-branch', 'existing-branch', force: true)

See Also:

Instance Method Summary collapse

Methods inherited from Git::Commands::Base

allow_exit_status, arguments, #initialize, requires_git_version, skip_version_validation

Constructor Details

This class inherits a constructor from Git::Commands::Base

Instance Method Details

#call(new_branch, **options) ⇒ Git::CommandLineResult #call(old_branch, new_branch, **options) ⇒ Git::CommandLineResult

Execute the git branch --copy command to copy a branch

Overloads:

  • #call(new_branch, **options) ⇒ Git::CommandLineResult

    Copies the current branch to the new_branch

    Parameters:

    • new_branch (String) —

      the new name for the copied branch

    • options (Hash) —

      command options

    Options Hash (**options):

    • :force (Boolean, nil) — default: nil —

      allow copying even if new_branch already exists

      Alias: :f

    Returns:

    Raises:

    • (ArgumentError) —

      if unsupported options are provided

    • (Git::FailedError) —

      if git exits with a non-zero exit status

  • #call(old_branch, new_branch, **options) ⇒ Git::CommandLineResult

    Copies old_branch to new_branch

    Parameters:

    • old_branch (String) —

      branch to copy from

    • new_branch (String) —

      the new name for the copied branch

    • options (Hash) —

      command options

    Options Hash (**options):

    • :force (Boolean, nil) — default: nil —

      allow copying even if new_branch already exists

      Alias: :f

    Returns:

    Raises:

    • (ArgumentError) —

      if unsupported options are provided

    • (Git::FailedError) —

      if git exits with a non-zero exit status




# File 'lib/git/commands/branch/copy.rb', line 50