Exception: FormulaConflictError Private

Inherits:
RuntimeError
  • Object
show all
Defined in:
exceptions.rb

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

Raised when a formula conflicts with another one.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(formula, conflicts) ⇒ FormulaConflictError

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns a new instance of FormulaConflictError.



422
423
424
425
426
 
# File 'exceptions.rb', line 422

def initialize(formula, conflicts)
  @formula = formula
  @conflicts = conflicts
  super message
end

Instance Attribute Details

#conflicts ⇒ Object (readonly)

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning. 



420
421
422
 
# File 'exceptions.rb', line 420

def conflicts
  @conflicts
end

#formula ⇒ Object (readonly)

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning. 



420
421
422
 
# File 'exceptions.rb', line 420

def formula
  @formula
end

Instance Method Details

#conflict_message(conflict) ⇒ Object

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning. 



428
429
430
431
432
433
 
# File 'exceptions.rb', line 428

def conflict_message(conflict)
  message = []
  message << "  #{conflict.name}"
  message << ": because #{conflict.reason}" if conflict.reason
  message.join
end

#message ⇒ String

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



436
437
438
439
440
441
442
443
444
445
446
447
448
449
 
# File 'exceptions.rb', line 436

def message
  message = []
  message << "Cannot install #{formula.full_name} because conflicting formulae are installed."
  message.concat conflicts.map { |c| conflict_message(c) } << ""
  message << <<~EOS
    Please `brew unlink #{conflicts.map(&:name) * " "}` before continuing.

    Unlinking removes a formula's symlinks from #{HOMEBREW_PREFIX}. You can
    link the formula again after the install finishes. You can `--force` this
    install, but the build may fail or cause obscure side effects in the
    resulting software.
  EOS
  message.join("\n")
end