rules_engine_users 0.0.1

data/rails_generators/templates/app/views/users/welcome_form.html.erb

@@ -0,0 +1,21 @@
+<div class="prepend-1 prepend-top span-16">
+	<h2>Set Your Password</h2>	
+  <% re_form_for(:user, :url => user_welcome_path, :html => {:id => "user_welcome"}, :span => "5x11") do |f| %>  
+    <% re_whitebox do %>      
+      <%= hidden_field_tag :token, @token%>
+    
+      <%= f.text_field :email, :label => 'Your Email', :size=>40, :required => true%>
+      <%= f.password_field :password, :label => 'New Password', :size=>25, :required => true%>
+      <%= f.password_field :password_confirmation, :label => 'Confirm New Password', :size=>25, :required => true%>
+    
+      <div class="span-10">
+        <%= link_to("Login", user_login_path) %>
+      </div>
+      <div class="span-5">
+        <%= re_button_submit("Set Password", "green", :span => "4") %>    
+      </div>  
+      <div class="clear"></div>
+    <% end %>
+  <% end %>
+</div>
+<div class="clear"></div>

data/rails_generators/templates/db/migrate/20100104014507_create_users.rb

@@ -0,0 +1,41 @@
+class CreateUsers < ActiveRecord::Migration
+  def self.up
+
+    # USERS
+    create_table :users do |t|
+      t.column :full_name,                 :string
+      t.column :email,                     :string
+      t.column :login,                     :string
+      t.column :time_zone,                 :string
+      t.column :crypted_password,          :string, :limit => 40
+      t.column :salt,                      :string, :limit => 40
+      t.column :created_at,                :datetime
+      t.column :updated_at,                :datetime
+      t.column :remember_token,            :string
+      t.column :remember_token_expires_at, :datetime
+      t.column :reset_token,               :string
+      t.column :reset_token_expires_at,    :datetime
+      t.column :access_level,              :int             
+    end    
+    
+    add_index :users, :full_name
+    add_index :users, :email
+    add_index :users, :login
+
+    ######### THIS SHOULD BE IN THE seeds.rb file
+    ActionMailer::Base.perform_deliveries = false
+
+    User.create (:full_name => 'Admin User', 
+                  :email => 'admin@test.com', 
+                  :login => 'admin', 
+                  :time_zone => "Pacific Time (US & Canada)",
+                  :password => 'nopassword', 
+                  :password_confirmation => 'nopassword', 
+                  :access_level => User::ACCESS_LEVEL_ADMIN )  
+    
+  end
+
+  def self.down
+    drop_table :users 
+  end
+end

data/rails_generators/templates/doc/README.rules_engine_users

