dailycred 0.1.2 → 0.1.4

data/.gitignore

@@ -15,3 +15,7 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+localtest/
+twooter/
+examples/tester/
+examples/

data/Gemfile

@@ -1,6 +1,18 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in omniauth-dailycred.gemspec
 gemspec
 
-gem 'omniauth'
+gem 'rspec'
+gem 'rails'
+gem 'simplecov'
+gem 'ruby_gntp'
+gem 'growl'
+gem 'spork'
+gem 'guard'
+gem 'guard-test'
+gem 'guard-rspec'
+gem 'mocha'
+gem 'fl-rocco'
+gem 'redcarpet', '~> 1.17'
+gem 'markdown'
+gem 'maruku'

data/Guardfile

@@ -0,0 +1,15 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :test do
+  watch(%r{^lib/generators/(.+)\.rb$})     { "test/generator_test.rb" }
+  watch(%r{^test/.+_test\.rb$}) { "test/generator_test.rb" }
+  watch('test/test_helper.rb')  { "test/generator_test.rb" }
+end
+
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/support/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/README.md

@@ -1,67 +1,194 @@
 # Dailycred
 
-## Installation
+## Introduction
 
-Add this line to your application's Gemfile: 
+The Dailycred ruby gem is everything you need to get off the ground running with robust authentication. It includes an [omniauth](https://github.com/intridea/omniauth) provider and a generator to create necessary models and controllers. The generated authentication structure is inspired by [nifty-generators](https://github.com/ryanb/nifty-generators). To get started using Dailycred with Ruby on Rails, the first thing you need to do is add the dailycred gem to your gemfile:
 
-And then execute:
+    gem 'dailycred'
 
-    $ bundle
+Make sure you've signed up for Dailycred, and head over to your [settings](https://www.dailycred.com/admin/settings) page to get your API keys. Once you've done that, head back to the command line and run:
 
-Or install it yourself as:
+    bundle
+    rails g dailycred
+    rake db:migrate
+
+Thats it! You've successfully added authentication to your app, and you can start signing up users. Run `rails s` to start your
+    server, and point your browser to [http://localhost:3000/auth](http://localhost:3000/auth) and you'll see a pre-built page with links to sign up.
+
+Here's what the dailycred gem generates for you:
+
+*   A few helper methods to `/app/controllers/application_controller.rb`.
+*   An initializer file at `/config/initializers/omniauth.rb` which configures your dailycred API keys.
+*   `/app/models/user.rb`, the User model.
+*   A migration file to create the user table in your database.
+
+
+While this is enough to get off the ground running with user authentication, this setup is meant to be lightweight and flexible, so feel free to tinker with
+    any of the generated code to better match your needs.
+
+## Authenticating
+
+#### login_path
+
+A helper for linking to the authentication url.
+
+    <%= link_to 'sign up', login_path %>
+    # => <a href="/auth/dailycred">sign up</a>
 
-    $ gem install omniauth-dailycred
+#### logout_path
 
-## Usage
+To logout a user, simply send them to `/auth/logout`.
 
-bash
+    <%= link_to 'logout', logout_path %>
+    # => <a href="/auth/logout">logout</a>
     
-    rails g dailycred YOUR_CLIENT_ID YOUR_SECRET_KEY
-    rake db:migrate
+#### authenticate
+
+To protect a controller method from unauthorized users, use the 'authorize' helper method as a `before_filter`.
+
+    #before_filter :authenticate, :except => [:index] #don't authenticate some
+    #before_filter :authenticate, :only => [:create, :new] #only authenticate some
+    before_filter :authenticate #all methods
+
+## Social Connect
+
+To use a social sign-in service instead of email, and password, use `connect_path.`
 
-This will generate everything you need to get going with authentication, including a user model, session controller, omniauth initializer, javascript tracking code, and many helper variables. You will You can locate your API keys at [dailycred](https://www.dailycred.com/admin/settings/keys)
+    <%= link_to 'sign in with facebook', connect_path(:identity_provider => :facebook) %>
 
-##### Authentication
+The `identity_provider` can be one of `facebook`, `google`, or `twitter.`
 
-Use the `:authenticate` helper to require a user to be signed in:
+After a user has social connected, their social data is serialized into individual fields in the user model. The serialized object is the exact same as what the social provider's graph response returns. For example:
 
-    before_filter :authenticate
+    p current_user.facebook
+    # =>
+    {
+        "video_upload_limits" => {
+            "length" => 1200.0,
+            "size" => 1073741824.0
+        },
+        "locale" => "en_US",
+        "link" => "http://www.facebook.com/joe.smith",
+        "updated_time" => "2012-09-27T19:04:38+0000",
+        "currency" => {
+            "user_currency" => "USD",
+            "currency_exchange" => 10.0,
+            "currency_exchange_inverse" => 0.1,
+            "currency_offset" => 100.0
+        },
+        "picture" => {
+            "data" => {
+                "url" => "http://profile.ak.fbcdn.net/hprofile-ak-ash4/370570_1039690812_2022945351_q.jpg",
+                "is_silhouette" => false
+            }
+        },
+        "id" => "1092609812",
+        "third_party_id" => "cBLDKnqlfYlReV7Jo4yRAFB1a4I",
+        "first_name" => "Joe",
+        "username" => "jsmitty",
+        "bio" => "shred the gnar.",
+        "email" => "jsmitty@dailycred.com",
+        "verified" => true,
+        "name" => "Joe Smith",
+        "last_name" => "Stoever",
+        "gender" => "male",
+        "access_token" =>"AAAFHsZAi9ddUBAKPMOKPDrmJlclwCoVHCfwflF5ZCyLZC70SOo0MPvj62lhHZAnV6jk8DEfBSjLtfcyC7Bx25a9CLphzoayv3EtvbE2tAQZDZD"
+    }
 
-The current user object can be located with `current_user`:
+You can also connect additional social accounts to an existing user:
 
-    # in posts_controller
+    <%= link_to 'connect with facebook', connect_user(:facebook) %>
 
-    @posts = currrent_user.posts.all
+`connect_user` defaults to connecting the `current_user`, but you can explicitly connect any user:
 
-##### Using only with Omniauth
+    <%= link_to 'connect with google', connect_user(:google, @user) %>
 
-If you already have omniauth set up and only want to use Dailycred as another OAuth provider, just add this line to your omniauth initializer file
+---
 
-    provider :dailycred, 'CLIENT_ID', 'SECRET_KEY'
+##Helpers
+
+There are a few other helper methods available:
+
+#### current_user
+
+Returns the current logged in user or nil. Example usage:
+
+    if !current_user.nil?
+      redirect_to :controller => 'welcome', :action => 'thanks'
+    end
 
-##### Events
+#### dailycred
 
-To fire an event to be logged in Dailycred:
+A helper for instantiating a dailycred client instance. Use as a `before_filter` to load a @dailycred instance variable, or just use it as a helper method. Example usage:
 
-    #in your controller
+As a before filter:
 
     before_filter :dailycred
 
-    def create
-      ...
+    def index
+        @dailycred.event(current_user.uid, "New Task", @task.name)
+    end
 
-      # after successfully saving the model:
-      @dailycred.event(current_user.uid, 'Created Post', @post.name)
+or just as a helper
 
+    def index
+        dailycred.event(current_user.uid, "New Task", @task.name)
     end
 
-## SSL Error
+#### Tagging a User
+
+Dailycred provides the ability to 'tag' users, whether for reference in analytics or any other reason. Note that this is a very simple 'tagging' system, and not something you should use for dynamic tagging situations in your application.
+
+    @user.tag 'awesome'
+    @user.untag 'awesome'
+
+#### Firing Events
+
+You can also fire events tied to a specific user - this is helpful for goal tracking and tying actions to a specific user in analytics. We already fire many events for when a user signs up, resets a password, and much more, but you can also use the event system for something more specific for your application.
+
+    # user#fire_event(key, value)
+    @user.fire_event 'task added', @task.name
+
+#### Building Referral URLs
+
+To easily build referral URLs to track sharing amongst your users, use `referral_link(my_site)`, where *my_site* is the url that you wish referred users to be sent to.
+
+    current_user.referral_link("http://www.mysite.com")
+
+#### Testing Controllers
+
+Testing controllers that have the `authenticate` before filter is easy:
+
+    # with mocha
+    @controller.expects(:current_user).returns(@user)
+
+See `dummy/test/functional/post_controller_test.rb` for an example.
+
+#### Dailycred API
+
+For reference, have a look at the [annotated source code.](https://www.dailycred.com/public/docs/ruby/lib/dailycred.html)
+
+For all API calls, you must first initalize a Dailycred client:
+
+    @dailycred = Dailycred.new "YOUR_CLIENT_ID", "your_secret_key", opts
+
+Where opts is an optional hash for passing options. After initializing your client, you can create events as well as tag and untag users:
+
+    @dailycred.event(current_user.uid, "New Task", @task.name) # user_id, key, value
+    @dailycred.tag(current_user.uid, "Failed Checkout") # user_id, key
+    @dailycred.untag(current_user.uid, "Failed Checkout") # user_id, key
+
 
-You may get an error such as the following:
+#### Configuration
 
-    Faraday::Error::ConnectionFailed (SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed):
+To specify where users should be redirected after authentication actions, setup configure an `after_auth` property on a `Rails.configuration.DAILYCRED_OPTIONS` variable. Example:
 
-If that is the case, consider following fixes explained [here](https://github.com/technoweenie/faraday/wiki/Setting-up-SSL-certificates) or [here](http://martinottenwaelter.fr/2010/12/ruby19-and-the-ssl-error).
+    # configure where users should be redirected after authentication
+    #
+    # Rails.configuration.DAILYCRED_OPTIONS = {
+    #   :after_auth => '/hello', #after login
+    #   :after_unauth => '/goodbye' #after logout
+    # }
 
 ## Contributing
 
@@ -71,6 +198,5 @@ If that is the case, consider following fixes explained [here](https://github.co
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
 
-omniauth-dailycred
+![](https://www.dailycred.com/dc.gif?client_id=dailycred&title=rails_repo "dailycred")
 
-OmniAuth adapter for dailycred using their OAuth2 Strategy

data/Rakefile

@@ -1,2 +1,32 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  # t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end
+
+begin
+  require 'rocco'
+  require 'rocco/tasks'
+  require 'fileutils'
+  require 'maruku'
+  Rocco::make 'docs/'
+  FileUtils.cp_r "docs/lib/", "/Users/hank/rails/dailycred/public/docs/ruby/", :verbose => true
+  md = ""
+  File.open("README.md", "r") do |infile|
+    while (line = infile.gets)
+      md += line
+    end
+  end
+  doc = Maruku.new(md)
+  File.open("/Users/hank/rails/dailycred/app/views/tags/ruby.html", 'w') {|f| f.write doc.to_html}
+rescue LoadError
+  warn "#$! -- rocco tasks not loaded."
+  task :rocco
+end

data/app/controllers/sessions_controller.rb

@@ -0,0 +1,31 @@
+class SessionsController < ApplicationController
+  before_filter :authenticate, :only => [:destroy]
+  before_filter :current_user
+  include Dailycred::Helpers
+
+  # Callback Route for OAuth flow
+  def create
+    @user = User.find_or_create_with_omniauth auth_hash
+    session[:user_id] = @user.id
+    redirect_to_auth
+  end
+
+  #GET /logout
+  def destroy
+    session[:user_id] = nil
+    redirect_to_unauth
+  end
+
+  def failure
+    redirect_to_unauth notice: params[:message]
+  end
+
+  def info
+  end
+
+  private
+
+  def auth_hash
+    request.env['omniauth.auth']
+  end
+end

data/app/views/sessions/info.html.erb

@@ -0,0 +1,13 @@
+<% if current_user %>
+  <p>Hello <%= current_user.email %> <br>
+    <%= link_to 'Logout', dailycred_engine.logout_path %>
+    <br><%= link_to 'connect with facebook', connect_user(:facebook) %>
+    <br><%= link_to 'connect with google', connect_user(:google) %>
+    <br><%= link_to 'connect with twitter', connect_user(:twitter) %>
+  </p>
+<% else %>
+  <%= link_to 'Log In', login_path() %>
+  <br><%= link_to 'connect with facebook', connect_path(:identity_provider => :facebook) %>
+  <br><%= link_to 'connect with google', connect_path(:identity_provider => :google) %>
+  <br><%= link_to 'connect with twitter', current_user.connect_path(:twitter) %>
+<% end %>

data/config/routes.rb

@@ -0,0 +1,7 @@
+Dailycred::Engine.routes.draw do
+  match "/:provider/callback" => "sessions#create"
+  match "/logout" => "sessions#destroy", :as => :logout
+  match "/" => "sessions#info", :as => :auth_info
+  # get "/dailycred", :as => :login
+  match "/failure" => "sessions#failure"
+end

data/dailycred.gemspec

@@ -3,16 +3,17 @@
 Gem::Specification.new do |gem|
   gem.authors       = ["Hank Stoever"]
   gem.email         = ["hstove@gmail.com"]
-  gem.description   = %q{descript}
-  gem.summary       = %q{summary}
+  gem.description   = %q{A Ruby on Rails engine for authentication with Dailycred.}
+  gem.summary       = %q{}
   gem.homepage      = "https://www.dailycred.com"
   gem.add_dependency("omniauth")
   gem.add_dependency("omniauth-oauth2")
 
+
   gem.files         = `git ls-files`.split("\n")
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.name          = "dailycred"
   gem.require_paths = ["lib"]
-  gem.version       = "0.1.2"
+  gem.version       = "0.1.4"
 end

data/docs/lib/dailycred/acts_as_dailycred.html

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=utf-8">
+  <title>acts_as_dailycred.rb</title>
+  <link rel="stylesheet" href="http://jashkenas.github.com/docco/resources/docco.css">
+</head>
+<body>
+<div id='container'>
+  <div id="background"></div>
+  <div id="jump_to">
+    Jump To &hellip;
+    <div id="jump_wrapper">
+      <div id="jump_page">
+          <a class="source" href="../dailycred.html">dailycred.rb</a>
+          <a class="source" href="acts_as_dailycred.html">acts_as_dailycred.rb</a>
+          <a class="source" href="client.html">client.rb</a>
+          <a class="source" href="engine.html">engine.rb</a>
+          <a class="source" href="helper.html">helper.rb</a>
+          <a class="source" href="middleware.html">middleware.rb</a>
+          <a class="source" href="tests_helper.html">tests_helper.rb</a>
+          <a class="source" href="user.html">user.rb</a>
+          <a class="source" href="../generators/dailycred_generator.html">dailycred_generator.rb</a>
+          <a class="source" href="../generators/templates/migration_create_user.html">migration_create_user.rb</a>
+          <a class="source" href="../generators/templates/omniauth.html">omniauth.rb</a>
+          <a class="source" href="../generators/templates/sessions_controller.html">sessions_controller.rb</a>
+          <a class="source" href="../generators/templates/user.html">user.rb</a>
+          <a class="source" href="../omniauth/strategies/dailycred.html">dailycred.rb</a>
+      </div>
+    </div>
+  </div>
+  <table cellspacing=0 cellpadding=0>
+  <thead>
+    <tr>
+      <th class=docs><h1>acts_as_dailycred.rb</h1></th>
+      <th class=code></th>
+    </tr>
+  </thead>
+  <tbody>
+  </table>
+</div>
+</body>