brew/Library/Homebrew/settings.rb

# typed: true
# frozen_string_literal: true

module Homebrew
  # Helper functions for reading and writing settings.
  #
  # @api private
  module Settings
    extend T::Sig

    module_function

    sig { params(setting: T.any(String, Symbol), repo: Pathname).returns(T.nilable(String)) }
    def read(setting, repo: HOMEBREW_REPOSITORY)
      return unless (repo/".git/config").exist?

      repo.cd do
        Utils.popen_read("git", "config", "--get", "homebrew.#{setting}").chomp.presence
      end
    end

    sig { params(setting: T.any(String, Symbol), value: T.any(String, T::Boolean), repo: Pathname).void }
    def write(setting, value, repo: HOMEBREW_REPOSITORY)
      return unless (repo/".git/config").exist?

      repo.cd do
        safe_system "git", "config", "--replace-all", "homebrew.#{setting}", value.to_s
      end
    end

    sig { params(setting: T.any(String, Symbol), repo: Pathname).void }
    def delete(setting, repo: HOMEBREW_REPOSITORY)
      return unless (repo/".git/config").exist?
      return if read(setting, repo: repo).blank?

      repo.cd do
        safe_system "git", "config", "--unset-all", "homebrew.#{setting}"
      end
    end
  end
end