@@ -0,0 +1,122 @@
+## Ruby and Rails Rules Engine Framework
+# More detailed documentation at http://www.r3ef.com
+
+## Installation Guide
+###################################### 
+# 1. Install the Gem
+sudo gem install rules_engine
+sudo gem install rules_engine_users
+sudo gem install will_paginate
+
+######################################
+# 2. Add to the existing Rails App
+  ./script/generate rules_engine_users
+
+######################################
+# 3. Setup the Rails Environments
+ - ./config/environment.rb
+
+  Rails::Initializer.run do |config|
+    ...
+    config.gem 'rules_engine'
+    config.gem 'rules_engine_users'
+    config.gem 'will_paginate'
+    ...
+    config.active_record.observers = :user_observer
+    ...
+  end
+
+  ActionController::Base.define_access_level(:rules_engine_editor,   10)
+  ActionController::Base.define_access_level(:rules_engine_reader,   5)
+  # ActionController::Base.define_access_level(:more_access,   7)
+  # ActionController::Base.define_access_level(:less_access,   3)
+
+ - ./config/environments/production.rb
+ - ./config/environments/development.rb
+
+  config.action_mailer.delivery_method = :smtp
+  config.action_mailer.smtp_settings = {
+    :address => "XXX",
+    :port => 25,
+    :user_name => "XXX",
+    :password => "XXX",
+    :domain => "XXX",
+    :authentication => :login  
+  }
+  RulesEngine::ControllerUserMail.host =   'domain.com'
+  RulesEngine::ControllerUserMail.from =   'domain.com'
+  RulesEngine::ControllerUserMail.prefix = 'My Cool App'
+
+ - ./config/environments/test.rb
+ - ./config/environments/cucumber.rb
+ 
+  config.gem 'cucumber-rails',   :lib => false, :version => '>=0.3.0'
+  config.gem 'database_cleaner', :lib => false, :version => '>=0.5.0'
+  config.gem 'webrat',           :lib => false, :version => '>=0.7.0'
+
+  config.gem "rspec",             :version => '>=1.3.0', :lib => false
+  config.gem "rspec-rails",       :version => '>=1.3.2', :lib => false
+  config.gem "faker",             :version => '>=0.3.1', :lib => false
+
+  config.gem "machinist",         :version => '>=1.0.6', :lib => false
+  config.gem 'rcov',              :version => '>=0.9.8', :lib => false
+  config.gem 'remarkable_rails',  :version => '>=3.1.13', :lib => false
+
+  require 'machinist/active_record'
+  require 'sham'
+  require 'faker'
+  require 'remarkable_rails'
+
+######################################
+# 4. Add the Routes
+ - ./config/routes.rb
+
+  ActionController::Routing::Routes.draw do |map|
+    ...
+    # map.root :controller => 're_pipelines', :action => 'template'
+  
+    map.with_options :controller => 'users', :path_prefix => '/user', :name_prefix => 'user_' do |user|
+      user.login  '/',                  :action => 'login_form',       :conditions => { :method => :get }
+      user.login  '/',                  :action => 'login',            :conditions => { :method => :post }
+      user.logout '/logout',            :action => 'logout'
+      user.pswd_forgot '/pswd_forgot',  :action => 'pswd_forgot_form', :conditions => { :method => :get }
+      user.pswd_forgot '/pswd_forgot',  :action => 'pswd_forgot',      :conditions => { :method => :post }
+      user.pswd_change '/pswd_change',  :action => 'pswd_change_form', :conditions => { :method => :get }
+      user.pswd_change '/pswd_change',  :action => 'pswd_change',      :conditions => { :method => :post }
+      user.details   '/details',        :action => 'details',     :conditions => { :method => :get }   
+      user.change '/change',            :action => 'change_form', :conditions => { :method => :get }
+      user.change '/change',            :action => 'change',      :conditions => { :method => :put }
+      user.pswd_reset  '/pswd_reset',   :action => 'pswd_reset_form',  :conditions => { :method => :get }
+      user.pswd_reset  '/pswd_reset',   :action => 'pswd_reset',       :conditions => { :method => :post }    
+      user.welcome  '/welcome',         :action => 'welcome_form',     :conditions => { :method => :get }
+      user.welcome  '/welcome',         :action => 'welcome',          :conditions => { :method => :post }    
+    end    
+
+    map.namespace :admin do |admin|
+      admin.resources :users, :controller => 'users'
+    end
+    ...
+  end  
+  
+
+######################################
+# 5. Install the Required Gems
+  rake gems:install
+  rake gems:install RAILS_ENV=test  	
+
+######################################
+# 6. Migrate the Database
+  rake db:migrate	
+  rake db:migrate RAILS_ENV=test
+
+######################################
+# 7. Run the Tests
+  rake spec
+  rake spec:rcov
+  rake cucumber
+  open coverage/index.html
+
+######################################
+# 8. Start the Server
+  ./script/server
+  open http://localhost:3000/re_pipelines

data/rails_generators/templates/doc/README.rules_engine_users_paths

@@ -0,0 +1,12 @@
+<h1>User Pages</h1>
+<ul>
+  <li><a href='/user/'>               Login                                           </a></li>
+  <li><a href='/user/logout'>         Logout                                          </a></li>
+  <li><a href='/user/user_details'>   Your Details                                    </a></li>
+  <li><a href='/user/pswd_forgot'>    Password Forgot                                 </a></li>
+  <li><a href='/user/pswd_change'>    Password Change                                 </a></li>
+  <li><a href='/user/pswd_reset'>     Password Reset (Check logs for reset token)     </a></li>
+  <li><a href='/user/welcome'>        User Welcome (Check logs for reset token)       </a></li>    
+
+  <li><a href='/admin/users'>         Admin Users                                     </a></li>
+</ul>

