grosser-rpx_now 0.2

data/README.markdown

@@ -0,0 +1,56 @@
+Problem
+=======
+ - OpenID is complex
+ - OpenID is not universally used
+
+Solution
+========
+ - Use [RPX](http://rpxnow.com) for universal and usable user login
+ - Make view/controller helpers for easy integration
+
+Usage
+=====
+ - Get an API key @ [RPX](http://rpxnow.com)
+ - 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/`
+ - As gem from source: `git clone git://github.com/grosser/rpx_now.git`,`cd rpx_now`,`rake manifest`,`rake install`
+
+Examples
+========
+
+View
+----
+    #login.erb
+    #here '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')%>
+
+Controller
+----------
+    # simple: use defaults
+    def rpx_token
+      data = RPXNew.user_data(params[:token],'YOUR RPX API KEY') # :name=>'John Doe',:email=>'john@doe.com',:identifier=>'blug.google.com/openid/dsdfsdfs3f3'
+      #when no user_data was found, data is empty, you may want to handle that seperatly...
+      #your user model must have an identifier column
+      self.current_user = User.find_by_identifier(data[:identifier]) || User.create!(data)
+      redirect_to '/'
+    end
+
+    # process the raw response yourself:
+    RPXNew.user_data(params[:token],'YOUR RPX API KEY'){|raw| {:email=>raw['profile']['verifiedEmail']}}
+
+    # request extended parameters (most users and APIs do not supply them)
+    RPXNew.user_data(params[:token],'YOUR RPX API KEY',:extended=>'true'){|raw| ...have a look at the RPX API DOCS...}
+
+Author
+======
+Michael Grosser  
+grosser.michael@gmail.com  
+Hereby placed under public domain, do what you want, just do not hold me accountable...  

data/Rakefile

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'echoe'
+
+desc "Run all specs in spec directory"
+task :test do |t|
+  options = "--colour --format progress --loadby --reverse"
+  files = FileList['spec/**/*_spec.rb']
+  system("spec #{options} #{files}")
+end
+
+#Gemspec
+porject_name = 'rpx_now'
+Echoe.new(porject_name , '0.2') do |p|
+  p.description    = "Helper to simplify RPX Now user login/creation"
+  p.url            = "http://github.com/grosser/#{porject_name}"
+  p.author         = "Michael Grosser"
+  p.email          = "grosser.michael@gmail.com"
+  p.dependencies   = %w[activesupport]
+end
+
+task :update_gemspec => [:manifest, :build_gemspec]

data/init.rb

@@ -0,0 +1 @@
+require 'rpx_now'

data/lib/rpx_now.rb

@@ -0,0 +1,61 @@
+require 'activesupport'
+module RPXNow
+  extend self
+  def user_data(token,api_key,parameters={})
+    raise "NO API KEY" if api_key.blank?
+    data = post('https://rpxnow.com/api/v2/auth_info',{:token=>token,:apiKey=>api_key}.merge(parameters))
+    data = ActiveSupport::JSON.decode(data)
+    return if data['err']
+    if block_given? then yield(data) else read_user_data_from_response(data) end
+  end
+
+  def embed_code(subdomain,url)
+<<EOF
+<iframe src="https://#{subdomain}.rpxnow.com/openid/embed?token_url=#{url}"
+  scrolling="no" frameBorder="no" style="width:400px;height:240px;">
+</iframe>
+EOF
+  end
+
+  def popup_code(text,subdomain,url,options={})
+<<EOF
+<a class="rpxnow" onclick="return false;" href="https://rathershort.rpxnow.com/openid/v2/signin?token_url=#{url}">
+  #{text}
+</a>
+<script src="https://rpxnow.com/openid/v2/widget" type="text/javascript"></script>
+<script type="text/javascript">
+  //<![CDATA[
+  RPXNOW.token_url = "#{url}";
+
+  RPXNOW.realm = "#{subdomain}";
+  RPXNOW.overlay = true;
+  RPXNOW.language_preference = '#{options[:language]||'en'}';
+  //]]>
+</script>
+EOF
+  end
+
+private
+
+  def read_user_data_from_response(response)
+    user_data = response['profile']
+    data = {}
+    data[:identifier] = user_data['identifier']
+    data[:email] = user_data['verifiedEmail'] || user_data['email']
+    data[:name] = user_data['displayName'] || user_data['preferredUsername'] || data[:email].sub(/@.*/,'')
+    data
+  end
+
+  def post(url,data)
+    require 'net/http'
+    url = URI.parse(url)
+    http = Net::HTTP.new(url.host, url.port)
+    if url.scheme == 'https'
+      require 'net/https'
+      http.use_ssl = true
+    end
+    resp, data = http.post(url.path, data.to_query)
+    raise "POST FAILED:"+resp.inspect unless resp.is_a? Net::HTTPOK
+    return data
+  end
+end

data/rpx_now.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rpx_now}
+  s.version = "0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Grosser"]
+  s.date = %q{2009-01-24}
+  s.description = %q{Helper to simplify RPX Now user login/creation}
+  s.email = %q{grosser.michael@gmail.com}
+  s.extra_rdoc_files = ["lib/rpx_now.rb", "README.markdown"]
+  s.files = ["Manifest", "lib/rpx_now.rb", "init.rb", "Rakefile", "README.markdown", "rpx_now.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/grosser/rpx_now}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rpx_now", "--main", "README.markdown"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rpx_now}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Helper to simplify RPX Now user login/creation}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_development_dependency(%q<echoe>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<echoe>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<echoe>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: grosser-rpx_now
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-24 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Helper to simplify RPX Now user login/creation
+email: grosser.michael@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- lib/rpx_now.rb
+- README.markdown
+files: 
+- Manifest
+- lib/rpx_now.rb
+- init.rb
+- Rakefile
+- README.markdown
+- rpx_now.gemspec
+has_rdoc: true
+homepage: http://github.com/grosser/rpx_now
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Rpx_now
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: rpx_now
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Helper to simplify RPX Now user login/creation
+test_files: []
+