Класс: Build Приватный

Наследует:

Object
Build

Включает:: Utils::Output::Mixin

Определён в:: build.rb

Обзор

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

Сборка формулы.

Краткое описание атрибутов экземпляра свернуть

#args ⇒ Homebrew::Cmd::InstallCmd::Args только для чтения приватный
#deps ⇒ Array<Dependency> только для чтения приватный
#formula ⇒ Formula только для чтения приватный
#reqs ⇒ Requirements только для чтения приватный

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

#detect_stdlibs ⇒ Array<Symbol> приватный
#effective_build_options_for(dependent) ⇒ BuildOptions приватный
#expand_deps ⇒ Array<Dependency> приватный
#expand_reqs ⇒ Requirements приватный
#fixopt(formula) ⇒ void приватный
#initialize(formula, options, args:) ⇒ void конструктор приватный
#install ⇒ void приватный
#normalize_pod2man_outputs!(formula) ⇒ void приватный

Методы, включённые из Utils::Output::Mixin

#issue_reporting_message, #odebug, #odeprecated, #odie, #odisabled, #ofail, #oh1, #oh1_title, #ohai, #ohai_title, #onoe, #opoo, #opoo_outside_github_actions, #opoo_without_github_actions_annotation, #pretty_deprecated, #pretty_disabled, #pretty_duration, #pretty_install_status, #pretty_installed, #pretty_uninstalled, #pretty_upgradable, #pretty_warning

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

#initialize(formula, options, args:) ⇒ `void`

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

Параметры:

formula (Formula)
options (Options)
args (Homebrew::Cmd::InstallCmd::Args)

# File 'build.rb', line 39

def initialize(formula, options, args:)
  @formula = formula
  @formula.build = BuildOptions.new(options, formula.options)
  @args = args
  @deps = T.let([], T::Array[Dependency])
  @reqs = T.let(Requirements.new, Requirements)

  return if args.ignore_dependencies?

  @deps = expand_deps
  @reqs = expand_reqs
end

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

#args ⇒ `Homebrew::Cmd::InstallCmd::Args` (только для чтения)

Возвращает:

(Homebrew::Cmd::InstallCmd::Args)



36
37
38

# File 'build.rb', line 36

def args
  @args
end

#deps ⇒ `Array<Dependency>` (только для чтения)

Возвращает:

(Array<Dependency>)



30
31
32

# File 'build.rb', line 30

def deps
  @deps
end

#formula ⇒ `Formula` (только для чтения)

Возвращает:

(Formula)



27
28
29

# File 'build.rb', line 27

def formula
  @formula
end

#reqs ⇒ `Requirements` (только для чтения)

Возвращает:

(Requirements)



33
34
35

# File 'build.rb', line 33

def reqs
  @reqs
end

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

#detect_stdlibs ⇒ `Array<Symbol>`

Возвращает:

(Array<Symbol>)

# File 'build.rb', line 225

def detect_stdlibs
  keg = Keg.new(formula.prefix)

  # The stdlib recorded in the install receipt is used during dependency
  # compatibility checks, so we only care about the stdlib that libraries
  # link against.
  keg.detect_cxx_stdlibs(skip_executables: true)
end

#effective_build_options_for(dependent) ⇒ `BuildOptions`

Параметры:

dependent (Formula)

Возвращает:

(BuildOptions)

# File 'build.rb', line 53

def effective_build_options_for(dependent)
  args  = dependent.build.used_options
  args |= Tab.for_formula(dependent).used_options
  BuildOptions.new(args, dependent.options)
end

#expand_deps ⇒ `Array<Dependency>`

Возвращает:

(Array<Dependency>)

# File 'build.rb', line 71

def expand_deps
  formula.recursive_dependencies do |dependent, dep|
    build = effective_build_options_for(T.cast(dependent, Formula))
    if dep.prune_from_option?(build) ||
       dep.prune_if_build_and_not_dependent?(T.cast(dependent, Formula), formula) ||
       (dep.test? && !dep.build?) || dep.implicit?
      next Dependable::PRUNE
    elsif dep.build?
      next Dependable::KEEP_BUT_PRUNE_RECURSIVE_DEPS
    end
  end
