lib/tanshuku.rb in tanshuku-0.0.13 vs lib/tanshuku.rb in tanshuku-0.0.14

@@ -7,26 +7,35 @@
 # Tanshuku's namespace.
 module Tanshuku
   # Returns a configuration object for Tanshuku.
   #
   # @return [Tanshuku::Configuration]
+  #
+  # @note
+  #   Mutating a {Tanshuku::Configuration} object is thread-<em><b>unsafe</b></em>. It is recommended to use
+  #   {Tanshuku.configure} for configuration.
   def self.config
-    Mutex.new.synchronize do
-      @config ||= Configuration.new
-    end
+    # Disable this cop but use `Tanshuku::Configuration#configure` for thread-safety.
+    # rubocop:disable ThreadSafety/InstanceVariableInClassMethod
+    @config ||= Configuration.new
+    # rubocop:enable ThreadSafety/InstanceVariableInClassMethod
   end
 
   # Configures Tanshuku.
   #
   # @yieldparam config [Tanshuku::Configuration] A configuration object that is yielded.
   # @yieldreturn [void]
   #
   # @return [void]
   #
+  # @note
+  #   This method is thread-safe. When mutating a {Tanshuku::Configuration} object for configuration, it is recommended
+  #   to use this method.
+  #
   # @example
   #   Tanshuku.configure do |config|
   #     config.default_url_options = { host: "localhost", protocol: :https }
   #   end
-  def self.configure
-    yield config
+  def self.configure(&)
+    config.configure(&)
   end
 end