delight 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a893e732517c88b60d7e1ad947e9d7e227ae2d8adc6ee6bbe173a5afafe1d50c
-  data.tar.gz: f54fa816caa3b625bdf01d083da3ebb5c66ec5a59e5124f0f7a94eeb0b388f68
+  metadata.gz: 4f8b296bea6885bf28e8099087e72cab52ef75a843e1c390a0d68b9b8e83798a
+  data.tar.gz: b1eac6efa6ba0c1aae4a279185de6fea118b9c796306326171cd0e7bea477c19
 SHA512:
-  metadata.gz: 3c3d820838cfcbb82641284df669a5a12d5dfd6fcb5e9a4f22a1625eee9c1852e499268b8166ae27a70b2d2a8dfca207be3d19061b6f630e4548512f0bddffdb
-  data.tar.gz: 646d778fb10679baf72bfe2c21aaa24f29e11e2f2b4fef3d91ee52e0013276d2bca924bf2919eb70f321478ceb904c784ca50c90c1345c1a00883a811a36b4c5
+  metadata.gz: a5ecfa1a5774c61d58e19bc0801be073a6899c916111bcdb754c53a5ba13d80dec48eba01bb6c68f0249215cc7d2e91a7e6a444e0546d121f8269e602b1d3dd1
+  data.tar.gz: 3a7c646c237a93f747bcd7beff8e457245619f118bd51452bb5771d5e3ab8b151f837ee905c56cfc1a1e876d58a485cd2d46557d3bb5c22460864c6d61637291

data/lib/delight/delight_enumerator/detect_bang.rb

@@ -0,0 +1,16 @@
+module Delight
+  module DelightEnumerator
+    module DetectBang
+      include CollectionMatcher
+
+      # This method finds required element or raises error if the element is
+      # not found. This is similar to sole, but returns first element (so
+      # duplicates are possible) but doesn't need to traverse whole Array.
+
+      def detect!(error_message: nil, &)
+        default_error_message = "No element found"
+        detect(&) || raise(Error::ElementNotFound, error_message || default_error_message)
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/detect_by.rb

@@ -0,0 +1,19 @@
+module Delight
+  module DelightEnumerator
+    module DetectBy
+      include CollectionMatcher
+
+      def detect_by(**)
+        detect do |element|
+          collection_matcher(element, **)
+        end
+      end
+
+      def detect_by!(**)
+        detect! do |element|
+          collection_matcher(element, **)
+        end
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/detect_by_key.rb

@@ -0,0 +1,19 @@
+module Delight
+  module DelightEnumerator
+    module DetectByKey
+      include HashCollectionMatcher
+
+      def detect_by_key(**)
+        detect do |element|
+          hash_collection_matcher(element, **)
+        end
+      end
+
+      def detect_by_key!(**)
+        detect! do |element|
+          hash_collection_matcher(element, **)
+        end
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/error/element_not_found.rb

@@ -0,0 +1,8 @@
+module Delight
+  module DelightEnumerator
+    module Error
+      class ElementNotFound < StandardError
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/error/sole_item_expected.rb

@@ -0,0 +1,8 @@
+module Delight
+  module DelightEnumerator
+    module Error
+      class SoleItemExpected < StandardError
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/error.rb

@@ -0,0 +1,6 @@
+module Delight
+  module DelightEnumerator
+    module Error
+    end
+  end
+end

data/lib/delight/delight_enumerator/hash_collection_matcher.rb

@@ -0,0 +1,11 @@
+module Delight
+  module DelightEnumerator
+    module HashCollectionMatcher
+      def hash_collection_matcher(element, **kwargs)
+        kwargs.all? do |key, value|
+          element.key?(key) && element.fetch(key) == value
+        end
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/{by_methods.rb → select_by.rb}

@@ -1,6 +1,6 @@
 module Delight
   module DelightEnumerator
