fb_graph 0.8.0 → 1.0.0

data/VERSION

@@ -1 +1 @@
-0.8.0
+1.0.0

data/fb_graph.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{fb_graph}
-  s.version = "0.8.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["nov matake"]
@@ -42,6 +42,7 @@ Gem::Specification.new do |s|
      "lib/fb_graph/connections/albums.rb",
      "lib/fb_graph/connections/attending.rb",
      "lib/fb_graph/connections/books.rb",
+     "lib/fb_graph/connections/checkins.rb",
      "lib/fb_graph/connections/comments.rb",
      "lib/fb_graph/connections/declined.rb",
      "lib/fb_graph/connections/events.rb",
@@ -98,6 +99,8 @@ Gem::Specification.new do |s|
      "spec/fake_json/events/maybe/smartday_private.json",
      "spec/fake_json/events/noreply/smartday_private.json",
      "spec/fake_json/groups/members/emacs_private.json",
+     "spec/fake_json/pages/checkins/gowalla_private.json",
+     "spec/fake_json/pages/checkins/gowalla_public.json",
      "spec/fake_json/pages/notes/post_with_valid_access_token.json",
      "spec/fake_json/pages/platform_private.json",
      "spec/fake_json/pages/platform_public.json",
@@ -123,6 +126,8 @@ Gem::Specification.new do |s|
      "spec/fake_json/users/arjun_public.json",
      "spec/fake_json/users/books/matake_private.json",
      "spec/fake_json/users/books/matake_public.json",
+     "spec/fake_json/users/checkins/mattt_private.json",
+     "spec/fake_json/users/checkins/mattt_public.json",
      "spec/fake_json/users/events/matake_private.json",
      "spec/fake_json/users/events/matake_public.json",
      "spec/fake_json/users/events/post_with_valid_access_token.json",
@@ -164,6 +169,7 @@ Gem::Specification.new do |s|
      "spec/fb_graph/album_spec.rb",
      "spec/fb_graph/application_spec.rb",
      "spec/fb_graph/auth_spec.rb",
+     "spec/fb_graph/checkin_spec.rb",
      "spec/fb_graph/collection_spec.rb",
      "spec/fb_graph/comment_spec.rb",
      "spec/fb_graph/connection_spec.rb",
@@ -172,6 +178,7 @@ Gem::Specification.new do |s|
      "spec/fb_graph/connections/albums_spec.rb",
      "spec/fb_graph/connections/attending_spec.rb",
      "spec/fb_graph/connections/books_spec.rb",
+     "spec/fb_graph/connections/checkins_spec.rb",
      "spec/fb_graph/connections/comments_spec.rb",
      "spec/fb_graph/connections/declined_spec.rb",
      "spec/fb_graph/connections/events_spec.rb",
@@ -225,6 +232,7 @@ Gem::Specification.new do |s|
     "spec/fb_graph/album_spec.rb",
      "spec/fb_graph/application_spec.rb",
      "spec/fb_graph/auth_spec.rb",
+     "spec/fb_graph/checkin_spec.rb",
      "spec/fb_graph/collection_spec.rb",
      "spec/fb_graph/comment_spec.rb",
      "spec/fb_graph/connection_spec.rb",
@@ -233,6 +241,7 @@ Gem::Specification.new do |s|
      "spec/fb_graph/connections/albums_spec.rb",
      "spec/fb_graph/connections/attending_spec.rb",
      "spec/fb_graph/connections/books_spec.rb",
+     "spec/fb_graph/connections/checkins_spec.rb",
      "spec/fb_graph/connections/comments_spec.rb",
      "spec/fb_graph/connections/declined_spec.rb",
      "spec/fb_graph/connections/events_spec.rb",

data/lib/fb_graph/checkin.rb

@@ -1,5 +1,7 @@
 module FbGraph
   class Checkin < Node
+    extend Searchable
+
     attr_accessor :from, :tags, :place, :message, :coordinates, :application, :created_time
 
     def initialize(identifier, attributes = {})
@@ -7,9 +9,36 @@ module FbGraph
       if (from = attributes[:from])
         @from = FbGraph::User.new(from.delete(:id), from)
       end