data/rails_generators/templates/features/admin/user/edit.feature

@@ -0,0 +1,46 @@
+Feature: change the user's details
+  As an logged in administrator
+  I want to change any user's details
+  
+Background:
+  Given I am logged in as an administrator
+	Given there is a "user"
+	Given I visit the edit admin user page
+
+Scenario: Visit the edit user page
+	Then I should see the view "admin/users/edit"
+	Then the "Full Name" field should be required
+	Then the "Full Name" field should be "user" "full_name"
+	Then the "Login Name" field should be required
+	Then the "Login Name" field should be "user" "login"
+	Then the "Email" field should be required
+	Then the "Email" field should be "user" "email"
+	Then the "Time Zone" field should be required
+	Then the "Time Zone" field should be "user" "time_zone"
+	Then the "Access Level" field should be required
+	# Then the "Access Level" field should be "Account Disabled"
+	Then the "Access Level" field should be "0"	
+	Then I should see the "Cancel" link to the admin user page
+	Then I should see the "Delete" link to the admin user page
+	Then I should see the "Update" button
+
+Scenario: I enter invalid details
+	Given I fill in "Full Name" with ""
+	When I press "Update"
+	Then I should see the view "admin/users/edit"
+	Then the form error message should be "Unable to Update User"
+	Then the "Full Name" field should be an error
+
+Scenario: I enter valid details
+	Given I fill in "Full Name" with "New Name"
+	When I press "Update"
+	Then I should see the view "admin/users/show"
+	Then the success message should be "User Updated"
+	Then I should see "New Name"
+
+	And I visit the edit admin user page
+
+Scenario: I delete the user
+  When I follow "Delete"
+	Then I should see the view "admin/users/index"
+	Then the success message should be "User Deleted"

data/rails_generators/templates/features/admin/user/index.feature

@@ -0,0 +1,78 @@
+Feature: see all of the user
+  As an logged in administrator
+  I want see or find all of the users
+  
+Background:
+  Given I am logged in as an administrator
+	Given I have the following users
+    | full_name | login   | email            |
+    | A One     | a_one   | a_one@test.com   |
+    | B Two     | b_two   | b_two@test.com   |
+    | C Three   | c_three | c_three@test.com |
+
+Scenario: List all of the users
+  When I am on the admin users page
+	Then I should see the view "admin/users/index"
+	Then I should see the breadcrumb "Home Page" link to the root page
+	Then I should see the breadcrumb "List Users" link to the admin users page
+	Then I should see the breadcrumb "+ Create New User" link to the new admin user page
+  Then I should see the "Search" button
+	Then should see "a_one@test.com" within "table.data"
+	Then should see "b_two@test.com" within "table.data"
+	Then should see "c_three@test.com" within "table.data"
+
+Scenario: Search by Name
+  Given I am on the admin users page
+	Given I fill in "query" with "B"
+	Given I select "Search Name" from "query_type"
+	When I press "Search"
+	Then I should see the view "admin/users/index"
+	Then the "query" field should be "B"
+	Then the "query_type" select field should be "Search Name"	
+	Then should not see "a_one@test.com" within "table.data"
+	Then should see "b_two@test.com" within "table.data"
+	Then should see "c_three@test.com" within "table.data"
+	
+Scenario: Search by Login
+  Given I am on the admin users page
+	Given I fill in "query" with "b"
+	Given I select "Search Login" from "query_type"
+	When I press "Search"
+	Then I should see the view "admin/users/index"
+	Then the "query" field should be "b"
+	Then the "query_type" select field should be "Search Login"
+	Then should not see "a_one@test.com" within "table.data"
+	Then should see "b_two@test.com" within "table.data"
+	Then should see "c_three@test.com" within "table.data"
+
+Scenario: Search by Email
+  Given I am on the admin users page
+	Given I fill in "query" with "b"
+	Given I select "Search Email" from "query_type"
+	When I press "Search"
+	Then I should see the view "admin/users/index"
+	Then the "query" field should be "b"
+	Then the "query_type" select field should be "Search Email"
+	Then should not see "a_one@test.com" within "table.data"
+	Then should see "b_two@test.com" within "table.data"
+	Then should see "c_three@test.com" within "table.data"
+
+Scenario: See the user details
+  Given there are no "users"
+	Given I am logged in as an administrator
+  Given there is a "user"
+  When I am on the admin users page
+	Then I should see the "user" "login" value
+	Then I should see the "user" "full_name" value
+	Then I should see the "user" "email" value
+	Then I should see the "user" "time_zone" value
+	# Then I should see the "user" "access_level" value
+	Then I should see "Account Disabled" 
+
+Scenario: Link to the user details
+  Given there is a "user"
+  When I am on the admin users page
+	Then I should see the user login name link to the user page 
+	Then I should see the user full name link to the user page 
+	
+

