RubyGems - scottmotte-merb-auth-slice-password-reset - Versions diffs - 0.9.14 - Mend

scottmotte-merb-auth-slice-password-reset 0.9.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

data/LICENSE +20 -0
data/README.textile +219 -0
data/Rakefile +57 -0
data/TODO +2 -0
data/app/controllers/application.rb +5 -0
data/app/controllers/passwords.rb +37 -0
data/app/helpers/application_helper.rb +64 -0
data/app/helpers/mailer_helper.rb +28 -0
data/app/mailers/password_reset_mailer.rb +19 -0
data/app/mailers/views/password_reset_mailer/new_password.html.erb +3 -0
data/app/mailers/views/password_reset_mailer/password_reset.text.erb +5 -0
data/app/views/layout/merb_auth_slice_password_reset.html.erb +16 -0
data/app/views/passwords/forgot_password.html.erb +7 -0
data/lib/merb-auth-slice-password-reset.rb +85 -0
data/lib/merb-auth-slice-password-reset/merbtasks.rb +112 -0
data/lib/merb-auth-slice-password-reset/mixins/senile_user.rb +93 -0
data/lib/merb-auth-slice-password-reset/mixins/senile_user/ar_senile_user.rb +19 -0
data/lib/merb-auth-slice-password-reset/mixins/senile_user/dm_senile_user.rb +22 -0
data/lib/merb-auth-slice-password-reset/mixins/senile_user/mm_senile_user.rb +22 -0
data/lib/merb-auth-slice-password-reset/mixins/senile_user/sq_senile_user.rb +20 -0
data/lib/merb-auth-slice-password-reset/slicetasks.rb +18 -0
data/lib/merb-auth-slice-password-reset/spectasks.rb +75 -0
data/public/javascripts/master.js +0 -0
data/public/stylesheets/master.css +2 -0
data/spec/mailers/password_reset_mailer_spec.rb +49 -0
data/spec/mixins/senile_user_spec.rb +111 -0
data/spec/spec_helper.rb +61 -0
data/stubs/app/controllers/passwords.rb +13 -0
data/stubs/app/mailers/views/password_reset_mailer/new_password.html.erb +3 -0
data/stubs/app/mailers/views/password_reset_mailer/password_reset.text.erb +5 -0
data/stubs/app/views/passwords/forgot_password.html.erb +7 -0
metadata +146 -0

data/app/mailers/views/password_reset_mailer/new_password.html.erb ADDED Viewed

@@ -0,0 +1,3 @@
+Your new password
+<%= @user.password %>

data/app/mailers/views/password_reset_mailer/password_reset.text.erb ADDED Viewed

@@ -0,0 +1,5 @@
+Your password has been reset.
+Please visit:
+  <%= password_reset_url(@user) %>

data/app/views/layout/merb_auth_slice_password_reset.html.erb ADDED Viewed

@@ -0,0 +1,16 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us" lang="en-us">
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+    <title>Fresh MerbAuthSlicePasswordReset Slice</title>
+    <link href="<%= public_path_for :stylesheet, 'master.css' %>" type="text/css" charset="utf-8" rel="stylesheet" media="all" />
+    <script src="<%= public_path_for :javascript, 'master.js' %>" type="text/javascript" charset="utf-8"></script>
+  </head>
+  <!-- you can override this layout at slices/merb-auth-slice-password-reset/app/views/layout/merb-auth-slice-password-reset.html.erb -->
+  <body class="merb-auth-slice-password-reset-slice">
+  <div id="container">
+	  <h1>MerbAuthSlicePasswordReset Slice</h1>
+    <div id="main"><%= catch_content :for_layout %></div>
+  </div>
+  </body>
+</html>

data/app/views/passwords/forgot_password.html.erb ADDED Viewed

@@ -0,0 +1,7 @@
+<form action="" method="post">
+  <p>
+    <label for="<%= @login_param_name %>"><%= @login_param_name.to_s.capitalize.t %></label>
+    <input type="text" class="text" name="<%= @login_param_name %>" id="<%= @login_param_name %>" />
+  </p>
+  <input type="submit" value="Reset password" />
+</form>

data/lib/merb-auth-slice-password-reset.rb ADDED Viewed