-      # TODO
-      # Checkin isn't available in Japan yet, so I can't use this feature yet.
-      # I'm very glad if someone helps me here.
+      @tags = []
+      if (tags = attributes[:tags])
+        FbGraph::Collection.new(tags).each do |user|
+          @tags << FbGraph::User.new(user.delete(:id), user)
+        end
+      end
+      if (location = attributes[:location])
+        @location = FbGraph::Page.new(location.delete(:id), location)
+      end
+      @message = attributes[:message]
+      if (coordinates = attributes[:coordinates])
+        # NOTE: it seems this attributes isn't used now
+        @coordinates = FbGraph::Venue.new(location)
+      end
+      if (application = attributes[:application])
+        @application = FbGraph::Application.new(application.delete(:id), application)
+      end
+      if (created_time = attributes.delete(:created_time))
+        @created_time = Time.parse(created_time).utc
+      end
+    end
+
+    # = Search for recent check-ins for an authorized user and his or her friends:
+    # 
+    #   FbGraph::Checkin.search(:access_token => ACCESS_TOKEN)
+    #   => Array of FbGraph::Checkin
+    def self.search(options = {})
+      # NOTE:
+      # checkin search doesn't support "q=***" parameter
+      super(nil, options)
     end
   end
 end

data/lib/fb_graph/connections/checkins.rb

@@ -0,0 +1,22 @@
+module FbGraph
+  module Connections
+    # == Fetch checkins
+    # 
+    # * To get a user's check-ins, request the "user_checkins".
+    # * To see the user's friends' check-ins, request the "friends_checkins". 
+    # ref) http://developers.facebook.com/docs/api#places
+    # 
+    #   FbGraph::User.new("matake").checkins(:access_token => ACCESS_TOKEN)
+    #   FbGraph::Page.new("Tokyo").checkins(:access_token => ACCESS_TOKEN)
+    module Checkins
+      def checkins(options = {})
+        checkins = self.connection(:checkins, options)
+        checkins.map! do |checkin|
+          FbGraph::Checkin.new(checkin.delete(:id), checkin.merge(
+            :access_token => options[:access_token] || self.access_token
+          ))
+        end
+      end
+    end
+  end
+end

data/lib/fb_graph/connections/subscriptions.rb

@@ -20,6 +20,7 @@ module FbGraph
       # See details at "Subscription Verification" in the Facebook API document.
       # ref) http://developers.facebook.com/docs/api/realtime
       # 
+      #   app = FbGraph::Application.new(APP_ID, :secret => APP_SECRET)
       #   app.subscribe!(
       #     :object => "user",
       #     :fields => "name,email",
@@ -38,6 +39,7 @@ module FbGraph
       # If you specify an object parameter, it will only delete the corresponding subscription.
       # ref) http://developers.facebook.com/docs/api/realtime
       # 
+      #   app = FbGraph::Application.new(APP_ID, :secret => APP_SECRET)
       #   app.unsubscribe!(
       #     :object => "user"
       #   )

data/lib/fb_graph/group.rb

@@ -7,20 +7,20 @@ module FbGraph
 
     attr_accessor :owner, :name, :description, :link, :venue, :privacy, :updated_time
 
-    def initialize(identifier, options = {})
+    def initialize(identifier, attributes = {})
       super
-      if (owner = options[:owner])
+      if (owner = attributes[:owner])
         @owner = FbGraph::User.new(owner.delete(:id), owner)
       end
-      @name         = options[:name]
-      @description  = options[:description]
-      @link         = options[:link]
-      @privacy      = options[:privacy]
-      if options[:venue]
-        @venue = FbGraph::Venue.new(options[:venue])
+      @name         = attributes[:name]
+      @description  = attributes[:description]
+      @link         = attributes[:link]
+      @privacy      = attributes[:privacy]
+      if attributes[:venue]
+        @venue = FbGraph::Venue.new(attributes[:venue])
       end
-      if options[:updated_time]
-        @updated_time = Time.parse(options[:updated_time]).utc
+      if attributes[:updated_time]
+        @updated_time = Time.parse(attributes[:updated_time]).utc
       end
     end
   end

data/lib/fb_graph/node.rb

