Spec-Zone.ru › Homebrew

Модуль: SharedEnvExtension Закрытый

Расширяет:
T::Helpers
Подключает:
CompilerConstants, OS::Linux::SharedEnvExtension, OS::Mac::SharedEnvExtension, Utils::Output::Mixin
Подключён в:
EnvActivation, Stdenv, Superenv
Определён в:
extend/ENV/shared.rb,
extend/ENV/shared.rbi

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

Краткое описание констант

Константы, подключённые из CompilerConstants

CompilerConstants::COMPILERS, CompilerConstants::COMPILER_SYMBOL_MAP, CompilerConstants::GNU_GCC_REGEXP, CompilerConstants::GNU_GCC_VERSIONS

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

  • #bottle_arch ⇒ String? только для чтения закрытый
  • #build_bottle ⇒ Boolean? только для чтения закрытый

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

  • #[]=(key, value) ⇒ T.type_parameter(:U) закрытый

    Переопределение, позволяющее использовать значения PATH.

  • #append(keys, value, separator = " ") ⇒ void закрытый
  • #append_path(key, path) ⇒ void закрытый
  • #append_to_cccfg(value) ⇒ void закрытый
  • #append_to_cflags(newflags) ⇒ void закрытый
  • #append_to_rustflags(rustflags) ⇒ void закрытый
  • #cc ⇒ String? закрытый
  • #cflags ⇒ String? закрытый
  • #compiler ⇒ Symbol, String закрытый

    Выводит текущий компилятор.

  • #cppflags ⇒ String? закрытый
  • #cxx ⇒ String? закрытый
  • #cxxflags ⇒ String? закрытый
  • #effective_arch ⇒ Symbol закрытый
  • #fc ⇒ String? закрытый
  • #fcflags ⇒ String? закрытый
  • #fflags ⇒ String? закрытый
  • #fortran ⇒ void закрытый
  • #ldflags ⇒ String? закрытый
  • #make_jobs ⇒ Integer закрытый
  • #permit_arch_flags ⇒ void закрытый
  • #prepend(keys, value, separator = " ") ⇒ void закрытый
  • #prepend_create_path(key, path) ⇒ void закрытый
  • #prepend_path(key, path) ⇒ void закрытый

    Добавляет каталог в начало PATH.

  • #refurbish_args ⇒ void закрытый
  • #remove(keys, value) ⇒ void закрытый
  • #remove_cc_etc ⇒ Hash{String => String, nil} закрытый
  • #remove_from_cflags(val) ⇒ void закрытый
  • #setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil, testing_formula: false, debug_symbols: false) ⇒ 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

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

#bottle_arch ⇒ String? (только для чтения)

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

Возвращает:

  • (String, nil)


43
44
45
# File 'extend/ENV/shared.rb', line 43

def bottle_arch
  @bottle_arch
end

#build_bottle ⇒ Boolean? (только для чтения)

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

Возвращает:

  • (Boolean, nil)


40
41
42
# File 'extend/ENV/shared.rb', line 40

def build_bottle
  @build_bottle
end

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

#[]=(key, value) ⇒ T.type_parameter(:U)

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

Переопределение, позволяющее использовать значения PATH.

Параметры:

  • key (String)
  • value (T.all(T.type_parameter(:U), T.nilable(T.any(String, Pathname, PATH))))

Возвращает:

  • (T.type_parameter(:U))


11
# File 'extend/ENV/shared.rbi', line 11

def []=(key, value); end

#append(keys, value, separator = " ") ⇒ void

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

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

Параметры:

  • keys (String, Array<String>)
  • value (T.untyped)
  • separator (String) (по умолчанию: " ")


94
95
96
97
98
99
100
101
102
103
104
# File 'extend/ENV/shared.rb', line 94

def append(keys, value, separator = "")
  value = value.to_s
  Array(keys).each do |key|
    old_value = self[key]
    self[key] = if old_value.blank?
      value
    else
      old_value + separator + value
    end
  end
end

#append_path(key, path) ⇒ void

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

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

Параметры:

  • key (String)
  • path (String, Pathname)


120
121
122
# File 'extend/ENV/shared.rb', line 120

def append_path(key, path)
  self[key] = PATH.new(self[key]).append(path)
end

#append_to_cccfg(value) ⇒ void

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

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

Параметры:

  • value (String)


89
90
91
# File 'extend/ENV/shared.rb', line 89

def append_to_cccfg(value)
  append("HOMEBREW_CCCFG", value, "")
end

#append_to_cflags(newflags) ⇒ void

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

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

Параметры:

  • newflags (String)


79
80
81
# File 'extend/ENV/shared.rb', line 79

