warden 0.5.3 → 0.6.0

data/VERSION

@@ -1 +0,0 @@
-0.5.3

data/lib/warden/authentication/hooks.rb

@@ -1,124 +0,0 @@
-# encoding: utf-8
-module Warden
-  class Manager
-
-    class << self
-      # A callback hook set to run every time after a user is set.
-      # This will happen the first time the user is either authenticated, accessed or manually set
-      # during a request.  You can supply as many hooks as you like, and they will be run in order of decleration
-      #
-      # Parameters:
-      # <block> A block where you can set arbitrary logic to run every time a user is set
-      #   Block Parameters: |user, auth, opts|
-      #     user - The user object that is being set
-      #     auth - The raw authentication proxy object.
-      #     opts - any options passed into the set_user call includeing :scope
-      #
-      # Example:
-      #   Warden::Manager.after_set_user do |user,auth,opts|
-      #     scope = opts[:scope]
-      #     if auth.session["#{scope}.last_access"].to_i > (Time.now - 5.minutes)
-      #       auth.logout(scope)
-      #       throw(:warden, :scope => scope, :reason => "Times Up")
-      #     end
-      #     auth.session["#{scope}.last_access"] = Time.now
-      #   end
-      #
-      # :api: public
-      def after_set_user(&block)
-        raise BlockNotGiven unless block_given?
-        _after_set_user << block
-      end
-
-      # Provides access to the array of after_set_user blocks to run
-      # :api: private
-      def _after_set_user # :nodoc:
-        @_after_set_user ||= []
-      end
-
-      # A callback hook set to run after the first authentiation of a session.
-      # This will only happenwhen the session is first authenticated
-      #
-      # Parameters:
-      # <block> A block to contain logic for the callback
-      #   Block Parameters: |user, auth, opts|
-      #     user - The user object that is being set
-      #     auth - The raw authentication proxy object.
-      #     opts - any options passed into the authenticate call includeing :scope
-      #
-      # Example:
-      #
-      #   Warden::Manager.after_authentication do |user, auth, opts|
-      #     throw(:warden, opts) unless user.active?
-      #   end
-      #
-      # :api: public
-      def after_authentication(&block)
-        raise BlockNotGiven unless block_given?
-        _after_authentication << block
-      end
-
-      # Provides access to the array of after_authentication blocks
-      # :api: private
-      def _after_authentication
-        @_after_authentication ||= []
-      end
-
-      # A callback that runs just prior to the failur application being called.
-      # This callback occurs after PATH_INFO has been modified for the failure (default /unauthenticated)
-      # In this callback you can mutate the environment as required by the failure application
-      # If a Rails controller were used for the failure_app for example, you would need to set request[:params][:action] = :unauthenticated
-      #
-      # Parameters:
-      # <block> A block to contain logic for the callback
-      #   Block Parameters: |user, auth, opts|
-      #     env - The rack env hash
-      #     opts - any options passed into the authenticate call includeing :scope
-      #
-      # Example:
-      #   Warden::Manager.before_failure do |env, opts|
-      #     params = Rack::Request.new(env).params
-      #     params[:action] = :unauthenticated
-      #     params[:warden_failure] = opts
-      #   end
-      #
-      # :api: public
-      def before_failure(&block)
-        _before_failure << block
-      end
-
-      # Provides access to the callback array for before_failure
-      # :api: private
-      def _before_failure
-        @_before_failure ||= []
-      end
-
-      # A callback that runs just prior to the logout of each scope.
-      #
-      # Parameters:
-      # <block> A block to contain logic for the callback
-      #   Block Parameters: |user, auth, scope|
-      #     user - The authenticated user for the current scope
-      #     auth - The warden proxy object
-      #     scope - current logout scope
-      #
-      # Example:
-      #   Warden::Manager.before_logout do |user, auth, scope|
-      #     user.forget_me!
-      #   end
-      #
-      # :api: public
-      def before_logout(&block)
-        _before_logout << block
-      end
-
-      # Provides access to the callback array for before_logout
-      # :api: private
-      def _before_logout
-        @_before_logout ||= []
-      end
-
-    end
-
-  end # Manager
-end # Warden

data/lib/warden/authentication/strategies.rb

@@ -1,59 +0,0 @@
-# encoding: utf-8
-module Warden
-  module Strategies
-    class << self
-      
-      # Adds a strategy to the grab-bag of strategies available to use.
-      # A strategy is a place where you can put logic related to authentication.
-      # A strategy inherits from Warden::Strategies::Base.  The _add_ method provides a clean way
-      # to declare your strategies.  
-      # You _must_ declare an @authenticate!@ method.
-      # You _may_ provide a @valid?@ method.
-      # The valid method should return true or false depending on if the strategy is a valid one for the request.
-      # 
-      # Parameters: 
-      #   <label: Symbol> The label is the name given to a strategy.  Use the label to refer to the strategy when authenticating
-      #   <strategy: Class|nil> The optional stragtegy argument if set _must_ be a class that inherits from Warden::Strategies::Base and _must_
-      #                         implement an @authenticate!@ method
-      #   <block> The block acts as a convinient way to declare your strategy.  Inside is the class definition of a strategy.
-      #
-      # Examples:
-      #
-      #   Block Declared Strategy:
-      #    Warden::Strategies.add(:foo) do
-      #      def authenticate!
-      #        # authentication logic
-      #      end
-      #    end
-      #
-      #    Class Declared Strategy:
-      #      Warden::Strategies.add(:foo, MyStrategy)
-      #
-      # :api: public
-      def add(label, strategy = nil, &blk)
-        strategy = strategy.nil? ? Class.new(Warden::Strategies::Base, &blk) : strategy
-        raise NoMethodError, "authenticate! is not declared in the #{label} strategy" if !strategy.method_defined?(:authenticate!)
-        raise "#{label.inspect} is Not a Warden::Strategy::Base" if !strategy.ancestors.include?(Warden::Strategies::Base)
-        _strategies[label] = strategy
-      end
-      
-      # Provides access to declared strategies by label
-      # :api: public
-      def [](label)
-        _strategies[label]
-      end
-      
-      # Clears all declared middleware.
-      # :api: public
-      def clear!
-        @strategies = {}
-      end
-
-      # :api: private
-      def _strategies
-        @strategies ||= {}
-      end
-    end # << self
-    
-  end # Strategies
-end # Warden