Chrononaut-rpx_now 0.5.6

data/.gitignore

@@ -0,0 +1,4 @@
+Manifest
+pkg
+.*.swp
+.*.swo

data/CHANGELOG

@@ -0,0 +1,23 @@
+0.5.0
+----
+  * ApiError is raised when API KEY was invalid (before did only return nil)
+  * ServerError is now seperated into ApiError and ServiceUnavailableError
+
+0.4.2
+----
+  * default IDs are strings, not integers, since RPX supports both
+  * Added username field to standart parameters
+
+0.4
+----
+  * The RPXNow.api_version= can be set globally
+  * Most methods now support :api_version=>'123', so you can specify the api_version on each call
+	* Added support for unobtrusive code generation. This will make the gem play nicely with developers creating unobtrusive pages with frameworks such as jQuery;
+	* The RPXNOW JSON responses are now parsed by Florian Frank JSON gem (http://json.rubyforge.org/);
+	* Removed the dependency of ActiveSupport. However, if present, ActiveSupport will be used due to its convenience methods Array#to_query and Hash#to_query.
+	* Added support for multiple versions of the widget. By default, everything will point to version 2;
+	* The specs have been updated.
+
+0.3
+----
+	* RPXNow::ServerError will be thrown when something is invalid/goes wrong, so watch out (not for invalid tokens in user_data)...

data/MIGRATION

@@ -0,0 +1,9 @@
+class AddIdentifierToUsers < ActiveRecord::Migration
+  def self.up
+    add_column :users, :identifier, :string
+  end
+
+  def self.down
+    remove_column :users, :identifier
+  end
+end

data/README.markdown

@@ -0,0 +1,107 @@
+Problem
+=======
+ - OpenID is complex, limited and hard to use for users
+ - Facebook / Twitter / Myspace / Google / MS-LiveId / AOL connections require different libraries and knowledge
+ - Multiple heterogenouse providers are hard to map to a single user
+
+Solution
+========
+ - Use [RPX](http://rpxnow.com) for universal and usable user login
+ - Use view/controller helpers for easy integration
+
+![Single Interface for all providers](https://rpxnow.com/images/how_diagram.png)
+![Visitors choose from providers they already have](https://rpxnow.com/images/6providers.png?2)
+
+Usage
+=====
+ - Get an API key @ [RPX](http://rpxnow.com)
+ - run [MIGRATION](http://github.com/grosser/rpx_now/raw/master/MIGRATION)
+ - Build login view
+ - Communicate with RPX API in controller to create or login User
+ - for more advanced features have a look at the [RPX API Docs](https://rpxnow.com/docs)
+
+Install
+=======
+ - As Rails plugin: `script/plugin install git://github.com/grosser/rpx_now.git `
+ - As gem: `sudo gem install grosser-rpx_now --source http://gems.github.com/`
+
+Examples
+========
+
+View
+----
+    #'mywebsite' is your subdomain/realm on RPX
+    <%=RPXNow.embed_code('mywebsite',rpx_token_sessions_url)%>
+    OR
+    <%=RPXNow.popup_code('Login here...','mywebsite',rpx_token_sessions_url,:language=>'de')%>
+
+`popup_code` can also be called with `:unobstrusive=>true`
+
+Environment
+-----------
+    Rails::Initializer.run do |config|
+      config.gem "grosser-rpx_now", :lib => "rpx_now", :source => "http://gems.github.com/"
+      ...
+    end
+    RPXNow.api_key = "YOU RPX API KEY"
+
+Controller
+----------
+    # user_data
+    # found: {:name=>'John Doe', :username => 'john', :email=>'john@doe.com', :identifier=>'blug.google.com/openid/dsdfsdfs3f3'}
+    # not found: nil (can happen with e.g. invalid tokens)
+    def rpx_token
+      raise "hackers?" unless data = RPXNow.user_data(params[:token])
+      self.current_user = User.find_by_identifier(data[:identifier]) || User.create!(data)
+      redirect_to '/'
+    end
+
+    # raw request processing
+    RPXNow.user_data(params[:token]){|raw| {:email=>raw['profile']['verifiedEmail']} }
+
+    # raw request with extended parameters (most users and APIs do not supply them)
+    RPXNow.user_data(params[:token], :extended=>'true'){|raw| ...have a look at the RPX API DOCS...}
+
+Advanced
+--------
+###Versions
+    RPXNow.api_version = 2
+
+###Mappings
+You can map your primary keys (e.g. user.id) to identifiers, so that  
+users can login to the same account with multiple identifiers.
+    RPXNow.map(identifier, primary_key) #add a mapping
+    RPXNow.unmap(identifier, primary_key) #remove a mapping
+    RPXNow.mappings(primary_key) # [identifier1,identifier2,...]
+    RPXNow.all_mappings # [["1",['google.com/dsdas','yahoo.com/asdas']], ["2",[...]], ... ]
+
+After a primary key is mapped to an identifier, when a user logs in with this identifier,  
+`RPXNow.user_data` will contain his `primaryKey` as `:id`.  
+A identifyer can only belong to one user (in doubt the last one it was mapped to)
+
+###User integration (e.g. ActiveRecord)
+    class User < ActiveRecord::Base
+      include RPXNow::UserIntegration
+    end
+
+    user.rpx.identifiers == RPXNow.mappings(user.id)
+    user.rpx.map(identifier) == RPXNow.map(identifier, user.id)
+    user.rpx.unmap(identifier) == RPXNow.unmap(identifier, user.id)
+
+###Contacts (PRX Pro)
+Retrieve all contacts for a given user:
+    RPXNow.contacts(identifier).each {|c| puts "#{c['displayName']}: #{c['emails']}}
+
+TODO
+====
+ - add provider / credentials helpers ?
+
+Author
+======
+###Contributors
+ - [DBA](http://github.com/DBA)
+ - [dbalatero](http://github.com/dbalatero)
+
+[Michael Grosser](http://pragmatig.wordpress.com)  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...  

data/Rakefile

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'echoe'
+
+desc "Run all specs in spec directory"
+task :default do |t|
+  options = "--colour --format progress --loadby --reverse"
+  files = FileList['spec/**/*_spec.rb']
+  system("spec #{options} #{files}")
+end
+
+#Gemspec
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    project_name = 'rpx_now'
+    gem.name = project_name
+    gem.summary = "Helper to simplify RPX Now user login/creation"
+    gem.email = "grosser.michael@gmail.com"
+    gem.homepage = "http://github.com/grosser/#{project_name}"
+    gem.authors = ["Michael Grosser"]
+    gem.add_dependency ['activesupport']
+  end
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+
+task :update_gemspec => [:manifest, :build_gemspec]

data/VERSION.yml

@@ -0,0 +1,4 @@
+---
+:minor: 5
+:patch: 6
+:major: 0