just_open_id 0.0.0

data/README.rdoc

@@ -0,0 +1,56 @@
+== Overview
+
+One of the things I was most looking forward to in rails 3 was the plugin / engine architecture. Recently, I sat down to figure out how to create my first engine and package it up as a gem and it took me awhile of time just to get the structure of the engine setup. It's missing a lot of the "rails" you get in a normal rails app.
+
+In it's simplest form engines are quite easy, however for a full-featured engine (such as creating a forum) there are a lot of extras that you're going to want. These are the things I spent time figuring out that I've packaged up into an easy starting point:
+
+* Namespacing models & controllers so they don't collide with those in the main app
+* Creating a global layout within your engine that gets nested within your application layout
+* Generating migrations from your engine
+* Creating an "acts_as_[plugin]" declaration for use inside your main app's models
+* Easy plugin configuration file editable from main app directory
+* Rake tasks within engine
+* Writing tests for models complete with fixtures
+* Serving static assets within engine
+* Packaging and distributing as a gem
+* Code is here - I've created an engine stub that has all the things setup for you already. I want to see a lot more rails 3 engines get created, I hope this helps! I'd love to hear feedback from you if you try it out.
+
+Here’s how you get ready to create your first gem by using this starting point:
+
+* git clone http://github.com/krschacht/rails_3_engine_demo.git
+* cd rails_3_engine_demo
+* [edit test/database.yml]
+* rake test (this will initialize your test database and run the basic test suite)
+
+Now, create a plain rails app and set it up to use your engine. FYI: even though the engine's directory is 'rails_3_engine_demo', internally the engine is named 'just_open_id'
+
+* cd .. [ this is to take you outside the 'rails_3_engine_demo' directory that was created above' ]
+* rails new demo_app_to_use_gem -d mysql
+* cd demo_app_to_use_gem
+* [edit config/database.yml]
+* [edit Gemfile, add line: ] gem ‘just_open_id’, :path => "../rails_3_engine_demo"
+* rails generate just_open_id
+* [examine config/initializers/just_open_id.rb to see basic config parameters]
+* rake db:create
+* rake db:migrate (one of the migrations that you'll see run came from the engine)
+
+You have now setup a empty rails app that utilizes your engine. To test out the functionality, startup the demo app’s webserver:
+
+* rails server
+* Then visit: http://localhost:3000/just_open_id (this is a controller included within the engine)
+* Watch the server logs as you're viewing this page and you'll see some output which is coming from an application before_filter which is executing from inside the engine (in lib/application_controller.rb)
+* rake just_open_id:report (this is a a rake task that is included inside the engine)
+
+Lastly, let's package up your engine as a real gem. You’ll need Jeweler installed for this:
+
+* cd rails_3_engine_demo
+* sudo gem install jeweler
+* rake gemspec
+* rake build
+* rake install (you have now installed your engine as a gem locally)
+* [ At this point if you wanted your demo app to use your installed gem, edit the Gemfile in your demo app and remove the 'path' option from your gem line. It should look like this: ] gem ‘just_open_id’
+* rake gemcutter:release (this pushes your gem up to Gemcutter, a public gem repository)
+
+Now you’re ready to start customizing this engine for your own purposes. Do a global find in your engine directory and replace every instance of "just_open_id" and "JustOpenId" with your engine name (be sure to preserve capitalization). Likewise, rename every directory and file that’s named "just_open_id" with your engine name. I should really automate this but I haven’t figured out how to create a rake task that I can run from within the engine directory itself.
+
+P.S. Special thanks to Chrispy for helping figure out the application_controller includes!

data/app/controllers/just_open_id/sessions_controller.rb

@@ -0,0 +1,22 @@
+module JustOpenId
+  class SessionsController < ApplicationController
+
+    unloadable
+    
+    layout 'just_open_id'  # this allows you to have a gem-wide layout
+    
+    def create
+      auth = request.env["omniauth.auth"]
+      user = User.find_by_provider_and_uid(auth["provider"], auth["uid"]) || User.create_with_omniauth(auth)
+      session[:user_id] = user.id
+      redirect_to root_url, :notice => "Signed in!"
+    end
+  
+    def destroy
+      session[:user_id] = nil
+      redirect_to root_url, :notice => "Signed out!"
+    end
+    
+  end
+end
+

data/app/models/just_open_id/user.rb

@@ -0,0 +1,14 @@
+module JustOpenId
+  class User < ActiveRecord::Base
+    set_table_name "just_open_id_users"
+
+    def self.create_with_omniauth(auth)
+      create! do |user|
+        user.provider = auth["provider"]
+        user.uid = auth["uid"]
+        user.name = auth["user_info"]["name"]
+      end
+    end
+    
+  end
+end

data/config/initializers/omniauth.rb

@@ -0,0 +1,10 @@
+# require 'omniauth/openid'
+# require 'openid/store/filesystem'
+# 
+# use Rack::Session::Cookie
+# use OmniAuth::Strategies::OpenID, OpenID::Store::Filesystem.new('/tmp')
+
+require 'openid/store/filesystem'
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :open_id, OpenID::Store::Filesystem.new('/tmp'), :identifier => JustOpenId::Engine.config.openid_url
+end

data/config/routes.rb

@@ -0,0 +1,9 @@
+Rails.application.routes.draw do |map|
+
+  # to login you go to:
+  # /auth/open_id
+  # it is provided by omniauth rack middleware declared in initializers/omniauth.rb
+  match "/auth/:provider/callback" => "JustOpenId::Sessions#create"
+  match "/signout" => "JustOpenId::Sessions#destroy", :as => :signout
+
+end

data/lib/engine.rb

@@ -0,0 +1,11 @@
+require 'just_open_id'
+require 'rails'
+require 'action_controller'
+
+module JustOpenId
+  class Engine < Rails::Engine
+    
+    config.openid_url = 'www.myopenid.com/'
+    
+  end
+end

data/lib/extensions/action_controller/base.rb

@@ -0,0 +1,28 @@
+class ActionController::Base
+  def self.require_user(options = {})
+    raise Exception, "require_user cannot be called on ActionController::Base. Only it's subclasses" if self ==  ActionController::Base
+    prepend_before_filter :require_user, options
+  end
+  
+  helper_method :current_user
+
+  protected
+
+  # Filters  
+  def require_user
+    current_user.present? || deny_access
+  end
+
+  def store_location
+    session[:return_to] = request.fullpath
+  end
+  
+  def deny_access
+    store_location
+    redirect_to login_path
+  end
+  
+  def current_user
+    @current_user ||= User.find(session[:user_id]) if session[:user_id]
+  end
+end

data/lib/just_open_id.rb

@@ -0,0 +1,14 @@
+module JustOpenId
+  require 'engine' if defined?(Rails) && Rails::VERSION::MAJOR == 3
+  require 'extensions/action_controller/base'
+
+  #  This engine is intended to run as a gem.
+  #  The lib below will be installed via gem dependencies.
+  begin
+    require "omniauth"
+  rescue LoadError => e
+    warn "Could not load 'omniauth'. Please ensure you have the omniauth gem installed and listed in your Gemfile."
+    raise
+  end
+end
+

data/lib/rails/generators/just_open_id/just_open_id_generator.rb

@@ -0,0 +1,65 @@
+require 'rails/generators'
+require 'rails/generators/migration'
+
+class JustOpenIdGenerator < Rails::Generators::Base
+  include Rails::Generators::Migration
+
+  def self.source_root
+    File.join(File.dirname(__FILE__), 'templates')
+  end
+   
+  def self.next_migration_number(dirname) #:nodoc:
+    if ActiveRecord::Base.timestamped_migrations
+      Time.now.utc.strftime("%Y%m%d%H%M%S")
+    else
+      "%.3d" % (current_migration_number(dirname) + 1)
+    end
+  end
+
+
+  # Every method that is declared below will be automatically executed when the generator is run
+  
+  def create_migration_file
+    f = File.open File.join(File.dirname(__FILE__), 'templates', 'schema.rb')
+    schema = f.read; f.close
+    
+    schema.gsub!(/ActiveRecord::Schema.*\n/, '')
+    schema.gsub!(/^end\n*$/, '')
+
+    f = File.open File.join(File.dirname(__FILE__), 'templates', 'migration.rb')
+    migration = f.read; f.close
+    migration.gsub!(/SCHEMA_AUTO_INSERTED_HERE/, schema)
+    
+    tmp = File.open "tmp/~migration_ready.rb", "w"
+    tmp.write migration
+    tmp.close
+
+    migration_template  '../../../tmp/~migration_ready.rb',
+                        'db/migrate/create_just_open_id_tables.rb'
+    remove_file 'tmp/~migration_ready.rb'
+  end
+
+  def copy_initializer_file
+    copy_file 'initializer.rb', 'config/initializers/just_open_id.rb'
+  end
+
+  def add_user_model
+    create_file 'app/models/user.rb' do
+      "class User < JustOpenId::User\nend"
+    end
+  end
+  
+  def welcome
+    puts '1. Run your migrations for your namespaced User model.
+2. Ensure you have a root path.
+3. Add this to a template.
+
+<% if current_user %>
+  Welcome <%= current_user.name %>!
+  <%= link_to "Sign Out", signout_path %>
+<% else %>
+  <%= link_to "Sign in with Twitter", "/auth/twitter" %>
+<% end %>'
+  end
+  
+end

data/lib/rails/generators/just_open_id/templates/initializer.rb

@@ -0,0 +1,5 @@
+module JustOpenId
+  class Engine < Rails::Engine
+    config.openid_url = 'www.myopenid.com/'
+  end
+end

data/lib/rails/generators/just_open_id/templates/migration.rb

@@ -0,0 +1,9 @@
+class CreateJustOpenIdTables < ActiveRecord::Migration
+  def self.up
+    SCHEMA_AUTO_INSERTED_HERE
+  end
+
+  def self.down
+    drop_table :just_open_id_users
+  end
+end

data/lib/rails/generators/just_open_id/templates/schema.rb

@@ -0,0 +1,11 @@
+ActiveRecord::Schema.define(:version => 0) do
+
+    create_table :just_open_id_users, :force => true do |t|
+      t.string :provider
+      t.string :uid
+      t.string :name
+
+      t.timestamps
+    end
+
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: just_open_id
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- Jody Alkema
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-09 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: rails
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: omniauth
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id002
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: openid
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id003
+- !ruby/object:Gem::Dependency 
+  prerelease: false
+  type: :runtime
+  name: omniauth
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id004
+description: 
+email: jody@alkema.ca
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- app/controllers/just_open_id/sessions_controller.rb
+- app/models/just_open_id/user.rb
+- config/initializers/omniauth.rb
+- config/routes.rb
+- lib/engine.rb
+- lib/extensions/action_controller/base.rb
+- lib/just_open_id.rb
+- lib/rails/generators/just_open_id/just_open_id_generator.rb
+- lib/rails/generators/just_open_id/templates/initializer.rb
+- lib/rails/generators/just_open_id/templates/migration.rb
+- lib/rails/generators/just_open_id/templates/schema.rb
+- README.rdoc
+has_rdoc: true
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Rails 3 engine just OpenID logins using OmniAuth
+test_files: []
+