def append_to_cflags(newflags)
  append(CC_FLAG_VARS, newflags)
end

#append_to_rustflags(rustflags) ⇒ void

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

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

Параметры:

  • rustflags (String)


125
126
127
# File 'extend/ENV/shared.rb', line 125

def append_to_rustflags(rustflags)
  append("HOMEBREW_RUSTFLAGS", rustflags)
end

#cc ⇒ String?

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

Возвращает:

  • (String, nil)


168
169
170
# File 'extend/ENV/shared.rb', line 168

def cc
  self["CC"]
end

#cflags ⇒ String?

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

Возвращает:

  • (String, nil)


178
179
180
# File 'extend/ENV/shared.rb', line 178

def cflags
  self["CFLAGS"]
end

#compiler ⇒ Symbol, String

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

Выводит текущий компилятор.

# Do something only for the system clang
if ENV.compiler == :clang
  # modify CFLAGS CXXFLAGS OBJCFLAGS OBJCXXFLAGS in one go:
  ENV.append_to_cflags "-I ./missing/includes"
end

Возвращает:

  • (Symbol, String)


219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
# File 'extend/ENV/shared.rb', line 219

def compiler
  @compiler ||= T.let(nil, T.nilable(T.any(Symbol, String)))
  @compiler ||= if (cc = @cc)
    warn_about_non_apple_gcc(cc) if cc.match?(GNU_GCC_REGEXP)

    fetch_compiler(cc, "--cc")
  elsif (cc = homebrew_cc)
    warn_about_non_apple_gcc(cc) if cc.match?(GNU_GCC_REGEXP)

    compiler = fetch_compiler(cc, "HOMEBREW_CC")

    if @formula
      compilers = [compiler] + CompilerSelector.compilers
      compiler = CompilerSelector.select_for(@formula, compilers, testing_formula: @testing_formula == true)
    end

    compiler
  elsif @formula
    CompilerSelector.select_for(@formula, testing_formula: @testing_formula == true)
  else
    DevelopmentTools.default_compiler
  end
end

#cppflags ⇒ String?

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

Возвращает:

  • (String, nil)


188
189
190
# File 'extend/ENV/shared.rb', line 188

def cppflags
  self["CPPFLAGS"]
end

#cxx ⇒ String?

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

Возвращает:

  • (String, nil)


173
174
175
# File 'extend/ENV/shared.rb', line 173

def cxx
  self["CXX"]
end

#cxxflags ⇒ String?

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

Возвращает:

  • (String, nil)


183
184
185
# File 'extend/ENV/shared.rb', line 183

def cxxflags
  self["CXXFLAGS"]
end

#effective_arch ⇒ Symbol

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

Возвращает:

  • (Symbol)


295
296
297
298
299
300
301
# File 'extend/ENV/shared.rb', line 295

def effective_arch
  if @build_bottle && @bottle_arch
    @bottle_arch.to_sym
  else
    Hardware.oldest_cpu
  end
end

#fc ⇒ String?

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

Возвращает:

  • (String, nil)


198
199
200
# File 'extend/ENV/shared.rb', line 198

def fc
  self["FC"]
end

#fcflags ⇒ String?

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

Возвращает:

  • (String, nil)


208
209
210
# File 'extend/ENV/shared.rb', line 208

def fcflags
  self["FCFLAGS"]
end

#fflags ⇒ String?

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

Возвращает:

  • (String, nil)


203
204
205
# File 'extend/ENV/shared.rb', line 203

def fflags
  self["FFLAGS"]
end

#fortran ⇒ void

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

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



264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
# File 'extend/ENV/shared.rb', line 264

def fortran
  # Ignore repeated calls to this function as it will misleadingly warn about
  # building with an alternative Fortran compiler without optimization flags,
  # despite it often being the Homebrew-provided one set up in the first call.
  return if @fortran_setup_done

  @fortran_setup_done = T.let(true, T.nilable(TrueClass))

  flags = []

  if fc
    opoo "Building with an unsupported Fortran compiler"
    self["F77"] ||= fc
  else
    if (gfortran = which("gfortran", (HOMEBREW_PREFIX/"bin").to_s))
      ohai "Using Homebrew-provided Fortran compiler"
    elsif (gfortran = which("gfortran", PATH.new(ORIGINAL_PATHS)))
      ohai "Using a Fortran compiler found at #{gfortran}"
    end
    if gfortran
      puts "This may be changed by setting the `$FC` environment variable."
      self["FC"] = self["F77"] = gfortran
      flags = FC_FLAG_VARS
    end
  end

  flags.each { |key| self[key] = cflags }
  set_cpu_flags(flags)
end

#ldflags ⇒ String?

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

