roles_active_record 0.2.5 → 0.3.1

data/roles_active_record.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{roles_active_record}
-  s.version = "0.2.5"
+  s.version = "0.3.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kristian Mandrup"]
-  s.date = %q{2010-10-11}
+  s.date = %q{2010-11-20}
   s.description = %q{Makes it easy to set a role strategy on your User model in Active Record}
   s.email = %q{kmandrup@gmail.com}
   s.extra_rdoc_files = [
@@ -38,8 +38,11 @@ Gem::Specification.new do |s|
      "lib/roles_active_record/namespaces.rb",
      "lib/roles_active_record/role.rb",
      "lib/roles_active_record/strategy.rb",
+     "lib/roles_active_record/strategy/multi.rb",
      "lib/roles_active_record/strategy/multi/many_roles.rb",
      "lib/roles_active_record/strategy/multi/roles_mask.rb",
+     "lib/roles_active_record/strategy/shared.rb",
+     "lib/roles_active_record/strategy/single.rb",
      "lib/roles_active_record/strategy/single/admin_flag.rb",
      "lib/roles_active_record/strategy/single/one_role.rb",
      "lib/roles_active_record/strategy/single/role_string.rb",
@@ -47,7 +50,6 @@ Gem::Specification.new do |s|
      "lib/views/_single_role_selector.erb.html",
      "logging.log",
      "roles_active_record.gemspec",
-     "roles_for_ar.gemspec",
      "sandbox/Rakefile",
      "sandbox/add_role_to_users_migration.erb",
      "sandbox/create_roles_migration.erb",
@@ -72,7 +74,6 @@ Gem::Specification.new do |s|
      "spec/migrations/role_string/002_add_role_string_to_users.rb",
      "spec/migrations/roles_mask/005_add_roles_mask_to_users.rb",
      "spec/migrations/users/001_create_users.rb",
-     "spec/roles_active_record/admin_flag_spec.rb",
      "spec/roles_active_record/generators/roles_generator_spec.rb",
      "spec/roles_active_record/generators/roles_migration/admin_flag_spec.rb",
      "spec/roles_active_record/generators/roles_migration/many_roles_spec.rb",
@@ -80,10 +81,14 @@ Gem::Specification.new do |s|
      "spec/roles_active_record/generators/roles_migration/role_string_spec.rb",
      "spec/roles_active_record/generators/roles_migration/roles_mask_spec.rb",
      "spec/roles_active_record/generators/setup_generator_spec.rb",
-     "spec/roles_active_record/many_roles_spec.rb",
-     "spec/roles_active_record/one_role_spec.rb",
-     "spec/roles_active_record/role_string_spec.rb",
-     "spec/roles_active_record/roles_mask_spec.rb",
+     "spec/roles_active_record/strategy/api.rb",
+     "spec/roles_active_record/strategy/api_examples.rb",
+     "spec/roles_active_record/strategy/multi/many_roles_spec.rb",
+     "spec/roles_active_record/strategy/multi/roles_mask_spec.rb",
+     "spec/roles_active_record/strategy/single/admin_flag_spec.rb",
+     "spec/roles_active_record/strategy/single/one_role_spec.rb",
+     "spec/roles_active_record/strategy/single/role_string_spec.rb",
+     "spec/roles_active_record/strategy/user_setup.rb",
      "spec/spec_helper.rb",
      "tmp/rails/app/models/user.rb",
      "tmp/rails/config/routes.rb",
@@ -112,7 +117,6 @@ Gem::Specification.new do |s|
      "spec/migrations/role_string/002_add_role_string_to_users.rb",
      "spec/migrations/roles_mask/005_add_roles_mask_to_users.rb",
      "spec/migrations/users/001_create_users.rb",
-     "spec/roles_active_record/admin_flag_spec.rb",
      "spec/roles_active_record/generators/roles_generator_spec.rb",
      "spec/roles_active_record/generators/roles_migration/admin_flag_spec.rb",
      "spec/roles_active_record/generators/roles_migration/many_roles_spec.rb",
@@ -120,10 +124,14 @@ Gem::Specification.new do |s|
      "spec/roles_active_record/generators/roles_migration/role_string_spec.rb",
      "spec/roles_active_record/generators/roles_migration/roles_mask_spec.rb",
      "spec/roles_active_record/generators/setup_generator_spec.rb",
-     "spec/roles_active_record/many_roles_spec.rb",
-     "spec/roles_active_record/one_role_spec.rb",
-     "spec/roles_active_record/role_string_spec.rb",
-     "spec/roles_active_record/roles_mask_spec.rb",
+     "spec/roles_active_record/strategy/api.rb",
+     "spec/roles_active_record/strategy/api_examples.rb",
+     "spec/roles_active_record/strategy/multi/many_roles_spec.rb",
+     "spec/roles_active_record/strategy/multi/roles_mask_spec.rb",
+     "spec/roles_active_record/strategy/single/admin_flag_spec.rb",
+     "spec/roles_active_record/strategy/single/one_role_spec.rb",
+     "spec/roles_active_record/strategy/single/role_string_spec.rb",
+     "spec/roles_active_record/strategy/user_setup.rb",
      "spec/spec_helper.rb"
   ]
 
