brew/Library/Homebrew/lazy_object.rb

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

require "delegate"

# An object which lazily evaluates its inner block only once a method is called on it.
class LazyObject < Delegator
  def initialize(&callable)
    super(callable)
  end

  def __getobj__(&)
    return @__getobj__ if defined?(@__getobj__)

    @__getobj__ = @__callable__.call
  end

  def __setobj__(callable)
    @__callable__ = callable
  end

  # Forward to the inner object to make lazy objects type-checkable.
  #
  # @!visibility private
  def is_a?(klass)
    # see https://sorbet.org/docs/faq#how-can-i-fix-type-errors-that-arise-from-super
    T.bind(self, T.untyped)

    __getobj__.is_a?(klass) || super
  end

  def class = __getobj__.class
  def to_s = __getobj__.to_s
end