foursquare2 0.8.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,19 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem 'faraday', '~> 0.5.3'
+gem 'faraday_middleware', '~> 0.3.0'
+gem 'hashie', '~> 1.0.0'
+
+
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,33 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.4)
+    faraday (0.5.5)
+      addressable (~> 2.2.4)
+      multipart-post (~> 1.1.0)
+      rack (>= 1.1.0, < 2)
+    faraday_middleware (0.3.2)
+      faraday (~> 0.5.4)
+    git (1.2.5)
+    hashie (1.0.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    multipart-post (1.1.0)
+    rack (1.2.1)
+    rake (0.8.7)
+    rcov (0.9.9)
+    shoulda (2.11.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  faraday (~> 0.5.3)
+  faraday_middleware (~> 0.3.0)
+  hashie (~> 1.0.0)
+  jeweler (~> 1.5.2)
+  rcov
+  shoulda

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Matt Mueller
+
+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/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "foursquare2"
+  gem.homepage = "http://github.com/mattmueller/foursquare2"
+  gem.license = "MIT"
+  gem.summary = "Foursquare API v2 gem in the spirit of the original foursquare gem"
+  gem.description = "Gives access to all endpoints in version 2 of foursquare's API with syntax that will be familiar to those who used the original foursquare gem by Jeremy Welch."
+  gem.email = "muellermr@gmail.com"
+  gem.authors = ["Matt Mueller"]
+  gem.add_runtime_dependency 'faraday', '~> 0.5.3'
+  gem.add_runtime_dependency 'faraday_middleware', '~> 0.3.0'
+  gem.add_runtime_dependency 'hashie', '~> 1.0.0'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "foursquare2 #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/Readme.md

@@ -0,0 +1,61 @@
+# foursquare2
+
+Ruby wrapper for the [foursquare v2 API](http://developer.foursquare.com/docs).
+
+## Installation
+
+    sudo gem install foursquare2
+
+## Usage
+
+### A Note on Authentication
+
+Currently this gem does not handle the oauth2 authentication flow for you, use the [oauth2 gem](https://github.com/intridea/oauth2) to retrieve and store oauth tokens for a user.  Obtain your client key/secret for userless access at the [foursquare developer site.](https://foursquare.com/oauth/)
+
+### Instantiate a client (Userless Access)
+
+    client = Foursquare2::Client.new(:client_key => 'your_key', :client_secret => 'your_secret')
+
+### Instantiate a client (Authenticated User Access)
+
+    client = Foursquare2::Client.new(:oauth_token => 'user_oauth_token')
+
+
+### Examples
+
+See [the documentation](http://rubydoc.info/gems/foursquare2) for a list of all supported methods and available options.
+
+#### Get information about a user (use 'self' for the authenticated user)
+
+    client.user(108914) 
+
+#### Get information about a venue
+
+    client.venue(5104)
+
+#### Search for venues
+
+    client.search_venues(:ll => '36.142064,-86.816086', :query => 'Starbucks')
+
+#### Check-in to a venue as the authenticated user
+
+    client.checkin(:venueId => "4b2afcaaf964a5205bb324e3", :broadcast => 'public', :ll => '36.142064,-86.816086', :shout => 'zomg coffee!1!')
+
+## Todo
+
+* Add test coverage
+* Integrate oauth2 authentication flow
+
+## Contributing to foursquare2
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2011 Matt Mueller. See LICENSE.txt for further details.

data/VERSION

@@ -0,0 +1 @@
+0.8.0

data/foursquare2.gemspec

@@ -0,0 +1,89 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{foursquare2}
+  s.version = "0.8.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matt Mueller"]
+  s.date = %q{2011-02-12}
+  s.description = %q{Gives access to all endpoints in version 2 of foursquare's API with syntax that will be familiar to those who used the original foursquare gem by Jeremy Welch.}
+  s.email = %q{muellermr@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "Rakefile",
+    "Readme.md",
+    "VERSION",
+    "foursquare2.gemspec",
+    "lib/foursquare2.rb",
+    "lib/foursquare2/checkins.rb",
+    "lib/foursquare2/client.rb",
+    "lib/foursquare2/photos.rb",
+    "lib/foursquare2/settings.rb",
+    "lib/foursquare2/specials.rb",
+    "lib/foursquare2/tips.rb",
+    "lib/foursquare2/users.rb",
+    "lib/foursquare2/venues.rb",
+    "test/helper.rb",
+    "test/test_foursquare2.rb"
+  ]
+  s.homepage = %q{http://github.com/mattmueller/foursquare2}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Foursquare API v2 gem in the spirit of the original foursquare gem}
+  s.test_files = [
+    "test/helper.rb",
+    "test/test_foursquare2.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<faraday>, ["~> 0.5.3"])
+      s.add_runtime_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+      s.add_runtime_dependency(%q<hashie>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_runtime_dependency(%q<faraday>, ["~> 0.5.3"])
+      s.add_runtime_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+      s.add_runtime_dependency(%q<hashie>, ["~> 1.0.0"])
+    else
+      s.add_dependency(%q<faraday>, ["~> 0.5.3"])
+      s.add_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+      s.add_dependency(%q<hashie>, ["~> 1.0.0"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<faraday>, ["~> 0.5.3"])
+      s.add_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+      s.add_dependency(%q<hashie>, ["~> 1.0.0"])
+    end
+  else
+    s.add_dependency(%q<faraday>, ["~> 0.5.3"])
+    s.add_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+    s.add_dependency(%q<hashie>, ["~> 1.0.0"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<faraday>, ["~> 0.5.3"])
+    s.add_dependency(%q<faraday_middleware>, ["~> 0.3.0"])
+    s.add_dependency(%q<hashie>, ["~> 1.0.0"])
+  end
+end
+

data/lib/foursquare2.rb

@@ -0,0 +1,19 @@
+require 'faraday'
+require 'faraday_middleware'
+
+directory = File.expand_path(File.dirname(__FILE__))
+
+module Foursquare2
+  class << self
+  end
+
+  require 'foursquare2/users'
+  require 'foursquare2/specials'
+  require 'foursquare2/settings'
+  require 'foursquare2/photos'
+  require 'foursquare2/tips'
+  require 'foursquare2/checkins'
+  require 'foursquare2/venues'
+  require 'foursquare2/client'
+
+end

data/lib/foursquare2/checkins.rb

@@ -0,0 +1,74 @@
+module Foursquare2
+  module Checkins
+
+    # Retrive information about a single checkin.
+    #
+    # @param [String] checkin_id the ID of the checkin.
+
+    def checkin(checkin_id)
+      response = connection.get("checkins/#{checkin_id}")
+      return_error_or_body(response, response.body.response.checkin)
+    end
+
+    # Retrive a list of recent checkins from friends.
+    #
+    # @param [Hash] options
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options String :limit - Maximum results to return (max 100)
+    # @option options Integer :afterTimestamp - Seconds after which to look for checkins
+
+    def recent_checkins(options={})
+      response = connection.get do |req|
+        req.url "checkins/recent", options
+      end
+      return_error_or_body(response, response.body.response.recent)
+    end
+
+    # Checkin on behalf of the user.
+    #
+    # @param [Hash] options
+    # @option options String :venueId - Venue for the checkin.
+    # @option options String :venue - For venueless checkins (name or other identifier)
+    # @option options String :shout - Message to be included with the checkin.
+    # @option options String :broadcast - Required, one or more of private,public,facebook,twitter.  Comma-separated.
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options Integer :llAcc - Accuracy of the lat/lon in meters.
+    # @option options Integer :alt - Altitude in meters
+    # @option options Integer :altAcc - Accuracy of the altitude in meters
+
+    def add_checkin(options={})
+      response = connection.post do |req|
+        req.url "checkins/add", options
+      end
+      return_error_or_body(response, response.body.response.checkin)
+    end
+
+    # Add a comment to a checkin.
+    #
+    # @param [String] checkin_id the ID of the checkin.
+    # @param [Hash]  options
+    # @option options String :text - Text of the comment to add, 200 character max.
+
+    def add_checkin_comment(checkin_id, options={})
+      response = connection.post do |req|
+        req.url "checkins/#{checkin_id}/addcomment", options
+      end
+      return_error_or_body(response, response.body.response)  
+    end
+
+    # Delete a checkin's comment
+    #
+    # @param [String] checkin_id - The ID of the checkin
+    # @param [Hash]  options
+    # @option options String :commentId - ID of the comment to be deleted.
+
+    def delete_checkin_comment(checkin_id, options={})
+      response = connection.post do |req|
+        req.url "checkins/#{checkin_id}/deletecomment", options
+      end
+      return_error_or_body(response, response.body.response)  
+    end
+
+  end    
+end
+

data/lib/foursquare2/client.rb

@@ -0,0 +1,71 @@
+require 'forwardable'
+
+module Foursquare2
+  class Client
+    extend Forwardable
+    
+    include Venues
+    include Checkins
+    include Tips
+    include Photos
+    include Settings
+    include Specials
+    include Users
+
+
+    #Initialize the client class that will be used for all foursquare API requests.  Note that either a valid user oauth token OR a valid client_id + secret is required.
+    #
+    #Certain requests will require an oauth token.  See http://developer.foursquare.com/docs/index_docs.html for the full list.
+    #
+    # @param [Hash] options
+    # @option options String :client_id Your foursquare app's client_id
+    # @option options String :client_secret Your foursquare app's client_secret
+    # @option options String :oauth_token A valid oauth token for a user (or the 'secret' value from api v1)
+    
+    def initialize(options={})
+      @client_id = options[:client_id]
+      @client_secret = options[:client_secret]
+      @oauth_token = options[:oauth_token]
+    end
+
+
+    # Sets up the connection to be used for all requests based on options passed during initialization.
+
+    def connection
+      params = {}
+      params[:client_id] = @client_id if @client_id
+      params[:client_secret] = @client_secret if @client_secret
+      params[:oauth_token] = @oauth_token if @oauth_token
+      @connection ||= Faraday::Connection.new(:url => api_url, :params => params, :headers => default_headers) do |builder|
+        builder.adapter Faraday.default_adapter
+        builder.use Faraday::Response::ParseJson
+        builder.use Faraday::Response::Mashify
+      end
+    end
+
+    # Base URL for api requests.
+
+    def api_url
+      "https://api.foursquare.com/v2"
+    end
+
+    # Helper method to return errors or desired response data as appropriate.
+    #
+    # Added just for convenience to avoid having to traverse farther down the response just to get to returned data.
+
+    def return_error_or_body(response, response_body)
+      response.body.meta.code == 200 ? response_body : response.body
+    end
+      
+    private
+
+
+      def default_headers
+        headers = {
+          :accept =>  'application/json',
+          :user_agent => 'Ruby gem'
+        }
+      end
+
+  end
+end

data/lib/foursquare2/photos.rb

@@ -0,0 +1,15 @@
+module Foursquare2
+  module Photos
+
+    # Retrive a photo
+    #
+    # @params [String] photo_id - The ID of the photo
+
+    def photo(photo_id)
+      response = connection.get("photos/#{photo_id}")
+      return_error_or_body(response, response.body.response.photo)
+    end    
+    
+  end
+end
+

data/lib/foursquare2/settings.rb

@@ -0,0 +1,34 @@
+module Foursquare2
+  module Settings
+
+    # Retrive all settings for the authenticated user.
+
+    def settings
+      response = connection.get("settings/all")
+      return_error_or_body(response, response.body.response.settings)
+    end    
+
+    # Retrieve a single setting for the authenticated user.
+    #
+    # @param [String] setting - The name of the setting to retrieve, one of sendtotwitter, sendtofacebook, pings.
+
+    def setting(setting)
+      response = connection.get("settings/setting")
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Update a single setting for the authenticated user.
+    #
+    # @param [String] setting - The name of the setting to update, one of sendtotwitter, sendtofacebook, pings.
+    # @param [String] value - One of '1','0'
+
+    def update_setting(setting,value)
+      response = connection.post do |req|
+        req.url "settings/#{setting}/set", {:value => value}
+      end
+      return_error_or_body(response, response.body.response)
+    end
+    
+  end
+end
+

data/lib/foursquare2/specials.rb

@@ -0,0 +1,31 @@
+module Foursquare2
+  module Specials
+
+    # Retrieve information about a special
+    #
+    # param [String] special_id The ID of the special
+
+    def special(special_id)
+      response = connection.get("specials/#{special_id}")
+      return_error_or_body(response, response.body.response.special)
+    end    
+
+    # Search for specials
+    #
+    # @param [Hash]  options
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options Integer :llAcc - Accuracy of the lat/lon in meters.
+    # @option options Integer :alt - Altitude in meters
+    # @option options Integer :altAcc - Accuracy of the altitude in meters
+    # @option options Integer :limit - The limit of results to return.
+
+    def search_specials(options={})
+      response = connection.get do |req|
+        req.url "specials/search", options
+      end
+      return_error_or_body(response, response.body.response.specials.items)
+    end
+    
+  end
+end
+

data/lib/foursquare2/tips.rb

@@ -0,0 +1,77 @@
+module Foursquare2
+  module Tips
+
+    # Retrieve information about a tip.
+    #
+    # param [String] tip_id - The id of the tip to retrieve.
+
+    def tip(tip_id)
+      response = connection.get("tips/#{tip_id}")
+      return_error_or_body(response, response.body.response.tip)
+    end    
+
+    # Search for tips.
+    #
+    # @param [Hash]  options
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options Integer :limit - The limit of results to return.
+    # @option options Integer :offset - Used to page through results.
+    # @option options String :filter - Set to 'friends' to limit tips to those from friends.
+    # @option options String :query - Only find tips matching this term.
+
+    def search_tips(options={})
+      response = connection.get do |req|
+        req.url "tips/search", options
+      end
+      return_error_or_body(response, response.body.response.tips)
+    end
+
+    # Add a tip
+    #
+    # @param [Hash]  options
+    # @option options String :venueId - Required, which venue to add the tip to.
+    # @option options String :text - The text of the tip.
+    # @option options String :url - Optionally associated url.
+
+    def add_tip(options={})
+      response = connection.post do |req|
+        req.url "tips/add", options
+      end
+      return_error_or_body(response, response.body.response.tip)
+    end
+
+    # Mark a tip todo for the authenticated user.
+    #
+    # param [String] tip_id - The id of the tip to mark.
+
+    def mark_tip_todo(tip_id)
+      response = connection.post do |req|
+        req.url "tips/#{tip_id}/marktodo"
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Mark a tip done for the authenticated user.
+    #
+    # param [String] tip_id - The id of the tip to mark.
+
+    def mark_tip_done(tip_id)
+      response = connection.post do |req|
+        req.url "tips/#{tip_id}/markdone"
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Unmark a tip todo for the authenticated user.
+    #
+    # param [String] tip_id - The id of the tip to unmark.
+
+    def unmark_tip(tip_id)
+      response = connection.post do |req|
+        req.url "tips/#{tip_id}/unmark"
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+  end
+end

data/lib/foursquare2/users.rb

@@ -0,0 +1,175 @@
+module Foursquare2
+  module Users
+
+    # Get information about a user
+    #
+    # @param [Integer] user_id - User to get information for.
+
+    def user(user_id)
+      response = connection.get("users/#{user_id}")
+      return_error_or_body(response, response.body.response.user)
+    end
+
+    # Search for users
+    # @param [Hash]  options
+    # @option options String :phone - Match on phone number
+    # @option options String :email - Match on email
+    # @option options String :twitter - Match on twitter username
+    # @option options String :twitterSource - Friends of this twitter handle that use foursquare.
+    # @option options String :fbid - Match on facebook id.
+    # @option options String :name - Match on name
+
+    def search_users(options={})
+      response = connection.get do |req|
+        req.url "users/search", options
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Get all pending friend requests for the authenticated user
+
+    def user_requests
+      response = connection.get("users/requests")
+      return_error_or_body(response, response.body.response.requests)
+    end
+
+    # Get all badges for a given user.
+    #
+    # @param [String] user_id - The user to retrieve badges for.
+
+    def user_badges(user_id)
+      response = connection.get("users/#{user_id}/badges")
+      return_error_or_body(response, response.body.response.sets)
+    end
+
+    # Get checkins for the authenticated user
+    # @param [Hash]  options
+    # @option options Integer :limit
+    # @option options Integer :offest - For paging through results
+    # @option options Integer :afterTimestamp - Get all checkins after this epoch time.
+    # @option options Integer :beforeTimestamp - Get all checkins before this epoch time.
+
+    def user_checkins(options={})
+      response = connection.get do |req|
+        req.url "users/self/checkins", options
+      end
+      return_error_or_body(response, response.body.response.checkins)
+    end
+
+    # Get all friends for a given user.
+    #
+    # @param [String] user_id - The user to retrieve friends for.
+    # @param [Hash]  options
+    # @option options Integer :limit
+    # @option options Integer :offest - For paging through results
+
+    def user_friends(user_id, options={})
+      response = connection.get do |req|
+        req.url "users/#{user_id}/friends", options
+      end
+      return_error_or_body(response, response.body.response.friends)
+    end
+
+    # Get all tips for a given user.
+    #
+    # @param [String] user_id - The user to retrieve friends for.
+    # @param [Hash]  options
+    # @option options Integer :limit
+    # @option options Integer :offest - For paging through results
+    # @option options String :sort - One of recent, nearby, popular
+    # @option options String :ll - Latitude and longitude in format LAT,LON - required for nearby sort option.
+
+    def user_tips(user_id, options={})
+      response = connection.get do |req|
+        req.url "users/#{user_id}/tips", options
+      end
+      return_error_or_body(response, response.body.response.tips)
+    end
+
+    # Get all todos for a given user.
+    #
+    # @param [String] user_id - The user to retrieve friends for.
+    # @param [Hash]  options
+    # @option options String :sort - One of recent, nearby, popular
+    # @option options String :ll - Latitude and longitude in format LAT,LON - required for nearby sort option.
+
+
+    def user_todos(user_id, options={})
+      response = connection.get do |req|
+        req.url "users/#{user_id}/todos", options
+      end
+      return_error_or_body(response, response.body.response.todos)
+    end
+
+    # Get the venue history for the authenticated user.
+    #
+    # @param [Hash]  options
+    # @option options Integer :afterTimestamp - Get all venues after this epoch time.
+    # @option options Integer :beforeTimestamp - Get all venues before this epoch time.
+
+
+    def user_venue_history(options={})
+      response = connection.get do |req|
+        req.url "users/self/venuehistory", options
+      end
+      return_error_or_body(response, response.body.response.venues)
+    end
+
+    # Request friendship with a user
+    #
+    # @param [String] user_id - The user to request friendship with.
+
+    def user_friend_request(user_id)
+      response = connection.post do |req|
+        req.url "users/#{user_id}/request"
+      end
+      return_error_or_body(response, response.body.response)
+    end   
+
+    # Unfriend a user
+    #
+    # @param [String] user_id - The user to unfriend.
+
+    def user_unfriend(user_id)
+      response = connection.post do |req|
+        req.url "users/#{user_id}/unfriend"
+      end
+      return_error_or_body(response, response.body.response)
+    end 
+
+    # Approve friendship with a user.
+    #
+    # @param [String] user_id - The user to approve friendship with.
+
+    def user_approve_friend(user_id)
+      response = connection.post do |req|
+        req.url "users/#{user_id}/approve"
+      end
+      return_error_or_body(response, response.body.response)
+    end 
+
+    # Deny friendship with a user.
+    #
+    # @param [String] user_id - The user to deny friendship with.
+
+    def user_deny_friend(user_id)
+      response = connection.post do |req|
+        req.url "users/#{user_id}/deny"
+      end
+      return_error_or_body(response, response.body.response)
+    end 
+
+    # Set pings for a friend
+    #
+    # @param [String] user_id - The user to set pings for
+    # @param [String] value - The value of ping setting for this friend, either true or false.
+
+    def user_set_friend_pings(user_id, value)
+      response = connection.post do |req|
+        req.url "users/#{user_id}/setpings", value
+      end
+      return_error_or_body(response, response.body.response)
+    end 
+
+  end
+end

data/lib/foursquare2/venues.rb

@@ -0,0 +1,103 @@
+module Foursquare2
+  module Venues
+
+    # Retrieve information about a venue
+    #
+    # param [String] venue_id The ID of the venue
+
+    def venue(venue_id)
+      response = connection.get("venues/#{venue_id}")
+      return_error_or_body(response, response.body.response.venue)
+    end
+
+    # Search for venues
+    #
+    # @param [Hash]  options
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options Integer :llAcc - Accuracy of the lat/lon in meters.
+    # @option options Integer :alt - Altitude in meters
+    # @option options Integer :altAcc - Accuracy of the altitude in meters
+    # @option options Integer :limit - The limit of results to return.
+    # @option options String :intent - One of checkin, match, or specials.
+    # @option options String :query - Query to match venues on.
+
+    def search_venues(options={})
+      response = connection.get do |req|
+        req.url "venues/search", options
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Retrieve information about all venue categories.
+
+    def venue_categories
+      response = connection.get("venues/categories")
+      return_error_or_body(response, response.body.response.categories)
+    end
+
+    # Add a venue
+    # @param [Hash]  options
+    # @option options String :name - Name of the venue (required)
+    # @option options String :address
+    # @option options String :crossStreet
+    # @option options String :city
+    # @option options String :state
+    # @option options String :zip
+    # @option options String :phone
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options String :primaryCategoryId - Main category for the venue, must be in the list of venue categories.
+
+    def add_venue(options={})
+      response = connection.post do |req|
+        req.url "venues/add", options
+      end
+      return_error_or_body(response, response.body.response.venue)
+    end
+
+    # Mark a venue as todo for the authenticated user
+    #
+    # @param [String] venue_id - Venue id to mark todo, required.
+    # @param [Hash] options
+    # @option options String :text - Text for the tip/todo
+
+    def mark_venue_todo(venue_id, options={})
+      response = connection.post do |req|
+        req.url "venues/#{venue_id}/marktodo", options
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Flag a venue as having a problem
+    #
+    # @param [String] venue_id - Venue id to flag, required.
+    # @param [Hash] options
+    # @option options String :problem - Reason for flag, one of mislocated,closed, or duplicate.  Required.
+
+    def flag_venue(venue_id, options={})
+      response = connection.post do |req|
+        req.url "venues/#{venue_id}/flag", options
+      end
+      return_error_or_body(response, response.body.response)
+    end
+
+    # Propose a venue edit
+    # @param [String] venue_id - Venue id to propose edit for, required.
+    # @param [Hash]  options
+    # @option options String :name - Name of the venue (required)
+    # @option options String :address
+    # @option options String :crossStreet
+    # @option options String :city
+    # @option options String :state
+    # @option options String :zip
+    # @option options String :phone
+    # @option options String :ll - Latitude and longitude in format LAT,LON
+    # @option options String :primaryCategoryId - Main category for the venue, must be in the list of venue categories.
+
+    def propose_venue_edit(venue_id, options={})
+      response = connection.post do |req|
+        req.url "venues/#{venue_id}/proposeedit", options
+      end
+      return_error_or_body(response, response.body.response)
+    end
+  end 
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'foursquare2'
+
+class Test::Unit::TestCase
+end

data/test/test_foursquare2.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestFoursquare2 < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+    flunk "hey buddy, you should probably rename this file and start testing for real"
+  end
+end

metadata

@@ -0,0 +1,241 @@
+--- !ruby/object:Gem::Specification 
+name: foursquare2
+version: !ruby/object:Gem::Version 
+  hash: 63
+  prerelease: false
+  segments: 
+  - 0
+  - 8
+  - 0
+  version: 0.8.0
+platform: ruby
+authors: 
+- Matt Mueller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-12 00:00:00 -06:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 0
+        - 5
+        - 3
+        version: 0.5.3
+  requirement: *id001
+  prerelease: false
+  type: :runtime
+  name: faraday
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 3
+        - 0
+        version: 0.3.0
+  requirement: *id002
+  prerelease: false
+  type: :runtime
+  name: faraday_middleware
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id003
+  prerelease: false
+  type: :runtime
+  name: hashie
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id004
+  prerelease: false
+  type: :development
+  name: shoulda
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id005
+  prerelease: false
+  type: :development
+  name: bundler
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  requirement: *id006
+  prerelease: false
+  type: :development
+  name: jeweler
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id007
+  prerelease: false
+  type: :development
+  name: rcov
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 0
+        - 5
+        - 3
+        version: 0.5.3
+  requirement: *id008
+  prerelease: false
+  type: :runtime
+  name: faraday
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 0
+        - 3
+        - 0
+        version: 0.3.0
+  requirement: *id009
+  prerelease: false
+  type: :runtime
+  name: faraday_middleware
+- !ruby/object:Gem::Dependency 
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id010
+  prerelease: false
+  type: :runtime
+  name: hashie
+description: Gives access to all endpoints in version 2 of foursquare's API with syntax that will be familiar to those who used the original foursquare gem by Jeremy Welch.
+email: muellermr@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+files: 
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- Rakefile
+- Readme.md
+- VERSION
+- foursquare2.gemspec
+- lib/foursquare2.rb
+- lib/foursquare2/checkins.rb
+- lib/foursquare2/client.rb
+- lib/foursquare2/photos.rb
+- lib/foursquare2/settings.rb
+- lib/foursquare2/specials.rb
+- lib/foursquare2/tips.rb
+- lib/foursquare2/users.rb
+- lib/foursquare2/venues.rb
+- test/helper.rb
+- test/test_foursquare2.rb
+has_rdoc: true
+homepage: http://github.com/mattmueller/foursquare2
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Foursquare API v2 gem in the spirit of the original foursquare gem
+test_files: 
+- test/helper.rb
+- test/test_foursquare2.rb