@@ -132,48 +140,45 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rspec>, [">= 2.0.0.rc"])
-      s.add_development_dependency(%q<database_cleaner>, ["~> 0.5.2"])
-      s.add_development_dependency(%q<generator-spec>, ["~> 0.6.5"])
-      s.add_runtime_dependency(%q<activerecord>, ["~> 3.0.0"])
-      s.add_runtime_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_runtime_dependency(%q<arel>, ["~> 1.0.0"])
-      s.add_runtime_dependency(%q<meta_where>, ["~> 0.9.3"])
-      s.add_runtime_dependency(%q<sugar-high>, ["~> 0.2.11"])
+      s.add_development_dependency(%q<rspec>, [">= 2.0"])
+      s.add_development_dependency(%q<database_cleaner>, [">= 0.5"])
+      s.add_development_dependency(%q<generator-spec>, [">= 0.7.0"])
+      s.add_runtime_dependency(%q<activerecord>, ["~> 3.0"])
+      s.add_runtime_dependency(%q<activesupport>, ["~> 3.0"])
+      s.add_runtime_dependency(%q<arel>, ["~> 1.0"])
+      s.add_runtime_dependency(%q<meta_where>, [">= 0.9"])
+      s.add_runtime_dependency(%q<sugar-high>, ["~> 0.3.0"])
       s.add_runtime_dependency(%q<require_all>, ["~> 1.2.0"])
-      s.add_runtime_dependency(%q<roles_generic>, ["~> 0.2.5"])
-      s.add_runtime_dependency(%q<rails3_artifactor>, [">= 0.2.6"])
-      s.add_runtime_dependency(%q<logging_assist>, [">= 0.1.5"])
-      s.add_runtime_dependency(%q<migration_assist>, [">= 0.1.5"])
+      s.add_runtime_dependency(%q<roles_generic>, [">= 0.3.0"])
+      s.add_runtime_dependency(%q<rails3_artifactor>, ["~> 0.3.1"])
+      s.add_runtime_dependency(%q<logging_assist>, ["~> 0.1.6"])
     else
-      s.add_dependency(%q<rspec>, [">= 2.0.0.rc"])
-      s.add_dependency(%q<database_cleaner>, ["~> 0.5.2"])
-      s.add_dependency(%q<generator-spec>, ["~> 0.6.5"])
-      s.add_dependency(%q<activerecord>, ["~> 3.0.0"])
-      s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-      s.add_dependency(%q<arel>, ["~> 1.0.0"])
-      s.add_dependency(%q<meta_where>, ["~> 0.9.3"])
-      s.add_dependency(%q<sugar-high>, ["~> 0.2.11"])
+      s.add_dependency(%q<rspec>, [">= 2.0"])
+      s.add_dependency(%q<database_cleaner>, [">= 0.5"])
+      s.add_dependency(%q<generator-spec>, [">= 0.7.0"])
+      s.add_dependency(%q<activerecord>, ["~> 3.0"])
+      s.add_dependency(%q<activesupport>, ["~> 3.0"])
+      s.add_dependency(%q<arel>, ["~> 1.0"])
+      s.add_dependency(%q<meta_where>, [">= 0.9"])
+      s.add_dependency(%q<sugar-high>, ["~> 0.3.0"])
       s.add_dependency(%q<require_all>, ["~> 1.2.0"])