@@ -0,0 +1,85 @@
+if defined?(Merb::Plugins)
+  $:.unshift File.dirname(__FILE__)
+  dependency 'merb-slices'
+  dependency 'merb-auth-core'
+  dependency 'merb-auth-more'
+  dependency 'merb-mailer'
+  require(File.expand_path(File.dirname(__FILE__) / "merb-auth-slice-password-reset" / "mixins") / "senile_user")
+  Merb::Plugins.add_rakefiles "merb-auth-slice-password-reset/merbtasks", "merb-auth-slice-password-reset/slicetasks", "merb-auth-slice-password-reset/spectasks"
+  # Register the Slice for the current host application
+  Merb::Slices::register(__FILE__)
+  # Slice configuration - set this in a before_app_loads callback.
+  # By default a Slice uses its own layout, so you can swicht to
+  # the main application layout or no layout at all if needed.
+  #
+  # Configuration options:
+  # :layout - the layout to use; defaults to :merb-auth-slice-password-reset
+  # :mirror - which path component types to use on copy operations; defaults to all
+  Merb::Slices::config[:merb_auth_slice_password_reset][:layout] ||= :application
+  # All Slice code is expected to be namespaced inside a module
+  module MerbAuthSlicePasswordReset
+    # Slice metadata
+    self.description = "MerbAuthSlicePasswordReset is a merb slice that adds password-reset functionality for merb-auth-based merb applications."
+    self.version = "0.9.10"
+    self.author = "Daniel Neighman, Christian Kebekus"
+    # Stub classes loaded hook - runs before LoadClasses BootLoader
+    # right after a slice's classes have been loaded internally.
+    def self.loaded
+    end
+    # Initialization hook - runs before AfterAppLoads BootLoader
+    def self.init
+    end
+    # Activation hook - runs after AfterAppLoads BootLoader
+    def self.activate
+    end
+    # Deactivation hook - triggered by Merb::Slices.deactivate(MerbAuthSlicePasswordReset)
+    def self.deactivate
+    end
+    # Setup routes inside the host application
+    #
+    # @param scope<Merb::Router::Behaviour>
+    #  Routes will be added within this scope (namespace). In fact, any
+    #  router behaviour is a valid namespace, so you can attach
+    #  routes at any level of your router setup.
+    #
+    # @note prefix your named routes with :merb_auth_slice_password_reset_
+    #   to avoid potential conflicts with global named routes.
+    def self.setup_router(scope)
+      scope.match("/reset_password/:password_reset_code").to(:controller => "passwords", :action => "reset").name(:reset_password)
+      scope.match("/forgot_password", :method => :get).to(:controller => "passwords", :action => "forgot_password").name(:forgot_password)
+      scope.match("/forgot_password", :method => :post).to(:controller => "passwords", :action => "send_confirmation")
+    end
+  end
+  # Setup the slice layout for MerbAuthSlicePasswordReset
+  #
+  # Use MerbAuthSlicePasswordReset.push_path and MerbAuthSlicePasswordReset.push_app_path
+  # to set paths to merb-auth-slice-password-reset-level and app-level paths. Example:
+  #
+  # MerbAuthSlicePasswordReset.push_path(:application, MerbAuthSlicePasswordReset.root)
+  # MerbAuthSlicePasswordReset.push_app_path(:application, Merb.root / 'slices' / 'merb-auth-slice-password-reset')
+  # ...
+  #
+  # Any component path that hasn't been set will default to MerbAuthSlicePasswordReset.root
+  #
+  # Or just call setup_default_structure! to setup a basic Merb MVC structure.
+  MerbAuthSlicePasswordReset.setup_default_structure!
+  MaSPR = MerbAuthSlicePasswordReset unless defined?(MaSPR)
+  # Add dependencies for other MerbAuthSlicePasswordReset classes below. Example:
+  # dependency "merb-auth-slice-password-reset/other"
+end

data/lib/merb-auth-slice-password-reset/merbtasks.rb ADDED Viewed

