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

# typed: true
# frozen_string_literal: true

require "os/mac/xcode"

# @private
class DevelopmentTools
  class << self
    extend T::Sig

    alias generic_locate locate
    undef installed?, default_compiler, curl_handles_most_https_certificates?,
          ca_file_handles_most_https_certificates?, subversion_handles_most_https_certificates?

    sig { params(tool: String).returns(T.nilable(Pathname)) }
    def locate(tool)
      (@locate ||= {}).fetch(tool) do |key|
        @locate[key] = if (located_tool = generic_locate(tool))
          located_tool
        else
          path = Utils.popen_read("/usr/bin/xcrun", "-no-cache", "-find", tool, err: :close).chomp
          Pathname.new(path) if File.executable?(path)
        end
      end
    end

    # Checks if the user has any developer tools installed, either via Xcode
    # or the CLT. Convenient for guarding against formula builds when building
    # is impossible.
    sig { returns(T::Boolean) }
    def installed?
      MacOS::Xcode.installed? || MacOS::CLT.installed?
    end

    sig { returns(Symbol) }
    def default_compiler
      :clang
    end

    sig { returns(T::Boolean) }
    def ca_file_handles_most_https_certificates?
      # The system CA file is too old for some modern HTTPS certificates on
      # older macOS versions.
      ENV["HOMEBREW_SYSTEM_CA_CERTIFICATES_TOO_OLD"].nil?
    end

    sig { returns(T::Boolean) }
    def curl_handles_most_https_certificates?
      # The system Curl is too old for some modern HTTPS certificates on
      # older macOS versions.
      ENV["HOMEBREW_SYSTEM_CURL_TOO_OLD"].nil?
    end

    sig { returns(T::Boolean) }
    def subversion_handles_most_https_certificates?
      # The system Subversion is too old for some HTTPS certificates on
      # older macOS versions.
      MacOS.version >= :sierra
    end

    sig { returns(String) }
    def installation_instructions
      MacOS::CLT.installation_instructions
    end

    sig { returns(String) }
    def custom_installation_instructions
      <<~EOS
        Install GNU's GCC:
          brew install gcc
      EOS
    end

    sig { returns(T::Hash[String, T.nilable(String)]) }
    def build_system_info
      build_info = {
        "xcode"          => MacOS::Xcode.version.to_s.presence,
        "clt"            => MacOS::CLT.version.to_s.presence,
        "preferred_perl" => MacOS.preferred_perl_version,
      }
      generic_build_system_info.merge build_info
    end
  end
end