omniauth-facebook 1.0.0.rc2 → 1.0.0

data/.travis.yml

@@ -1,6 +1,7 @@
 rvm:
   - 1.8.7
   - 1.9.2
+  - 1.9.3
   - jruby
 branches:
   only:

data/Gemfile

@@ -1,5 +1,3 @@
 source :rubygems
 
 gemspec
-
-gem 'omniauth-oauth2', :git => 'git://github.com/intridea/omniauth-oauth2.git'

data/README.md

@@ -2,30 +2,100 @@
 
 This gem contains the Facebook strategy for OmniAuth 1.0.
 
+Supports the OAuth 2.0 server-side flow. Read the Facebook docs for more details: http://developers.facebook.com/docs/authentication
+
 ## Installing
 
 Add to your `Gemfile`:
 
 ```ruby
-gem 'omniauth-facebook', '~> 1.0.0.rc1'
+gem 'omniauth-facebook'
 ```
 
 Then `bundle install`.
 
-## Supported Flows
+## Usage
+
+`OmniAuth::Strategies::Facebook` is simply a Rack middleware. Read the OmniAuth 1.0 docs for detailed instructions: https://github.com/intridea/omniauth.
+
+Here's a quick example, adding the middleware to a Rails app in `config/initializers/omniauth.rb`:
+
+```ruby
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :facebook, ENV['FACEBOOK_KEY'], ENV['FACEBOOK_SECRET']
+end
+```
+
+## Configuring
+
+You can configure several options, which you pass in to the `provider` method via a `Hash`:
+
+* `scope`: A comma-separated list of permissions you want to request from the user. See the Facebook docs for a full list of available permissions: http://developers.facebook.com/docs/reference/api/permissions. Default: `email,offline_access`
+* `display`: The display context to show the authentication page. Options are: `page`, `popup`, `iframe`, `touch` and `wap`. Read the Facebook docs for more details: http://developers.facebook.com/docs/reference/dialogs#display. Default: `page`
 
-Supports the Server-side Flow as described in the the Facebook docs:
-http://developers.facebook.com/docs/authentication
+For example, to request `email`, `offline_access` and `read_stream` permissions and display the authentication page in a popup window:
+ 
+```ruby
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :facebook, ENV['FACEBOOK_KEY'], ENV['FACEBOOK_SECRET'], :scope => 'email,offline_access,read_stream', :display => 'popup'
+end
+```
+
+*NB.* If you want to set the `display` format on a per-request basis, you can just pass it to the OmniAuth request phase URL, for example: `/auth/facebook?display=popup`.
+
+## Authentication Hash
+
+Here's an example *Authentication Hash* available in `request.env['omniauth.auth']`:
+
+```ruby
+{
+  :provider => 'facebook',
+  :uid => '1234567',
+  :info => {
+    :nickname => 'jbloggs',
+    :email => 'joe@bloggs.com',
+    :name => 'Joe Bloggs',
+    :first_name => 'Joe',
+    :last_name => 'Bloggs',
+    :image => 'http://graph.facebook.com/1234567/picture?type=square',
+    :urls => { :Facebook => 'http://www.facebook.com/jbloggs' },
+    :location => 'Palo Alto, California'
+  },
+  :credentials => {
+    :token => 'ABCDEF...', # OAuth 2.0 access_token, which you may wish to store
+    :expires_at => 1321747205, # when the access token expires (if it expires)
+    :expires => true # if you request `offline_access` this will be false
+  },
+  :extra => {
+    :raw_info => {
+      :id => '1234567',
+      :name => 'Joe Bloggs',
+      :first_name => 'Joe',
+      :last_name => 'Bloggs',
+      :link => 'http://www.facebook.com/jbloggs',
+      :username => 'jbloggs',
+      :location => { :id => '123456789', :name => 'Palo Alto, California' },
+      :gender => 'male',
+      :email => 'joe@bloggs.com',
+      :timezone => -8,
+      :locale => 'en_US',
+      :verified => true,
+      :updated_time => '2011-11-11T06:21:03+0000'
+    }
+  }
+}
+```
 
-**Pending:** Supports the Client-side Flow via parsing out the verification code from the signed request cookie.
+The precise information available may depend on the permissions which you request.
 
-## Ruby
+## Supported Rubies
 
-Tested with the following Ruby versions:
+Actively tested with the following Ruby versions:
 
+- MRI 1.9.3
 - MRI 1.9.2
 - MRI 1.8.7
-- JRuby 1.6.4
+- JRuby 1.6.5
 
 ## License
 

data/example/config.ru

@@ -21,7 +21,7 @@ end
 use Rack::Session::Cookie
 
 use OmniAuth::Builder do
-  provider :facebook, ENV['APP_ID'], ENV['APP_SECRET'], :scope => 'email,read_stream', :authorize_params => { :display => 'popup' }
+  provider :facebook, ENV['APP_ID'], ENV['APP_SECRET'], :scope => 'email,read_stream', :display => 'popup'
 end
 
 run App.new

data/lib/omniauth/facebook/version.rb

@@ -1,5 +1,5 @@
 module OmniAuth
   module Facebook
-    VERSION = "1.0.0.rc2"
+    VERSION = "1.0.0"
   end
 end

data/lib/omniauth/strategies/facebook.rb

@@ -19,6 +19,8 @@ module OmniAuth
         :param_name => 'access_token'
       }
       
+      option :authorize_options, [:scope, :display]
+      
       uid { raw_info['id'] }
       
       info do

data/spec/omniauth/strategies/facebook_spec.rb

@@ -219,7 +219,7 @@ describe OmniAuth::Strategies::Facebook do
     end
     
     it 'returns the refresh token and expiry time when expiring' do
-      ten_mins_from_now = (Time.now + 360).to_i
+      ten_mins_from_now = (Time.now + 600).to_i
       @access_token.stub(:expires?) { true }
       @access_token.stub(:refresh_token) { '321' }
       @access_token.stub(:expires_at) { ten_mins_from_now }

metadata

@@ -1,19 +1,19 @@
 --- !ruby/object:Gem::Specification
 name: omniauth-facebook
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc2
-  prerelease: 6
+  version: 1.0.0
+  prerelease: 
 platform: ruby
 authors:
 - Mark Dodwell
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-11 00:00:00.000000000Z
+date: 2011-11-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: omniauth-oauth2
-  requirement: &70323804271400 !ruby/object:Gem::Requirement
+  requirement: &70230182116160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *70323804271400
+  version_requirements: *70230182116160
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70323804270900 !ruby/object:Gem::Requirement
+  requirement: &70230182114320 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: 2.7.0
   type: :development
   prerelease: false
-  version_requirements: *70323804270900
+  version_requirements: *70230182114320
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70323804270520 !ruby/object:Gem::Requirement
+  requirement: &70230182112600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +43,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70323804270520
+  version_requirements: *70230182112600
 description: 
 email:
 - mark@mkdynamic.co.uk
@@ -78,12 +78,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -728790844477512045
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
+      segments:
+      - 0
+      hash: -728790844477512045
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.10