-      s.add_dependency(%q<roles_generic>, ["~> 0.2.5"])
-      s.add_dependency(%q<rails3_artifactor>, [">= 0.2.6"])
-      s.add_dependency(%q<logging_assist>, [">= 0.1.5"])
-      s.add_dependency(%q<migration_assist>, [">= 0.1.5"])
+      s.add_dependency(%q<roles_generic>, [">= 0.3.0"])
+      s.add_dependency(%q<rails3_artifactor>, ["~> 0.3.1"])
+      s.add_dependency(%q<logging_assist>, ["~> 0.1.6"])
     end
   else
-    s.add_dependency(%q<rspec>, [">= 2.0.0.rc"])
-    s.add_dependency(%q<database_cleaner>, ["~> 0.5.2"])
-    s.add_dependency(%q<generator-spec>, ["~> 0.6.5"])
-    s.add_dependency(%q<activerecord>, ["~> 3.0.0"])
-    s.add_dependency(%q<activesupport>, ["~> 3.0.0"])
-    s.add_dependency(%q<arel>, ["~> 1.0.0"])
-    s.add_dependency(%q<meta_where>, ["~> 0.9.3"])
-    s.add_dependency(%q<sugar-high>, ["~> 0.2.11"])
+    s.add_dependency(%q<rspec>, [">= 2.0"])
+    s.add_dependency(%q<database_cleaner>, [">= 0.5"])
+    s.add_dependency(%q<generator-spec>, [">= 0.7.0"])
+    s.add_dependency(%q<activerecord>, ["~> 3.0"])
+    s.add_dependency(%q<activesupport>, ["~> 3.0"])
+    s.add_dependency(%q<arel>, ["~> 1.0"])
+    s.add_dependency(%q<meta_where>, [">= 0.9"])
+    s.add_dependency(%q<sugar-high>, ["~> 0.3.0"])
     s.add_dependency(%q<require_all>, ["~> 1.2.0"])
-    s.add_dependency(%q<roles_generic>, ["~> 0.2.5"])
-    s.add_dependency(%q<rails3_artifactor>, [">= 0.2.6"])
-    s.add_dependency(%q<logging_assist>, [">= 0.1.5"])
-    s.add_dependency(%q<migration_assist>, [">= 0.1.5"])
+    s.add_dependency(%q<roles_generic>, [">= 0.3.0"])
+    s.add_dependency(%q<rails3_artifactor>, ["~> 0.3.1"])
+    s.add_dependency(%q<logging_assist>, ["~> 0.1.6"])
   end
 end
 

data/spec/fixtures/many_roles_setup.rb

@@ -4,5 +4,5 @@ class User < ActiveRecord::Base
   strategy :many_roles, :default
   role_class :role
 
-  valid_roles_are :admin, :guest
+  valid_roles_are :admin, :guest, :user
 end

data/spec/fixtures/one_role_setup.rb

@@ -4,5 +4,5 @@ class User < ActiveRecord::Base
   strategy :one_role, :default
   role_class :role
 
-  valid_roles_are :admin, :guest
+  valid_roles_are :admin, :guest, :user
 end

data/spec/migrations/many_roles/002_create_roles.rb

@@ -1,7 +1,6 @@
 class CreateRoles < ActiveRecord::Migration
   def self.up
     create_table :roles do |t|
-      t.integer :role_id
       t.string  :name
       t.timestamps
     end

data/spec/migrations/roles_mask/005_add_roles_mask_to_users.rb

@@ -1,7 +1,7 @@
 class AddRolesMaskToUsers < ActiveRecord::Migration
   def self.up           
     change_table :users do |t|
-      t.integer :roles_mask, :default => 1
+      t.integer :roles_mask, :default => 0
     end
   end
 

