Module: SharedEnvExtension Private
- Includes:
- CompilerConstants
- Included in:
- EnvActivation, Stdenv, Superenv
- Defined in:
- extend/os/mac/extend/ENV/shared.rb,
extend/os/linux/extend/ENV/shared.rb,
extend/ENV/shared.rb,
extend/ENV/shared.rbi
This module is part of a private API. This module may only be used in the Homebrew/brew repository. Third parties should avoid using this module if possible, as it may be removed or changed without warning.
Constant Summary
Constants included from CompilerConstants
CompilerConstants::COMPILERS, CompilerConstants::COMPILER_SYMBOL_MAP, CompilerConstants::GNU_GCC_REGEXP, CompilerConstants::GNU_GCC_VERSIONS
Instance Method Summary collapse
-
#[]=(key, value) ⇒ T.type_parameter(:U)
private
Overload to allow
PATH
values. - #append(keys, value, separator = " ") ⇒ void private
- #append_path(key, path) ⇒ void private
- #append_to_cccfg(value) ⇒ void private
- #append_to_cflags(newflags) ⇒ void private
- #cc ⇒ String? private
- #cflags ⇒ String? private
-
#compiler ⇒ Symbol, String
private
Outputs the current compiler.
- #cppflags ⇒ String? private
- #cxx ⇒ String? private
- #cxxflags ⇒ String? private
- #effective_arch ⇒ Symbol private
- #fc ⇒ String? private
- #fcflags ⇒ String? private
- #fflags ⇒ String? private
- #fortran ⇒ void private
- #ldflags ⇒ String? private
- #make_jobs ⇒ Integer private
- #no_fixup_chains_support? ⇒ Boolean private
- #no_weak_imports_support? ⇒ Boolean private
- #permit_arch_flags ⇒ void private
- #prepend(keys, value, separator = " ") ⇒ void private
- #prepend_create_path(key, path) ⇒ void private
-
#prepend_path(key, path) ⇒ void
private
Prepends a directory to
PATH
. - #refurbish_args ⇒ void private
- #remove(keys, value) ⇒ void private
- #remove_cc_etc ⇒ Hash{String => String, nil} private
- #remove_from_cflags(val) ⇒ void private
- #setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil, testing_formula: false, debug_symbols: false) ⇒ void (also: #generic_shared_setup_build_environment) private
Instance Method Details
#[]=(key, value) ⇒ T.type_parameter(:U)
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.
Overload to allow PATH
values.
13 |
# File 'extend/ENV/shared.rbi', line 13 def []=(key, value); end |
#append(keys, value, separator = " ") ⇒ void
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.
This method returns an undefined value.
85 86 87 88 89 90 91 92 93 94 95 |
# File 'extend/ENV/shared.rb', line 85 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
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.
This method returns an undefined value.
111 112 113 |
# File 'extend/ENV/shared.rb', line 111 def append_path(key, path) self[key] = PATH.new(self[key]).append(path) end |
#append_to_cccfg(value) ⇒ void
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.
This method returns an undefined value.
80 81 82 |
# File 'extend/ENV/shared.rb', line 80 def append_to_cccfg(value) append("HOMEBREW_CCCFG", value, "") end |
#append_to_cflags(newflags) ⇒ void
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.
This method returns an undefined value.
70 71 72 |
# File 'extend/ENV/shared.rb', line 70 def append_to_cflags(newflags) append(CC_FLAG_VARS, newflags) end |
#cc ⇒ 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.
154 155 156 |
# File 'extend/ENV/shared.rb', line 154 def cc self["CC"] end |
#cflags ⇒ 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.
164 165 166 |
# File 'extend/ENV/shared.rb', line 164 def cflags self["CFLAGS"] end |
#compiler ⇒ Symbol, 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.
Outputs the current compiler.
# 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
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 |
# File 'extend/ENV/shared.rb', line 205 def compiler @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) end compiler elsif @formula CompilerSelector.select_for(@formula) else DevelopmentTools.default_compiler end end |
#cppflags ⇒ 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.
174 175 176 |
# File 'extend/ENV/shared.rb', line 174 def cppflags self["CPPFLAGS"] end |
#cxx ⇒ 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.
159 160 161 |
# File 'extend/ENV/shared.rb', line 159 def cxx self["CXX"] end |
#cxxflags ⇒ 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.
169 170 171 |
# File 'extend/ENV/shared.rb', line 169 def cxxflags self["CXXFLAGS"] end |
#effective_arch ⇒ Symbol
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.
5 6 7 8 9 10 11 12 13 |
# File 'extend/os/linux/extend/ENV/shared.rb', line 5 def effective_arch if @build_bottle && @bottle_arch @bottle_arch.to_sym elsif @build_bottle Hardware.oldest_cpu else :native end end |
#fc ⇒ 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.
184 185 186 |
# File 'extend/ENV/shared.rb', line 184 def fc self["FC"] end |
#fcflags ⇒ 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.
194 195 196 |
# File 'extend/ENV/shared.rb', line 194 def fcflags self["FCFLAGS"] end |
#fflags ⇒ 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.
189 190 191 |
# File 'extend/ENV/shared.rb', line 189 def fflags self["FFLAGS"] end |
#fortran ⇒ void
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.
This method returns an undefined value.
244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 |
# File 'extend/ENV/shared.rb', line 244 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 = true flags = [] if fc ohai "Building with an alternative Fortran compiler", "This is unsupported." 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?
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.
179 180 181 |
# File 'extend/ENV/shared.rb', line 179 def ldflags self["LDFLAGS"] end |
#make_jobs ⇒ Integer
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.
320 321 322 |
# File 'extend/ENV/shared.rb', line 320 def make_jobs Homebrew::EnvConfig.make_jobs.to_i end |
#no_fixup_chains_support? ⇒ Boolean
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.
36 37 38 39 40 41 |
# File 'extend/os/mac/extend/ENV/shared.rb', line 36 def no_fixup_chains_support? # This is supported starting Xcode 13, which ships ld64-711. # https://developer.apple.com/documentation/xcode-release-notes/xcode-13-release-notes # https://en.wikipedia.org/wiki/Xcode#Xcode_11.0_-_14.x_(since_SwiftUI_framework)_2 DevelopmentTools.ld64_version >= 711 end |
#no_weak_imports_support? ⇒ Boolean
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.
26 27 28 29 30 31 32 33 |
# File 'extend/os/mac/extend/ENV/shared.rb', line 26 def no_weak_imports_support? return false if compiler != :clang return false if !MacOS::Xcode.version.null? && MacOS::Xcode.version < "8.0" return false if !MacOS::CLT.version.null? && MacOS::CLT.version < "8.0" true end |
#permit_arch_flags ⇒ void
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.
This method returns an undefined value.
317 |
# File 'extend/ENV/shared.rb', line 317 def permit_arch_flags; end |
#prepend(keys, value, separator = " ") ⇒ void
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.
This method returns an undefined value.
98 99 100 101 102 103 104 105 106 107 108 |
# File 'extend/ENV/shared.rb', line 98 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
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.
This method returns an undefined value.
130 131 132 133 134 |
# File 'extend/ENV/shared.rb', line 130 def prepend_create_path(key, path) path = Pathname(path) path.mkpath prepend_path key, path end |
#prepend_path(key, path) ⇒ void
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.
This method returns an undefined value.
Prepends a directory to PATH
.
Is the formula struggling to find the pkgconfig file? Point it to it.
This is done automatically for keg-only formulae.
ENV.prepend_path "PKG_CONFIG_PATH", "#{Formula["glib"].opt_lib}/pkgconfig"
Prepending a system path such as /usr/bin is a no-op so that requirements
don't accidentally override superenv shims or formulae's bin
directories.
ENV.prepend_path "PATH", which("emacs").dirname
123 124 125 126 127 |
# File 'extend/ENV/shared.rb', line 123 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
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.
This method returns an undefined value.
325 |
# File 'extend/ENV/shared.rb', line 325 def refurbish_args; end |
#remove(keys, value) ⇒ void
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.
This method returns an undefined value.
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 |
# File 'extend/ENV/shared.rb', line 137 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}
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.
64 65 66 67 |
# File 'extend/ENV/shared.rb', line 64 def remove_cc_etc keys = %w[CC CXX OBJC OBJCXX LD CPP CFLAGS CXXFLAGS OBJCFLAGS OBJCXXFLAGS LDFLAGS CPPFLAGS] keys.to_h { |key| [key, delete(key)] } end |
#remove_from_cflags(val) ⇒ void
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.
This method returns an undefined value.
75 76 77 |
# File 'extend/ENV/shared.rb', line 75 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 Also known as:
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.
This method returns an undefined value.
15 16 17 18 19 20 21 22 23 |
# File 'extend/os/mac/extend/ENV/shared.rb', line 15 def setup_build_environment(formula: nil, cc: nil, build_bottle: false, bottle_arch: nil, testing_formula: false, debug_symbols: false) generic_shared_setup_build_environment(formula:, cc:, build_bottle:, bottle_arch:, testing_formula:, debug_symbols:) # Normalise the system Perl version used, where multiple may be available self["VERSIONER_PERL_VERSION"] = MacOS.preferred_perl_version end |