wilderpeople 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4591ba4d3f4654cae88164e3106ef022b0dfbc32
-  data.tar.gz: d364ee06d64951745386aba6b7fadbc3783cd4e5
+  metadata.gz: 26c48edebe245cbafc5148e4cee8a83b7cd5bba4
+  data.tar.gz: 9839aeaf707ef84954a9388e6f7b92beb652c38f
 SHA512:
-  metadata.gz: 756050f37ba7b4ed278e80276b977d006ed74fd7ef8cfc1c29819ffed3c5c9623d1b03b085d9b53711872508365c2d547aad1379b86532485556df6eb18a2fc9
-  data.tar.gz: 4068c8206a34f4f0bac26d7eb7f7c34663ed090a8cd2f18510aefc15965ae54425c252c9053a84644b5acd228cee282187f5a3e59d072776cd25e1a0fc8549d9
+  metadata.gz: 415c1bf9ec3c123e1bc41370898418aa283e5a20b65867322da03b900a88d0bb851d3a15e2c9fad74912d98596ae9dbaf91c361fb536a5f70df96b6e18f0a514
+  data.tar.gz: 3888ea7c8becd071d831534af1419346b6db62aa1f91bb0b87b30f01a78d2175ef3279a6bd7cd4e3f36ba4fb736ab0a0ab265edbfbe35bb186802f59663fdbd4

data/.gitignore

@@ -7,3 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+*.gem

data/README.md

@@ -6,8 +6,7 @@ other types of data from an array.
 
 The tool assumes you have an array of hashes, where each hash describes an
 unique item or person. It then allows you to pass in a "matching dataset" and
-in return it will return the hash that best matches that data, **if there
-is only one best match.**
+in return it will return the hash that best matches that data.
 
 ## Installation
 
@@ -98,6 +97,26 @@ person = search.find surname: 'Bloggs', forename: 'Fred',  gender: 'Female'
 person == {surname: 'Bloggs', forename: 'Winifred', gender: 'Female'}
 ```
 
+### Select
+
+If it is not necessary to return a unique record, `select` can be used to
+retrieve all the items that match the `config` criteria.
+
+```ruby
+config = {
+  must: {
+    surname: :exact,
+    gender: :exact
+  }
+}
+search = Wilderpeople::Search.new(data: data, config: config)
+person = search.select surname: 'Bloggs', gender: 'Female'
+person == [
+  {"surname"=>"Bloggs", "forename"=>"Winifred", "gender"=>"Female"},
+  {"surname"=>"Bloggs", "forename"=>"Jane", "gender"=>"Female"}
+]
+```
+
 ### Criteria configuration
 
 The `config` is a hash of one or two parts. The parts being:

data/lib/wilderpeople/search.rb

@@ -8,9 +8,16 @@ module Wilderpeople
     end
 
     def find(args)
+      select(args)
+      result.first if result.size == 1
+    end
+
+    def select(args)
       @result = data
       @args = args
-      select_must || select_can
+      select_must
+      select_can if result.size > 1
+      result
     end
 
     private
@@ -24,7 +31,6 @@ module Wilderpeople
           Matcher.by matcher_method, datum[key], args[key]
         end
       end
-      result.first if result.size == 1
     end
 
     def must_rules
@@ -41,13 +47,11 @@ module Wilderpeople
           Matcher.by matcher_method, datum[key], args[key]
         end
       end
-      # Then determine if one datum appears in more matches
-      # than any other, and if so return that one.
+      # Then determine which items appears in more matches
+      # than any other, and if so return those.
       occurrences = find_occurrences(matches)
       count_of_commonest = occurrences.values.max
-      if occurrences.values.count(count_of_commonest) == 1
-        occurrences.rassoc(count_of_commonest)[0]
-      end
+      @result = occurrences.select{|_k, v| v == count_of_commonest}.keys
     end
 
     def can_rules

data/lib/wilderpeople/version.rb

@@ -1,3 +1,17 @@
 module Wilderpeople
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end
+
+# History
+# =======
+#
+# 0.1.0: Initial release
+# ----------------------
+# Basic functionality working that allows unique items to be retrieved from
+# a data set based on a set of criteria and a matching dataset.
+#
+# 0.2.0: Add select to return matching items
+# ------------------------------------------
+# Added a `select` method to search, that will return all the matching items
+#
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wilderpeople
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Rob Nichols
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-03-09 00:00:00.000000000 Z
+date: 2017-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hypocorism