containable 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1e298c787a7b1af3ec410a5a32d51ec1216746399332cbffc9d9001c83a6b47
-  data.tar.gz: b6f38a2cd98b8f5a4ee4b9878d24757caa79ce5bef706504123a77b69526af80
+  metadata.gz: 20cb1da4c7c47518d39bccbd70943a6de404a97d9987cc7536630dcebad2a2ab
+  data.tar.gz: bcd7fa642d1a61bcb4bab8e91253be219ec63ad4bcc1d42fc2c9bad296c6197d
 SHA512:
-  metadata.gz: a9d282dd36d6062d4b38704170c0867148e86928f5d11a9c636ce6d703d4f9edc0ece5423a460659affc7e3958cfd2e00064563a9d45a10e51a2915dff4f97de
-  data.tar.gz: 5dc4a5db810937e870d6749893626593908f58fe0eba64b60edc8a17c436a7ccb736e7a59b310ff5a8a870132a63bccb2544c840941ee0e12caf47d325b4f280
+  metadata.gz: 99044bb884dd733e8bb878490e7c4281b2b9cd9bba4d49eab8e2cabf970672f476b4ae9170eb779b6a64019c9916b39a5c2aa4fde2c138e69e585103fd987fdf
+  data.tar.gz: 803562859a58d4215b19cec5b67beaf3b02ef7983702a51e03001aec0af254c44c0c67224aaa328a84ee2fb035a5b252a7a28b57fa37c003acb2fa21cf816edd

data/README.adoc

@@ -93,7 +93,7 @@ end
 # Only a module can be a container. (TypeError)
 ----
 
-This is important since containers are only meant to hold your dependencies and nothing else. Modules are the perfect construct for this.
+This is important since containers are only meant to hold your dependencies and nothing else. Modules are perfect for this.
 
 === Registration
 
@@ -175,6 +175,19 @@ Container[:three] = 3
 
 With the above, a combination of `.register` and `.[]=` (setter) messages are used. While the latter is handy the former should be preferred for improved readability.
 
+⚠️ Due to registration being flexible to begin with, avoid nesting closures. Example:
+
+[source,ruby]
+----
+# No
+register(:sanitizer) { -> content { Sanitize.fragment content, Sanitize::Config::BASIC } }
+
+# Yes
+register :sanitizer, -> content { Sanitize.fragment content, Sanitize::Config::BASIC }
+----
+
+While the former will work, there is no benefit to nesting like this. The latter is more performant because you don't have to unwrap the nested closure to achieve the same functionality since there is nothing to achieve from the lazy resolution of the sanitize functionality.
+
 === Resolution
 
 Now that you understand how to register dependencies, we can talk about resolving them. There are two ways to resolve a dependency. Example:
@@ -504,7 +517,7 @@ You'll notice, in all of the examples, only two methods are used: `.stub!` and `
 
 _Always_ use `.stub!` to set your container up for testing. Once setup, you can add more stubs by using the `.stub` method (without the bang). So, to recap, use `.stub!` as a one-liner for setup and initial stubs then use `.stub` to add more stubs after the fact. Finally, ensure you restore (i.e. `.restore`) your container for proper cleanup after each test.
 
-‼️ Use of `.stub!`, while convenient for testing, should -- under no circmstances -- be used in production code because it is meant for testing purposes only.
+‼️ Use of `.stub!`, while convenient for testing, should -- under no circumstances -- be used in production code because it is meant for testing purposes only.
 
 == Development
 

data/containable.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "containable"
-  spec.version = "0.2.0"
+  spec.version = "0.4.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/containable"

data/lib/containable.rb

@@ -18,4 +18,6 @@ module Containable
     extend Test
     stub(**)
   end
+
+  def restore = false
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: containable
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -35,7 +35,7 @@ cert_chain:
   3n5C8/6Zh9DYTkpcwPSuIfAga6wf4nXc9m6JAw8AuMLaiWN/r/2s4zJsUHYERJEu
   gZGm4JqtuSg8pYjPeIJxS960owq+SfuC+jxqmRA54BisFCv/0VOJi7tiJVY=
   -----END CERTIFICATE-----
-date: 2024-05-31 00:00:00.000000000 Z
+date: 2024-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -94,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: A thread-safe dependency injection container.