associate_rb 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2226fb6bd49b3122bdf396d0cf45179dc6fc4c819c45ac67df4bc359338c70e6
-  data.tar.gz: ebbd89597b05a4cfdb5c642a7b23f73ed0f09431bc327400792aa29fa727234e
+  metadata.gz: f6ddfeb80c1669afeec3e1d586af97bb94cad6f407c99b906fd971289c1adf49
+  data.tar.gz: 74906eddf3068f8084e988f3f8cf2fb6cac036e96c6a0bb2824386fff1310639
 SHA512:
-  metadata.gz: f86605f0c5dda42e23832d87f585b84ca1d0b0b6b7d93fa795ac0041bb94e9dc4ce0a49521830b5b0e15615daa9590638a8882ddb9235681b78c95e719a7aa0e
-  data.tar.gz: 3ec09d6dd17d3a343751bcb5c060ea4656144a548e83054eb30a8c4cf937408dd98785019b26e1667453f5bc68b98f5e4e73b1fd70c876a427331b39ec3f34b4
+  metadata.gz: 3456689d6ac803d68069c8326083c9911ce80915977acf418cfefa3bc5a5ba236f8f8a0d0b0755feff4845706548a143be2efade4bb0a142e006778ef45332ee
+  data.tar.gz: f1e153ce3e4cd5ba3fbf969ba36be3f66703f55c77e02c3ae376073503f71b36609fd5f2da6439c6fd928cede72e61c73e7d40fe13db8d869f6f4f0862a5a079

data/lib/extensions/array_extension.rb

@@ -1,14 +1,47 @@
 module AssociateRB
   module ArrayExtension
-    # Associates each element of the Array with the given value
-    #
+    # Returns a [Hash] containing key-value pairs provided by the block
+    # applied to elements of the given [Array].
+    # 
     # @return [Hash] the association
     # 
     # @yield [it] Executes the association block
     def associate
+      associate_to({}) { |it| yield(it) }
+    end
+
+    # Returns a [Hash] containing the elements from the given [Array] indexed
+    # by the key returned from the block applied to each element.
+    # 
+    # @return [Hash] the association
+    # 
+    # @yield [it] the value to be associated (becomes the key)
+    def associate_by
+      associate { |it| yield(it).to it }
+    end
+
+    # Returns a [Hash] where keys are elements from the given [Array] and values
+    # are produced by the block applied to each element.
+    #
+    # @return [Hash] the association
+    # 
+    # @yield [it] the value to be associated (becomes the value)
+    def associate_with
+      associate { |it| it.to yield(it) }
+    end
+
+    # Returns a [Hash] containing key-value pairs provided by the block
+    # applied to elements of the given [Array], and the elements of the
+    # [Hash] sent to the method.
+    #
+    # @param association [Hash] the Hash to merge with the new values
+    # @return [Hash] the association
+    #
+    # @yield [it] the value to be associated
+    def associate_to(association)
       raise ArgumentError, 'No block provided' unless block_given?
+      raise ArgumentError, 'Given association is not a Hash' unless association.is_a?(Hash)
 
-      association = {}
       self.each do |it|
         associated = yield(it)
         raise ArgumentError, 'Block does not return Hash' unless associated.is_a?(Hash)
@@ -18,26 +51,26 @@ module AssociateRB
       association
     end
 
-    # Associates each element of the Array by the value of the provided block
-    #
+    # Returns a [Hash] containing the elements from the given [Array] indexed
+    # by the key returned from the block applied to each element, and the
+    # elements of the [Hash] sent to the method.
+    # 
     # @return [Hash] the association
     # 
     # @yield [it] the value to be associated (becomes the key)
-    def associate_by
-      raise ArgumentError, 'No block provided' unless block_given?
-
-      self.associate { |it| yield(it).to it }
+    def associate_by_to(association)
+      associate_to(association) { |it| yield(it).to it }
     end
 
-    # Associates each element of the Array with the value of the provided block
+    # Returns a [Hash] where keys are elements from the given [Array] and values
+    # are produced by the block applied to each element, and the elements of
+    # the [Hash] sent to the method.
     #
     # @return [Hash] the association
     # 
     # @yield [it] the value to be associated (becomes the value)
-    def associate_with
-      raise ArgumentError, 'No block provided' unless block_given?
-
-      self.associate { |it| it.to yield(it) }
+    def associate_with_to(association)
+      associate_to(association) { |it| it.to yield(it) }
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: associate_rb
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Lucas Queiroz