end

#expand_reqs ⇒ `Requirements`

Возвращает:

(Requirements)

# File 'build.rb', line 60

def expand_reqs
  formula.recursive_requirements do |dependent, req|
    dependent = T.cast(dependent, Formula)
    build = effective_build_options_for(dependent)
    if req.prune_from_option?(build) || req.prune_if_build_and_not_dependent?(dependent, formula) || req.test?
      next Dependable::PRUNE
    end
  end
end

#fixopt(formula) ⇒ `void`

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

Параметры:

formula (Formula)

# File 'build.rb', line 235

def fixopt(formula)
  path = if formula.linked_keg.directory? && formula.linked_keg.symlink?
    formula.linked_keg.resolved_path
  elsif formula.prefix.directory?
    formula.prefix
  elsif (children = formula.rack.children.presence) && children.size == 1 &&
        (first_child = children.first.presence) && first_child.directory?
    first_child
  else
    raise
  end
  Keg.new(path).optlink(verbose: args.verbose?)
rescue
  raise "#{formula.opt_prefix} not present or broken\nPlease reinstall #{formula.full_name}. Sorry :("
end

#install ⇒ `void`

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

# File 'build.rb', line 85

def install
  formula_deps = deps.map(&:to_formula)
  keg_only_deps = formula_deps.select(&:keg_only?)
  run_time_deps = deps.reject(&:build?).map(&:to_formula)

  formula_deps.each do |dep|
    fixopt(dep) unless dep.opt_prefix.directory?
  end

  ENV.activate_extensions!(env: args.env)

  if superenv?(args.env)
    superenv = ENV
    superenv.keg_only_deps = keg_only_deps
    superenv.deps = formula_deps
    superenv.run_time_deps = run_time_deps
    ENV.setup_build_environment(
      formula:,
      cc:            args.cc,
      build_bottle:  args.build_bottle?,
      bottle_arch:   args.bottle_arch,
      debug_symbols: args.debug_symbols?,
    )
    reqs.each do |req|
      req.modify_build_environment(
        env: args.env, cc: args.cc, build_bottle: args.build_bottle?, bottle_arch: args.bottle_arch,
      )
    end
  else
    ENV.setup_build_environment(
      formula:,
      cc:            args.cc,
      build_bottle:  args.build_bottle?,
      bottle_arch:   args.bottle_arch,
      debug_symbols: args.debug_symbols?,
    )
    reqs.each do |req|
      req.modify_build_environment(
        env: args.env, cc: args.cc, build_bottle: args.build_bottle?, bottle_arch: args.bottle_arch,
      )
    end

    keg_only_deps.each do |dep|
      ENV.prepend_path "PATH", dep.opt_bin.to_s
      ENV.prepend_path "PKG_CONFIG_PATH", "#{dep.opt_lib}/pkgconfig"
      ENV.prepend_path "PKG_CONFIG_PATH", "#{dep.opt_share}/pkgconfig"
      ENV.prepend_path "ACLOCAL_PATH", "#{dep.opt_share}/aclocal"
      ENV.prepend_path "CMAKE_PREFIX_PATH", dep.opt_prefix.to_s
      ENV.prepend "LDFLAGS", "-L#{dep.opt_lib}" if dep.opt_lib.directory?
      ENV.prepend "CPPFLAGS", "-I#{dep.opt_include}" if dep.opt_include.directory?
    end
  end

  new_env = {
    "TMPDIR" => HOMEBREW_TEMP.to_s,
    "TEMP"   => HOMEBREW_TEMP.to_s,
    "TMP"    => HOMEBREW_TEMP.to_s,
  }

  with_env(new_env) do
    if args.debug? && !Homebrew::EnvConfig.disable_debrew?
      require "debrew"
      formula.extend(Debrew::Formula)
    end

    formula.update_head_version

    formula.brew(
      fetch:         false,
      keep_tmp:      args.keep_tmp?,
      debug_symbols: args.debug_symbols?,
      interactive:   args.interactive?,
    ) do
      with_env(
        # For head builds, HOMEBREW_FORMULA_PREFIX should include the commit,
        # which is not known until after the formula has been staged.
        HOMEBREW_FORMULA_PREFIX:    formula.prefix,
        # https://reproducible-builds.org/docs/build-path/
        HOMEBREW_FORMULA_BUILDPATH: formula.buildpath,
        # https://reproducible-builds.org/docs/source-date-epoch/
        SOURCE_DATE_EPOCH:          formula.source_modified_time.to_i.to_s,
        # Avoid make getting confused about timestamps.
        # https://github.com/Homebrew/homebrew-core/pull/87470
        TZ:                         "UTC0",
      ) do
        if args.git?
          formula.selective_patch(is_data: false)
          system "git", "init"
          system "git", "add", "-A"
          formula.selective_patch(is_data: true)
        else
          formula.patch
        end

        if args.interactive?
          ohai "Entering interactive mode..."
          puts <<~EOS
            Type `exit` to return and finalize the installation.
            Install to this prefix: #{formula.prefix}          EOS

          if args.git?
            puts <<~EOS
              This directory is now a Git repository. Make your changes and then use:
                git diff | pbcopy
              to copy the diff to the clipboard.
            EOS
          end

          interactive_shell(formula)
        else
          formula.prefix.mkpath
          formula.logs.mkpath

          (formula.logs/"00.options.out").write \
            "#{formula.full_name}#{formula.build.used_options.sort.join("")}".strip

          Pathname.activate_extensions!
          formula.install

          stdlibs = detect_stdlibs
          tab = Tab.create(formula, ENV.compiler, stdlibs.first)
          tab.write

          # Find and link metafiles
          formula.prefix.install_metafiles T.must(formula.buildpath)
          if formula.libexec.exist?
            require "metafiles"
            no_metafiles = formula.prefix.children.none? { |p| p.file? && Metafiles.copy?(p.basename.to_s) }
            formula.prefix.install_metafiles formula.libexec if no_metafiles
          end

          normalize_pod2man_outputs!(formula)
        end
      end
    end
  end