@@ -105,7 +105,7 @@ module FbGraph
         _response_ = JSON.parse(response.body).with_indifferent_access
         if _response_[:error]
           case _response_[:error][:type]
-          when 'OAuthAccessTokenException', 'QueryParseException', 'OAuthInvalidRequestException'
+          when 'OAuthAccessTokenException', 'QueryParseException', 'OAuthInvalidRequestException', 'OAuthInvalidTokenException'
             raise FbGraph::Unauthorized.new(_response_[:error][:message])
           else
             raise FbGraph::BadRequest.new("#{_response_[:error][:type]} :: #{_response_[:error][:message]}")

data/lib/fb_graph/page.rb

@@ -13,9 +13,10 @@ module FbGraph
     include Connections::Posts
     include Connections::Members
     include Connections::Events
+    include Connections::Checkins
     extend Searchable
 
-    attr_accessor :name, :username, :link, :category, :founded, :company_overview, :mission, :products, :fan_count
+    attr_accessor :name, :username, :link, :category, :founded, :company_overview, :mission, :products, :fan_count, :location
 
     def initialize(identifier, attributes = {})
       super
@@ -32,6 +33,9 @@ module FbGraph
         @products = products.split "\n"
       end
       @fan_count = attributes[:fan_count]
+      if (location = attributes[:location])
+        @venue = FbGraph::Venue.new(location)
+      end
     end
   end
 end

data/lib/fb_graph/status.rb

@@ -5,17 +5,17 @@ module FbGraph
 
     attr_accessor :from, :message, :updated_time
 
-    def initialize(identifier, options = {})
+    def initialize(identifier, attributes = {})
       super
-      if (from = options[:from])
+      if (from = attributes[:from])
         @from = if from[:category]
           FbGraph::Page.new(from.delete(:id), from)
         else
           FbGraph::User.new(from.delete(:id), from)
         end
       end
-      @message = options[:message]
-      if (updated_time = options.delete(:updated_time))
+      @message = attributes[:message]
+      if (updated_time = attributes.delete(:updated_time))
         @updated_time = Time.parse(updated_time).utc
       end
     end

data/lib/fb_graph/tag.rb

@@ -4,13 +4,13 @@ module FbGraph
 
     attr_accessor :user, :x, :y, :created_time
 
-    def initialize(identifier, options = {})
-      @x = options.delete(:x)
-      @y = options.delete(:y)
-      if (created_time = options.delete(:created_time))
+    def initialize(identifier, attributes = {})
+      @x = attributes.delete(:x)
+      @y = attributes.delete(:y)
+      if (created_time = attributes.delete(:created_time))
         @created_time = Time.parse(created_time).utc
       end
-      @user = User.new(identifier, options)
+      @user = User.new(identifier, attributes)
     end
   end
 end

data/lib/fb_graph/user.rb

@@ -26,57 +26,58 @@ module FbGraph
     # include Connections::Inbox
     # include Connections::Outbox
     # include Connections::Updates
-    include Connections::Accounts
     # ++
+    include Connections::Accounts
+    include Connections::Checkins
     extend Searchable
 
     attr_accessor :first_name, :last_name, :name, :link, :about, :birthday, :work, :education, :email, :website, :hometown, :location, :bio, :quotes, :gender, :interested_in, :meeting_for, :relationship_status, :religion, :political, :verified, :significant_other, :timezone, :updated_time
 
-    def initialize(identifier, options = {})
+    def initialize(identifier, attributes = {})
       super
-      @first_name = options[:first_name]
-      @last_name  = options[:last_name]
-      @name       = options[:name]
-      @link       = options[:link]
-      @about      = options[:about]
-      if options[:birthday]
-        month, day, year = options[:birthday].split('/').collect(&:to_i)
+      @first_name = attributes[:first_name]
+      @last_name  = attributes[:last_name]
+      @name       = attributes[:name]
+      @link       = attributes[:link]
+      @about      = attributes[:about]
+      if attributes[:birthday]
+        month, day, year = attributes[:birthday].split('/').collect(&:to_i)
         year ||= 0
         @birthday = Date.new(year, month, day)
       end
       @work = []
