# frozen_string_literal: true

# typed: true

module Datadog
  module Core
    module Utils
      # Helper class to execute something only once such as not repeating warning logs, and instrumenting classes
      # only once.
      #
      # Thread-safe when used correctly (e.g. be careful of races when lazily initializing instances of this class).
      #
      # Note: In its current state, this class is not Ractor-safe.
      # In https://github.com/DataDog/dd-trace-rb/pull/1398#issuecomment-797378810 we have a discussion of alternatives,
      # including an alternative implementation that is Ractor-safe once spent.
      class OnlyOnce
        def initialize
          @mutex = Mutex.new
          @ran_once = false
        end

        def run
          @mutex.synchronize do
            return if @ran_once

            @ran_once = true

            yield
          end
        end

        def ran?
          @mutex.synchronize { @ran_once }
        end

        private

        def reset_ran_once_state_for_tests
          @mutex.synchronize { @ran_once = false }
        end
      end
    end
  end
end