data/rails_generators/templates/features/admin/user/new.feature

@@ -0,0 +1,26 @@
+Feature: see all of the user
+  As an logged in administrator
+  I want create a new user
+  
+Background:
+  Given I am logged in as an administrator
+
+Scenario: View the new user form
+  When I am on the new admin user page
+	Then I should see the view "admin/users/new"
+	Then I should see the breadcrumb "Home Page" link to the root page
+	Then I should see the breadcrumb "List Users" link to the admin users page
+	Then I should see the breadcrumb title "New User"
+	Then the "Full Name" field should be required
+	Then the "Full Name" field should be blank
+	Then the "Login Name" field should be required
+	Then the "Login Name" field should be blank
+	Then the "Email" field should be required
+	Then the "Email" field should be blank
+	Then the "Time Zone" field should be required
+	Then the "Time Zone" select field should be "(GMT-05:00) Eastern Time (US & Canada)"
+	Then the "Access Level" field should be required
+	Then the "Access Level" select field should be "Account Disabled"
+  Then I should see the "Cancel" link to the admin users page
+  Then I should see the "Create" button
+

data/rails_generators/templates/features/admin/user/show.feature

@@ -0,0 +1,22 @@
+Feature: see the user details
+  As an logged in administrator
+  I want see the user
+  
+Background:
+  Given I am logged in as an administrator
+	Given there is a "user"
+	
+Scenario: View the user details	
+  When I visit the admin user page
+	Then I should see the view "admin/users/show"
+	Then I should see the breadcrumb "Home Page" link to the root page
+	Then I should see the breadcrumb "List Users" link to the admin users page
+	Then I should see the breadcrumb title "User Details"
+	Then I should see the "user" "full_name" value
+	Then I should see the "user" "login" value
+	Then I should see the "user" "email" value
+	Then I should see the "user" "time_zone" value
+	# Then I should see the "user" "access_level" value
+	Then I should see "Account Disabled"
+  Then I should see the "Edit" link to the edit admin user page
+

data/rails_generators/templates/features/admin/user/step_definitions/edit_steps.rb

@@ -0,0 +1,3 @@
+When /^I visit the edit admin user page$/ do
+  visit edit_admin_user_path(@user)
+end

data/rails_generators/templates/features/admin/user/step_definitions/index_steps.rb

@@ -0,0 +1,13 @@
+Given /^I have the following users$/ do |table|
+  table.hashes.each do |item|
+    User.make(item)
+  end  
+end
+
+Then /^I should see the user login name link to the user page$/ do
+  response.should have_tag("a[href=#{admin_user_path(@user)}]", :text => @user.login)
+end
+
+Then /^I should see the user full name link to the user page$/ do
+  response.should have_tag("a[href=#{admin_user_path(@user)}]", :text => @user.full_name)
+end

data/rails_generators/templates/features/admin/user/step_definitions/show_steps.rb

@@ -0,0 +1,3 @@
+When /^I visit the admin user page$/ do
+  visit admin_user_path(@user)
+end

data/rails_generators/templates/features/support/blueprint_users.rb

