Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby wrapper for Yahoo!'s FireEagle
Ruby
branch: master

bump version

Signed-off-by: Jesse Newland <jnewland@gmail.com>
latest commit b2a5e1dd38
@mojodna mojodna authored committed
Failed to load latest commit information.
config updated Manifest and deps
lib
script rubyforge jumping jacks. github needs a gem server and automatic rdoc…
spec Added missing response elements
tasks Make spec the default Rake task
.gitignore rethinking the version number
History.txt support for OAuth 1.0a
License.txt cleanup before push to rubyforge
Manifest.txt updated Manifest and deps
README.txt document github repo
Rakefile rubyforge jumping jacks. github needs a gem server and automatic rdoc…
fireeagle.gemspec bump version
setup.rb initial import

README.txt

FireEagle[http://fireeagle.yahoo.net] (FE) is a system providing centralized
management of user location information. FE allows 3rd party developers to
pdate and/or access user's location data.

http://fireeagle.yahoo.net/developer/documentation

== Installation

 gem install fireeagle
 
== Usage

  >> require 'fireeagle'
  >> client = FireEagle::Client.new(
    :consumer_key        => "<consumer key>",
    :consumer_secret     => "<consumer secret>",
    :access_token        => "[access token]",
    :access_token_secret => "[access token secret]")

==== With a User-specific OAuth Access Token

  # update your location
  >> client.update(:q => "punta del diablo, uruguay") # I wish
  # query your location
  >> user = client.user
  => #<FireEagle::User:0x1ca5e08 ... >
  >> user.locations
  => [#<FireEagle::Location:0x1cdd9e8 ...>, #<FireEagle::Location:0x1cc8ffc ...>, ... ]
  >> user.best_guess
  => #<FireEagle::Location:0x1cdd9e8 ...>
  >> user.best_guess.name
  => "Punta del Diablo, Uruguay"
  # lookup a location
  >> locations = client.lookup(:q => "30022")
  => [#<FireEagle::Location:0x1cdd9e8 ...>, #<FireEagle::Location:0x1cc8ffc ...>, ...]
  >> locations.first.name => "Alpharetta, GA 30022"
  >> locations.first.place_id => "IrhZMHuYA5s1fFi4Qw"

== Authorization

Authorization is handled by OAuth. For more details about the OAuth
authorization flow and how it differs based on your application type, please
see http://fireeagle.yahoo.net/developer/documentation/authorizing

== Contributing

http://github.com/jnewland/fireeagle/tree/master. You know what to do.

Rubyforge Project Page:: http://rubyforge.org/projects/fireeagle
Author::    Jesse Newland (http://soylentfoo.jnewland.com) (jnewland@gmail.com[mailto:jnewland@gmail.com])
Copyright:: Copyright (c) 2008 Jesse Newland. Portions[http://pastie.caboo.se/private/oevvkdzl0zrdkf8s7hetg] Copyright (c) 2008 Yahoo!
License::   Distributed under the same terms as Ruby
Something went wrong with that request. Please try again.