simple_token_authentication 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 899877f6ac2eca79e1be82590f26f325d8f78cdb
-  data.tar.gz: 7c4c175d5c7bc2ee42fa766ba93842fbdeaea4bc
+  metadata.gz: aff7351e0178a92409d1092d897fba3190bf7931
+  data.tar.gz: 13cf3934848704cb786c32a88d2811ca957e2907
 SHA512:
-  metadata.gz: 0c6c9e2369c3a66d73e3bb374a8668bbb10453a8fd6096a95dee6b4afbf494cc8d2400752e74844876eccccba04d1f8bb6e8add7bd9e437b676de8f4028578a8
-  data.tar.gz: 51c836d46edb83dec3f98404248c57e2b69604c09522216e5627f2d9a7225241e2471195ec0d9a412e66964b62d45712ad7f02faa0bc9a1c0f9379fbf3bba013
+  metadata.gz: 554b98719aee74a692f8bb5d80089f22ff1ce8ea85f2abdb3071b441a9decf87525d3e3f64aa24726e29f3fe0ed4b148352633ade88ffa0af8f49ede34003244
+  data.tar.gz: a15f550bac6dd2776aed33aebf543f8ee1806818817c6ed37fb8a965cb2ced54df1f618c6c3445cb6cb3e193341987c6bec1faa8291dfe95b0dd30ff98154fec

data/README.md

@@ -106,6 +106,10 @@ class ApplicationController < ActionController::Base # or ActionController::API
   # The token authentication requirement can target specific controller actions:
   # acts_as_token_authentication_handler_for User, only: [:create, :update, :destroy]
   # acts_as_token_authentication_handler_for User, except: [:index, :show]
+  #
+  # Or target specific controller conditions:
+  # acts_as_token_authentication_handler_for User, unless: lambda { |controller| controller.request.format.html? }
+  # acts_as_token_authentication_handler_for User, if: lambda { |controller| controller.request.format.json? }
 
   # Several token authenticatable models can be handled by the same controller.
   # If so, for all of them except the last, the fallback_to_devise should be disabled.
@@ -116,6 +120,14 @@ class ApplicationController < ActionController::Base # or ActionController::API
   # acts_as_token_authentication_handler_for SpecialUser, fallback_to_devise: false
   # acts_as_token_authentication_handler_for User # the last fallback is up to you
 