@@ -0,0 +1,112 @@
+namespace :slices do
+  namespace :merb_auth_slice_password_reset do
+    desc "Install MerbAuthSlicePasswordReset"
+    task :install => [:preflight, :setup_directories, :copy_assets, :migrate]
+    desc "Test for any dependencies"
+    task :preflight do # see slicetasks.rb
+    end
+    desc "Setup directories"
+    task :setup_directories do
+      puts "Creating directories for host application"
+      MerbAuthSlicePasswordReset.mirrored_components.each do |type|
+        if File.directory?(MerbAuthSlicePasswordReset.dir_for(type))
+          if !File.directory?(dst_path = MerbAuthSlicePasswordReset.app_dir_for(type))
+            relative_path = dst_path.relative_path_from(Merb.root)
+            puts "- creating directory :#{type} #{File.basename(Merb.root) / relative_path}"
+            mkdir_p(dst_path)
+          end
+        end
+      end
+    end
+    desc "Copy stub files to host application"
+    task :stubs do
+      puts "Copying stubs for MerbAuthSlicePasswordReset - resolves any collisions"
+      copied, preserved = MerbAuthSlicePasswordReset.mirror_stubs!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    desc "Copy stub files and views to host application"
+    task :patch => [ "stubs", "freeze:views" ]
+    desc "Copy public assets to host application"
+    task :copy_assets do
+      puts "Copying assets for MerbAuthSlicePasswordReset - resolves any collisions"
+      copied, preserved = MerbAuthSlicePasswordReset.mirror_public!
+      puts "- no files to copy" if copied.empty? && preserved.empty?
+      copied.each { |f| puts "- copied #{f}" }
+      preserved.each { |f| puts "! preserved override as #{f}" }
+    end
+    desc "Migrate the database"
+    task :migrate do # see slicetasks.rb
+    end
+    desc "Freeze MerbAuthSlicePasswordReset into your app (only merb-auth-slice-password-reset/app)"
+    task :freeze => [ "freeze:app" ]
+    namespace :freeze do
+      desc "Freezes MerbAuthSlicePasswordReset by installing the gem into application/gems"
+      task :gem do
+        ENV["GEM"] ||= "merb-auth-slice-password-reset"
+        Rake::Task['slices:install_as_gem'].invoke
+      end
+      desc "Freezes MerbAuthSlicePasswordReset by copying all files from merb-auth-slice-password-reset/app to your application"
+      task :app do
+        puts "Copying all merb-auth-slice-password-reset/app files to your application - resolves any collisions"
+        copied, preserved = MerbAuthSlicePasswordReset.mirror_app!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      desc "Freeze all views into your application for easy modification"
+      task :views do
+        puts "Copying all view templates to your application - resolves any collisions"
+        copied, preserved = MerbAuthSlicePasswordReset.mirror_files_for :view
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      desc "Freeze all mailers into your application for easy modification"
+      task :mailers do
+        puts "Copying all mailer templates to your application - resolves any collisions"
+        copied, preserved = MerbAuthSlicePasswordReset.mirror_files_for :mailer
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      desc "Freeze all models into your application for easy modification"
+      task :models do
+        puts "Copying all models to your application - resolves any collisions"
+        copied, preserved = MerbAuthSlicePasswordReset.mirror_files_for :model
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+      desc "Freezes MerbAuthSlicePasswordReset as a gem and copies over merb-auth-slice-password-reset/app"
+      task :app_with_gem => [:gem, :app]
+      desc "Freezes MerbAuthSlicePasswordReset by unpacking all files into your application"
+      task :unpack do
+        puts "Unpacking MerbAuthSlicePasswordReset files to your application - resolves any collisions"
+        copied, preserved = MerbAuthSlicePasswordReset.unpack_slice!
+        puts "- no files to copy" if copied.empty? && preserved.empty?
+        copied.each { |f| puts "- copied #{f}" }
+        preserved.each { |f| puts "! preserved override as #{f}" }
+      end
+    end
+  end
+end

data/lib/merb-auth-slice-password-reset/mixins/senile_user.rb ADDED Viewed