data/spec/roles_active_record/strategy/api.rb

@@ -0,0 +1,214 @@
+class Role
+end
+
+describe 'Roles Generic API' do
+  before :each do
+    default_user_setup    
+  end
+
+  describe '#in_role' do
+    it "should return first user matching role" do        
+      if User.respond_to? :in_role
+        User.in_role(:guest).first.name.should == 'Guest user'
+        User.in_role(:admin).first.name.should == 'Admin user'
+      end
+    end
+  end
+
+  describe '#in_roles' do
+    it "should return first user matching role" do        
+      if User.respond_to? :in_roles
+        User.in_roles(:guest, :user).first.name.should == 'Guest user'      
+        User.in_roles(:admin, :guest).should be_empty
+      end
+    end
+  end
+
+
+  # it "should be true that a User that includes Roles::Generic has a complete Roles::Generic interface" do
+  #   # mutation API
+  #   [:roles=, :role=, :add_roles, :add_role, :remove_role, :remove_roles, :exchange_roles, :exchange_role].each do |api_method|
+  #     @admin_user.respond_to?(api_method).should be_true
+  #   end
+  # 
+  #   # inspection API
+  #   [:valid_role?, :valid_roles?, :has_roles?, :has_role?, :has?, :is?, :roles, :roles_list, :admin?].each do |api_method|
+  #     @admin_user.respond_to?(api_method).should be_true
+  #   end                  
+  # 
+  #   # class method API
+  #   [:valid_role?, :valid_roles?, :valid_roles].each do |class_api_method|
+  #     @admin_user.class.respond_to?(class_api_method).should be_true
+  #   end
+  # end
+  # 
+  # describe '#valid_role?' do
+  #   it "should be true that the admin user has a valid role of :guest" do      
+  #     # @admin_user.valid_role?(:guest).should be_true
+  #   end
+  # 
+  #   it "should be true that the User class has a valid role of :guest" do      
+  #     # User.valid_role?(:guest).should be_true
+  #   end
+  # end 
+  
+  # describe '#valid_roles' do
+  #   it "should be true that the admin user has a valid role of :guest" do      
+  #     # @admin_user.valid_roles.should include(:guest, :admin)
+  #   end
+  # 
+  #   it "should be true that the User class has a valid role of :guest" do      
+  #     User.valid_roles.should include(:guest, :admin)
+  #   end
+  # end
+  # 
+  # describe '#valid_roles?' do
+  #   it "should be true that the admin user has a valid role of :guest" do      
+  #     @admin_user.valid_roles?(:guest, :admin).should be_true
+  #   end
+  # 
+  #   it "should be true that the User class has a valid role of :guest" do      
+  #     User.valid_roles?(:guest, :admin).should be_true
+  #   end
+  # end
+  # 
+  # describe '#has_role?' do     
+  #   it "should have admin user role to :admin and not to :user" do            
+  #     @admin_user.has_role?(:user).should be_false
+  #     @admin_user.has_role?(:admin).should be_true
+  #   end
+  # 
+  #   it "should be true that guest user has role :user and not :admin" do      
+  #     @guest_user.has_role?(:guest).should be_true    
+  #     @guest_user.has_role?(:admin).should be_false
+  #   end
+  # end
+  # 
+  # describe '#has?' do    
+  #   it "should be true that the admin_user has the :admin role" do      
+  #     @admin_user.has?(:admin).should be_true      
+  #   end
+  # 
+  #   it "should NOT be true that the admin_user has the :admin role" do      
+  #     @guest_user.has?(:admin).should be_false
+  #   end
+  # end
+  # 
+  # describe '#has_roles?' do
+  #   it "should be true that the admin_user has the roles :admin" do      
+  #     @admin_user.has_roles?(:admin).should be_true
+  #   end
+  # 
+  #   it "should NOT be true that the user has the roles :admin" do
+  #     @guest_user.has_roles?(:admin).should be_false
+  #   end
+  # end
+  # 
+  # describe '#roles_list' do
+  #   it "should be true that the first role of admin_user is the :admin role" do      
+  #     @admin_user.roles_list.should include(:admin)
+  #   end
+  # 
+  #   it "should be true that the first role of admin_user is the :user role" do            
+  #     case @normal_user.class.role_strategy.multiplicity
+  #     when :single
+  #       if @normal_user.class.role_strategy.name == :admin_flag
+  #         @normal_user.roles_list.should include(:guest)
+  #       else
+  #         @normal_user.roles_list.should include(:user)
+  #       end
+  #     when :multi
+  #       @normal_user.roles_list.should include(:user, :guest)
+  #     end
+  #   end
+  # end
+  # 
+  # describe '#roles' do
+  #   it "should be true that the roles of admin_user is an array with the role :admin" do      
+  #     roles = @admin_user.roles
+  #     if roles.kind_of? Role
+  #       roles.name.to_sym.should == :admin
+  #     elsif roles.kind_of? Array
+  #       if @normal_user.class.role_strategy.type == :complex
+  #         roles.first.name.to_sym.should == :admin
+  #       else
+  #         roles.first.to_sym.should == :admin          
+  #       end
+  #     else       
+  #       roles.to_sym.should == :admin
+  #     end
+  #   end
+  # end 
+  # 
+  # describe '#admin?' do    
+  #   it "should be true that admin_user is in the :admin role" do      
+  #     @admin_user.admin?.should be_true
+  #   end
+  # 
+  #   it "should NOT be true that the user is in the :admin role" do      
+  #     @guest_user.admin?.should be_false
+  #   end
+  # end
+  # 
+  # describe '#is?' do          
+  #   it "should be true that admin_user is in the :admin role" do      
+  #     @admin_user.is?(:admin).should be_true
+  #   end
+  # 
+  #   it "should NOT be true that the user is in the :admin role" do      
+  #     @guest_user.is?(:admin).should be_false
+  #   end
+  # end    
+  # 
+  # describe '#roles=' do
+  #   it "should set user role to :admin" do
+  #     @guest_user.roles = :admin      
+  #     @guest_user.has_role?(:admin).should be_true      
+  #     @guest_user.roles = :guest            
+  #   end    
+  # end
+  # 
+  # describe '#exchange_roles' do
+  #   it "should exchange user role :user with role :admin" do
+  #     @guest_user.exchange_role :guest, :with => :admin      
+  #     @guest_user.has?(:guest).should be_false
+  #     @guest_user.has?(:admin).should be_true
+  #   end    
+  # 
+  #   it "should exchange user role :admin with roles :user and :guest" do
+  #     @admin_user.exchange_role :admin, :with => [:user, :guest]
+  #     puts "Role: #{@admin_user.role}"
+  #     @admin_user.has?(:admin).should be_false
+  # 
+  #     case @admin_user.class.role_strategy.multiplicity
+  #     when :single     
+  #       if @normal_user.class.role_strategy.name == :admin_flag
+  #         @admin_user.has?(:admin).should be_false
+  #         @admin_user.has?(:guest).should be_true
+  #       else
+  #         @admin_user.has?(:user).should be_true
+  #         @admin_user.has?(:guest).should be_false
+  #         @admin_user.has?(:admin).should be_false
+  #       end        
+  #     when :multi
+  #       @admin_user.has_role?(:user).should be_true
+  #       @admin_user.has_role?(:guest).should be_true
+  #       @admin_user.has?(:admin).should be_false        
+  #     end
+  #   end    
+  # end 
+  # 
+  # describe '#remove_roles' do
+  #   it "should remove user role :admin using #remove_roles" do
+  #     @admin_user.remove_roles :admin
+  #     @admin_user.has_role?(:admin).should_not be_true
+  #   end    
+  # 
+  #   it "should remove user role :admin using #remove_role" do
+  #     @guest_user.add_role :admin
+  #     @guest_user.has_role?(:admin).should be_true
+  #     @guest_user.remove_role :admin
+  #     @guest_user.has_role?(:admin).should_not be_true
+  #   end  
+  # end
+end

