parse_resource 1.6.1 → 1.6.2

data/README.md

@@ -44,7 +44,7 @@ Installation
 Include in your `Gemfile`:
 
 ```ruby
-gem "parse_resource", "~> 1.6.0"
+gem "parse_resource", "~> 1.6.1"
 ```
 
 Or just gem install:
@@ -92,61 +92,68 @@ class Post < ParseResource::Base
 end
 ```
 
-If you are using version `1.5.11` or earlier, subclass to just `ParseResource`.
+If you are using version `1.5.11` or earlier, subclass to just `ParseResource`--or just update to the most recent version.
 
 Creating, updating, and deleting:
 
 ```ruby
 p = Post.new
- => #<Post:0xab74864 @attributes={}, @unsaved_attributes={}> 
-p.valid?
- => false 
-p.errors
- => #<ActiveModel::Errors:0xab71998 @base=#<Post:0xab74864 @attributes={}, @unsaved_attributes={}, @validation_context=nil, @errors=#<ActiveModel::Errors:0xab71998 ...>>, @messages={:title=>["can't be blank"]}> 
-p.title = "Introducing ParseResource"
- => "Introducing ParseResource" 
-p.valid?
- => true 
-p.author = "Alan deLevie"
- => "Alan deLevie" 
+
+# validations
+p.valid? #=> false 
+p.errors #=> #<ActiveModel::Errors:0xab71998 ... @messages={:title=>["can't be blank"]}> 
+p.title = "Introducing ParseResource" #=> "Introducing ParseResource" 
+p.valid? #=> true 
+
+# setting more attributes, then saving
+p.author = "Alan deLevie" 
 p.body = "Ipso Lorem"
- => "Ipso Lorem" 
-p.save
- => #<Post:0xab74864 @attributes={:title=>"Introducing ParseResource", :author=>"Alan deLevie", :body=>"Ipso Lorem", :createdAt=>"2011-09-19T01:32:04.973Z", :objectId=>"QARfXUILgY"}, @unsaved_attributes={}, @validation_context=nil, @errors=#<ActiveModel::Errors:0xab71998 @base=#<Post:0xab74864 ...>, @messages={}>> 
-p.id
- => "QARfXUILgY" 
-p.updated_at
- => nil 
-p.created_at
- => "2011-09-19T01:32:04.973Z" 
+p.save #=> #<Post:0xab74864 ... > 
+
+# checking the id generated by Parse's servers
+p.id #=> "QARfXUILgY" 
+p.updated_at #=> nil 
+p.created_at #=> "2011-09-19T01:32:04.973Z" # does anybody want this to be a DateTime object? Let me know.
+
+# updating
 p.title = "[Update] Introducing ParseResource"
- => "[Update] Introducing ParseResource" 
 p.save
- => #<Post:0xab74864 @attributes={:title=>"[Update] Introducing ParseResource", :author=>"Alan deLevie", :body=>"Ipso Lorem", :createdAt=>"2011-09-19T01:32:04.973Z", :objectId=>"QARfXUILgY", :updatedAt=>"2011-09-19T01:32:37.930Z", "title"=>"[Update] Introducing ParseResource"}, @unsaved_attributes={}, @validation_context=nil, @errors=#<ActiveModel::Errors:0xab71998 @base=#<Post:0xab74864 ...>, @messages={}>> 
-p.updated_at
- => "2011-09-19T01:32:37.930Z" 
-p.destroy
- => nil 
-p.title
- => nil 
+p.updated_at #=> "2011-09-19T01:32:37.930Z" # more magic from Parse's servers
+
+# destroying an object
+p.destroy #=> nil 
+p.title #=> nil
 ```
 
 Finding:
 
 ```ruby