@@ -0,0 +1,14 @@
+# USER
+User.blueprint do
+  email                   { Faker::Internet.email }  
+  login                   { Faker::Name.name.gsub(/[^a-z0-9]+/i, '_') }  
+  full_name               { Faker::Name.name }
+  password                { 's3creT' }
+  password_confirmation   { password }
+  access_level            { User::ACCESS_LEVEL_DISABLED }
+  time_zone               { "Eastern Time (US & Canada)" }
+end
+
+User.blueprint(:administrator) do
+  access_level            { User::ACCESS_LEVEL_ADMIN }
+end

data/rails_generators/templates/features/user/change.feature

@@ -0,0 +1,37 @@
+Feature: change the current user's details
+  As an logged in user
+  I want to change my details
+  
+Background:
+  Given I am logged in as a user
+
+Scenario: Visit change my details
+  When I am on the user change page
+	Then I should see the view "users/change_form"
+	Then the "Full Name" field should be required
+	Then the "Full Name" field should be "login" "full_name"
+	Then the "Login Name" field should be required
+	Then the "Login Name" field should be "login" "login"
+	Then the "Email" field should be required
+	Then the "Email" field should be "login" "email"
+	Then the "Time Zone" field should be required
+	Then the "Time Zone" field should be "login" "time_zone"
+	Then I should see the "Change Your Password" link to the user pswd change page
+	Then I should see the "Cancel" link to the user details page
+	Then I should see the "Update" button
+
+Scenario: I enter invalid details
+  Given I am on the user change page
+	Given I fill in "Full Name" with ""
+	When I press "Update"
+	Then I should see the view "users/change_form"
+	Then the form error message should be "Unable to Change User Details"
+	Then the "Full Name" field should be an error
+
+Scenario: I enter valid details
+  Given I am on the user change page
+	Given I fill in "Full Name" with "New Name"
+	When I press "Update"
+	Then I should see the view "users/details"
+	Then the success message should be "User Details Changed"
+	Then I should see "New Name"

data/rails_generators/templates/features/user/details.feature

@@ -0,0 +1,15 @@
+Feature: see the current user's details
+  As an logged in user
+  I want to confirm my details
+  
+Background:
+  Given I am logged in as a user
+  
+Scenario: Visit user details page
+  When I am on the user details page
+	Then I should see the view "users/details"
+	Then I should see the "login" "full_name" value
+	Then I should see the "login" "login" value
+	Then I should see the "login" "email" value
+	Then I should see the "login" "time_zone" value
+	Then I should see the "Update Your Details" link to the user change page

data/rails_generators/templates/features/user/login.feature

@@ -0,0 +1,65 @@
+Feature: login a user
+  As an unlogged in guest
+  I want to login to my account
+  
+Background:
+  Given I am not logged in
+  
+Scenario: Visit login
+  When I am on the user login page
+	Then I should see the view "users/login_form"
+	Then the "Email or Login Name" field should be required
+	Then the "Email or Login Name" field should be blank
+	Then the "Password" field should be required
+	Then the "Password" field should be blank
+	Then the "Remember Me" field should be blank
+	Then I should see the "Forgot Password?" link to the user pswd forgot page
+	Then I should see the "Login" button
+
+Scenario: Login with the correct details  
+  Given there is a user with email "bill@smith.com" and password "smitty"
+  Given I am on the user login page
+  Given I fill in "Email or Login Name" with "bill@smith.com"
+  Given I fill in "Password" with "smitty"
+  When I press "Login"
+  Then I should be on the root page
+  Then I should be logged in
+
+Scenario: Login with the wrong details  
+  Given there is a user with email "bill@smith.com" and password "smitty"
+  Given I am on the user login page
+  Given I fill in "Email or Login Name" with "bill@smith.com"
+  Given I fill in "Password" with "wrong"
+  When I press "Login"
+  Then I should be on the user login page
+  Then I should not be logged in
+
+Scenario: Login as a disabled user  
+  Given there is a disabled user with email "bill@smith.com" and password "smitty"
+  Given I am on the user login page
+  Given I fill in "Email or Login Name" with "bill@smith.com"
+  Given I fill in "Password" with "smitty"
+  When I press "Login"
+  Then I should be on the home page
+	Then the error message should not be blank
+  Then I should not be logged in
+
+Scenario: Login with remember me set
+  Given there is a user with email "bill@smith.com" and password "smitty"
+  Given I am on the user login page
+  Given I fill in "Email or Login Name" with "bill@smith.com"
+  Given I fill in "Password" with "smitty"
+  Given I check "Remember Me"
+  When I press "Login"
+  Then I should be logged in
+  Then the remember me token should be set
+
+Scenario: remember me previously set  
+  Given there is a user with email "bill@smith.com" and password "smitty"
+  Given I am on the user login page
+  Given I fill in "Email or Login Name" with "bill@smith.com"
+  Given I fill in "Password" with "smitty"
+  Given I check "Remember Me"
+  Given I press "Login"
+  When I go to the user logout page
+  Then the remember me token should be set

