collector 0.0.10 → 0.0.11

data/README.md

@@ -3,10 +3,10 @@
 [![Build Status](https://travis-ci.org/brandonweiss/collector.png)](https://travis-ci.org/brandonweiss/collector)
 [![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/brandonweiss/collector)
 
-_Collector isn't ready for use just yet. And I don't mean it's unstable or alpha, I mean literally it doesn't do anything yet. When the basic feature set is ready I will bump the minor version (to 0.1.0)._
-
 Collector is an implementation of the Repository Pattern for MongoDB. For those new to the Repository Pattern, it is a Facade that isolates the persistence layer from your application. If you're familiar with Rails, or more specifically ActiveRecord or most other ORMs, you'll know that the models and persistence layer are tightly coupled—literally they are the same object. That pattern is a great way to cut your teeth, but ultimately it's a terrible design. Your application does not and should not care about how its data is persisted. Collector will help with that.
 
+_Collector is currently under initial development, and I mean that in the context of [semantic versioning](http://semver.org), which I follow. Initial development is anything with a major version of zero (0.x.x), which means anything may change at any time; there is no public API. I'll do my best not to wildly change anything, but if you upgrade, run your application tests to see if anything breaks. If you don't have application tests then you have failed. Go home and re-think your life choices that have brought you to this point._
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -72,6 +72,15 @@ pickle = Pickle.new(brine: "vinegar", started_at: Time.now)
 PickleRepository.save(pickle)
 ```
 
+Repositories can get all models, find by ID, or find dynamically by any attribute.
+
+```ruby
+PickleRepository.all
+PickleRepository.find_by_id(BSON::ObjectId("50af1f3fb392d4aa0d000001"))
+PickleRepository.find_by_color("green")
+PickleRepository.find_by_taste("delicious")
+```
+
 ### Requirements
 
 Collector will only work with 1.9.x and above. Specifically it's tested with 1.9.2 and 1.9.3.

data/lib/collector/repository.rb

@@ -59,6 +59,10 @@ module Collector
         end
       end
 
+      def find_by_id(id)
+        deserialize!(collection.find(_id: id))
+      end
+
       def method_missing(method_sym, *arguments, &block)
         if method_sym.to_s =~ /^find_by_(.*)$/
           collection.find($1.to_sym => arguments.first).map do |document|

data/lib/collector/version.rb

@@ -1,3 +1,3 @@
 module Collector
-  VERSION = "0.0.10"
+  VERSION = "0.0.11"
 end

data/test/collector/repository_spec.rb

@@ -96,6 +96,17 @@ describe Collector::Repository do
     end
   end
 
+  describe "find_by_id" do
+    it "returns a document by its ID" do
+      id = "bson-id"
+      document = stub
+      TestRepository.expects(:deserialize!).with(document)
+      collection = mock { expects(:find).with(_id: id).returns(document) }
+      TestRepository.expects(:collection).returns(collection)
+      TestRepository.find_by_id(id)
+    end
+  end
+
   describe "finders" do
     it "dynamically matches find_by finders" do
       document_1 = stub

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: collector
 version: !ruby/object:Gem::Version
-  version: 0.0.10
+  version: 0.0.11
   prerelease: 
 platform: ruby
 authors: