brew/Library/Homebrew/extend/os/linux/development_tools.rb

# typed: strict
# frozen_string_literal: true

module OS
  module Linux
    module DevelopmentTools
      module ClassMethods
        extend T::Helpers

        requires_ancestor { ::DevelopmentTools }

        sig { params(tool: T.any(String, Symbol)).returns(T.nilable(Pathname)) }
        def locate(tool)
          @locate ||= T.let({}, T.nilable(T::Hash[T.any(String, Symbol), Pathname]))
          @locate.fetch(tool) do |key|
            @locate[key] = if ::DevelopmentTools.needs_build_formulae? &&
                              (binutils_path = HOMEBREW_PREFIX/"opt/binutils/bin/#{tool}").executable?
              binutils_path
            elsif ::DevelopmentTools.needs_build_formulae? &&
                  (glibc_path = HOMEBREW_PREFIX/"opt/glibc/bin/#{tool}").executable?
              glibc_path
            elsif (homebrew_path = HOMEBREW_PREFIX/"bin/#{tool}").executable?
              homebrew_path
            elsif File.executable?(system_path = "/usr/bin/#{tool}")
              Pathname.new system_path
            end
          end
        end

        sig { returns(Symbol) }
        def default_compiler = :gcc

        sig { returns(T::Boolean) }
        def needs_libc_formula?
          return @needs_libc_formula unless @needs_libc_formula.nil?

          @needs_libc_formula = T.let(nil, T.nilable(T::Boolean))

          # Undocumented environment variable to make it easier to test libc
          # formula automatic installation.
          @needs_libc_formula = true if ENV["HOMEBREW_FORCE_LIBC_FORMULA"]
          @needs_libc_formula ||= OS::Linux::Glibc.below_ci_version?
        end

        sig { returns(Pathname) }
        def host_gcc_path
          # Prioritise versioned path if installed
          path = Pathname.new("/usr/bin/#{OS::LINUX_PREFERRED_GCC_COMPILER_FORMULA.tr("@", "-")}")
          return path if path.exist?

          super
        end

        sig { returns(T::Boolean) }
        def needs_compiler_formula?
          return @needs_compiler_formula unless @needs_compiler_formula.nil?

          @needs_compiler_formula = T.let(nil, T.nilable(T::Boolean))

          # Undocumented environment variable to make it easier to test compiler
          # formula automatic installation.
          @needs_compiler_formula = true if ENV["HOMEBREW_FORCE_COMPILER_FORMULA"]
          @needs_compiler_formula ||= OS::Linux::Libstdcxx.below_ci_version?
        end

        sig { returns(T::Hash[String, T.nilable(String)]) }
        def build_system_info
          super.merge({
            "glibc_version"     => OS::Linux::Glibc.version.to_s.presence,
            "oldest_cpu_family" => ::Hardware.oldest_cpu.to_s,
          })
        end
      end
    end
  end
end

DevelopmentTools.singleton_class.prepend(OS::Linux::DevelopmentTools::ClassMethods)