-      if options[:work]
-        options[:work].each do |work|
+      if attributes[:work]
+        attributes[:work].each do |work|
           @work << FbGraph::Work.new(work)
         end
       end
       @education = []
-      if options[:education]
-        options[:education].each do |education|
+      if attributes[:education]
+        attributes[:education].each do |education|
           @education << FbGraph::Education.new(education)
         end
       end
-      @email   = options[:email]
-      @website = options[:website].to_s.split("\n")
-      if (hometown = options[:hometown])
+      @email   = attributes[:email]
+      @website = attributes[:website].to_s.split("\n")
+      if (hometown = attributes[:hometown])
         @hometown = FbGraph::Page.new(hometown.delete(:id), hometown)
       end
-      if (location = options[:location])
+      if (location = attributes[:location])
         @location = FbGraph::Page.new(location.delete(:id), location)
       end
-      @bio                 = options[:bio]
-      @quotes              = options[:quotes]
-      @gender              = options[:gender]
-      @interested_in       = Array(options[:interested_in])
-      @meeting_for         = Array(options[:meeting_for])
-      @relationship_status = options[:relationship_status]
-      @religion            = options[:religion]
-      @political           = options[:political]
-      @verified            = options[:verified]
-      @significant_other   = options[:significant_other] # What's this??
-      @timezone            = options[:timezone]
-      if options[:updated_time]
-        @updated_time = Time.parse(options[:updated_time]).utc
+      @bio                 = attributes[:bio]
+      @quotes              = attributes[:quotes]
+      @gender              = attributes[:gender]
+      @interested_in       = Array(attributes[:interested_in])
+      @meeting_for         = Array(attributes[:meeting_for])
+      @relationship_status = attributes[:relationship_status]
+      @religion            = attributes[:religion]
+      @political           = attributes[:political]
+      @verified            = attributes[:verified]
+      @significant_other   = attributes[:significant_other] # What's this??
+      @timezone            = attributes[:timezone]
+      if attributes[:updated_time]
+        @updated_time = Time.parse(attributes[:updated_time]).utc
       end
     end
 

data/lib/fb_graph/video.rb

@@ -5,23 +5,23 @@ module FbGraph
 
     attr_accessor :from, :message, :description, :length, :created_time, :updated_time
 
-    def initialize(identifier, options = {})
+    def initialize(identifier, attributes = {})
       super
-      if (from = options[:from])
+      if (from = attributes[:from])
         @from = if from[:category]
           FbGraph::Page.new(from.delete(:id), from)
         else
           FbGraph::User.new(from.delete(:id), from)
         end
       end
-      @message     = options[:message]
-      @description = options[:description]
-      @length      = options[:length]
-      if options[:created_time]
-        @created_time = Time.parse(options[:created_time]).utc
+      @message     = attributes[:message]
+      @description = attributes[:description]
+      @length      = attributes[:length]
+      if attributes[:created_time]
+        @created_time = Time.parse(attributes[:created_time]).utc
       end
-      if options[:updated_time]
-        @updated_time = Time.parse(options[:updated_time]).utc
+      if attributes[:updated_time]
+        @updated_time = Time.parse(attributes[:updated_time]).utc
       end
     end
   end

data/lib/fb_graph.rb

@@ -55,6 +55,7 @@ require 'fb_graph/searchable'
 require 'fb_graph/node'
 require 'fb_graph/album'
 require 'fb_graph/application'
+require 'fb_graph/checkin'
 require 'fb_graph/comment'
 require 'fb_graph/education'
 require 'fb_graph/event'

data/spec/fake_json/pages/checkins/gowalla_private.json