data/spec/roles_active_record/strategy/api_examples.rb

@@ -0,0 +1,213 @@
+describe "Roles for Active Record: #{api_name}" do   
+  before do
+    api_migrate    
+  end
+
+  before :each do
+    api_fixture        
+  end
+  
+  require "roles_active_record/strategy/user_setup.rb"
+
+  before do
+    default_user_setup    
+  end
+
+  describe '#in_role' do
+    it "should return first user matching role" do        
+      if User.respond_to? :in_role
+        User.in_role(:guest).first.name.should == 'Guest user'
+        User.in_role(:admin).first.name.should == 'Admin user'
+      end
+    end
+  end
+
+  describe '#in_any_role' do
+    it "should return first user matching role" do        
+      if User.respond_to? :in_roles
+        User.in_any_role(:guest, :user).first.name.should == 'Guest user'      
+        User.in_any_role(:admin, :guest).should be_empty
+      end
+    end
+  end
+  
+  it "should be true that a User that includes Roles::Generic has a complete Roles::Generic interface" do
+    # mutation API
+    [:roles=, :role=, :add_roles, :add_role, :remove_role, :remove_roles, :exchange_roles, :exchange_role].each do |api_method|
+      @admin_user.respond_to?(api_method).should be_true
+    end
+  
+    # inspection API
+    [:valid_role?, :valid_roles?, :has_roles?, :has_role?, :has?, :is?, :roles, :roles_list, :admin?].each do |api_method|
+      @admin_user.respond_to?(api_method).should be_true
+    end                  
+  
+    # class method API
+    [:valid_role?, :valid_roles?, :valid_roles].each do |class_api_method|
+      @admin_user.class.respond_to?(class_api_method).should be_true
+    end
+  end 
+  
+  describe '#valid_role?' do
+    it "should be true that the admin user has a valid role of :guest" do      
+      # @admin_user.valid_role?(:guest).should be_true
+    end
+  
+    it "should be true that the User class has a valid role of :guest" do      
+      # User.valid_role?(:guest).should be_true
+    end
+  end  
+  
+  describe '#valid_roles' do
+    it "should be true that the admin user has a valid role of :guest" do      
+      # @admin_user.valid_roles.should include(:guest, :admin)
+    end
+  
+    it "should be true that the User class has a valid role of :guest" do      
+      User.valid_roles.should include(:guest, :admin)
+    end
+  end
+  
+  describe '#valid_roles?' do
+    it "should be true that the admin user has a valid role of :guest" do      
+      @admin_user.valid_roles?(:guest, :admin).should be_true
+    end
+  
+    it "should be true that the User class has a valid role of :guest" do      
+      User.valid_roles?(:guest, :admin).should be_true
+    end
+  end  
+  
+  describe '#has_role?' do     
+    it "should have admin user role to :admin and not to :user" do            
+      @admin_user.has_role?(:user).should be_false
+      @admin_user.has_role?(:admin).should be_true
+    end
+  
+    it "should be true that guest user has role :guest and not :admin" do      
+      puts "Guest user: #{@guest_user.roles_list}"
+      @guest_user.has_role?(:guest).should be_true    
+      @guest_user.has_role?(:admin).should be_false
+    end
+  end  
+  
+  describe '#has?' do    
+    it "should be true that the admin_user has the :admin role" do      
+      @admin_user.has?(:admin).should be_true      
+    end
+  
+    it "should NOT be true that the admin_user has the :admin role" do      
+      @guest_user.has?(:admin).should be_false
+    end
+  end
+  
+  describe '#has_roles?' do
+    it "should be true that the admin_user has the roles :admin" do      
+      # @admin_user.has_roles?(:admin).should be_true
+    end
+  
+    it "should NOT be true that the user has the roles :admin" do
+      @guest_user.has_roles?(:admin).should be_false
+    end
+  end 
+           
+  describe '#roles_list' do
+    it "should be true that the first role of admin_user is the :admin role" do      
+      @admin_user.roles_list.should include(:admin)
+    end
+  
+    it "should be true that the first role of admin_user is the :user role" do            
+      case @normal_user.class.role_strategy.multiplicity
+      when :single
+        #if @normal_user.class.role_strategy.name == :admin_flag
+        @normal_user.roles_list.should include(:guest)
+        # else
+        #   @normal_user.roles_list.should include(:user)
+        #end
+      when :multi
+        puts "Norm: #{@normal_user.roles}"
+        @normal_user.roles_list.should include(:user, :guest)
+      end
+    end
+  end 
+  
+  describe '#roles' do
+    it "should be true that the roles of admin_user is an array with the role :admin" do      
+      roles = @admin_user.roles
+      if defined?(Role) && roles.kind_of?(Role)
+        roles.name.to_sym.should == :admin
+      elsif roles.kind_of? Array
+        if @normal_user.class.role_strategy.type == :complex
+          roles.first.name.to_sym.should == :admin
+        end
+        if @normal_user.class.role_strategy.name == :admin_flag
+          roles.first.should == true          
+        end
+      else       
+        roles.to_sym.should == :admin
+      end
+    end
+  end 
+  
+  describe '#admin?' do    
+    it "should be true that admin_user is in the :admin role" do      
+      @admin_user.admin?.should be_true
+    end
+  
+    it "should NOT be true that the user is in the :admin role" do      
+      @guest_user.admin?.should be_false
+    end
+  end 
+  
+  describe '#is?' do          
+    it "should be true that admin_user is in the :admin role" do      
+      @admin_user.is?(:admin).should be_true
+    end
+  
+    it "should NOT be true that the user is in the :admin role" do      
+      @guest_user.is?(:admin).should be_false
+    end
+  end    
+  
+  describe '#roles=' do
+    it "should set user role to :admin" do
+      @guest_user.roles = :admin      
+      @guest_user.has_role?(:admin).should be_true      
+      @guest_user.roles = :guest            
+    end    
+  end 
+  
+  describe '#exchange_roles' do
+    it "should exchange user role :user with role :admin" do
+      @guest_user.exchange_role :guest, :with => :admin      
+      @guest_user.has?(:guest).should be_false
+      @guest_user.has?(:admin).should be_true
+    end    
+  
+    it "should exchange user role :admin with roles :user and :guest" do
+      case @admin_user.class.role_strategy.multiplicity
+      when :single     
+        lambda { @admin_user.exchange_role :admin, :with => [:user, :guest] }.should raise_error(ArgumentError)
+      when :multi
+        @admin_user.exchange_role :admin, :with => [:user, :guest]
+        @admin_user.has_role?(:user).should be_true
+        @admin_user.has_role?(:guest).should be_true
+        @admin_user.has?(:admin).should be_false        
+      end
+    end    
+  end 
+  
+  describe '#remove_roles' do
+    it "should remove user role :admin using #remove_roles" do
+      @admin_user.remove_roles :admin
+      @admin_user.has_role?(:admin).should_not be_true
+    end    
+  
+    it "should remove user role :admin using #remove_role" do
+      @guest_user.add_role :admin
+      @guest_user.has_role?(:admin).should be_true
+      @guest_user.remove_role :admin
+      @guest_user.has_role?(:admin).should_not be_true
+    end  
+  end  
+end

data/spec/roles_active_record/strategy/multi/many_roles_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+use_roles_strategy :many_roles
+
+class User < ActiveRecord::Base    
+  include Roles::ActiveRecord
+  
+  strategy :many_roles, :default
+  valid_roles_are :admin, :guest, :user   
+end
+
+def api_migrate
+  migrate('many_roles')
+end
+
+def api_fixture
+  load 'fixtures/many_roles_setup.rb'
+end
+
+def api_name
+  :many_roles
+end
+
+load 'roles_active_record/strategy/api_examples.rb'
+
+
+
+

data/spec/roles_active_record/strategy/multi/roles_mask_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+use_roles_strategy :roles_mask
+
+class User < ActiveRecord::Base    
+  include Roles::ActiveRecord
+  
+  strategy :roles_mask, :default
+  valid_roles_are :admin, :guest, :user   
+end
+
+def api_migrate
+  migrate('roles_mask')
+end
+
+def api_name
+  :roles_mask
+end
+
+load 'roles_active_record/strategy/api_examples.rb'
+
+
+
+