end

#normalize_pod2man_outputs!(formula) ⇒ `void`

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

Параметры:

formula (Formula)

# File 'build.rb', line 252

def normalize_pod2man_outputs!(formula)
  keg = Keg.new(formula.prefix)
  keg.normalize_pod2man_outputs!
end

Класс: Build Приватный

Обзор

Краткое описание атрибутов экземпляра свернуть

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

Методы, включённые из Utils::Output::Mixin

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

#initialize(formula, options, args:) ⇒ void

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

#args ⇒ Homebrew::Cmd::InstallCmd::Args (только для чтения)

#deps ⇒ Array<Dependency> (только для чтения)

#formula ⇒ Formula (только для чтения)

#reqs ⇒ Requirements (только для чтения)

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

#detect_stdlibs ⇒ Array<Symbol>

#effective_build_options_for(dependent) ⇒ BuildOptions

#expand_deps ⇒ Array<Dependency>

#expand_reqs ⇒ Requirements

#fixopt(formula) ⇒ void

#install ⇒ void

#normalize_pod2man_outputs!(formula) ⇒ void

#initialize(formula, options, args:) ⇒ `void`

#args ⇒ `Homebrew::Cmd::InstallCmd::Args` (только для чтения)

#deps ⇒ `Array<Dependency>` (только для чтения)

#formula ⇒ `Formula` (только для чтения)

#reqs ⇒ `Requirements` (только для чтения)

#detect_stdlibs ⇒ `Array<Symbol>`

#effective_build_options_for(dependent) ⇒ `BuildOptions`

#expand_deps ⇒ `Array<Dependency>`

#expand_reqs ⇒ `Requirements`

#fixopt(formula) ⇒ `void`

#install ⇒ `void`

#normalize_pod2man_outputs!(formula) ⇒ `void`