+  # Aliases can be defined for namespaced models:
+  #
+  # acts_as_token_authentication_handler_for Customer::Representative, as: :facilitator
+  # acts_as_token_authentication_handler_for SpecialUser, as: :user
+  #
+  # When defined, aliases are used to define both the params and the header names to watch.
+  # E.g. facilitator_token, X-Facilitator-Token
+
   # ...
 end
 ```

data/lib/simple_token_authentication.rb

@@ -11,7 +11,7 @@ module SimpleTokenAuthentication
 
   def self.ensure_models_can_act_as_token_authenticatables model_adapters
     model_adapters.each do |model_adapter|
-      model_adapter.base_class.send :include, SimpleTokenAuthentication::ActsAsTokenAuthenticatable
+      model_adapter.base_class.send :extend, SimpleTokenAuthentication::ActsAsTokenAuthenticatable
     end
   end
 

data/lib/simple_token_authentication/acts_as_token_authenticatable.rb

@@ -1,49 +1,14 @@
-require 'active_support/concern'
-require 'simple_token_authentication/token_generator'
+require 'simple_token_authentication/token_authenticatable'
 
 module SimpleTokenAuthentication
   module ActsAsTokenAuthenticatable
-    extend ::ActiveSupport::Concern
 
-    # Please see https://gist.github.com/josevalim/fb706b1e933ef01e4fb6
-    # before editing this file, the discussion is very interesting.
+    # This module ensures that no TokenAuthenticatable behaviour
+    # is added before the class actually `acts_as_token_authenticatable`.
 
-    included do
-      private :generate_authentication_token
-      private :token_suitable?
-      private :token_generator
-    end
-
-    # Set an authentication token if missing
-    #
-    # Because it is intended to be used as a filter,
-    # this method is -and should be kept- idempotent.
-    def ensure_authentication_token
-      if authentication_token.blank?
-        self.authentication_token = generate_authentication_token(token_generator)
-      end
-    end
-
-    def generate_authentication_token(token_generator)
-      loop do
-        token = token_generator.generate_token
-        break token if token_suitable?(token)
-      end
-    end
-
-    def token_suitable?(token)
-      self.class.where(authentication_token: token).count == 0
-    end
-
-    # Private: Get one (always the same) object which behaves as a token generator
-    def token_generator
-      @token_generator ||= TokenGenerator.new
-    end
-
-    module ClassMethods
-      def acts_as_token_authenticatable(options = {})
-        before_save :ensure_authentication_token
-      end
+    def acts_as_token_authenticatable(options = {})
+      include SimpleTokenAuthentication::TokenAuthenticatable
+      before_save :ensure_authentication_token
     end
   end
 end

data/lib/simple_token_authentication/entities_manager.rb

@@ -2,9 +2,9 @@ require 'simple_token_authentication/entity'
 
 module SimpleTokenAuthentication
   class EntitiesManager
-    def find_or_create_entity(model)
+    def find_or_create_entity(model, model_alias=nil)
       @entities ||= {}
-      @entities[model.name] ||= Entity.new(model)
+      @entities[model.name] ||= Entity.new(model, model_alias)
     end
   end
 end

data/lib/simple_token_authentication/entity.rb

@@ -1,8 +1,9 @@
 module SimpleTokenAuthentication
   class Entity
-    def initialize model
+    def initialize(model, model_alias=nil)
       @model = model
       @name = model.name
+      @name_underscore = model_alias.to_s unless model_alias.nil?
     end
 
     def model
@@ -14,7 +15,7 @@ module SimpleTokenAuthentication
     end
 
     def name_underscore
-      name.underscore
+      @name_underscore || name.underscore
     end
 
     # Private: Return the name of the header to watch for the token authentication param
@@ -23,7 +24,7 @@ module SimpleTokenAuthentication
         && token_header_name = SimpleTokenAuthentication.header_names["#{name_underscore}".to_sym][:authentication_token]
         token_header_name
       else
-        "X-#{name}-Token"
+        "X-#{name_underscore.camelize}-Token"
       end
     end
 
@@ -33,7 +34,7 @@ module SimpleTokenAuthentication
         && identifier_header_name = SimpleTokenAuthentication.header_names["#{name_underscore}".to_sym][identifier]
         identifier_header_name
       else
-        "X-#{name}-#{identifier.to_s.camelize}"
+        "X-#{name_underscore.camelize}-#{identifier.to_s.camelize}"
       end
     end
 

data/lib/simple_token_authentication/token_authenticatable.rb

@@ -0,0 +1,43 @@
+require 'active_support/concern'
+require 'simple_token_authentication/token_generator'
+
+module SimpleTokenAuthentication
+  module TokenAuthenticatable
+    extend ::ActiveSupport::Concern
+
+    # Please see https://gist.github.com/josevalim/fb706b1e933ef01e4fb6
+    # before editing this file, the discussion is very interesting.
+
+    included do
+      private :generate_authentication_token
+      private :token_suitable?
+      private :token_generator
+    end
+
+    # Set an authentication token if missing
+    #
+    # Because it is intended to be used as a filter,
+    # this method is -and should be kept- idempotent.
+    def ensure_authentication_token
+      if authentication_token.blank?
+        self.authentication_token = generate_authentication_token(token_generator)
+      end
+    end
+
+    def generate_authentication_token(token_generator)
+      loop do
+        token = token_generator.generate_token
+        break token if token_suitable?(token)
+      end
+    end
+
+    def token_suitable?(token)
+      self.class.where(authentication_token: token).count == 0
+    end
+
+    # Private: Get one (always the same) object which behaves as a token generator
+    def token_generator
+      @token_generator ||= TokenGenerator.new
+    end
+  end
+end

data/lib/simple_token_authentication/token_authentication_handler.rb

@@ -92,7 +92,8 @@ module SimpleTokenAuthentication
       #
       # Returns nothing.
       def handle_token_authentication_for(model, options = {})
-        entity = entities_manager.find_or_create_entity(model)
+        model_alias = options[:as] || options['as']
+        entity = entities_manager.find_or_create_entity(model, model_alias)
         options = SimpleTokenAuthentication.parse_options(options)
         define_token_authentication_helpers_for(entity, fallback_authentication_handler)
         set_token_authentication_hooks(entity, options)
@@ -141,7 +142,7 @@ module SimpleTokenAuthentication
         else
           :"authenticate_#{entity.name_underscore}_from_token"
         end
-        before_filter authenticate_method, options.slice(:only, :except)
+        before_filter authenticate_method, options.slice(:only, :except, :if, :unless)
       end
     end
   end

data/lib/simple_token_authentication/version.rb

@@ -1,3 +1,3 @@
 module SimpleTokenAuthentication
-  VERSION = "1.8.0"
+  VERSION = "1.9.0"
 end

data/spec/configuration/action_controller_callbacks_options_spec.rb

@@ -50,4 +50,44 @@ describe 'ActionController', action_controller_callbacks_options: true do
       end
     end
   end
+
+  describe ':if option' do
+
+    context 'when provided to `acts_as_token_authentication_hanlder_for`' do
+
+      it 'is applied to the corresponding callback (1)', rspec_3_error: true, private: true do
+        some_class = @subjects.first
+
+        expect(some_class).to receive(:before_filter).with(:authenticate_user_from_token!, { if: lambda { |controller| 'some condition' } })
+        some_class.acts_as_token_authentication_handler_for User, if: lambda { |controller| 'some condition' }
+      end
+
+      it 'is applied to the corresponding callback (2)', rspec_3_error: true, private: true do
+        some_child_class = @subjects.last
+
+        expect(some_child_class).to receive(:before_filter).with(:authenticate_user_from_token!, { if: lambda { |controller| 'some condition' } })
+        some_child_class.acts_as_token_authentication_handler_for User, if: lambda { |controller| 'some condition' }
+      end
+    end
+  end
+
+  describe ':unless option' do
+
+    context 'when provided to `acts_as_token_authentication_hanlder_for`' do
+
+      it 'is applied to the corresponding callback (1)', rspec_3_error: true, private: true do
+        some_class = @subjects.first
+
+        expect(some_class).to receive(:before_filter).with(:authenticate_user_from_token!, { unless: lambda { |controller| 'some condition' } })
+        some_class.acts_as_token_authentication_handler_for User, unless: lambda { |controller| 'some condition' }
+      end
+
+      it 'is applied to the corresponding callback (2)', rspec_3_error: true, private: true do
+        some_child_class = @subjects.last
+
+        expect(some_child_class).to receive(:before_filter).with(:authenticate_user_from_token!, { unless: lambda { |controller| 'some condition' } })
+        some_child_class.acts_as_token_authentication_handler_for User, unless: lambda { |controller| 'some condition' }
+      end
+    end
+  end
 end

data/spec/lib/simple_token_authentication/acts_as_token_authenticatable_spec.rb

@@ -15,14 +15,22 @@ describe DummyTokenGenerator do
   it_behaves_like 'a token generator'
 end
 
-describe 'A token authenticatable class (or one of its children)' do
+describe 'Any class which extends SimpleTokenAuthentication::ActsAsTokenAuthenticatable (or any if its children)' do
 
   after(:each) do
     ensure_examples_independence
   end
 
   before(:each) do
-    define_test_subjects_for_inclusion_of(SimpleTokenAuthentication::ActsAsTokenAuthenticatable)
+    define_test_subjects_for_extension_of(SimpleTokenAuthentication::ActsAsTokenAuthenticatable)
+  end
+
+  it 'doesn\'t behave like a token authenticatable', public: true do
+    stub_const('SimpleTokenAuthentication::TokenAuthenticatable', Module.new)
+
+    @subjects.each do |subject|
+      expect(subject).not_to be_include SimpleTokenAuthentication::TokenAuthenticatable
+    end
   end
 
   it 'responds to :acts_as_token_authenticatable', public: true do
@@ -31,77 +39,45 @@ describe 'A token authenticatable class (or one of its children)' do
     end
   end
 
-  describe 'which supports the :before_save hook' do
-
-    context 'when it acts as token authenticatable' do
-      it 'ensures its instances have an authentication token before being saved (1)', rspec_3_error: true, public: true do
-        some_class = @subjects.first
-
-        expect(some_class).to receive(:before_save).with(:ensure_authentication_token)
-        some_class.acts_as_token_authenticatable
-      end
-
-      it 'ensures its instances have an authentication token before being saved (2)', rspec_3_error: true, public: true do
-        some_child_class = @subjects.last
+  context 'when it explicitely acts as a token authenticatable' do
 
-        expect(some_child_class).to receive(:before_save).with(:ensure_authentication_token)
-        some_child_class.acts_as_token_authenticatable
-      end
-    end
-  end
+    it 'behaves like a token authenticatable (1)', rspec_3_error: true, public: true do
+      stub_const('SimpleTokenAuthentication::TokenAuthenticatable', Module.new)
 
-  describe 'instance' do
+      some_class = @subjects.first
+      allow(some_class).to receive(:before_save)
 
-    it 'responds to :ensure_authentication_token', protected: true do
-      @subjects.map!{ |subject| subject.new }
-      @subjects.each do |subject|
-        expect(subject).to respond_to :ensure_authentication_token
-      end
+      some_class.acts_as_token_authenticatable
+      expect(some_class).to be_include SimpleTokenAuthentication::TokenAuthenticatable
     end
 
-    context 'when some authentication tokens are already in use' do
-
-      before(:each) do
-        TOKENS_IN_USE = ['ExampleTok3n', '4notherTokeN']
+    it 'behaves like a token authenticatable (2)', rspec_3_error: true, public: true do
+      stub_const('SimpleTokenAuthentication::TokenAuthenticatable', Module.new)
 
-        @subjects.each do |k|
-          k.class_eval do
+      some_child_class = @subjects.last
+      allow(some_child_class).to receive(:before_save)
 
-            def initialize(args={})
-              @authentication_token = args[:authentication_token]
-              @token_generator = DummyTokenGenerator.new(
-                  tokens_to_be_generated: TOKENS_IN_USE + ['Dist1nCt-Tok3N'])
-            end
+      some_child_class.acts_as_token_authenticatable
+      expect(some_child_class).to be_include SimpleTokenAuthentication::TokenAuthenticatable
+    end
+  end
 
-            def authentication_token=(value)
-              @authentication_token = value
-            end
+  describe '.acts_as_token_authenticatable' do
 
-            def authentication_token
-              @authentication_token
-            end
+    context 'when the class supports the :before_save hook' do
 
-            # the 'ExampleTok3n' is already in use
-            def token_suitable?(token)
-              not TOKENS_IN_USE.include? token
-            end
+      it 'ensures its instances have an authentication token before being saved (1)', rspec_3_error: true, public: true do
+        some_class = @subjects.first
 
-            def token_generator
-              @token_generator
-            end
-          end
-        end
-        @subjects.map!{ |subject| subject.new }
+        expect(some_class).to receive(:before_save).with(:ensure_authentication_token)
+        some_class.acts_as_token_authenticatable
       end
 
-      it 'ensures its authentication token is unique', public: true do
-        @subjects.each do |subject|
-          subject.ensure_authentication_token
+      it 'ensures its instances have an authentication token before being saved (2)', rspec_3_error: true, public: true do
+        some_child_class = @subjects.last
 
-          expect(subject.authentication_token).not_to eq 'ExampleTok3n'
-          expect(subject.authentication_token).not_to eq '4notherTokeN'
-          expect(subject.authentication_token).to eq 'Dist1nCt-Tok3N'
-        end
+        expect(some_child_class).to receive(:before_save).with(:ensure_authentication_token)
+        some_child_class.acts_as_token_authenticatable
       end
     end
   end

data/spec/lib/simple_token_authentication/acts_as_token_authentication_handler_spec.rb

@@ -1,16 +1,5 @@
 require 'spec_helper'
 
-def ignore_cucumber_hack
-  skip_rails_test_environment_code
-end
-
-# Skip the code intended to be run in the Rails test environment
-def skip_rails_test_environment_code
-  rails = double()
-  stub_const('Rails', rails)
-  allow(rails).to receive_message_chain(:env, :test?).and_return(false)
-end
-
 describe 'Any class which extends SimpleTokenAuthentication::ActsAsTokenAuthenticationHandler (or any if its children)' do
 
   after(:each) do

data/spec/lib/simple_token_authentication/entities_manager_spec.rb

@@ -19,10 +19,10 @@ describe SimpleTokenAuthentication::EntitiesManager do
       stub_const('SuperUser', super_user)
     end
 
-    context 'when a model is provided for the first time' do
+    context 'when a model is provided for the first time', token_authenticatable_aliases_option: true do
 
       it 'creates an Entity instance for the model', private: true do
-        expect(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser)
+        expect(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser, nil) # no alias
         expect(subject.find_or_create_entity(SuperUser)).to eq 'an Entity instance'
       end
 
@@ -35,13 +35,22 @@ describe SimpleTokenAuthentication::EntitiesManager do
           stub_const('Admin', admin)
           # ensure its Entity instance exists
           subject.find_or_create_entity(Admin)
-          allow(SimpleTokenAuthentication::Entity).to receive(:new).and_return('some new Entity instance')
+          allow(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser, nil).and_return('some new Entity instance')
+          allow(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser, 'some_alias').and_return('some new Entity instance with an alias')
         end
 
         it 'creates an Entity instance for the model', private: true do
-          expect(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser)
+          expect(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser, nil)
           expect(subject.find_or_create_entity(SuperUser)).to eq 'some new Entity instance'
         end
+
+        context 'when a model alias was provided' do
+
+          it 'creates an Entity instance with that alias for the model', private: true do
+            expect(SimpleTokenAuthentication::Entity).to receive(:new).with(SuperUser, 'some_alias')
+            expect(subject.find_or_create_entity(SuperUser, 'some_alias')).to eq 'some new Entity instance with an alias'
+          end
+        end
       end
     end
 

data/spec/lib/simple_token_authentication/entity_spec.rb

@@ -64,6 +64,12 @@ describe SimpleTokenAuthentication::Entity do
       expect(@subject.name_underscore).to be_instance_of String
       expect(@subject.name_underscore).to eq @subject.name_underscore.underscore
     end
+
+    it 'can be predefined', token_authenticatable_aliases_option: true do
+      @subject = SimpleTokenAuthentication::Entity.new(SuperUser, 'incognito_super_user')
+
+      expect(@subject.name_underscore).to eq 'incognito_super_user'
+    end
   end
 
   describe '#token_header_name', protected: true do

data/spec/lib/simple_token_authentication/token_authenticatable_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+class DummyTokenGenerator
+  def initialize(args={})
+    @tokens_to_be_generated = args[:tokens_to_be_generated]
+  end
+
+  def generate_token
+    @tokens_to_be_generated.shift
+  end
+end
+
+describe DummyTokenGenerator do
+  it_behaves_like 'a token generator'
+end
+
+describe 'Any instance of a class which includes SimpleTokenAuthentication::TokenAuthenticatable' do
+
+  let(:described_class) do
+    define_dummy_class_which_includes SimpleTokenAuthentication::TokenAuthenticatable
+  end
+
+  after(:each) do
+    # ensure_examples_independence
+    SimpleTokenAuthentication.send(:remove_const, :SomeClass)
+  end
+
+  it_behaves_like 'a token authenticatable'
+
+  let(:subject) { described_class.new() }
+
+  describe '#ensure_authentication_token' do
+
+    context 'when some authentication tokens are already in use' do
+
+      before(:each) do
+        TOKENS_IN_USE = ['ExampleTok3n', '4notherTokeN']
+
+        subject.instance_eval do
+
+          @token_generator = DummyTokenGenerator.new(
+            tokens_to_be_generated: TOKENS_IN_USE + ['Dist1nCt-Tok3N'])
+
+          def authentication_token=(value)
+            @authentication_token = value
+          end
+
+          def authentication_token
+            @authentication_token
+          end
+
+          # the 'ExampleTok3n' is already in use
+          def token_suitable?(token)
+            not TOKENS_IN_USE.include? token
+          end
+        end
+      end
+
+      it 'ensures its authentication token is unique', public: true do
+        subject.ensure_authentication_token
+
+        expect(subject.authentication_token).not_to eq 'ExampleTok3n'
+        expect(subject.authentication_token).not_to eq '4notherTokeN'
+        expect(subject.authentication_token).to eq 'Dist1nCt-Tok3N'
+      end
+    end
+  end
+end

data/spec/lib/simple_token_authentication/token_authentication_handler_spec.rb

@@ -40,8 +40,8 @@ describe 'Any class which includes SimpleTokenAuthentication::TokenAuthenticatio
       it 'ensures token authentication is handled for the given (token authenticatable) models', public: true do
         double_super_admin_model
         entities_manager = double()
-        allow(entities_manager).to receive(:find_or_create_entity).with(User).and_return('User entity')
-        allow(entities_manager).to receive(:find_or_create_entity).with(SuperAdmin).and_return('SuperAdmin entity')
+        allow(entities_manager).to receive(:find_or_create_entity).with(User, nil).and_return('User entity')
+        allow(entities_manager).to receive(:find_or_create_entity).with(SuperAdmin, nil).and_return('SuperAdmin entity')
 
         # skip steps which are not relevant in this example
         allow(SimpleTokenAuthentication).to receive(:fallback).and_return('default')
@@ -55,6 +55,24 @@ describe 'Any class which includes SimpleTokenAuthentication::TokenAuthenticatio
         subject.handle_token_authentication_for(SuperAdmin, {option: 'some specific value'})
       end
     end
+
+    context 'when an alias is provided for the model', token_authenticatable_aliases_option: true do
+
+      it 'creates an Entity with that alias', private: true do
+        entities_manager = double()
+        allow(entities_manager).to receive(:find_or_create_entity)
+
+        # skip steps which are not relevant in this example
+        allow(subject).to receive(:entities_manager).and_return(entities_manager)
+        allow(subject).to receive(:set_token_authentication_hooks)
+        allow(subject).to receive(:define_token_authentication_helpers_for)
+
+        expect(entities_manager).to receive(:find_or_create_entity).with(User, 'some_alias')
+        subject.handle_token_authentication_for(User, {option: 'value', as: 'some_alias'})
+        expect(entities_manager).to receive(:find_or_create_entity).with(User, 'another_alias')
+        subject.handle_token_authentication_for(User, {option: 'value', 'as' => 'another_alias'})
+      end
+    end
   end
 
   describe '.entities_manager' do
@@ -447,6 +465,65 @@ describe 'Any class which includes SimpleTokenAuthentication::TokenAuthenticatio
           expect(subject.new).not_to respond_to :authenticate_user_from_token!
         end
       end
+
+      context 'with the :admin alias', token_authenticatable_aliases_option: true do
+
+        let(:options) do
+          { 'as' => :admin }
+        end
+
+        it 'ensures its instances require admin to authenticate from token or any Devise strategy before any action', public: true do
+          expect(subject).to receive(:before_filter).with(:authenticate_admin_from_token!, {})
+          subject.handle_token_authentication_for SuperAdmin, options
+        end
+
+        context 'and disables the fallback to Devise authentication' do
+
+          let(:options) do
+            { as: 'admin', fallback_to_devise: false }
+          end
+
+          it 'ensures its instances require admin to authenticate from token before any action', public: true do
+            expect(subject).to receive(:before_filter).with(:authenticate_admin_from_token, {})
+            subject.handle_token_authentication_for SuperAdmin, options
+          end
+        end
+
+        describe 'instance' do
+
+          before(:each) do
+            double_super_admin_model
+
+            subject.class_eval do
+              handle_token_authentication_for SuperAdmin, as: :admin
+            end
+          end
+
+          it 'responds to :authenticate_admin_from_token', protected: true do
+            expect(subject.new).to respond_to :authenticate_admin_from_token
+          end
+
+          it 'responds to :authenticate_admin_from_token!', protected: true do
+            expect(subject.new).to respond_to :authenticate_admin_from_token!
+          end
+
+          it 'does not respond to :authenticate_super_admin_from_token', protected: true do
+            expect(subject.new).not_to respond_to :authenticate_super_admin_from_token
+          end
+
+          it 'does not respond to :authenticate_super_admin_from_token!', protected: true do
+            expect(subject.new).not_to respond_to :authenticate_super_admin_from_token!
+          end
+
+          it 'does not respond to :authenticate_user_from_token', protected: true do
+            expect(subject.new).not_to respond_to :authenticate_user_from_token
+          end
+
+          it 'does not respond to :authenticate_user_from_token!', protected: true do
+            expect(subject.new).not_to respond_to :authenticate_user_from_token!
+          end
+        end
+      end
     end
   end
 end

data/spec/support/spec_for_token_authenticatable_interface.rb

@@ -0,0 +1,8 @@
+RSpec.shared_examples 'a token authenticatable' do
+
+  let(:token_authenticatable) { described_class.new() }
+
+  it 'responds to :ensure_authentication_token', private: true do
+    expect(token_authenticatable).to respond_to :ensure_authentication_token
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simple_token_authentication
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Gonzalo Bulnes Guilpain
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-21 00:00:00.000000000 Z
+date: 2015-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionmailer
@@ -156,11 +156,11 @@ files:
 - lib/simple_token_authentication/entity.rb
 - lib/simple_token_authentication/fallback_authentication_handler.rb
 - lib/simple_token_authentication/sign_in_handler.rb
+- lib/simple_token_authentication/token_authenticatable.rb
 - lib/simple_token_authentication/token_authentication_handler.rb
 - lib/simple_token_authentication/token_comparator.rb
 - lib/simple_token_authentication/token_generator.rb
 - lib/simple_token_authentication/version.rb
-- lib/tasks/simple_token_authentication_tasks.rake
 - spec/configuration/action_controller_callbacks_options_spec.rb
 - spec/configuration/fallback_to_devise_option_spec.rb
 - spec/configuration/header_names_option_spec.rb
@@ -179,6 +179,7 @@ files:
 - spec/lib/simple_token_authentication/errors_spec.rb
 - spec/lib/simple_token_authentication/fallback_authentication_handler_spec.rb
 - spec/lib/simple_token_authentication/sign_in_handler_spec.rb
+- spec/lib/simple_token_authentication/token_authenticatable_spec.rb
 - spec/lib/simple_token_authentication/token_authentication_handler_spec.rb
 - spec/lib/simple_token_authentication/token_comparator_spec.rb
 - spec/lib/simple_token_authentication/token_generator_spec.rb
@@ -190,6 +191,7 @@ files:
 - spec/support/spec_for_configuration_option_interface.rb
 - spec/support/spec_for_entities_manager_interface.rb
 - spec/support/spec_for_sign_in_handler_interface.rb
+- spec/support/spec_for_token_authenticatable_interface.rb
 - spec/support/spec_for_token_comparator_interface.rb
 - spec/support/spec_for_token_generator_interface.rb
 - spec/support/specs_for_token_authentication_handler_interface.rb
@@ -218,36 +220,38 @@ signing_key:
 specification_version: 4
 summary: Simple (but safe) token authentication for Rails apps or API with Devise.
 test_files:
-- spec/configuration/skip_devise_trackable_option_spec.rb
-- spec/configuration/header_names_option_spec.rb
-- spec/configuration/sign_in_token_option_spec.rb
-- spec/configuration/action_controller_callbacks_options_spec.rb
-- spec/configuration/fallback_to_devise_option_spec.rb
-- spec/support/spec_for_configuration_option_interface.rb
-- spec/support/spec_for_token_comparator_interface.rb
-- spec/support/spec_for_authentication_handler_interface.rb
-- spec/support/spec_for_entities_manager_interface.rb
-- spec/support/dummy_classes_helper.rb
-- spec/support/specs_for_token_authentication_handler_interface.rb
-- spec/support/spec_for_token_generator_interface.rb
-- spec/support/spec_for_adapter.rb
-- spec/support/spec_for_sign_in_handler_interface.rb
 - spec/lib/simple_token_authentication_spec.rb
+- spec/lib/simple_token_authentication/entities_manager_spec.rb
+- spec/lib/simple_token_authentication/sign_in_handler_spec.rb
 - spec/lib/simple_token_authentication/fallback_authentication_handler_spec.rb
-- spec/lib/simple_token_authentication/token_generator_spec.rb
-- spec/lib/simple_token_authentication/adapter_spec.rb
+- spec/lib/simple_token_authentication/token_comparator_spec.rb
 - spec/lib/simple_token_authentication/configuration_spec.rb
-- spec/lib/simple_token_authentication/adapters/rails_api_adapter_spec.rb
-- spec/lib/simple_token_authentication/adapters/active_record_adapter_spec.rb
-- spec/lib/simple_token_authentication/adapters/mongoid_adapter_spec.rb
-- spec/lib/simple_token_authentication/adapters/rails_adapter_spec.rb
+- spec/lib/simple_token_authentication/token_generator_spec.rb
+- spec/lib/simple_token_authentication/acts_as_token_authenticatable_spec.rb
 - spec/lib/simple_token_authentication/acts_as_token_authentication_handler_spec.rb
+- spec/lib/simple_token_authentication/token_authenticatable_spec.rb
 - spec/lib/simple_token_authentication/token_authentication_handler_spec.rb
-- spec/lib/simple_token_authentication/sign_in_handler_spec.rb
-- spec/lib/simple_token_authentication/acts_as_token_authenticatable_spec.rb
 - spec/lib/simple_token_authentication/errors_spec.rb
-- spec/lib/simple_token_authentication/entities_manager_spec.rb
-- spec/lib/simple_token_authentication/token_comparator_spec.rb
+- spec/lib/simple_token_authentication/adapters/active_record_adapter_spec.rb
+- spec/lib/simple_token_authentication/adapters/mongoid_adapter_spec.rb
+- spec/lib/simple_token_authentication/adapters/rails_adapter_spec.rb
+- spec/lib/simple_token_authentication/adapters/rails_api_adapter_spec.rb
 - spec/lib/simple_token_authentication/entity_spec.rb
+- spec/lib/simple_token_authentication/adapter_spec.rb
+- spec/configuration/action_controller_callbacks_options_spec.rb
+- spec/configuration/header_names_option_spec.rb
+- spec/configuration/fallback_to_devise_option_spec.rb
+- spec/configuration/skip_devise_trackable_option_spec.rb
+- spec/configuration/sign_in_token_option_spec.rb
 - spec/spec_helper.rb
+- spec/support/spec_for_authentication_handler_interface.rb
+- spec/support/spec_for_entities_manager_interface.rb
+- spec/support/spec_for_adapter.rb
+- spec/support/spec_for_token_authenticatable_interface.rb
+- spec/support/specs_for_token_authentication_handler_interface.rb
+- spec/support/spec_for_token_comparator_interface.rb
+- spec/support/spec_for_configuration_option_interface.rb
+- spec/support/spec_for_sign_in_handler_interface.rb
+- spec/support/dummy_classes_helper.rb
+- spec/support/spec_for_token_generator_interface.rb
 has_rdoc: 

data/lib/tasks/simple_token_authentication_tasks.rake

@@ -1,4 +0,0 @@
-# desc "Explaining what the task does"
-# task :simple_token_authentication do
-#   # Task goes here
-# end