cmdrkeene-foursquare 0.0.2 → 0.0.3

data/LICENSE

@@ -1 +1,20 @@
-Until further notice: Copyright 2009 Brandon Keene - All Rights Reserved
+Copyright (c) 2009 Brandon Keene
+ 
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+ 
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,104 @@
+Foursquare
+==========
+
+A ruby interface for Foursquare's [JSON API](http://groups.google.com/group/foursquare-api/web/api-documentation).
+Sign up for a Foursquare account at [http://playfoursquare.com](http://playfoursquare.com).
+
+Install
+-------
+
+    $ gem sources -a http://gems.github.com
+    $ sudo gem install cmdrkeene-foursquare
+
+Usage
+-----
+
+### checkin(options = {}) 
+
+Allows you to check-in to a place.
+
+First, create a new Foursquare instance with your Basic Authentication
+credentials:
+
+    @foursquare = Foursquare.new("user@example.com", "sekret")
+
+Then, you can check in with a venue id (vid):
+
+    @foursquare.checkin(:vid => 1234)
+    
+Or you can check in with a name search for a venue:
+
+    @foursquare.checkin(:venue => "Mamoun's")
+
+If successful, you will get a response hash with the following keys:
+
+*    **ID**
+
+        "id" => 701707
+
+*    **Message**
+
+        "message" => "OK! We've got you @ Santana's Bay Park."
+
+*    **Created**
+
+        "created" => "Tue, 11 Aug 09 16:02:13 +0000"
+
+
+*    **Mayor**
+
+        "mayor" => {
+          "type"    => "nochange",
+          "message" => "Casey W. is The Mayor of Santana's Bay Park."
+        }
+
+*    **Scoring**
+
+        "scoring" => {
+          "score" => {
+            "icon"    => "http://playfoursquare.com/images/scoring/2.png",
+            "points"  => 1,
+            "message" => "First stop today"
+          },
+          "total" => {
+            "points"  => 6,
+            "message" => "6 pts "
+          },
+          "rank" => {
+            "city" => {
+              "city"      => "San Diego",
+              "position"  => 42,
+              "message"   => "#42 in San Diego (this week)"
+            },
+            "friends" => {
+              "position"  => 1,
+              "message"   => "#1 amongst friends"
+            }
+          }
+        }
+
+*    **Badges**
+
+        "badges" => {
+          "badge" => {
+            "name"  => "Newbie",
+            "text"  => "Congrats on your first check-in!",
+            "icon"  => "http://playfoursquare.com/images/badges/newbie_on.png",
+            "id"    => 54494
+          }
+        }
+
+*    **Venue**
+    
+        "venue" => {
+          "city"        => "San Diego",
+          "address"     => "1975 Morena Blvd.",
+          "name"        => "Santana's Bay Park",
+          "zip"         => 92110, 
+          "geolong"     => -117.207,
+          "geolat"      => 32.782, 
+          "crossstreet" => nil,
+          "id"          => 84689,
+          "cityid"      => 38,
+          "state"       => "CA"
+        }

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/foursquare.gemspec

@@ -5,20 +5,20 @@
 
 Gem::Specification.new do |s|
   s.name = %q{foursquare}
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Brandon Keene"]
-  s.date = %q{2009-08-12}
+  s.date = %q{2009-08-28}
   s.description = %q{Ruby API for Foursquare (playfoursquare.com)}
   s.email = %q{bkeene@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README"
+     "README.markdown"
   ]
   s.files = [
     "LICENSE",
-     "README",
+     "README.markdown",
      "Rakefile",
      "VERSION",
      "foursquare.gemspec",
@@ -26,6 +26,12 @@ Gem::Specification.new do |s|
      "lib/foursquare.rb",
      "spec/fixtures/checkin_failure.json",
      "spec/fixtures/checkin_success.json",
+     "spec/fixtures/cities.json",
+     "spec/fixtures/test_failure.json",
+     "spec/fixtures/test_success.json",
+     "spec/fixtures/user.json",
+     "spec/fixtures/venues_authenticated.json",
+     "spec/fixtures/venues_unauthenticated.json",
      "spec/foursquare_spec.rb",
      "spec/spec_helper.rb"
   ]

data/lib/foursquare.rb

@@ -1,20 +1,126 @@
 require 'httparty'
 
 class Foursquare
+  class AuthenticationRequiredError < StandardError;end
   class VenueNotFoundError < StandardError;end
-  
+
   include HTTParty
   base_uri "http://api.playfoursquare.com/v1"
   format :json
-  
-  def initialize(username, password)
+
+  def initialize(username = nil, password = nil)
     @auth = {:username => username, :password => password}
   end
-  
-  def checkin(venue_id)
-    raise ArgumentError, "you must pass a venue_id" unless venue_id
-    response = self.class.post("/checkin.json", {:query => {:vid => venue_id}, :basic_auth => @auth})
+
+  # Allows you to check-in to a place.
+  #
+  # Options
+  #   :vid      => (optional, not necessary if you are 'shouting' or have a
+  #                venue name). ID of the venue where you want to check-in.
+  #   :venue    => (optional, not necessary if you are 'shouting' or have a
+  #                vid) if you don't have a venue ID, pass the venue name as
+  #                a string using this parameter. foursquare will attempt to
+  #                match it on the server-side
+  #   :shout    => (optional) a message about your check-in
+  #   :private  => (optional, defaults to the user's setting). true means
+  #                "don't show your friends". false means "show everyone"
+  #   :twitter  => (optional, defaults to the user's setting). false means
+                   # "send to twitter". false means "don't send to twitter"
+  #   :geolat   => (optional, but recommended)
+  #   :geolong  => (optional, but recommended)
+  def checkin(options = {})
+    unless options[:private].nil?
+      options[:private] = 1 if options[:private] == true
+      options[:private] = 0 if options[:private] == false
+    end
+    unless options[:twitter].nil?
+      options[:twitter] = 1 if options[:twitter] == true
+      options[:twitter] = 0 if options[:twitter] == false
+    end
+    response = self.class.post("/checkin.json",
+                               :query => options,
+                               :basic_auth => @auth)
     raise VenueNotFoundError if response.keys.include?("addvenueprompt")
     response["checkin"]
   end
+
+  # Like self.venues(), except when authenticated the method will return venue
+  # meta-data related to you and your friends.
+  def venues(options = {})
+    self.class.require_latitude_and_longitude(options)
+
+    response = self.class.get("/venues.json",
+                              :query => options,
+                              :basic_auth => @auth)["venues"]
+    response && response.flatten
+  end
+  
+  # Returns data for a particular user
+  #
+  # Options
+  #   :uid    => userid for the user whose information you want to retrieve. 
+  #              if you do not specify a 'uid', the authenticated user's 
+  #              profile data will be returned.
+  #   :badges => (optional, default: false) set to true ("1") to also show 
+  #              badges for this user
+  #   :mayor  => (optional, default: false) set to true ("1") to also show 
+  #              venues for which this user is a mayor
+  def user(options = {}) 
+    self.class.get("/user.json", :query => options)["user"]
+  end
+
+  ############################################################################
+  # Class methods
+  ############################################################################
+
+  # Returns a list of currently active cities.
+  # http://api.playfoursquare.com/v1/cities
+  def self.cities
+    get("/cities.json", :query => nil)["cities"]
+  end
+
+  # Returns a list of tips near the area specified. (The distance returned is 
+  # in miles).
+  # Options
+  #   :geolat   => latitude (required)
+  #   :geolong  => longitude (required)
+  # 
+  # http://api.playfoursquare.com/v1/tips
+  def self.tips(options = {})
+    require_latitude_and_longitude(options)
+    # XXX
+  end
+  
+  # Returns a list of venues near the area specified or that match the search
+  # term. Distance returned is in miles. It will return venue meta-data
+  # related to you and your friends.
+  #
+  # Options
+  #   :geolat   => latitude (required)
+  #   :geolong  => longitude (required)
+  #   :r        => radius in miles (optional)
+  #   :l        => limit of results (optional, default 10)
+  #   :q        => keyword search (optional)
+  # 
+  # http://api.playfoursquare.com/v1/venues
+  def self.venues(options = {})
+    require_latitude_and_longitude(options)
+
+    get("/venues.json", :query => options)["venues"]["group"]
+  end
+
+  # Test if API is up and available
+  # http://api.playfoursquare.com/v1/test
+  def self.available?
+    response = get("/test.json", :query => nil)
+    (!response.nil? && response["response"] == "ok") ? true : false
+  end
+
+  private
+
+  def self.require_latitude_and_longitude(options)
+    unless options[:geolat] and options[:geolong]
+      raise ArgumentError, "you must supply :geolat and :geolong"
+    end
+  end
 end

data/spec/fixtures/cities.json

@@ -0,0 +1 @@
+{"cities":[{"id":56,"timezone":"Europe/Amsterdam","name":"Amsterdam","geolat":52.3789,"geolong":4.90067},{"id":46,"timezone":"America/New_York","name":"Atlanta","geolat":33.7525,"geolong":-84.3888},{"id":42,"timezone":"America/Chicago","name":"Austin","geolat":30.2669,"geolong":-97.7428},{"id":24,"timezone":"America/New_York","name":"Boston","geolat":42.3583,"geolong":-71.0603},{"id":32,"timezone":"America/Chicago","name":"Chicago","geolat":41.8858,"geolong":-87.6181},{"id":43,"timezone":"America/Chicago","name":"Dallas / Fort Worth","geolat":32.7887,"geolong":-96.7676},{"id":25,"timezone":"America/Denver","name":"Denver","geolat":39.734,"geolong":-105.026},{"id":47,"timezone":"America/New_York","name":"Detroit","geolat":42.3333,"geolong":-83.0484},{"id":48,"timezone":"America/Chicago","name":"Houston","geolat":29.7594,"geolong":-95.3594},{"id":49,"timezone":"America/Los_Angeles","name":"Las Vegas","geolat":36.1721,"geolong":-115.122},{"id":34,"timezone":"America/Los_Angeles","name":"Los Angeles","geolat":34.0443,"geolong":-118.251},{"id":39,"timezone":"America/New_York","name":"Miami","geolat":25.7323,"geolong":-80.2436},{"id":51,"timezone":"America/Chicago","name":"Minneapolis / St. Paul","geolat":44.9609,"geolong":-93.2642},{"id":22,"timezone":"America/New_York","name":"New York City","geolat":40.7255,"geolong":-73.9983},{"id":33,"timezone":"America/New_York","name":"Philadelphia","geolat":39.8694,"geolong":-75.2731},{"id":53,"timezone":"America/Phoenix","name":"Phoenix","geolat":33.4483,"geolong":-112.073},{"id":37,"timezone":"America/Los_Angeles","name":"Portland","geolat":45.527,"geolong":-122.685},{"id":38,"timezone":"America/Los_Angeles","name":"San Diego","geolat":32.7153,"geolong":-117.156},{"id":23,"timezone":"America/Los_Angeles","name":"San Francisco","geolat":37.7587,"geolong":-122.433},{"id":41,"timezone":"America/Los_Angeles","name":"Seattle","geolat":47.6036,"geolong":-122.326},{"id":31,"timezone":"America/New_York","name":"Washington, DC","geolat":38.8964,"geolong":-77.0447}]}

data/spec/fixtures/test_success.json

@@ -0,0 +1 @@
+{"response":"ok"}

data/spec/fixtures/user.json

@@ -0,0 +1 @@
+{"user":{"id":31786,"firstname":"John","lastname":"Connor","city":{"id":38,"name":"San Diego","shortname":"San Diego","geolat":32.7153,"geolong":-117.156},"gender":"none","settings":{"feeds_key":"9c0cf605ddd2251495640129c7c40c6e"},"checkin":{"id":707746,"shout":null,"display":"John C. @ Santana's Mexican Grill (Bay Park)","created":"Wed, 12 Aug 09 10:21:33 +0000","venue":{"id":84689,"name":"Santana's Mexican Grill (Bay Park)","address":"1975 Morena Blvd","crossstreet":"Napier St","geolat":32.782,"geolong":-117.207}}}}

data/spec/fixtures/venues_authenticated.json

@@ -0,0 +1 @@
+{"venues":[[{"id":10350,"name":"Sandbar","distance":0.1,"address":"3064 Grand Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7281,"geolong":-80.2428,"stats":{"checkins":18}},{"id":10287,"name":"Mr. Moe's","distance":0.1,"address":"3131 Commodore Plaza","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7274,"geolong":-80.2441,"stats":{"checkins":6}},{"id":18315,"name":"Barracuda Bar","distance":0.1,"address":"3035 Fuller St","crossstreet":"at Grand Ave","city":"Miami","state":"FL","zip":33133,"phone":"305 448-1144","geolat":25.7276,"geolong":-80.2432,"stats":{"checkins":4}},{"id":45598,"name":"Boardwalk Tavern & Pizzeria","distance":0.1,"address":"3415 Main Hwy","crossstreet":null,"city":"Coconut Grove","state":"FL","zip":33133,"phone":"305-567-0080","geolat":25.7277,"geolong":-80.2427,"stats":{"checkins":3}}],[{"id":88408,"name":"Barracadu Bar & Grill }i{","distance":0.1,"address":"3035 Fuller St,","crossstreet":"btw Main Hwy and Grand ave","city":"Miami","state":"FL","zip":33133,"phone":"(305) 448-1144","geolat":25.7276,"geolong":-80.2432},{"id":85556,"name":"Barracadu Coconut Grove}i{","distance":0.1,"address":"3035 Fuller St","crossstreet":"btw Main Hwy and Grand ave","city":"Miami","state":"FL","zip":null,"phone":"(305) 448-1144","geolat":25.7276,"geolong":-80.2432},{"id":10147,"name":"Don Quixote","distance":0.1,"address":"3120 Commodore Plaza","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7271,"geolong":-80.2447},{"id":10219,"name":"Hungry Sailor","distance":0.1,"address":"3424 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7276,"geolong":-80.2428},{"id":10391,"name":"Tavern In The Grove","distance":0.1,"address":"3416 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7276,"geolong":-80.2427},{"id":10356,"name":"Senor Frogs","distance":0.1,"address":"3480 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7267,"geolong":-80.2442},{"id":10252,"name":"Life","distance":0.2,"address":"3342 Virginia St","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7289,"geolong":-80.2415},{"id":84676,"name":"InfiniHQ","distance":0.2,"address":"3339 Virginia St","crossstreet":"at Oak Ave","city":"Miami","state":"FL","zip":33133,"phone":3057284641,"geolat":25.7292,"geolong":-80.2413},{"id":10173,"name":"Flavour","distance":0.2,"address":"2895 McFarlane RD.","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7275,"geolong":-80.2411},{"id":10390,"name":"Taurus Chops","distance":0.2,"address":"3540 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7251,"geolong":-80.245},{"id":10305,"name":"Oxygen Lounge","distance":0.2,"address":"2911 Grand Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7285,"geolong":-80.2406},{"id":10331,"name":"Quench","distance":0.3,"address":"2801 Florida Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":"305 448-8150","geolat":25.7291,"geolong":-80.2395},{"id":10224,"name":"Improv Comedy Club","distance":0.3,"address":"3390 Mary St","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7282,"geolong":-80.2393},{"id":80526,"name":"The Jewlicious Pad","distance":0.4,"address":"Grand Ave","crossstreet":null,"city":"Coconut Grove","state":"FL","zip":null,"phone":null,"twitter":"jewgonewild","geolat":25.7278,"geolong":-80.2499},{"id":10124,"name":"Cocont Grove Expo Center","distance":0.4,"address":"2700 south bayshore drive","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7282,"geolong":-80.2379},{"id":66946,"name":"Flordia","distance":0.4,"address":"650 williamstreet","crossstreet":"Sr mia","city":"Miami","state":"FL","zip":null,"phone":null,"geolat":25.7263,"geolong":-80.2511},{"id":83833,"name":"Doubletree Coconut Grove","distance":0.6,"address":"2649 South Bayshore Drive","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":"305-858-2500","geolat":25.7312,"geolong":-80.2353},{"id":86452,"name":"Scottys Landing","distance":0.6,"address":"3381 pan American drive","crossstreet":null,"city":"Coconut grove","state":"FL","zip":33133,"phone":null,"geolat":25.7278,"geolong":-80.2342},{"id":18241,"name":"Monty's","distance":0.8,"address":"2550 South Bayshore Drive","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":"305 858-1431","geolat":25.7321,"geolong":-80.2326},{"id":85554,"name":"Berries in the Grove }i{","distance":0.8,"address":"2884 S.W. 27th Ave","crossstreet":"btw US1 and Coconut ave","city":"Miami","state":"FL","zip":33133,"phone":"(305) 448-2111","geolat":25.7382,"geolong":-80.2381}]]}

data/spec/fixtures/venues_unauthenticated.json

@@ -0,0 +1 @@
+{"venues":{"group":[{"id":84676,"name":"InfiniHQ","distance":0.3,"address":"3339 Virginia St","crossstreet":"at Oak Ave","city":"Miami","state":"FL","zip":33133,"phone":3057284641,"geolat":25.7292,"geolong":-80.2413},{"id":10252,"name":"Life","distance":0.3,"address":"3342 Virginia St","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7289,"geolong":-80.2415},{"id":10350,"name":"Sandbar","distance":0.3,"address":"3064 Grand Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7281,"geolong":-80.2428},{"id":10305,"name":"Oxygen Lounge","distance":0.3,"address":"2911 Grand Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7285,"geolong":-80.2406},{"id":45598,"name":"Boardwalk Tavern & Pizzeria","distance":0.3,"address":"3415 Main Hwy","crossstreet":null,"city":"Coconut Grove","state":"FL","zip":33133,"phone":"305-567-0080","geolat":25.7277,"geolong":-80.2427},{"id":88408,"name":"Barracadu Bar & Grill }i{","distance":0.3,"address":"3035 Fuller St,","crossstreet":"btw Main Hwy and Grand ave","city":"Miami","state":"FL","zip":33133,"phone":"(305) 448-1144","geolat":25.7276,"geolong":-80.2432},{"id":85556,"name":"Barracadu Coconut Grove}i{","distance":0.3,"address":"3035 Fuller St","crossstreet":"btw Main Hwy and Grand ave","city":"Miami","state":"FL","zip":null,"phone":"(305) 448-1144","geolat":25.7276,"geolong":-80.2432},{"id":18315,"name":"Barracuda Bar","distance":0.3,"address":"3035 Fuller St","crossstreet":"at Grand Ave","city":"Miami","state":"FL","zip":33133,"phone":"305 448-1144","geolat":25.7276,"geolong":-80.2432},{"id":10219,"name":"Hungry Sailor","distance":0.3,"address":"3424 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7276,"geolong":-80.2428},{"id":10391,"name":"Tavern In The Grove","distance":0.3,"address":"3416 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7276,"geolong":-80.2427},{"id":10331,"name":"Quench","distance":0.3,"address":"2801 Florida Ave","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":"305 448-8150","geolat":25.7291,"geolong":-80.2395},{"id":10287,"name":"Mr. Moe's","distance":0.3,"address":"3131 Commodore Plaza","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7274,"geolong":-80.2441},{"id":10147,"name":"Don Quixote","distance":0.4,"address":"3120 Commodore Plaza","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7271,"geolong":-80.2447},{"id":10173,"name":"Flavour","distance":0.4,"address":"2895 McFarlane RD.","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7275,"geolong":-80.2411},{"id":10356,"name":"Senor Frogs","distance":0.4,"address":"3480 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7267,"geolong":-80.2442},{"id":10224,"name":"Improv Comedy Club","distance":0.4,"address":"3390 Mary St","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7282,"geolong":-80.2393},{"id":10124,"name":"Cocont Grove Expo Center","distance":0.5,"address":"2700 south bayshore drive","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7282,"geolong":-80.2379},{"id":80526,"name":"The Jewlicious Pad","distance":0.5,"address":"Grand Ave","crossstreet":null,"city":"Coconut Grove","state":"FL","zip":null,"phone":null,"twitter":"jewgonewild","geolat":25.7278,"geolong":-80.2499},{"id":10390,"name":"Taurus Chops","distance":0.5,"address":"3540 Main Highway","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":null,"geolat":25.7251,"geolong":-80.245},{"id":83833,"name":"Doubletree Coconut Grove","distance":0.5,"address":"2649 South Bayshore Drive","crossstreet":null,"city":"Miami","state":"FL","zip":33133,"phone":"305-858-2500","geolat":25.7312,"geolong":-80.2353}]}}

data/spec/foursquare_spec.rb

@@ -2,48 +2,45 @@ require File.dirname(__FILE__) + '/spec_helper'
 require File.dirname(__FILE__) + '/../init'
 
 describe Foursquare do
-  describe ".checkin" do
+  before do
+    @username = "user@example.com"
+    @password = "secret"
+  end
+
+  describe "#checkin" do
     before do
-      @valid_venue_id   = 84689
-      @invalid_venue_id = 111
-      @username = "user@example.com"
-      @password = "secret"
+      @valid_vid   = 84689
+      @invalid_vid = 111
 
       # Success
       FakeWeb.register_uri(:post,
-                           "http://api.playfoursquare.com/v1/checkin.json?vid=#{@valid_venue_id}",
+                           "http://api.playfoursquare.com/v1/checkin.json?vid=#{@valid_vid}",
                            :body => "Unauthorized",
                            :status => ["401", "Unauthorized"])
       FakeWeb.register_uri(:post,
-                           "http://user%40example.com:secret@api.playfoursquare.com/v1/checkin.json?vid=#{@valid_venue_id}",
+                           "http://user%40example.com:secret@api.playfoursquare.com/v1/checkin.json?vid=#{@valid_vid}",
                            :body => fakeweb_read('checkin_success.json'))
 
       # Failure
       FakeWeb.register_uri(:post,
-                           "http://api.playfoursquare.com/v1/checkin.json?vid=#{@invalid_venue_id}",
+                           "http://api.playfoursquare.com/v1/checkin.json?vid=#{@invalid_vid}",
                            :body => "Unauthorized",
                            :status => ["401", "Unauthorized"])
       FakeWeb.register_uri(:post,
-                           "http://user%40example.com:secret@api.playfoursquare.com/v1/checkin.json?vid=#{@invalid_venue_id}",
+                           "http://user%40example.com:secret@api.playfoursquare.com/v1/checkin.json?vid=#{@invalid_vid}",
                            :body => fakeweb_read('checkin_failure.json'))
     end
-    
-    it "should require a venue_id" do
-      lambda {
-        Foursquare.new(@username, @password).checkin
-      }.should raise_error(ArgumentError)
-    end
-    
+
     it "should raise an error if user is invalid" do
       lambda {
-        Foursquare.new("bork@pork.com", "arglebargle").checkin(@valid_venue_id)
+        Foursquare.new("bork@pork.com", "arglebargle").checkin(@valid_vid)
       }.should raise_error
     end
-    
+
     describe "to a valid venue, with a valid user" do
       it "should check in and return check in data" do
         @foursquare = Foursquare.new(@username, @password)
-        checkin = @foursquare.checkin(@valid_venue_id)
+        checkin = @foursquare.checkin(:vid => @valid_vid)
         checkin.should == {
           "mayor"     => {"type"=>"nochange", "message"=>"Casey W. is The Mayor of Santana's Bay Park."},
           "scoring"   => {
@@ -54,7 +51,7 @@ describe Foursquare do
               "friends" => {"position"=>1, "message"=>"#1 amongst friends"}
             },
           },
-          "id" => 701707, 
+          "id" => 701707,
           "badges" => {
             "badge" => {"name"=>"Newbie", "text"=>"Congrats on your first check-in!", "icon"=>"http://playfoursquare.com/images/badges/newbie_on.png", "id"=>54494}
           },
@@ -63,26 +60,214 @@ describe Foursquare do
         }
       end
     end
-    
+
     describe "with an invalid venue" do
       it "should raise an error" do
         lambda {
           @foursquare = Foursquare.new(@username, @password)
-          @foursquare.checkin(@invalid_venue_id).should == "foo"
+          @foursquare.checkin(:vid => @invalid_vid).should == "foo"
         }.should raise_error(Foursquare::VenueNotFoundError)
       end
     end
   end
 
-  describe ".city" do
+  describe ".cities" do
+    before do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/cities.json",
+                           :body => fakeweb_read('cities.json'))
+    end
+
+    it "should return all cities currently active on Foursquare" do
+      cities = [
+        {"name"=>"Amsterdam", "geolong"=>4.90067, "geolat"=>52.3789, "timezone"=>"Europe/Amsterdam", "id"=>56},
+        {"name"=>"Atlanta", "geolong"=>-84.3888, "geolat"=>33.7525, "timezone"=>"America/New_York", "id"=>46},
+        {"name"=>"Austin", "geolong"=>-97.7428, "geolat"=>30.2669, "timezone"=>"America/Chicago", "id"=>42},
+        {"name"=>"Boston", "geolong"=>-71.0603, "geolat"=>42.3583, "timezone"=>"America/New_York", "id"=>24},
+        {"name"=>"Chicago", "geolong"=>-87.6181, "geolat"=>41.8858, "timezone"=>"America/Chicago", "id"=>32},
+        {"name"=>"Dallas / Fort Worth", "geolong"=>-96.7676, "geolat"=>32.7887, "timezone"=>"America/Chicago", "id"=>43},
+        {"name"=>"Denver", "geolong"=>-105.026, "geolat"=>39.734, "timezone"=>"America/Denver", "id"=>25},
+        {"name"=>"Detroit", "geolong"=>-83.0484, "geolat"=>42.3333, "timezone"=>"America/New_York", "id"=>47},
+        {"name"=>"Houston", "geolong"=>-95.3594, "geolat"=>29.7594, "timezone"=>"America/Chicago", "id"=>48},
+        {"name"=>"Las Vegas", "geolong"=>-115.122, "geolat"=>36.1721, "timezone"=>"America/Los_Angeles", "id"=>49},
+        {"name"=>"Los Angeles", "geolong"=>-118.251, "geolat"=>34.0443, "timezone"=>"America/Los_Angeles", "id"=>34},
+        {"name"=>"Miami", "geolong"=>-80.2436, "geolat"=>25.7323, "timezone"=>"America/New_York", "id"=>39},
+        {"name"=>"Minneapolis / St. Paul", "geolong"=>-93.2642, "geolat"=>44.9609, "timezone"=>"America/Chicago", "id"=>51},
+        {"name"=>"New York City", "geolong"=>-73.9983, "geolat"=>40.7255, "timezone"=>"America/New_York", "id"=>22},
+        {"name"=>"Philadelphia", "geolong"=>-75.2731, "geolat"=>39.8694, "timezone"=>"America/New_York", "id"=>33},
+        {"name"=>"Phoenix", "geolong"=>-112.073, "geolat"=>33.4483, "timezone"=>"America/Phoenix", "id"=>53},
+        {"name"=>"Portland", "geolong"=>-122.685, "geolat"=>45.527, "timezone"=>"America/Los_Angeles", "id"=>37},
+        {"name"=>"San Diego", "geolong"=>-117.156, "geolat"=>32.7153, "timezone"=>"America/Los_Angeles", "id"=>38},
+        {"name"=>"San Francisco", "geolong"=>-122.433, "geolat"=>37.7587, "timezone"=>"America/Los_Angeles", "id"=>23},
+        {"name"=>"Seattle", "geolong"=>-122.326, "geolat"=>47.6036, "timezone"=>"America/Los_Angeles", "id"=>41},
+        {"name"=>"Washington, DC", "geolong"=>-77.0447, "geolat"=>38.8964, "timezone"=>"America/New_York", "id"=>31}
+      ]
+      Foursquare.cities.should == cities
+    end
+  end
+
+  describe ".tips" do
+    # Having problems with the tips resource respect coordinates
   end
 
-  describe ".tip" do
+  describe "#user" do
+    it "should return user data for an arbitrary user" do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/user.json?uid=31786",
+                           :body => fakeweb_read('user.json'))
+      
+      @foursquare = Foursquare.new(@username, @password)
+      @foursquare.user(:uid => 31786).should == {
+        "city" => {"shortname"=>"San Diego", 
+                   "name"=>"San Diego",
+                   "geolong"=>-117.156,
+                   "geolat"=>32.7153, "id"=>38},
+        "gender"=>"none",
+        "lastname"=>"Connor",
+        "id"=>31786,
+        "checkin"=>{"shout"=>nil,
+                    "id"=>707746,
+                    "display"=>"John C. @ Santana's Mexican Grill (Bay Park)",
+                    "venue"=>{"address"=>"1975 Morena Blvd",
+                              "name"=>"Santana's Mexican Grill (Bay Park)", 
+                              "geolong"=>-117.207,
+                              "geolat"=>32.782,
+                              "crossstreet"=>"Napier St",
+                              "id"=>84689},
+        "created"=>"Wed, 12 Aug 09 10:21:33 +0000"},
+        "firstname"=>"John",
+        "settings"=>{"feeds_key"=>"9c0cf605ddd2251495640129c7c40c6e"}}
+    end
+
+    it "should return user data for the authenticated user" do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/user.json",
+                           :body => fakeweb_read('user.json'))
+      
+      @foursquare = Foursquare.new(@username, @password)
+      @foursquare.user.should == {
+        "city" => {"shortname"=>"San Diego", 
+                   "name"=>"San Diego",
+                   "geolong"=>-117.156,
+                   "geolat"=>32.7153, "id"=>38},
+        "gender"=>"none",
+        "lastname"=>"Connor",
+        "id"=>31786,
+        "checkin"=>{"shout"=>nil,
+                    "id"=>707746,
+                    "display"=>"John C. @ Santana's Mexican Grill (Bay Park)",
+                    "venue"=>{"address"=>"1975 Morena Blvd",
+                              "name"=>"Santana's Mexican Grill (Bay Park)", 
+                              "geolong"=>-117.207,
+                              "geolat"=>32.782,
+                              "crossstreet"=>"Napier St",
+                              "id"=>84689},
+        "created"=>"Wed, 12 Aug 09 10:21:33 +0000"},
+        "firstname"=>"John",
+        "settings"=>{"feeds_key"=>"9c0cf605ddd2251495640129c7c40c6e"}}
+    end
   end
   
-  describe ".user" do
+  describe "#user" do
+    it "should return authenticated user's data" do
+      
+    end
   end
-    
+
   describe ".venue" do
+    before do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/venues.json?geolat=25.7323&geolong=80.2436",
+                           :body => fakeweb_read('venues_unauthenticated.json'))
+    end
+
+    it "should raise an error unless geolat and geolong are passed" do
+      lambda {
+        Foursquare.venues
+      }.should raise_error(ArgumentError)
+    end
+
+    it "should return a list of nearby venues" do
+      venues = [
+        {"city"=>"Miami", "address"=>"3339 Virginia St", "name"=>"InfiniHQ", "zip"=>33133, "geolong"=>-80.2413, "geolat"=>25.7292, "crossstreet"=>"at Oak Ave", "id"=>84676, "phone"=>3057284641, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3342 Virginia St", "name"=>"Life", "zip"=>33133, "geolong"=>-80.2415, "geolat"=>25.7289, "crossstreet"=>nil, "id"=>10252, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3064 Grand Ave", "name"=>"Sandbar", "zip"=>33133, "geolong"=>-80.2428, "geolat"=>25.7281, "crossstreet"=>nil, "id"=>10350, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"2911 Grand Ave", "name"=>"Oxygen Lounge", "zip"=>33133, "geolong"=>-80.2406, "geolat"=>25.7285, "crossstreet"=>nil, "id"=>10305, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Coconut Grove", "address"=>"3415 Main Hwy", "name"=>"Boardwalk Tavern & Pizzeria", "zip"=>33133, "geolong"=>-80.2427, "geolat"=>25.7277, "crossstreet"=>nil, "id"=>45598, "phone"=>"305-567-0080", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3035 Fuller St,", "name"=>"Barracadu Bar & Grill }i{", "zip"=>33133, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"btw Main Hwy and Grand ave", "id"=>88408, "phone"=>"(305) 448-1144", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3035 Fuller St", "name"=>"Barracadu Coconut Grove}i{", "zip"=>nil, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"btw Main Hwy and Grand ave", "id"=>85556, "phone"=>"(305) 448-1144", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3035 Fuller St", "name"=>"Barracuda Bar", "zip"=>33133, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"at Grand Ave", "id"=>18315, "phone"=>"305 448-1144", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3424 Main Highway", "name"=>"Hungry Sailor", "zip"=>33133, "geolong"=>-80.2428, "geolat"=>25.7276, "crossstreet"=>nil, "id"=>10219, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3416 Main Highway", "name"=>"Tavern In The Grove", "zip"=>33133, "geolong"=>-80.2427, "geolat"=>25.7276, "crossstreet"=>nil, "id"=>10391, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"2801 Florida Ave", "name"=>"Quench", "zip"=>33133, "geolong"=>-80.2395, "geolat"=>25.7291, "crossstreet"=>nil, "id"=>10331, "phone"=>"305 448-8150", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3131 Commodore Plaza", "name"=>"Mr. Moe's", "zip"=>33133, "geolong"=>-80.2441, "geolat"=>25.7274, "crossstreet"=>nil, "id"=>10287, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3120 Commodore Plaza", "name"=>"Don Quixote", "zip"=>33133, "geolong"=>-80.2447, "geolat"=>25.7271, "crossstreet"=>nil, "id"=>10147, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"2895 McFarlane RD.", "name"=>"Flavour", "zip"=>33133, "geolong"=>-80.2411, "geolat"=>25.7275, "crossstreet"=>nil, "id"=>10173, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"3480 Main Highway", "name"=>"Senor Frogs", "zip"=>33133, "geolong"=>-80.2442, "geolat"=>25.7267, "crossstreet"=>nil, "id"=>10356, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"3390 Mary St", "name"=>"Improv Comedy Club", "zip"=>33133, "geolong"=>-80.2393, "geolat"=>25.7282, "crossstreet"=>nil, "id"=>10224, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"2700 south bayshore drive", "name"=>"Cocont Grove Expo Center", "zip"=>33133, "geolong"=>-80.2379, "geolat"=>25.7282, "crossstreet"=>nil, "id"=>10124, "phone"=>nil, "state"=>"FL", "distance"=>0.5},
+        {"city"=>"Coconut Grove", "address"=>"Grand Ave", "name"=>"The Jewlicious Pad", "zip"=>nil, "geolong"=>-80.2499, "geolat"=>25.7278, "crossstreet"=>nil, "id"=>80526, "phone"=>nil, "twitter"=>"jewgonewild", "state"=>"FL", "distance"=>0.5},
+        {"city"=>"Miami", "address"=>"3540 Main Highway", "name"=>"Taurus Chops", "zip"=>33133, "geolong"=>-80.245, "geolat"=>25.7251, "crossstreet"=>nil, "id"=>10390, "phone"=>nil, "state"=>"FL", "distance"=>0.5},
+        {"city"=>"Miami", "address"=>"2649 South Bayshore Drive", "name"=>"Doubletree Coconut Grove", "zip"=>33133, "geolong"=>-80.2353, "geolat"=>25.7312, "crossstreet"=>nil, "id"=>83833, "phone"=>"305-858-2500", "state"=>"FL", "distance"=>0.5}
+      ]
+      Foursquare.venues(:geolat => 25.7323, :geolong => 80.2436)
+    end
+  end
+
+  describe "#venue" do
+    before do
+      FakeWeb.register_uri(:get,
+                           "http://user%40example.com:secret@api.playfoursquare.com/v1/venues.json?geolat=25.7323&geolong=80.2436",
+                           :body => fakeweb_read('venues_authenticated.json'))
+    end
+
+    it "should return venues with user metadata" do
+      venues_with_user_data = [
+        {"city"=>"Miami", "address"=>"3064 Grand Ave", "name"=>"Sandbar", "zip"=>33133, "stats"=>{"checkins"=>18}, "geolong"=>-80.2428, "geolat"=>25.7281, "crossstreet"=>nil, "id"=>10350, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3131 Commodore Plaza", "name"=>"Mr. Moe's", "zip"=>33133, "stats"=>{"checkins"=>6}, "geolong"=>-80.2441, "geolat"=>25.7274, "crossstreet"=>nil, "id"=>10287, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3035 Fuller St", "name"=>"Barracuda Bar", "zip"=>33133, "stats"=>{"checkins"=>4}, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"at Grand Ave", "id"=>18315, "phone"=>"305 448-1144", "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Coconut Grove", "address"=>"3415 Main Hwy", "name"=>"Boardwalk Tavern & Pizzeria", "zip"=>33133, "stats"=>{"checkins"=>3}, "geolong"=>-80.2427, "geolat"=>25.7277, "crossstreet"=>nil, "id"=>45598, "phone"=>"305-567-0080", "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3035 Fuller St,", "name"=>"Barracadu Bar & Grill }i{", "zip"=>33133, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"btw Main Hwy and Grand ave", "id"=>88408, "phone"=>"(305) 448-1144", "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3035 Fuller St", "name"=>"Barracadu Coconut Grove}i{", "zip"=>nil, "geolong"=>-80.2432, "geolat"=>25.7276, "crossstreet"=>"btw Main Hwy and Grand ave", "id"=>85556, "phone"=>"(305) 448-1144", "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3120 Commodore Plaza", "name"=>"Don Quixote", "zip"=>33133, "geolong"=>-80.2447, "geolat"=>25.7271, "crossstreet"=>nil, "id"=>10147, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3424 Main Highway", "name"=>"Hungry Sailor", "zip"=>33133, "geolong"=>-80.2428, "geolat"=>25.7276, "crossstreet"=>nil, "id"=>10219, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3416 Main Highway", "name"=>"Tavern In The Grove", "zip"=>33133, "geolong"=>-80.2427, "geolat"=>25.7276, "crossstreet"=>nil, "id"=>10391, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3480 Main Highway", "name"=>"Senor Frogs", "zip"=>33133, "geolong"=>-80.2442, "geolat"=>25.7267, "crossstreet"=>nil, "id"=>10356, "phone"=>nil, "state"=>"FL", "distance"=>0.1},
+        {"city"=>"Miami", "address"=>"3342 Virginia St", "name"=>"Life", "zip"=>33133, "geolong"=>-80.2415, "geolat"=>25.7289, "crossstreet"=>nil, "id"=>10252, "phone"=>nil, "state"=>"FL", "distance"=>0.2},
+        {"city"=>"Miami", "address"=>"3339 Virginia St", "name"=>"InfiniHQ", "zip"=>33133, "geolong"=>-80.2413, "geolat"=>25.7292, "crossstreet"=>"at Oak Ave", "id"=>84676, "phone"=>3057284641, "state"=>"FL", "distance"=>0.2},
+        {"city"=>"Miami", "address"=>"2895 McFarlane RD.", "name"=>"Flavour", "zip"=>33133, "geolong"=>-80.2411, "geolat"=>25.7275, "crossstreet"=>nil, "id"=>10173, "phone"=>nil, "state"=>"FL", "distance"=>0.2},
+        {"city"=>"Miami", "address"=>"3540 Main Highway", "name"=>"Taurus Chops", "zip"=>33133, "geolong"=>-80.245, "geolat"=>25.7251, "crossstreet"=>nil, "id"=>10390, "phone"=>nil, "state"=>"FL", "distance"=>0.2},
+        {"city"=>"Miami", "address"=>"2911 Grand Ave", "name"=>"Oxygen Lounge", "zip"=>33133, "geolong"=>-80.2406, "geolat"=>25.7285, "crossstreet"=>nil, "id"=>10305, "phone"=>nil, "state"=>"FL", "distance"=>0.2},
+        {"city"=>"Miami", "address"=>"2801 Florida Ave", "name"=>"Quench", "zip"=>33133, "geolong"=>-80.2395, "geolat"=>25.7291, "crossstreet"=>nil, "id"=>10331, "phone"=>"305 448-8150", "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Miami", "address"=>"3390 Mary St", "name"=>"Improv Comedy Club", "zip"=>33133, "geolong"=>-80.2393, "geolat"=>25.7282, "crossstreet"=>nil, "id"=>10224, "phone"=>nil, "state"=>"FL", "distance"=>0.3},
+        {"city"=>"Coconut Grove", "address"=>"Grand Ave", "name"=>"The Jewlicious Pad", "zip"=>nil, "geolong"=>-80.2499, "geolat"=>25.7278, "crossstreet"=>nil, "id"=>80526, "phone"=>nil, "twitter"=>"jewgonewild", "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"2700 south bayshore drive", "name"=>"Cocont Grove Expo Center", "zip"=>33133, "geolong"=>-80.2379, "geolat"=>25.7282, "crossstreet"=>nil, "id"=>10124, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"650 williamstreet", "name"=>"Flordia", "zip"=>nil, "geolong"=>-80.2511, "geolat"=>25.7263, "crossstreet"=>"Sr mia", "id"=>66946, "phone"=>nil, "state"=>"FL", "distance"=>0.4},
+        {"city"=>"Miami", "address"=>"2649 South Bayshore Drive", "name"=>"Doubletree Coconut Grove", "zip"=>33133, "geolong"=>-80.2353, "geolat"=>25.7312, "crossstreet"=>nil, "id"=>83833, "phone"=>"305-858-2500", "state"=>"FL", "distance"=>0.6},
+        {"city"=>"Coconut grove", "address"=>"3381 pan American drive", "name"=>"Scottys Landing", "zip"=>33133, "geolong"=>-80.2342, "geolat"=>25.7278, "crossstreet"=>nil, "id"=>86452, "phone"=>nil, "state"=>"FL", "distance"=>0.6},
+        {"city"=>"Miami", "address"=>"2550 South Bayshore Drive", "name"=>"Monty's", "zip"=>33133, "geolong"=>-80.2326, "geolat"=>25.7321, "crossstreet"=>nil, "id"=>18241, "phone"=>"305 858-1431", "state"=>"FL", "distance"=>0.8},
+        {"city"=>"Miami", "address"=>"2884 S.W. 27th Ave", "name"=>"Berries in the Grove }i{", "zip"=>33133, "geolong"=>-80.2381, "geolat"=>25.7382, "crossstreet"=>"btw US1 and Coconut ave", "id"=>85554, "phone"=>"(305) 448-2111", "state"=>"FL", "distance"=>0.8}
+      ]
+
+      @foursquare = Foursquare.new(@username, @password)
+      @foursquare.venues(:geolat => "25.7323", :geolong => "80.2436").should == venues_with_user_data
+    end
+  end
+
+  describe ".available?" do
+    it "it should return true when foursquare is up" do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/test.json",
+                           :body => fakeweb_read('test_success.json'))
+
+      Foursquare.should be_available
+    end
+
+    it "should return false when foursquare is down" do
+      FakeWeb.register_uri(:get,
+                           "http://api.playfoursquare.com/v1/test.json",
+                           :body => fakeweb_read('test_failure.json'))
+      Foursquare.should_not be_available
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: cmdrkeene-foursquare
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors: 
 - Brandon Keene
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-12 00:00:00 -07:00
+date: 2009-08-28 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -30,10 +30,10 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE
-- README
+- README.markdown
 files: 
 - LICENSE
-- README
+- README.markdown
 - Rakefile
 - VERSION
 - foursquare.gemspec
@@ -41,11 +41,16 @@ files:
 - lib/foursquare.rb
 - spec/fixtures/checkin_failure.json
 - spec/fixtures/checkin_success.json
+- spec/fixtures/cities.json
+- spec/fixtures/test_failure.json
+- spec/fixtures/test_success.json
+- spec/fixtures/user.json
+- spec/fixtures/venues_authenticated.json
+- spec/fixtures/venues_unauthenticated.json
 - spec/foursquare_spec.rb
 - spec/spec_helper.rb
 has_rdoc: false
 homepage: http://github.com/cmdrkeene/foursquare
-licenses: 
 post_install_message: 
 rdoc_options: 
 - --charset=UTF-8
@@ -66,7 +71,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.5
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 3
 summary: Ruby API for Foursquare (playfoursquare.com)

data/README

@@ -1,11 +0,0 @@
-= A Ruby API for Foursquare (playfoursquare.com)
-
-
-== Supported Actions
-
-== Check In
-
-To check into a venue by id:
-  
-  @foursquare = Foursquare.new(username, password)
-  @foursquare.check_in(12345) # => {"score" => {...}, ...}