-    module ByMethods
+    module SelectBy
       include CollectionMatcher
 
       def select_by(**)

data/lib/delight/delight_enumerator/select_by_key.rb

@@ -0,0 +1,13 @@
+module Delight
+  module DelightEnumerator
+    module SelectByKey
+      include HashCollectionMatcher
+
+      def select_by_key(**)
+        select do |element|
+          hash_collection_matcher(element, **)
+        end
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/sole_by.rb

@@ -0,0 +1,29 @@
+module Delight
+  module DelightEnumerator
+    module SoleBy
+      include CollectionMatcher
+
+      def sole_by(**)
+        sole_by_implementation(:collection_matcher, **)
+      end
+
+      private
+
+      def sole_by_implementation(searcher, **)
+        results = lazy.select do |element|
+          public_send(searcher, element, **)
+        end
+
+        found, undesired = results.first(2)
+
+        if found.nil?
+          raise Error::ElementNotFound
+        elsif undesired
+          raise Error::SoleItemExpected, undesired
+        end
+
+        found
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/sole_by_key.rb

@@ -0,0 +1,12 @@
+module Delight
+  module DelightEnumerator
+    module SoleByKey
+      include SoleBy
+      include HashCollectionMatcher
+
+      def sole_by_key(**)
+        sole_by_implementation(:hash_collection_matcher, **)
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator/try_sole_by.rb

@@ -0,0 +1,27 @@
+module Delight
+  module DelightEnumerator
+    module TrySoleBy
+      include CollectionMatcher
+
+      def try_sole_by(**)
+        try_sole_by_implementation(:collection_matcher, **)
+      end
+
+      private
+
+      def try_sole_by_implementation(searcher, **)
+        results = lazy.select do |element|
+          public_send(searcher, element, **)
+        end
+
+        found, undesired = results.first(2)
+
+        if undesired
+          raise Error::SoleItemExpected, undesired
+        end
+
+        found
+      end
+    end
+  end
+end

data/lib/delight/delight_enumerator.rb

@@ -2,7 +2,20 @@ module Delight
   module DelightEnumerator
     refine Enumerable do
       import_methods CollectionMatcher
-      import_methods ByMethods
+      import_methods HashCollectionMatcher
+
+      import_methods SelectBy
+      import_methods SelectByKey
+
+      import_methods DetectBang
+      import_methods DetectBy
+      import_methods DetectByKey
+
+      import_methods SoleBy
+      import_methods SoleByKey
+
+      import_methods TrySoleBy
+      # import_methods TrySoleByKey
     end
   end
 end

data/lib/delight/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Delight
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: delight
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Mariusz Droździel
 bindir: exe
 cert_chain: []
-date: 2025-04-08 00:00:00.000000000 Z
+date: 2025-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -35,8 +35,19 @@ files:
 - Rakefile
 - lib/delight.rb
 - lib/delight/delight_enumerator.rb
-- lib/delight/delight_enumerator/by_methods.rb
 - lib/delight/delight_enumerator/collection_matcher.rb
+- lib/delight/delight_enumerator/detect_bang.rb
+- lib/delight/delight_enumerator/detect_by.rb
+- lib/delight/delight_enumerator/detect_by_key.rb
+- lib/delight/delight_enumerator/error.rb
+- lib/delight/delight_enumerator/error/element_not_found.rb
+- lib/delight/delight_enumerator/error/sole_item_expected.rb
+- lib/delight/delight_enumerator/hash_collection_matcher.rb
+- lib/delight/delight_enumerator/select_by.rb
+- lib/delight/delight_enumerator/select_by_key.rb
+- lib/delight/delight_enumerator/sole_by.rb
+- lib/delight/delight_enumerator/sole_by_key.rb
+- lib/delight/delight_enumerator/try_sole_by.rb
 - lib/delight/version.rb
 - sig/delight.rbs
 homepage: https://github.com/marzdrel/delight