@@ -0,0 +1,93 @@
+module Merb
+  class Authentication
+    module Mixins
+      # This mixin provides basic password-reset functionality for senile users.
+      #
+      # Added properties:
+      #  :password_reset_code, String
+      #
+      # To use it simply require it and include it into your user class.
+      #
+      # class User
+      #   include Merb::Authentication::Mixins::SenileUser
+      #
+      # end
+      #
+      module SenileUser
+        def self.included(base)
+          base.class_eval do
+            include Merb::Authentication::Mixins::SenileUser::InstanceMethods
+            extend  Merb::Authentication::Mixins::SenileUser::ClassMethods
+            path = File.expand_path(File.dirname(__FILE__)) / "senile_user"
+            if defined?(DataMapper) && DataMapper::Resource > self
+              require path / "dm_senile_user"
+              extend(Merb::Authentication::Mixins::SenileUser::DMClassMethods)
+            elsif defined?(ActiveRecord) && ancestors.include?(ActiveRecord::Base)
+              require path / "ar_senile_user"
+              extend(Merb::Authentication::Mixins::SenileUser::ARClassMethods)
+            elsif defined?(Sequel) && ancestors.include?(Sequel::Model)
+              require path / "sq_senile_user"
+              extend(Merb::Authentication::Mixins::SenileUser::SQClassMethods)
+            elsif MongoMapper::Document > self
+              require path / "mm_senile_user"
+              extend(Merb::Authentication::Mixins::SenileUser::MMClassMethods)
+            end
+          end # base.class_eval
+        end # self.included
+        module ClassMethods
+          def make_key
+            Digest::SHA1.hexdigest( Time.now.to_s.split(//).sort_by {rand}.join )
+          end
+        end # ClassMethods
+        module InstanceMethods
+          def reset_password!
+            self.password = self.password_confirmation = Digest::SHA1.hexdigest( Time.now.to_s.split(//).sort_by {rand}.join )[0, 7]
+            send_new_password
+            self.password_reset_code = nil
+            self.save
+          end
+          def generate_password_reset_code
+            pwreset_key_success = false
+            until pwreset_key_success
+              self.password_reset_code = self.class.make_key
+              self.save
+              pwreset_key_success = self.errors.on(:password_reset_code).nil? ? true : false
+            end
+          end
+          def password_reset?
+            ! self.password_reset_code.nil?
+          end
+          # Sends out the password reset notification.
+          # Used 'Request to change your password' as subject if +MaSFP[:password_reset_subject]+ is not set.
+          def send_password_reset_notification
+            generate_password_reset_code
+            deliver_password_reset_email(:password_reset, :subject => (MaSPR[:password_reset_subject] || "Request to change your password"))
+          end
+          def send_new_password
+            deliver_password_reset_email(:new_password, :subject => (MaSPR[:new_password_subject] || "Your new password"))
+          end
+          private
+          # Helper method delivering the email.
+          def deliver_password_reset_email(action, params)
+            from = MaSPR[:from_email]
+            raise "No :from_email option set for Merb::Slices::config[:merb_auth_slice_password_reset][:from_email]" unless from
+            MaSPR::PasswordResetMailer.dispatch_and_deliver(action, params.merge(:from => from, :to => self.email), :user => self)
+          end
+        end # InstanceMethods
+      end # SenileUser
+    end # Mixins
+  end # Authentication
+end # Merb

data/lib/merb-auth-slice-password-reset/mixins/senile_user/ar_senile_user.rb ADDED Viewed

@@ -0,0 +1,19 @@
+module Merb
+  class Authentication
+    module Mixins
+      module SenileUser
+        module ARClassMethods
+          def self.extended(base)
+            def find_with_password_reset_code(code)
+              find(:first, :conditions => ["password_reset_code = ?", code])
+            end
+            def find_with_login_param(param_name, value)
+              find(:first, :conditions => ["#{param_name} = ?", value])
+            end
+          end # self.extended
+        end # ARClassMethods
+      end # SenileUser
+    end # Mixins
+  end # Authentication
+end # Merb

data/lib/merb-auth-slice-password-reset/mixins/senile_user/dm_senile_user.rb ADDED Viewed

@@ -0,0 +1,22 @@
+module Merb
+  class Authentication
+    module Mixins
+      module SenileUser
+        module DMClassMethods
+          def self.extended(base)
+            base.class_eval do
+              property :password_reset_code, String, :writer => :protected
+            end # base.class_eval
+            def find_with_password_reset_code(code)
+              first(:password_reset_code => code)
+            end
+            def find_with_login_param(param_name, value)
+              first(param_name => value)
+            end
+          end # self.extended
+        end # DMClassMethods
+      end # SenileUser
+    end # Mixins
+  end # Authentication
+end #Merb

data/lib/merb-auth-slice-password-reset/mixins/senile_user/mm_senile_user.rb ADDED Viewed

@@ -0,0 +1,22 @@
+module Merb
+  class Authentication
+    module Mixins
+      module SenileUser
+        module MMClassMethods
+          def self.extended(base)
+            base.class_eval do
+              key :password_reset_code, String
+            end # base.class_eval
+            def find_with_password_reset_code(code)
+              find(:first, :conditions => {:password_reset_code => code})
+            end
+            def find_with_login_param(param_name, value)
+              find(:first, :conditions => {param_name => value})
+            end
+          end # self.extended
+        end # MMClassMethods
+      end # SenileUser
+    end # Mixins
+  end # Authentication
+end #Merb

data/lib/merb-auth-slice-password-reset/mixins/senile_user/sq_senile_user.rb ADDED Viewed

@@ -0,0 +1,20 @@
+module Merb
+  class Authentication
+    module Mixins
+      module SenileUser
+        module SQClassMethods
+          def self.extended(base)
+            def find_with_password_reset_code(code)
+              self[:password_reset_code => code]
+            end
+            def find_with_login_param(param_name, value)
+              self[param_name => value]
+            end
+          end # self.extended
+        end # SQClassMethods
+        module SQInstanceMethods
+        end # SQInstanceMethods
+      end # SenileUser
+    end # Mixins
+  end # Authentication
+end # Merb

data/lib/merb-auth-slice-password-reset/slicetasks.rb ADDED Viewed

@@ -0,0 +1,18 @@
+namespace :slices do
+  namespace :merb_auth_slice_password_reset do
+    # add your own merb-auth-slice-password-reset tasks here
+    # implement this to test for structural/code dependencies
+    # like certain directories or availability of other files
+    desc "Test for any dependencies"
+    task :preflight do
+    end
+    # implement this to perform any database related setup steps
+    desc "Migrate the database"
+    task :migrate do
+    end
+  end
+end

data/lib/merb-auth-slice-password-reset/spectasks.rb ADDED Viewed

@@ -0,0 +1,75 @@
+namespace :slices do
+  namespace :merb_auth_slice_password_reset do
+    desc "Run slice specs within the host application context"
+    task :spec => [ "spec:explain", "spec:default" ]
+    namespace :spec do
+      slice_root = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+      task :explain do
+        puts "\nNote: By running MerbAuthSlicePasswordReset specs inside the application context any\n" +
+        "overrides could break existing specs. This isn't always a problem,\n" +
+        "especially in the case of views. Use these spec tasks to check how\n" +
+        "well your application conforms to the original slice implementation."
+      end
+      Spec::Rake::SpecTask.new('default') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+      desc "Run all model specs, run a spec for a specific Model with MODEL=MyModel"
+      Spec::Rake::SpecTask.new('model') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['MODEL'])
+          t.spec_files = Dir["#{slice_root}/spec/models/**/#{ENV['MODEL']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/models/**/*_spec.rb"].sort
+        end
+      end
+      desc "Run all controller specs, run a spec for a specific Controller with CONTROLLER=MyController"
+      Spec::Rake::SpecTask.new('controller') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/#{ENV['CONTROLLER']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/controllers/**/*_spec.rb"].sort
+        end
+      end
+      desc "Run all view specs, run specs for a specific controller (and view) with CONTROLLER=MyController (VIEW=MyView)"
+      Spec::Rake::SpecTask.new('view') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['CONTROLLER'] and ENV['VIEW'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/#{ENV['VIEW']}*_spec.rb"].sort
+        elsif(ENV['CONTROLLER'])
+          t.spec_files = Dir["#{slice_root}/spec/views/**/#{ENV['CONTROLLER']}/*_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/views/**/*_spec.rb"].sort
+        end
+      end
+      desc "Run all mailer specs, run a spec for a specific Mailer with MAILER=MyMailer"
+      Spec::Rake::SpecTask.new('mailer') do |t|
+        t.spec_opts = ["--format", "specdoc", "--colour"]
+        if(ENV['MAILER'])
+          t.spec_files = Dir["#{slice_root}/spec/mailer/**/#{ENV['MAILER']}_spec.rb"].sort
+        else
+          t.spec_files = Dir["#{slice_root}/spec/mailers/**/*_spec.rb"].sort
+        end
+      end
+      desc "Run all specs and output the result in html"
+      Spec::Rake::SpecTask.new('html') do |t|
+        t.spec_opts = ["--format", "html"]
+        t.libs = ['lib', 'server/lib' ]
+        t.spec_files = Dir["#{slice_root}/spec/**/*_spec.rb"].sort
+      end
+    end
+  end
+end