-a = Post.create(:title => "foo", :author => "bar", :body => "ipso")
- => #<Post:0xa6eee34 @attributes={:title=>"foo", :author=>"bar", :body=>"ipso", :createdAt=>"2011-09-19T01:36:42.833Z", :objectId=>"dPjKwaqQUv"}, @unsaved_attributes={}, @validation_context=nil, @errors=#<ActiveModel::Errors:0xa6ee54c @base=#<Post:0xa6eee34 ...>, @messages={}>> 
-b = Post.create(:title => "a newer post", :author => "bar", :body => "some newer content")
- => #<Post:0xa6b5e68 @attributes={:title=>"a newer post", :author=>"bar", :body=>"some newer content", :createdAt=>"2011-09-19T01:37:16.805Z", :objectId=>"ZripqKvunV"}, @unsaved_attributes={}, @validation_context=nil, @errors=#<ActiveModel::Errors:0xa6b5710 @base=#<Post:0xa6b5e68 ...>, @messages={}>> 
-posts = Post.where(:author => "bar")
- => [#<Post:0xa67b830 @attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}, @unsaved_attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}>, #<Post:0xa67b088 @attributes={:body=>"some newer content", :author=>"bar", :title=>"a newer post", :updatedAt=>"2011-09-19T01:37:16.805Z", :createdAt=>"2011-09-19T01:37:16.805Z", :objectId=>"ZripqKvunV"}, @unsaved_attributes={:body=>"some newer content", :author=>"bar", :title=>"a newer post", :updatedAt=>"2011-09-19T01:37:16.805Z", :createdAt=>"2011-09-19T01:37:16.805Z", :objectId=>"ZripqKvunV"}>] 
-p = Post.first
- => #<Post:0xa640dd4 @attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}, @unsaved_attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}> 
-posts = Post.all
- => [#<Post:0xa6236a8 @attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}, @unsaved_attributes={:body=>"ipso", :author=>"bar", :title=>"foo", :updatedAt=>"2011-09-19T01:36:42.834Z", :createdAt=>"2011-09-19T01:36:42.834Z", :objectId=>"dPjKwaqQUv"}>, #<Post:0xa6226cc @attributes={:body=>"some newer content", :author=>"bar", :title=>"a newer post", :updatedAt=>"2011-09-19T01:37:16.805Z", :createdAt=>"2011-09-19T01:37:16.805Z", :objectId=>"ZripqKvunV"}, @unsaved_attributes={:body=>"some newer content", :author=>"bar", :title=>"a newer post", :updatedAt=>"2011-09-19T01:37:16.805Z", :createdAt=>"2011-09-19T01:37:16.805Z", :objectId=>"ZripqKvunV"}>]
+posts = Post.where(:author => "Arrington")
+# the query is lazy loaded
+# nothing gets sent to the Parse server until you run #all, #count, or any Array method on the query 
+# (e.g. #first, #each, or #map)
+
+posts.each do |post|
+  "#{post.title}, by #{post.author}"
+end
+
+posts.map {|p| p.title} #=> ["Unpaid blogger", "Uncrunched"]
+
 id = "DjiH4Qffke"
-p = Post.find(id)
- => #<Post:0xa50f028 @unsaved_attributes={}, @attributes={"title"=>"fvvV", "updatedAt"=>"2011-09-22T21:36:13.044Z", "createdAt"=>"2011-09-22T21:36:13.044Z", "objectId"=>"DjiH4Qffke"}> 
+p = Post.find(id) #simple find by id
+
+#you can chain method calls, just like in ActiveRecord
+Post.where(:param1 => "foo").where(:param2 => "bar").all
+
+#destroy all objects
+Post.destroy_all
+
+#limit the query
+posts = Post.limit(5).where(:foo => "bar")
+posts.length #=> 5
+
+#get a count
+Post.where(:bar => "foo").count #=> 1337
 ```
 
 

data/VERSION

@@ -1 +1 @@
-1.6.1
+1.6.2

data/lib/base.rb

@@ -5,7 +5,7 @@ require "erb"
 require "rest-client"
 require "json"
 require "active_support/hash_with_indifferent_access"
-require "criteria"
+require "query"
 
 module ParseResource
 
@@ -127,32 +127,32 @@ module ParseResource
       # Find a ParseResource::Base object by chaining #where method calls.
       #
       def where(*args)
-        Criteria.new(self).where(*args)
+        Query.new(self).where(*args)
       end
 
       # Add this at the end of a method chain to get the count of objects, instead of an Array of objects
       def count
         #https://www.parse.com/docs/rest#queries-counting
-        Criteria.new(self).count(1)
+        Query.new(self).count(1)
       end
 
       # Find all ParseResource::Base objects for that model.
       #
       # @return [Array] an `Array` of objects that subclass `ParseResource`.
       def all
-        Criteria.new(self).all
+        Query.new(self).all
       end
 
       # Find the first object. Fairly random, not based on any specific condition.
       #
       def first
-        Criteria.new(self).limit(1).first
+        Query.new(self).limit(1).first
       end
 
       # Limits the number of objects returned
       #
       def limit(n)
-        Criteria.new(self).limit(n)
+        Query.new(self).limit(n)
       end
 
       # Create a ParseResource::Base object.

data/lib/parse_resource.rb

@@ -1,5 +1,5 @@
 require 'base'
-require 'criteria'
+require 'query'
 
 module ParseResource
 end

data/lib/{criteria.rb → query.rb}

@@ -1,4 +1,4 @@
-class Criteria
+class Query
 
   def initialize(klass)
     @klass = klass
@@ -30,25 +30,7 @@ class Criteria
     all
   end
 
-  #def each(&block)
-  #  resp = @klass.resource.get(:params => {:where => criteria[:conditions].to_json})
-  #  results = JSON.parse(resp)['results']
-  #  results.map {|r| @klass.model_name.constantize.new(r, false)}.each(&block)
-  #end
-
-  #def first
-  #  resp = @klass.resource.get(:params => {:where => criteria[:conditions].to_json})
-  #  results = JSON.parse(resp)['results']
-  #  results.map {|r| @klass.model_name.constantize.new(r, false)}.first
-  #end
-
-  #def length
-  #  resp = @klass.resource.get(:params => {:where => criteria[:conditions].to_json})
-  #  results = JSON.parse(resp)['results']
-  #  results.length
-  #end
-
-  def all
+  def execute
     params = {}
     params.merge!({:where => criteria[:conditions].to_json}) if criteria[:conditions]
     params.merge!({:limit => criteria[:limit].to_json}) if criteria[:limit]
@@ -66,14 +48,24 @@ class Criteria
     end
   end
 
-  def method_missing(meth)
+  def all
+    execute
+  end
+
+  def method_missing(meth, *args, &block)
     if Array.method_defined?(meth)
-      all.send(meth)
+      all.send(meth, *args, &block)
     else
       super
     end
   end
 
-
+  def respond_to?(meth)
+    if Array.method_defined?(meth)
+      true
+    else
+      super
+    end
+  end
 
 end

data/parse_resource.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "parse_resource"
-  s.version = "1.6.1"
+  s.version = "1.6.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Alan deLevie"]
@@ -25,9 +25,8 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "lib/base.rb",
-    "lib/criteria.rb",
-    "lib/examples/post.rb",
     "lib/parse_resource.rb",
+    "lib/query.rb",
     "parse_resource.gemspec",
     "rdoc/ParseResource.html",
     "rdoc/created.rid",
@@ -36,7 +35,8 @@ Gem::Specification.new do |s|
     "rdoc/rdoc.css",
     "test/active_model_lint_test.rb",
     "test/helper.rb",
-    "test/test_parse_resource.rb"
+    "test/test_parse_resource.rb",
+    "test/test_query.rb"
   ]
   s.homepage = "http://github.com/adelevie/parse_resource"
   s.licenses = ["MIT"]

data/test/test_parse_resource.rb

@@ -133,6 +133,26 @@ class TestParseResource < Test::Unit::TestCase
     assert @post.attributes['createdAt']
   end
 
+  def test_each
+    Post.destroy_all
+    4.times do |i|
+      Post.create(:title => "each", :author => i.to_s)
+    end
+    posts = Post.where(:title => "each")
+    posts.each do |p|
+      assert_equal p.title, "each"
+    end
+  end
+
+  def test_map
+    Post.destroy_all
+    4.times do |i|
+      Post.create(:title => "map", :author => i.to_s)
+    end
+    posts = Post.where(:title => "map")
+    assert_equal posts.map {|p| p}.class, Array
+  end
+
   def test_id
     @post = Post.create(:title => "testing id")
     assert @post.respond_to?(:id)
@@ -168,6 +188,7 @@ class TestParseResource < Test::Unit::TestCase
     p = Post.create(:title => "hello1234567890abc!")
     id = p.id
     p.destroy
+    assert_equal p.title, nil
     assert_equal 0, Post.where(:title => "hello1234567890abc!", :objectId => id).length
   end
 

data/test/test_query.rb

@@ -0,0 +1,13 @@
+require 'helper'
+require 'parse_resource'
+
+class TestQuery < Test::Unit::TestCase
+
+  def test_respond_to
+    q = Query.new(self).where(:foo => "bar")
+    assert_equal q.respond_to?(:length), true
+    assert_equal q.respond_to?(:[]), true
+    assert_equal q.respond_to?(:map), true
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: parse_resource
 version: !ruby/object:Gem::Version
-  version: 1.6.1
+  version: 1.6.2
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2011-12-09 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &73171530 !ruby/object:Gem::Requirement
+  requirement: &83699820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *73171530
+  version_requirements: *83699820
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &73170980 !ruby/object:Gem::Requirement
+  requirement: &83699170 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *73170980
+  version_requirements: *83699170
 - !ruby/object:Gem::Dependency
   name: activemodel
-  requirement: &73170580 !ruby/object:Gem::Requirement
+  requirement: &83698030 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *73170580
+  version_requirements: *83698030
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &73170070 !ruby/object:Gem::Requirement
+  requirement: &83697660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *73170070
+  version_requirements: *83697660
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &73169570 !ruby/object:Gem::Requirement
+  requirement: &83697230 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *73169570
+  version_requirements: *83697230
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &73168660 !ruby/object:Gem::Requirement
+  requirement: &83696570 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *73168660
+  version_requirements: *83696570
 - !ruby/object:Gem::Dependency
   name: reek
-  requirement: &73167950 !ruby/object:Gem::Requirement
+  requirement: &83695740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,10 +87,10 @@ dependencies:
         version: 1.2.8
   type: :development
   prerelease: false
-  version_requirements: *73167950
+  version_requirements: *83695740
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &73167430 !ruby/object:Gem::Requirement
+  requirement: &83694910 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +98,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *73167430
+  version_requirements: *83694910
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &73166820 !ruby/object:Gem::Requirement
+  requirement: &83694410 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -109,10 +109,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *73166820
+  version_requirements: *83694410
 - !ruby/object:Gem::Dependency
   name: activemodel
-  requirement: &73166070 !ruby/object:Gem::Requirement
+  requirement: &83693630 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -120,7 +120,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *73166070
+  version_requirements: *83693630
 description: ''
 email: adelevie@gmail.com
 executables: []
@@ -137,9 +137,8 @@ files:
 - Rakefile
 - VERSION
 - lib/base.rb
-- lib/criteria.rb
-- lib/examples/post.rb
 - lib/parse_resource.rb
+- lib/query.rb
 - parse_resource.gemspec
 - rdoc/ParseResource.html
 - rdoc/created.rid
@@ -149,6 +148,7 @@ files:
 - test/active_model_lint_test.rb
 - test/helper.rb
 - test/test_parse_resource.rb
+- test/test_query.rb
 homepage: http://github.com/adelevie/parse_resource
 licenses:
 - MIT
@@ -164,7 +164,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -909392589
+      hash: -629305873
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/lib/examples/post.rb

@@ -1,11 +0,0 @@
-require 'helper'
-require 'parse_resource'
-
-path = "parse_resource.yml"
-settings = YAML.load(ERB.new(File.new(path).read).result)['test']
-
-ParseResource.load!(settings['app_id'], settings['master_key'])
-
-class Post < ParseResource
-  fields :title, :author, :body
-end