Added raise option to find_first.

Also added find alias.

README.md

@@ -1,4 +1,4 @@
-[![Lines of Code](http://img.shields.io/badge/lines_of_code-38-brightgreen.svg?style=flat)](http://blog.codinghorror.com/the-best-code-is-no-code-at-all/)
+[![Lines of Code](http://img.shields.io/badge/lines_of_code-46-brightgreen.svg?style=flat)](http://blog.codinghorror.com/the-best-code-is-no-code-at-all/)
 [![Code Status](http://img.shields.io/codeclimate/github/hopsoft/queryable_hash.svg?style=flat)](https://codeclimate.com/github/hopsoft/queryable_hash)
 [![Dependency Status](http://img.shields.io/gemnasium/hopsoft/queryable_hash.svg?style=flat)](https://gemnasium.com/hopsoft/queryable_hash)
 [![Build Status](http://img.shields.io/travis/hopsoft/queryable_hash.svg?style=flat)](https://travis-ci.org/hopsoft/queryable_hash)

lib/queryable_hash.rb

@@ -1,4 +1,5 @@
 require_relative "queryable_hash/version"
+require_relative "queryable_hash/not_found_error"
 require_relative "queryable_hash/wrapper"
 
 module QueryableHash

lib/queryable_hash/not_found_error.rb

@@ -0,0 +1,4 @@
+module QueryableHash
+  class NotFoundError < StandardError
+  end
+end

lib/queryable_hash/version.rb

@@ -1,3 +1,3 @@
 module QueryableHash
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

lib/queryable_hash/wrapper.rb

@@ -19,13 +19,18 @@ def find_all(*queries, nil_value: nil)
       end
     end
 
-    def find_first(*queries, nil_value: nil)
+    def find_first(*queries, nil_value: nil, raise_when_nil: false)
       first = find_all(*queries, nil_value: nil_value).find do |result|
         result != nil_value
       end
-      first || nil_value
+      first ||= nil_value
+
+      raise NotFoundError if raise_when_nil && first == nil_value
+      first
     end
 
+    alias_method :find, :find_first
+
     def to_hash
       @original_hash
     end

test/wrapper_test.rb

@@ -79,6 +79,16 @@ class QueryableHashTest < PryTest::Test
       assert term == "Standard Generalized Markup Language"
     end
 
+    test "find_first with raise" do
+      query = "nate.this.key.does.not.exist"
+      begin
+        @queryable.find_first(query, raise_when_nil: true)
+      rescue NotFoundError => e
+      end
+
+      assert e
+    end
+
     test "to_hash" do
       assert @queryable.to_hash == @data
     end