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

# typed: strict
# frozen_string_literal: true

require "os/mac/xcode"

module OS
  module Mac
    module DevelopmentTools
      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 (located_tool = super(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 self.ld64_version
        @ld64_version ||= T.let(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, T.nilable(Version))
      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,
        }
        super.merge build_info
      end
    end
  end
end

DevelopmentTools.singleton_class.prepend(OS::Mac::DevelopmentTools)