contextio 1.1.0 → 1.2.0

data/CHANGES.md

@@ -1,5 +1,10 @@
 # Changes
 
+## 1.2.0
+
+* Add `#empty?` and `#size` to resource collections so you can treat them even
+  *more* like arrays! - Geoff Longman
+
 ## 1.1.0
 
 * Allow passing options to `OAuth` through the gem. Notably, `:timeout` and

data/README.md

@@ -19,7 +19,7 @@ boolean has converted to something with a `?` at the end (e.g. `HasChildren` and
 `initial_import_finished` are `has_children?` and `initial_import_finished?`,
 respectively).
 
-## Example
+## Examples
 
 ```ruby
 require 'contextio'
@@ -37,6 +37,19 @@ account.messages.where(folder: '\Drafts').each do |m|
 end
 ```
 
+To grab some object you already know the primary key for, you'll use the `[]`
+method like you would for a `Hash` or `Array`. This is most helpful for
+accounts, but works for any resource collection.
+
+```ruby
+require 'contextio'
+
+contextio = ContextIO.new('your_api_key', 'your_api_secret')
+
+account = contextio.accounts[some_account_id]
+email_Address = account.messages[some_message_id]
+```
+
 ## Install
 
     $ gem install contextio

data/lib/contextio/api/resource_collection.rb

@@ -53,6 +53,22 @@ class ContextIO
         end
       end
 
+      # Returns the number of elements in self. May be zero.
+      #
+      # @note Calling this method will load the collection if not already loaded.
+      def size
+        attribute_hashes.size
+      end
+      alias :length, :size
+      alias :count, :size
+
+      # Returns true if self contains no elements.
+      #
+      # @note Calling this method will load the collection if not already loaded.
+      def empty?
+        size == 0
+      end
+
       # Specify one or more constraints for limiting resources in this
       # collection. See individual classes for the list of valid constraints.
       # Not all collections have valid where constraints at all.

data/lib/contextio/version.rb

@@ -1,6 +1,6 @@
 class ContextIO
   # @private
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 
   # The gem version.
   #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contextio
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-07 00:00:00.000000000 Z
+date: 2013-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth