Модуль: Utils::Inreplace Приватный

Определён в:: utils/inreplace.rb

Обзор

Этот модуль является частью приватного API. Этот модуль можно использовать только в репозитории Homebrew/brew. По возможности сторонним разработчикам следует избегать использования этого модуля, так как его могут удалить или изменить без предупреждения.

Вспомогательные функции для замены текста в файлах на месте.

Определено в пространстве имён

Классы: Error

Краткое описание методов класса свернуть

.inreplace(paths, before = nil, after = nil, audit_result: true, global: true, &block) ⇒ void
Иногда перед установкой нужно кое-что изменить.

Подробное описание методов класса

.inreplace(paths, before = nil, after = nil, audit_result: true, global: true, &block) ⇒ `void`

Этот метод возвращает неопределённое значение.

Иногда перед установкой нужно кое-что изменить. Обычно мы предпочитаем использовать патч, но если в патче вам нужен prefix этой формулы, придётся прибегнуть к inreplace, потому что в патче нет доступа к переменным, определённым формулой: во встроенном патче доступна только HOMEBREW_PREFIX.

Примеры

inreplace поддерживает регулярные выражения:

inreplace "somefile.cfg", /look[for]what?/, "replace by #{bin}/tool"

inreplace поддерживает блоки:

inreplace "Makefile" do |s|
  s.gsub! "/usr/local", HOMEBREW_PREFIX.to_s
end

Параметры:

paths (Enumerable<String, Pathname>, String, Pathname)
before (Pathname, Regexp, String, nil) (по умолчанию: nil)
after (Pathname, String, Symbol, nil) (по умолчанию: nil)
audit_result (Boolean) (по умолчанию: true)
global (Boolean) (по умолчанию: true)
block (T.proc.params(s: StringInreplaceExtension).void, nil)

Вызывает исключение:

(Utils::Inreplace::Error)

См. также:

StringInreplaceExtension

# File 'utils/inreplace.rb', line 55

def self.inreplace(paths, before = nil, after = nil, audit_result: true, global: true, &block)
  paths = Array(paths)
  after &&= after.to_s
  before = before.to_s if before.is_a?(Pathname)

  errors = {}

  errors["`paths` (first) parameter"] = ["`paths` was empty"] if paths.all?(&:blank?)

  paths.each do |path|
    str = File.binread(path)
    s = StringInreplaceExtension.new(str)

    if before.nil? && after.nil?
      raise ArgumentError, "Must supply a block or before/after params" unless block

      yield s
    elsif global
      s.gsub!(T.must(before), T.must(after), audit_result:)
    else
      s.sub!(T.must(before), T.must(after), audit_result:)
    end

    errors[path] = s.errors unless s.errors.empty?

    Pathname(path).atomic_write(s.inreplace_string)
  end

  raise Utils::Inreplace::Error, errors if errors.present?
end

© 2009–present Homebrew contributors
Licensed under the BSD 2-Clause License.
https://docs.brew.sh/rubydoc/Utils/Inreplace.html