delight 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a893e732517c88b60d7e1ad947e9d7e227ae2d8adc6ee6bbe173a5afafe1d50c
-  data.tar.gz: f54fa816caa3b625bdf01d083da3ebb5c66ec5a59e5124f0f7a94eeb0b388f68
+  metadata.gz: 8b71843e7ea31f5cd0ead34733ab94d3505e09db476072a9e40f189aa969df72
+  data.tar.gz: 259873047a56a06f96a907c394a1ce6280021ea886831e43283e3cc1886938fe
 SHA512:
-  metadata.gz: 3c3d820838cfcbb82641284df669a5a12d5dfd6fcb5e9a4f22a1625eee9c1852e499268b8166ae27a70b2d2a8dfca207be3d19061b6f630e4548512f0bddffdb
-  data.tar.gz: 646d778fb10679baf72bfe2c21aaa24f29e11e2f2b4fef3d91ee52e0013276d2bca924bf2919eb70f321478ceb904c784ca50c90c1345c1a00883a811a36b4c5
+  metadata.gz: 3300b566241e7874db2f180fd6fb5f406cb0a48bbf81955b8fb2d561a5e83f56319144083d9e98cfd74642f4081b6586e92288ffc368a6840bef0e751b8b17e4
+  data.tar.gz: a44f89bbf3927b3bc4b79fe677912311d16f29d16a414eb5ab4132aa3c939864cc840aad2c820b8433d75f44b749b62b5b79962f25e6db0c14db8149a4d4a781

data/lib/delight/{delight_enumerator → enumerator}/collection_matcher.rb

@@ -1,5 +1,5 @@
 module Delight
-  module DelightEnumerator
+  module Enumerator
     module CollectionMatcher
       def collection_matcher(element, **kwargs)
         kwargs.all? do |key, value|

data/lib/delight/enumerator/detect_bang.rb

@@ -0,0 +1,14 @@
+module Delight
+  module Enumerator
+    module DetectBang
+      # 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/enumerator/detect_by.rb

@@ -0,0 +1,17 @@
+module Delight
+  module Enumerator
+    module DetectBy
+      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/enumerator/detect_by_key.rb

@@ -0,0 +1,17 @@
+module Delight
+  module Enumerator
+    module DetectByKey
+      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/enumerator/error/element_not_found.rb

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

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

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

data/lib/delight/enumerator/error.rb

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

data/lib/delight/enumerator/hash_collection_matcher.rb

@@ -0,0 +1,11 @@
+module Delight
+  module Enumerator
+    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 → enumerator/select_by.rb}

@@ -1,8 +1,6 @@
 module Delight
-  module DelightEnumerator
-    module ByMethods
-      include CollectionMatcher
-
+  module Enumerator
+    module SelectBy
       def select_by(**)
         select do |element|
           collection_matcher(element, **)

data/lib/delight/enumerator/select_by_key.rb

@@ -0,0 +1,11 @@
+module Delight
+  module Enumerator
+    module SelectByKey
+      def select_by_key(**)
+        select do |element|
+          hash_collection_matcher(element, **)
+        end
+      end
+    end
+  end
+end

data/lib/delight/enumerator/sole_by.rb

@@ -0,0 +1,27 @@
+module Delight
+  module Enumerator
+    module SoleBy
+      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/enumerator/sole_by_key.rb

@@ -0,0 +1,9 @@
+module Delight
+  module Enumerator
+    module SoleByKey
+      def sole_by_key(**)
+        sole_by_implementation(:hash_collection_matcher, **)
+      end
+    end
+  end
+end

data/lib/delight/enumerator/try_sole_by.rb

@@ -0,0 +1,25 @@
+module Delight
+  module Enumerator
+    module TrySoleBy
+      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/enumerator.rb

@@ -0,0 +1,21 @@
+module Delight
+  module Enumerator
+    refine Enumerable do
+      import_methods CollectionMatcher
+      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.3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: delight
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Mariusz Droździel
 bindir: exe
 cert_chain: []
-date: 2025-04-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -34,9 +34,20 @@ files:
 - README.md
 - 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/enumerator.rb
+- lib/delight/enumerator/collection_matcher.rb
+- lib/delight/enumerator/detect_bang.rb
+- lib/delight/enumerator/detect_by.rb
+- lib/delight/enumerator/detect_by_key.rb
+- lib/delight/enumerator/error.rb
+- lib/delight/enumerator/error/element_not_found.rb
+- lib/delight/enumerator/error/sole_item_expected.rb
+- lib/delight/enumerator/hash_collection_matcher.rb
+- lib/delight/enumerator/select_by.rb
+- lib/delight/enumerator/select_by_key.rb
+- lib/delight/enumerator/sole_by.rb
+- lib/delight/enumerator/sole_by_key.rb
+- lib/delight/enumerator/try_sole_by.rb
 - lib/delight/version.rb
 - sig/delight.rbs
 homepage: https://github.com/marzdrel/delight
@@ -59,7 +70,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Delightful extensions to Ruby's standard library.
 test_files: []

data/lib/delight/delight_enumerator.rb

@@ -1,8 +0,0 @@
-module Delight
-  module DelightEnumerator
-    refine Enumerable do
-      import_methods CollectionMatcher
-      import_methods ByMethods
-    end
-  end
-end