data/rails_generators/templates/features/user/pswd_change.feature

@@ -0,0 +1,46 @@
+Feature: change the current user's password
+  As an logged in user
+  I want to change my password
+  
+Background:
+  Given I am logged in as a user
+
+Scenario: Visit change my password
+  When I am on the user pswd change page
+	Then I should see the view "users/pswd_change_form"
+	Then the "Old Password" field should be required
+	Then the "Old Password" field should be blank
+	Then the "New Password" field should be required
+	Then the "New Password" field should be blank
+	Then the "Confirm New Password" field should be required
+	Then the "Confirm New Password" field should be blank
+	Then I should see the "Change Your Details" link to the user change page
+	Then I should see the "Cancel" link to the user details page
+	Then I should see the "Update" button
+
+Scenario: I enter invalid old password
+  Given I am on the user pswd change page
+	Given I fill in "Old Password" with "wrong"
+	Given I fill in "New Password" with "new_password"
+	Given I fill in "Confirm New Password" with "new_password"
+	When I press "Update"
+	Then I should see the view "users/pswd_change_form"
+	Then the error message should be "Invalid Old Password"
+
+Scenario: I enter a wrong confirm new password
+  Given I am on the user pswd change page
+	Given I fill in "Old Password" with "mock_password"
+	Given I fill in "New Password" with "new_password"
+	Given I fill in "Confirm New Password" with "new_password_wrong"
+	When I press "Update"
+	Then I should see the view "users/pswd_change_form"
+	Then the error message should be "Could not change password"
+
+Scenario: I enter a a new password
+  Given I am on the user pswd change page
+	Given I fill in "Old Password" with "mock_password"
+	Given I fill in "New Password" with "new_password"
+	Given I fill in "Confirm New Password" with "new_password"
+	When I press "Update"
+	Then I should see the view "users/details"
+	Then the success message should be "Password Changed"

data/rails_generators/templates/features/user/pswd_forgot.feature

@@ -0,0 +1,32 @@
+Feature: reset my password
+  As an unlogged in user
+  I want to reset my password
+  
+Background:
+  Given I am not logged in
+  
+Scenario: Visit user pswd forgot
+  When I am on the user pswd forgot page
+	Then I should see the view "users/pswd_forgot_form"
+	Then the "Your Email" field should be required
+	Then the "Your Email" field should be blank
+	Then I should see the "Login" link to the user login page
+	Then I should see the "Reset Password" button
+
+Scenario: Enter an invalid email
+  Given there are no "users" with "email" set to "bill@smith.com"
+  Given I am on the user pswd forgot page
+  Given I fill in "Your Email" with "bill@smith.com"
+  When I press "Reset Password"
+  Then I should be on the user pswd forgot page
+	Then the error message should be "Could not reset password"
+
+Scenario: Enter a valid email
+  Given there is a "user" with "email" set to "bill@smith.com"
+  Given I am on the user pswd forgot page
+  Given I fill in "Your Email" with "bill@smith.com"
+  When I press "Reset Password"
+  Then I should be on the user login page
+	Then the success message should be "An email has been sent with the password reset details."
+	Then warning "Test the outbound email is correct"
+	# http://drnicwilliams.com/2009/03/26/testing-outbound-emails-with-cucumber/