@@ -0,0 +1,113 @@
+{
+   "data": [
+      {
+         "id": "696876187499",
+         "from": {
+            "name": "Roger Pincombe",
+            "id": "12820552"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               }
+            ]
+         },
+         "message": "Checking out Austin, TX",
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-09-08T00:09:25+0000"
+      },
+      {
+         "id": "463895351674",
+         "from": {
+            "name": "Scott Raymond",
+            "id": "505421674"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Sandi Weldon",
+                  "id": "695370206"
+               }
+            ]
+         },
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-20T22:33:26+0000"
+      },
+      {
+         "id": "461099202106",
+         "from": {
+            "name": "John Marstall",
+            "id": "752752106"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Phillip Bowden",
+                  "id": "25316885"
+               },
+               {
+                  "name": "Brian Bailey",
+                  "id": "526567227"
+               },
+               {
+                  "name": "John Critz",
+                  "id": "805120116"
+               },
+               {
+                  "name": "Keegan Jones",
+                  "id": "1304370418"
+               }
+            ]
+         },
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-19T19:46:24+0000"
+      }
+   ],
+   "paging": {
+      "previous": "https://graph.facebook.com/120454134658381/checkins?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&since=2010-09-08T00%3A09%3A25%2B0000",
+      "next": "https://graph.facebook.com/120454134658381/checkins?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&until=2010-08-19T19%3A46%3A23%2B0000"
+   }
+}

data/spec/fake_json/pages/checkins/gowalla_public.json

@@ -0,0 +1,6 @@
+{
+   "error": {
+      "type": "OAuthInvalidTokenException",
+      "message": "An access token is required to request this resource."
+   }
+}

data/spec/fake_json/users/checkins/mattt_private.json