Возвращает:

  • (String, nil)


193
194
195
# File 'extend/ENV/shared.rb', line 193

def ldflags
  self["LDFLAGS"]
end

#make_jobs ⇒ Integer

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

Возвращает:

  • (Integer)


340
341
342
# File 'extend/ENV/shared.rb', line 340

def make_jobs
  Homebrew::EnvConfig.make_jobs.to_i
end

#permit_arch_flags ⇒ void

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

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



337
# File 'extend/ENV/shared.rb', line 337

def permit_arch_flags; end

#prepend(keys, value, separator = " ") ⇒ void

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

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

Параметры:

  • keys (String, Array<String>)
  • value (T.untyped)
  • separator (String) (по умолчанию: " ")


107
108
109
110
111
112
113
114
115
116
117
# File 'extend/ENV/shared.rb', line 107

def prepend(keys, value, separator = "")
  value = value.to_s
  Array(keys).each do |key|
    old_value = self[key]
    self[key] = if old_value.blank?
      value
    else
      value + separator + old_value
    end
  end
end

#prepend_create_path(key, path) ⇒ void

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

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

Параметры:

  • key (String)
  • path (String, Pathname)


144
145
146
147
148
# File 'extend/ENV/shared.rb', line 144

def prepend_create_path(key, path)
  path = Pathname(path)
  path.mkpath
  prepend_path key, path
end

#prepend_path(key, path) ⇒ void

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

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

Добавляет каталог в начало PATH. Формула не может найти файл pkgconfig? Укажите ей путь к нему. Для формул, доступных только в keg, это делается автоматически.

ENV.prepend_path "PKG_CONFIG_PATH", "#{Formula["glib"].opt_lib}/pkgconfig"

Добавление в начало системного пути, такого как /usr/bin, ничего не меняет, чтобы требования случайно не перекрывали заглушки superenv или каталоги bin формул.

ENV.prepend_path "PATH", which("emacs").dirname

Параметры:

  • key (String)
  • path (String, Pathname)


137
138
139
140
141
# File 'extend/ENV/shared.rb', line 137

def prepend_path(key, path)
  return if %w[/usr/bin/bin/usr/sbin/sbin].include? path.to_s

  self[key] = PATH.new(self[key]).prepend(path)
end

#refurbish_args ⇒ void

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

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



345
# File 'extend/ENV/shared.rb', line 345

def refurbish_args; end

#remove(keys, value) ⇒ void

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

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

Параметры:

  • keys (String, Array<String>)
  • value (T.untyped)


151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
# File 'extend/ENV/shared.rb', line 151

def remove(keys, value)
  return if value.nil?

  Array(keys).each do |key|
    old_value = self[key]
    next if old_value.nil?

    new_value = old_value.sub(value, "")
    if new_value.empty?
      delete(key)
    else
      self[key] = new_value
    end
  end
end

#remove_cc_etc ⇒ Hash{String => String, nil}

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

Возвращает:

  • (Hash{String => String, nil})


73
74
75
76
# File 'extend/ENV/shared.rb', line 73

def remove_cc_etc
  keys = %w[CCCXXOBJCOBJCXXLDCPPCFLAGSCXXFLAGSOBJCFLAGSOBJCXXFLAGSLDFLAGSCPPFLAGS]
  keys.to_h { |key| [key, delete(key)] }
end

#remove_from_cflags(val) ⇒ void

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

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

Параметры:

  • val (Regexp, String)


84
85
86
# File 'extend/ENV/shared.rb', line 84

def remove_from_cflags(val)
  remove CC_FLAG_VARS, val
end

#setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil, testing_formula: false, debug_symbols: false) ⇒ void

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

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

Параметры:

  • formula (Formula, nil) (по умолчанию: nil)
  • cc (String, nil) (по умолчанию: nil)
  • build_bottle (Boolean, nil) (по умолчанию: false)
  • bottle_arch (String, nil) (по умолчанию: nil)
  • testing_formula (Boolean) (по умолчанию: false)
  • debug_symbols (Boolean, nil) (по умолчанию: false)


55
56
57
58
59
60
61
62
63
64
# File 'extend/ENV/shared.rb', line 55

def setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil, testing_formula: false,
                            debug_symbols: false)
  @formula = T.let(formula, T.nilable(Formula))
  @cc = T.let(cc, T.nilable(String))
  @build_bottle = T.let(build_bottle, T.nilable(T::Boolean))
  @bottle_arch = T.let(bottle_arch, T.nilable(String))
  @debug_symbols = T.let(debug_symbols, T.nilable(T::Boolean))
  @testing_formula = T.let(testing_formula, T.nilable(T::Boolean))
  reset
end

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API