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

# typed: true # rubocop:disable Sorbet/StrictSigil
# frozen_string_literal: true

require "os/mac/xcode"

class DevelopmentTools
  class << self
    alias generic_locate locate
    undef installed?, default_compiler, curl_handles_most_https_certificates?,
          subversion_handles_most_https_certificates?

    sig { params(tool: T.any(String, Symbol)).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(Version) }
    def ld64_version
      @ld64_version ||= begin
        json = Utils.popen_read("/usr/bin/ld", "-version_details")
        if $CHILD_STATUS.success?
          Version.parse(JSON.parse(json)["version"])
        else
          Version::NULL
        end
      end
    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