@@ -0,0 +1,389 @@
+{
+   "data": [
+      {
+         "id": "696876187499",
+         "from": {
+            "name": "Roger Pincombe",
+            "id": "12820552"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               }
+            ]
+         },
+         "message": "Checking out Austin, TX",
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-09-08T00:09:25+0000"
+      },
+      {
+         "id": "701128934833",
+         "from": {
+            "name": "Sarah Smith",
+            "id": "222574"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Keegan Jones",
+                  "id": "1304370418"
+               }
+            ]
+         },
+         "message": "Pretty good DJ",
+         "place": {
+            "id": "140580665977144",
+            "name": "halcyon",
+            "location": {
+               "latitude": 30.267038941383,
+               "longitude": -97.745790481567
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-09-04T01:52:54+0000"
+      },
+      {
+         "id": "611783578689",
+         "from": {
+            "name": "Mattt Thompson",
+            "id": "4810308"
+         },
+         "place": {
+            "id": "111665838868969",
+            "name": "Elephant Room",
+            "location": {
+               "street": "315 Congress Ave",
+               "city": "Austin",
+               "state": "TX",
+               "zip": "78701-4032",
+               "latitude": 30.265453,
+               "longitude": -97.743661
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-09-02T04:04:34+0000",
+         "comments": {
+            "data": [
+               {
+                  "id": "611783578689_603913",
+                  "from": {
+                     "name": "Glenn D Banton Sr.",
+                     "id": "100001008400197"
+                  },
+                  "message": "Past tense.. \"was\"?",
+                  "created_time": "2010-09-02T16:00:55+0000"
+               },
+               {
+                  "id": "611783578689_604315",
+                  "from": {
+                     "name": "Mattt Thompson",
+                     "id": "4810308"
+                  },
+                  "message": "Yeah, Facebook loves them some correct tenses.",
+                  "created_time": "2010-09-02T20:45:41+0000"
+               }
+            ],
+            "paging": {
+               "previous": "https://graph.facebook.com/611783578689/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&since=2010-09-02T20%3A45%3A41%2B0000",
+               "next": "https://graph.facebook.com/611783578689/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&until=2010-09-02T16%3A00%3A54%2B0000"
+            }
+         }
+      },
+      {
+         "id": "610883667119",
+         "from": {
+            "name": "Mattt Thompson",
+            "id": "4810308"
+         },
+         "place": {
+            "id": "139045549463750",
+            "name": "The Ginger Man",
+            "location": {
+               "latitude": 30.266271416667,
+               "longitude": -97.74553775
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-26T22:48:57+0000",
+         "comments": {
+            "data": [
+               {
+                  "id": "610883667119_594123",
+                  "from": {
+                     "name": "Jenn Vargas",
+                     "id": "419222"
+                  },
+                  "message": "jealousssss",
+                  "created_time": "2010-08-27T07:22:24+0000"
+               },
+               {
+                  "id": "610883667119_594693",
+                  "from": {
+                     "name": "Sharon Wong",
+                     "id": "4806450"
+                  },
+                  "message": "I love that place!",
+                  "created_time": "2010-08-27T17:52:13+0000"
+               }
+            ],
+            "paging": {
+               "previous": "https://graph.facebook.com/610883667119/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&since=2010-08-27T17%3A52%3A13%2B0000",
+               "next": "https://graph.facebook.com/610883667119/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&until=2010-08-27T07%3A22%3A23%2B0000"
+            }
+         }
+      },
+      {
+         "id": "699014073033",
+         "from": {
+            "name": "Sarah Smith",
+            "id": "222574"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Maggie Cook",
+                  "id": "11404163"
+               }
+            ]
+         },
+         "message": "I admit I am here thanks to a Gowalla notification email :)",
+         "place": {
+            "id": "139045549463750",
+            "name": "The Ginger Man",
+            "location": {
+               "latitude": 30.266271416667,
+               "longitude": -97.74553775
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-26T03:14:26+0000",
+         "likes": {
+            "data": [
+               {
+                  "id": "630266137",
+                  "name": "Tom Watson"
+               }
+            ]
+         },
+         "comments": {
+            "data": [
+               {
+                  "id": "699014073033_1045588",
+                  "from": {
+                     "name": "Brooke Segaran",
+                     "id": "685395130"
+                  },
+                  "message": "i love the Ginger Man! I think they have a sister bar in Houston - it was one of my favorites when I lived there.",
+                  "created_time": "2010-08-26T15:38:02+0000"
+               }
+            ],
+            "paging": {
+               "previous": "https://graph.facebook.com/699014073033/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&since=2010-08-26T15%3A38%3A02%2B0000",
+               "next": "https://graph.facebook.com/699014073033/comments?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&until=2010-08-26T15%3A38%3A01%2B0000"
+            }
+         }
+      },
+      {
+         "id": "610777350179",
+         "from": {
+            "name": "Mattt Thompson",
+            "id": "4810308"
+         },
+         "place": {
+            "id": "139045549463750",
+            "name": "The Ginger Man",
+            "location": {
+               "latitude": 30.266271416667,
+               "longitude": -97.74553775
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-26T02:27:11+0000",
+         "likes": {
+            "data": [
+               {
+                  "id": "788861822",
+                  "name": "Kim Ahlstr\u00f6m"
+               }
+            ]
+         }
+      },
+      {
+         "id": "610294378059",
+         "from": {
+            "name": "Mattt Thompson",
+            "id": "4810308"
+         },
+         "place": {
+            "id": "121133247902315",
+            "name": "Caffe Medici",
+            "location": {
+               "street": "1101 W Lynn St",
+               "city": "Austin",
+               "state": "TX",
+               "zip": "78703-3951",
+               "latitude": 30.279843,
+               "longitude": -97.759178
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-23T01:40:17+0000"
+      },
+      {
+         "id": "463895351674",
+         "from": {
+            "name": "Scott Raymond",
+            "id": "505421674"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Sandi Weldon",
+                  "id": "695370206"
+               }
+            ]
+         },
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-20T22:33:26+0000"
+      },
+      {
+         "id": "10100357716724694",
+         "from": {
+            "name": "Patrick Navarro",
+            "id": "8300721"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Maggie Cook",
+                  "id": "11404163"
+               },
+               {
+                  "name": "Drew Yeaton",
+                  "id": "65005613"
+               }
+            ]
+         },
+         "message": "Twitter Happy Hour",
+         "place": {
+            "id": "118824551503801",
+            "name": "Union park",
+            "location": {
+               "latitude": 30.26986587,
+               "longitude": -97.74904483
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-19T23:36:55+0000"
+      },
+      {
+         "id": "461099202106",
+         "from": {
+            "name": "John Marstall",
+            "id": "752752106"
+         },
+         "tags": {
+            "data": [
+               {
+                  "name": "Mattt Thompson",
+                  "id": "4810308"
+               },
+               {
+                  "name": "Phillip Bowden",
+                  "id": "25316885"
+               },
+               {
+                  "name": "Brian Bailey",
+                  "id": "526567227"
+               },
+               {
+                  "name": "John Critz",
+                  "id": "805120116"
+               },
+               {
+                  "name": "Keegan Jones",
+                  "id": "1304370418"
+               }
+            ]
+         },
+         "place": {
+            "id": "120454134658381",
+            "name": "Gowalla HQ",
+            "location": {
+               "latitude": 30.26876,
+               "longitude": -97.74962
+            }
+         },
+         "application": {
+            "name": "Facebook for iPhone",
+            "id": "6628568379"
+         },
+         "created_time": "2010-08-19T19:46:24+0000"
+      }
+   ],
+   "paging": {
+      "previous": "https://graph.facebook.com/4810308/checkins?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&since=2010-09-08T00%3A09%3A25%2B0000",
+      "next": "https://graph.facebook.com/4810308/checkins?access_token=134145643294322%7Ce31f8c85a0ad9e63018eb051-579612276%7CgwSx9WAssLi5sW3vqqe8UPGjchY.&limit=25&until=2010-08-19T19%3A46%3A23%2B0000"
+   }
+}

data/spec/fake_json/users/checkins/mattt_public.json

@@ -0,0 +1,6 @@
+{
+   "error": {
+      "type": "OAuthInvalidTokenException",
+      "message": "An access token is required to request this resource."
+   }
+}

data/spec/fb_graph/checkin_spec.rb

@@ -0,0 +1,5 @@
+require File.join(File.dirname(__FILE__), '../spec_helper')
+
+describe FbGraph::Checkin, '.new' do
+  # TODO
+end

data/spec/fb_graph/connections/checkins_spec.rb

@@ -0,0 +1,109 @@
+require File.join(File.dirname(__FILE__), '../../spec_helper')
+
+context 'when included by FbGraph::User' do
+  describe FbGraph::Connections::Checkins, '#checkins' do
+    before(:all) do
+      fake_json(:get, 'mattt/checkins', 'users/checkins/mattt_public')
+      fake_json(:get, 'mattt/checkins?access_token=access_token', 'users/checkins/mattt_private')
+    end
+
+    context 'when no access_token given' do
+      it 'should raise FbGraph::Unauthorized' do
+        lambda do
+          FbGraph::User.new('mattt').checkins
+        end.should raise_exception(FbGraph::Unauthorized)
+      end
+    end
+
+    context 'when access_token is given' do
+      it 'should return checkins as FbGraph::Checkin' do
+        checkins = FbGraph::User.new('mattt', :access_token => 'access_token').checkins
+        checkins.first.should == FbGraph::Checkin.new(
+          '696876187499',
+          :access_token => 'access_token',
+          :from => {
+            :id => '12820552',
+            :name => 'Roger Pincombe'
+          },
+          :tags => {
+            :data => [{
+              :id => '4810308',
+              :name => 'Mattt Thompson'
+            }]
+          },
+          :message => 'Checking out Austin, TX',
+          :place => {
+            :id => '120454134658381',
+            :name => 'Gowalla HQ',
+            :location => {
+              :latitude => 30.26876,
+              :longitude => -97.74962
+            }
+          },
+          :application => {
+            :id => '6628568379',
+            :name => 'Facebook for iPhone'
+          },
+          :created_time => '2010-09-08T00:09:25+0000'
+        )
+        checkins.each do |checkin|
+          checkin.should be_instance_of(FbGraph::Checkin)
+        end
+      end
+    end
+  end
+end
+
+context 'when included by FbGraph::Page' do
+  describe FbGraph::Connections::Checkins, '#checkins' do
+    before(:all) do
+      fake_json(:get, 'gowalla/checkins', 'pages/checkins/gowalla_public')
+      fake_json(:get, 'gowalla/checkins?access_token=access_token', 'pages/checkins/gowalla_private')
+    end
+
+    context 'when no access_token given' do
+      it 'should raise FbGraph::Unauthorized' do
+        lambda do
+          FbGraph::Page.new('gowalla').checkins
+        end.should raise_exception(FbGraph::Unauthorized)
+      end
+    end
+
+    context 'when access_token is given' do
+      it 'should return checkins as FbGraph::Checkin' do
+        checkins = FbGraph::Page.new('gowalla', :access_token => 'access_token').checkins
+        checkins.first.should == FbGraph::Checkin.new(
+          '696876187499',
+          :access_token => 'access_token',
+          :from => {
+            :id => '12820552',
+            :name => 'Roger Pincombe'
+          },
+          :tags => {
+            :data => [{
+              :id => '4810308',
+              :name => 'Mattt Thompson'
+            }]
+          },
+          :message => 'Checking out Austin, TX',
+          :place => {
+            :id => '120454134658381',
+            :name => 'Gowalla HQ',
+            :location => {
+              :latitude => 30.26876,
+              :longitude => -97.74962
+            }
+          },
+          :application => {
+            :id => '6628568379',
+            :name => 'Facebook for iPhone'
+          },
+          :created_time => '2010-09-08T00:09:25+0000'
+        )
+        checkins.each do |checkin|
+          checkin.should be_instance_of(FbGraph::Checkin)
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: fb_graph
 version: !ruby/object:Gem::Version 
-  hash: 63
+  hash: 23
   prerelease: false
   segments: 
+  - 1
   - 0
-  - 8
   - 0
-  version: 0.8.0
+  version: 1.0.0
 platform: ruby
 authors: 
 - nov matake
@@ -154,6 +154,7 @@ files:
 - lib/fb_graph/connections/albums.rb
 - lib/fb_graph/connections/attending.rb
 - lib/fb_graph/connections/books.rb
+- lib/fb_graph/connections/checkins.rb
 - lib/fb_graph/connections/comments.rb
 - lib/fb_graph/connections/declined.rb
 - lib/fb_graph/connections/events.rb
@@ -210,6 +211,8 @@ files:
 - spec/fake_json/events/maybe/smartday_private.json
 - spec/fake_json/events/noreply/smartday_private.json
 - spec/fake_json/groups/members/emacs_private.json
+- spec/fake_json/pages/checkins/gowalla_private.json
+- spec/fake_json/pages/checkins/gowalla_public.json
 - spec/fake_json/pages/notes/post_with_valid_access_token.json
 - spec/fake_json/pages/platform_private.json
 - spec/fake_json/pages/platform_public.json
@@ -235,6 +238,8 @@ files:
 - spec/fake_json/users/arjun_public.json
 - spec/fake_json/users/books/matake_private.json
 - spec/fake_json/users/books/matake_public.json
+- spec/fake_json/users/checkins/mattt_private.json
+- spec/fake_json/users/checkins/mattt_public.json
 - spec/fake_json/users/events/matake_private.json
 - spec/fake_json/users/events/matake_public.json
 - spec/fake_json/users/events/post_with_valid_access_token.json
@@ -276,6 +281,7 @@ files:
 - spec/fb_graph/album_spec.rb
 - spec/fb_graph/application_spec.rb
 - spec/fb_graph/auth_spec.rb
+- spec/fb_graph/checkin_spec.rb
 - spec/fb_graph/collection_spec.rb
 - spec/fb_graph/comment_spec.rb
 - spec/fb_graph/connection_spec.rb
@@ -284,6 +290,7 @@ files:
 - spec/fb_graph/connections/albums_spec.rb
 - spec/fb_graph/connections/attending_spec.rb
 - spec/fb_graph/connections/books_spec.rb
+- spec/fb_graph/connections/checkins_spec.rb
 - spec/fb_graph/connections/comments_spec.rb
 - spec/fb_graph/connections/declined_spec.rb
 - spec/fb_graph/connections/events_spec.rb
@@ -365,6 +372,7 @@ test_files:
 - spec/fb_graph/album_spec.rb
 - spec/fb_graph/application_spec.rb
 - spec/fb_graph/auth_spec.rb
+- spec/fb_graph/checkin_spec.rb
 - spec/fb_graph/collection_spec.rb
 - spec/fb_graph/comment_spec.rb
 - spec/fb_graph/connection_spec.rb
@@ -373,6 +381,7 @@ test_files:
 - spec/fb_graph/connections/albums_spec.rb
 - spec/fb_graph/connections/attending_spec.rb
 - spec/fb_graph/connections/books_spec.rb
+- spec/fb_graph/connections/checkins_spec.rb
 - spec/fb_graph/connections/comments_spec.rb
 - spec/fb_graph/connections/declined_spec.rb
 - spec/fb_graph/connections/events_spec.rb