cantango 0.8.5.1 → 0.8.6

data/Gemfile

@@ -49,8 +49,8 @@ group :test do
 end
 
 group :development, :test do
-  # gem 'rspec-rails', '2.6.1' # needed in development to expose the rails generators
-  # gem 'forgery',    '0.3.10' # needed in development when using rake db:seed
+  gem "rspec-rails",  '>= 2.6.1'  # needed in development to expose the rails generators
+  gem 'forgery',      '>= 0.3' # needed in development when using rake db:seed
   gem 'factory_girl'
 
   # Adapters

data/README.textile

@@ -2,10 +2,10 @@ h1. CanTango
 
 CanTango is an advanced Access Control (permissions) system for Rails 3. It:
 
-* extends "CanCan":http://github.com/ryanb/cancan and offers a role oriented design
+* extends "CanCan":http://github.com/ryanb/cancan and offers a more role oriented design
 * integrates with _role_ and _authentication_ systems in a non-intrusive manner
-* can _cache_ rules between requests for increased performance
-* can _store_ rules in a permission store, including a YAML file, for easy administration
+* can _cache_ ability rules between requests for increased performance
+* can _store_ abilites in a permission store, including a YAML file, for easy administration
 * works well with multiple user accounts and sub applications
 * supports multiple "Devise":https://github.com/plataformatec/devise users
 
@@ -37,15 +37,15 @@ Run bundler in a terminal/console from the folder of your Gemfile (root folder o
 
 h2. Update Sept 1, 2011
 
-Version *0.8.5* has been released.
+Version *0.8.5.1* has been released.
 
-CanTango now supports "sugar-high 0.6":https://github.com/kristianmandrup/sugar-high.git' where "sweetloader":https://github.com/kristianmandrup/sweet_loader.git' has been extracted into its own gem.
+CanTango now:
 
-* The Cache has been refactored
-* Engines are now run in correct order (and only if active)
-* The Cache Kompiler (for dynamic rules caching) and Moneta cache are now optional (via adapters)
-* Permits are found and loaded via pre-registratio via the @#inherited@ method for the base permits. You can also use the _tango_permit_ macro.
-* Better visibility of the @Ability@ flow, to allow one to see which rules are triggered by which permits (likely via a special :debug config mode, since it would affect performance).
+* supports "sugar-high 0.6":https://github.com/kristianmandrup/sugar-high.
+* The ability cache has been refactored
+* Activated engines are now run in specified order
+* The ability cache rules compiler (for dynamic rules caching) and Moneta cache/store are now optional (enabled via adapters)
+* Permits are found and loaded using pre-registration via inheritance. You can also use the _tango_permit_ macro for more control.
 
 The wiki will soon be updated to reflect these improvements and changes.
 
@@ -73,14 +73,16 @@ h3. Rails 3 configuration
 
 The CanTango "Configuration":https://github.com/kristianmandrup/cantango/wiki/Configuration consists of a nice DSL that let's you configure most of the things we imagine you would want to customize. Feel free to suggest more configuration options!
 
-h3. Access Control via Permits and Permissions
+h3. Abilities via Permits and Permissions
 
-AC rules can be defined in both:
+Abilities are Access Control rules. With CanTango, these can be defined in both:
 
 * "Permissions":https://github.com/kristianmandrup/cantango/wiki/Permissions (fx a yaml file)
 * "Permits":https://github.com/kristianmandrup/cantango/wiki/Permits (special classes)
 
-AC rules can be defined for the following conceptual entities:
+Note: For the simplest cases, you can define a @#permit_rules@ instance method directly in _CanTango::Ability_
+
+Abilities can be defined for the following conceptual entities:
 
 * User models
 * User Account models
@@ -88,15 +90,44 @@ AC rules can be defined for the following conceptual entities:
 * Role groups
 * Users
 
+h3. Debugging Abilities and Permits
+
+Each Permit is in effect an Ability on its own. This lets you easily investigate which Permits allowed or denied a certain action for a specific ability candidate (typically a user or user account). 
+
+Debugging Example:
+
+<pre>
+# First you must enable debug mode
+CanTango.debug!
+
+# And have the permit engine execute at least once
+user_can? :read, Article
+
+# Then you can debug the permits execution
+CanTango.permits_allowed current_user, :read, Article
+
+admin_can? :read, Article
+CanTango.permits_denied admin_user, :publish, [Article, Post]
+CanTango.permits_allowed admin_user, :write, Article
+
+CanTango.clear_executed_permits! # reset as if no permits have been executed
+
+user_can? :publish, Article
+CanTango.permits_denied current_user, [:write, publish], [Article, Post]
+
+guest_account_can? :publish, Article
+CanTango.permits_denied guest_account, :publish, [Article, Post], options
+</pre>
+
 h3. Design overview
 
-The default CanTango ability pattern is simple.
+The default CanTango Ability pattern is simple.
 
-1. Return cached rules for ability candidate if available
+1. Return cached ability rules for candidate if available
 2. Generate rules for candidate
 3. Cache rules for candidate
 
-An ability candidate is typically either a user or an account instance.
+A candidate is typically either a user or an account instance.
 
 Caching can be enabled or disabled. To generate the rules, one or more engines are executed.
 
@@ -141,18 +172,8 @@ If you encounter bugs, raise an issue or:
 
 h2. Contributors
 
-*Kristian Mandrup*
-- Main architect
-- Designer of structure
-- Feature ideas
-- Initiator of project
-- Devise app integration specs
-
-"Stanislaw Pankevich":https://github.com/stanislaw
-- Main contributor of permissions engine
-- Caching of Procs for caching engine
-- Lots of bug fixes and specs
-- Tireless "worker" ;)
+* Kristian Mandrup
+* "Stanislaw Pankevich":https://github.com/stanislaw
 
 h3. Copyright
 

data/VERSION

@@ -1 +1 @@
-0.8.5.1
+0.8.6

data/cantango.gemspec

@@ -4,17 +4,14 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = %q{cantango}
-  s.version = "0.8.5.1"
+  s.name = "cantango"
+  s.version = "0.8.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = [%q{Kristian Mandrup}, %q{Stanislaw Pankevich}]
-  s.date = %q{2011-09-02}
-  s.description = %q{Define your permission rules as role- or role group specific permits.
-Integrates well with multiple Devise user acounts.
-Includes rules caching.
-Store permissions in yaml file or key-value store}
-  s.email = %q{kmandrup@gmail.com, s.pankevich@gmail.com}
+  s.authors = ["Kristian Mandrup", "Stanislaw Pankevich"]
+  s.date = "2011-09-16"
+  s.description = "Define your permission rules as role- or role group specific permits.\nIntegrates well with multiple Devise user acounts.\nIncludes rules caching.\nStore permissions in yaml file or key-value store"
+  s.email = "kmandrup@gmail.com, s.pankevich@gmail.com"
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.textile"
@@ -71,6 +68,7 @@ Store permissions in yaml file or key-value store}
     "lib/cantango/configuration/adapters.rb",
     "lib/cantango/configuration/autoload.rb",
     "lib/cantango/configuration/categories.rb",
+    "lib/cantango/configuration/debug.rb",
     "lib/cantango/configuration/engines.rb",
     "lib/cantango/configuration/engines/cache.rb",
     "lib/cantango/configuration/engines/engine.rb",
@@ -274,7 +272,6 @@ Store permissions in yaml file or key-value store}
     "spec/active_record/scenarios/user_accounts/permits/user_account_permit.rb",
     "spec/active_record/scenarios/user_accounts/user_account_spec.rb",
     "spec/active_record/spec_helper.rb",
-    "spec/cantango/README.textile",
     "spec/cantango/ability/cache/key_spec.rb",
     "spec/cantango/ability/cache/kompiler_spec.rb",
     "spec/cantango/ability/cache/reader_compile_spec.rb",
@@ -300,6 +297,7 @@ Store permissions in yaml file or key-value store}
     "spec/cantango/configuration/adapter_spec.rb",
     "spec/cantango/configuration/autoload_spec.rb",
     "spec/cantango/configuration/categories_spec.rb",
+    "spec/cantango/configuration/debug_spec.rb",
     "spec/cantango/configuration/engines/cache_spec.rb",
     "spec/cantango/configuration/engines/engine_shared.rb",
     "spec/cantango/configuration/engines/permission_spec.rb",
@@ -634,11 +632,11 @@ Store permissions in yaml file or key-value store}
     "wiki/when_to_use.markdown",
     "wiki/why_to_use.markdown"
   ]
-  s.homepage = %q{http://github.com/kristianmandrup/cantango}
-  s.licenses = [%q{MIT}]
-  s.require_paths = [%q{lib}]
-  s.rubygems_version = %q{1.8.8}
-  s.summary = %q{CanCan extension with role oriented permission management and more}
+  s.homepage = "http://github.com/kristianmandrup/cantango"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "CanCan extension with role oriented permission management and more"
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
@@ -650,6 +648,8 @@ Store permissions in yaml file or key-value store}
       s.add_runtime_dependency(%q<sweetloader>, ["~> 0.1.0"])
       s.add_runtime_dependency(%q<sqlite3>, [">= 0"])
       s.add_runtime_dependency(%q<hashie>, [">= 0.4"])
+      s.add_development_dependency(%q<rspec-rails>, [">= 2.6.1"])
+      s.add_development_dependency(%q<forgery>, [">= 0.3"])
       s.add_development_dependency(%q<factory_girl>, [">= 0"])
       s.add_development_dependency(%q<sourcify>, [">= 0"])
       s.add_development_dependency(%q<dkastner-moneta>, [">= 1.0"])
@@ -664,6 +664,8 @@ Store permissions in yaml file or key-value store}
       s.add_dependency(%q<sweetloader>, ["~> 0.1.0"])
       s.add_dependency(%q<sqlite3>, [">= 0"])
       s.add_dependency(%q<hashie>, [">= 0.4"])
+      s.add_dependency(%q<rspec-rails>, [">= 2.6.1"])
+      s.add_dependency(%q<forgery>, [">= 0.3"])
       s.add_dependency(%q<factory_girl>, [">= 0"])
       s.add_dependency(%q<sourcify>, [">= 0"])
       s.add_dependency(%q<dkastner-moneta>, [">= 1.0"])
@@ -679,6 +681,8 @@ Store permissions in yaml file or key-value store}
     s.add_dependency(%q<sweetloader>, ["~> 0.1.0"])
     s.add_dependency(%q<sqlite3>, [">= 0"])
     s.add_dependency(%q<hashie>, [">= 0.4"])
+    s.add_dependency(%q<rspec-rails>, [">= 2.6.1"])
+    s.add_dependency(%q<forgery>, [">= 0.3"])
     s.add_dependency(%q<factory_girl>, [">= 0"])
     s.add_dependency(%q<sourcify>, [">= 0"])
     s.add_dependency(%q<dkastner-moneta>, [">= 1.0"])

data/lib/cantango.rb

@@ -22,6 +22,22 @@ module CanTango
     end
 
     alias_method :config, :configure
+
+    def permits_allowed candidate, actions, subjects, *extra_args
+      config.permits.allowed candidate, actions, subjects, *extra_args
+    end
+
+    def permits_denied candidate, actions, subjects, *extra_args
+      config.permits.denied candidate, actions, subjects, *extra_args
+    end
+
+    def clear_permits_executed!
+      config.permits.clear_executed!
+    end
+
+    def debug!
+      config.debug.set :on
+    end
   end
 end
 

data/lib/cantango/ability/cache/key.rb

@@ -4,14 +4,18 @@ module CanTango
       class Key
         attr_reader :user, :subject
 
-        def initialize user, subject
+        def initialize user, subject = nil
           @user = user
-          @subject = subject
+          @subject = subject || user
+        end
+
+        def self.create_for ability
+          self.new ability.user, ability.subject
         end
 
         def value
-          raise "#{user.class} must have a method ##{user_key_field}. You can configure this with CanTango.config#user.unique_key_field" if !user.respond_to?(user_key_field)
-          @value ||= [user_key, subject_roles_hash].hash
+          raise "No key could be generated for #{user} and #{subject}" if hash_values.empty?
+          @value ||= hash_values.hash
         end
 
         def same? session
@@ -21,8 +25,13 @@ module CanTango
 
         protected
 
+        def hash_values
+          @hash_values ||= [user_key, subject_roles_hash].compact
+        end
+
         def user_key
-          user.send(user_key_field)
+          # raise "#{user.class} must have a method ##{user_key_field}. You can configure this with CanTango.config#user.unique_key_field" if !user.respond_to?(user_key_field)
+          user.send(user_key_field) if user.respond_to? user_key_field
         end
 
         def user_key_field
@@ -30,7 +39,14 @@ module CanTango
         end
 
         def subject_roles_hash
-          [subject.roles_list, subject.role_groups_list].hash
+          role_hash_values.empty? ? nil : role_hash_values.hash
+        end
+
+        def role_hash_values
+          @role_hash_values ||= [:roles_list, :role_groups_list].inject([]) do |result, meth|
+            result << subject.send(meth) if subject.respond_to? meth
+            result
+          end
         end
       end
     end

data/lib/cantango/configuration.rb

@@ -7,7 +7,7 @@ module CanTango
     autoload_modules :Models, :Engines, :Ability
     autoload_modules :User, :Guest, :UserAccount
     autoload_modules :Roles, :RoleGroups, :Registry, :RoleRegistry, :HashRegistry, :PermitRegistry, :Factory
-    autoload_modules :SpecialPermits, :Autoload, :Adapters, :Permits
+    autoload_modules :SpecialPermits, :Autoload, :Adapters, :Permits, :Debug
     autoload_modules :Users, :UserAccounts
 
     include Singleton
@@ -21,7 +21,7 @@ module CanTango
     def self.components
       [
         :guest, :autoload, :user, :user_account, :models, :roles, :role_groups,
-        :engines, :users, :user_accounts, :categories, :adapters, :permits
+        :engines, :users, :user_accounts, :categories, :adapters, :permits, :debug
       ]
     end
 

data/lib/cantango/configuration/adapters.rb

@@ -1,9 +1,9 @@
 module CanTango
   class Configuration
     class Adapters < Registry
-  
+
       include Singleton
-      
+
       def adapter name
         raise "Unknown adapter #{name}" if !available_adapters.include? name.to_sym
         require "cantango/adapter/#{name}"
@@ -16,7 +16,6 @@ module CanTango
       def available_adapters
         [:moneta, :compiler]
       end
-   
     end
   end
 end

data/lib/cantango/configuration/debug.rb

@@ -0,0 +1,25 @@
+module CanTango
+  class Configuration
+    # Note: This config feature is currently not used, but could potentially be of use in the future
+    class Debug
+      include Singleton
+
+      def set state = :on
+        raise ArgumentError, "Must be :on or :off" unless !state || [:on, :off].include?(state)
+        @state = state || :on
+      end
+
+      def on?
+        @state == :on
+      end
+
+      def off?
+        !on?
+      end
+    end
+  end
+end
+
+
+
+

data/lib/cantango/configuration/permits.rb

@@ -1,10 +1,9 @@
 module CanTango
-  class Configuration 
+  class Configuration
     class Permits < PermitRegistry
       include Singleton
 
       attr_reader :accounts
-      # CanTango.config.permits.accounts[:admin].role => {}
 
       def accounts
         @accounts ||= Hash.new
@@ -22,6 +21,50 @@ module CanTango
         registry = account_name ? self.send(account_name.to_sym) : self
         registry.send(permit_type)[permit_name] = permit_clazz
       end
+
+      def allowed candidate, actions, subjects, *extra_args
+        executed_for(candidate).inject([]) do |result, permit|
+          result << permit.class if permit.can? actions, subjects, *extra_args
+          result
+        end
+      end
+
+      def denied candidate, actions, subjects, *extra_args
+        executed_for(candidate).inject([]) do |result, permit|
+          result << permit.class if permit.cannot? actions, subjects, *extra_args
+          result
+        end
+      end
+
+      def was_executed permit, ability
+        executed_for(ability) << permit
+      end
+
+      def executed_for ability
+        executed[hash_key_for(ability)] ||= []
+      end
+
+      def executed
+        @executed ||= {}
+      end
+
+      def clear_executed!
+        @executed = nil
+      end
+
+      protected
+
+      def hash_key_for subject
+        key_for(subject).value
+      end
+
+      def key_for subject
+        subject.kind_of?(CanTango::Ability) ? key_maker.create_for(subject) : key_maker.new(subject)
+      end
+
+      def key_maker
+        CanTango::Ability::Cache::Key
+      end
     end
   end
 end

data/lib/cantango/configuration/registry.rb

@@ -4,7 +4,7 @@ require 'sugar-high/kind_of'
 module CanTango
   class Configuration
     class Registry
-      
+
       attr_writer   :default
       attr_accessor :registered
 

data/lib/cantango/engine.rb

@@ -7,7 +7,7 @@ module CanTango
     end
 
     def execute!
-      # raise NotImplementedError      
+      # raise NotImplementedError
     end
   end
 end

data/lib/cantango/permission_engine.rb

@@ -9,7 +9,6 @@ module CanTango
     end
 
     def execute!
-      puts "permissions"
       permissions.each do |permission|
         permission.evaluate! user
       end

data/lib/cantango/permit_engine.rb

@@ -8,7 +8,9 @@ module CanTango
     end
 
     def execute!
+      # CanTango.config.permits.clear_executed! # should there be an option clear before each execution?
       permits.each do |permit|
+        CanTango.config.permits.was_executed(permit, ability) if CanTango.config.debug.on?
         break if permit.execute == :break
       end
     end
@@ -17,7 +19,7 @@ module CanTango
     # has a role or a role group
     # also execute any permit marked as special
     def permits
-      permit_factory.build!
+      @permits ||= permit_factory.build!
     end
 
     def permit_class_names

data/lib/cantango/permits/permit.rb

@@ -30,12 +30,14 @@ module CanTango
       # executes the permit
       def execute
         executor.execute!
+        ability_sync!
       end
 
       def category label
         config.models.by_category label
       end
 
+
       def any reg_exp
         config.models.by_reg_exp reg_exp
       end
@@ -72,11 +74,16 @@ module CanTango
         ability.user_account
       end
 
-      def rules
-        ability.send :rules
+      def ability_rules
+        ability.send(:rules)
+      end
+
+      def ability_sync!
+        ability_rules << (rules - ability_rules)
+        ability_rules.flatten!
       end
 
-      # In a specific Role based Permit you can use 
+      # In a specific Role based Permit you can use
       #   def permit? user, options = {}
       #     return if !super(user, :in_role)
       #     ... permission logic follows
@@ -103,7 +110,7 @@ module CanTango
         end
       end
 
-      include CanTango::Rules
+      include CanTango::Rules # also makes a Permit a subclass of CanCan::Ability
 
       protected
 
@@ -117,7 +124,7 @@ module CanTango
         raise "License #{clazz} could not be enforced using #{self.inspect}"
       end
 
-      # This method will contain the actual rules 
+      # This method will contain the actual rules
       # can be implemented in the subclass
 
       def permit_rules

data/lib/cantango/rules.rb

@@ -3,21 +3,6 @@ module CanTango
     autoload_modules :Adaptor, :UserRelation, :Dsl, :Scope, :RuleClass
 
     include Dsl
-    include CanTango::Rules::RuleClass
-    # Examples:
-    #   can :read, Project
-    #   can [:read, :create], [Project, Post]
-    #   can :read, Project, :active => true, :user_id => user.id
-    def can(action, subject, conditions = nil, &block)
-      rules << rule_class.new(true, action, subject, conditions, block)
-    end
-
-    # Examples:
-    #   cannot :read, Project
-    #   cannot [:read, :create], [Project, Post]
-    #   cannot :read, Project, :active => true, :user_id => user.id    
-    def cannot(action, subject, conditions = nil, &block)
-      rules << rule_class.new(false, action, subject, conditions, block)
-    end 
+    include CanCan::Ability
   end
 end

data/spec/cantango/configuration/debug_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+class Menu
+end
+
+class WaiterRolePermit < CanTango::RolePermit
+  def initialize ability
+    super
+  end
+
+  protected
+
+  def permit_rules
+    can :read, Menu
+    cannot :write, Menu
+  end
+end
+
+class ChefRolePermit < CanTango::RolePermit
+  def initialize ability
+    super
+  end
+
+  protected
+
+  def permit_rules
+    can :publish, Menu
+    can :write, Menu
+  end
+end
+
+class Context
+  include CanTango::Api::User::Ability
+end
+
+# Note: This config feature is currently not used, but could potentially be of use in the future
+describe CanTango::Configuration::Debug do
+  let(:context) { Context.new }
+  subject       { CanTango.config.debug }
+
+  describe 'should set debug mode :on' do
+    before do
+      subject.set :on
+    end
+
+    its(:on?) { should be_true }
+    its(:off?) { should be_false }
+  end
+
+  describe 'should set debug mode :off' do
+    before do
+      subject.set :on
+    end
+
+    its(:on?)   { should be_true  }
+    its(:off?)  { should be_false }
+  end
+
+  describe 'debug! should set debug mode :on' do
+    before do
+      CanTango.debug!
+    end
+
+    its(:on?) { should be_true }
+    its(:off?) { should be_false }
+  end
+end
+

data/spec/cantango/configuration/permits_spec.rb

@@ -1,5 +1,38 @@
 require 'spec_helper'
 
+class Menu
+end
+
+class WaiterRolePermit < CanTango::RolePermit
+  def initialize ability
+    super
+  end
+
+  protected
+
+  def permit_rules
+    can :read, Menu
+    cannot :write, Menu
+  end
+end
+
+class ChefRolePermit < CanTango::RolePermit
+  def initialize ability
+    super
+  end
+
+  protected
+
+  def permit_rules
+    can :publish, Menu
+    can :write, Menu
+  end
+end
+
+class Context
+  include CanTango::Api::User::Ability
+end
+
 describe CanTango::Configuration::Permits do
   before do
     @permit_registry = CanTango::Configuration::Permits.instance
@@ -22,4 +55,31 @@ describe CanTango::Configuration::Permits do
       end
     end
   end
+
+  describe 'debugging permits' do
+    let(:context) { Context.new }
+    let (:user) do
+      User.new 'kris', 'kris@gmail.com', :role => :waiter
+    end
+
+    before do
+      CanTango.config.debug.set :on
+      context.user_ability(user).can? :read, Menu
+    end
+
+    describe 'should tell which permits allowe :read' do
+      it 'should show WaiterRolePermit as the permit that allowed :read of Menu' do
+        CanTango.permits_allowed(user, :read, Menu).should include(WaiterRolePermit)
+      end
+    end
+
+    describe 'should tell which permits denied :write' do
+      it 'should show WaiterRolePermit as the permit that denied :write of Menu' do
+        CanTango.permits_denied(user, :write, Menu).should include(WaiterRolePermit)
+      end
+    end
+  end
 end
+
+
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cantango
 version: !ruby/object:Gem::Version
-  version: 0.8.5.1
+  version: 0.8.6
   prerelease: 
 platform: ruby
 authors:
@@ -10,11 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-02 00:00:00.000000000Z
+date: 2011-09-16 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &2158261060 !ruby/object:Gem::Requirement
+  requirement: &2158759980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: 3.0.1
   type: :runtime
   prerelease: false
-  version_requirements: *2158261060
+  version_requirements: *2158759980
 - !ruby/object:Gem::Dependency
   name: cancan
-  requirement: &2158260560 !ruby/object:Gem::Requirement
+  requirement: &2158759180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -33,10 +33,10 @@ dependencies:
         version: '1.4'
   type: :runtime
   prerelease: false
-  version_requirements: *2158260560
+  version_requirements: *2158759180
 - !ruby/object:Gem::Dependency
   name: sugar-high
-  requirement: &2158260080 !ruby/object:Gem::Requirement
+  requirement: &2158752840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -44,10 +44,10 @@ dependencies:
         version: 0.6.0
   type: :runtime
   prerelease: false
-  version_requirements: *2158260080
+  version_requirements: *2158752840
 - !ruby/object:Gem::Dependency
   name: sweetloader
-  requirement: &2158259560 !ruby/object:Gem::Requirement
+  requirement: &2158751900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -55,10 +55,10 @@ dependencies:
         version: 0.1.0
   type: :runtime
   prerelease: false
-  version_requirements: *2158259560
+  version_requirements: *2158751900
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &2158259060 !ruby/object:Gem::Requirement
+  requirement: &2158749860 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -66,10 +66,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2158259060
+  version_requirements: *2158749860
 - !ruby/object:Gem::Dependency
   name: hashie
-  requirement: &2158258580 !ruby/object:Gem::Requirement
+  requirement: &2158748240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -77,10 +77,32 @@ dependencies:
         version: '0.4'
   type: :runtime
   prerelease: false
-  version_requirements: *2158258580
+  version_requirements: *2158748240
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: &2158734040 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.1
+  type: :development
+  prerelease: false
+  version_requirements: *2158734040
+- !ruby/object:Gem::Dependency
+  name: forgery
+  requirement: &2158732460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: *2158732460
 - !ruby/object:Gem::Dependency
   name: factory_girl
-  requirement: &2158258080 !ruby/object:Gem::Requirement
+  requirement: &2158729700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -88,10 +110,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2158258080
+  version_requirements: *2158729700
 - !ruby/object:Gem::Dependency
   name: sourcify
-  requirement: &2158257580 !ruby/object:Gem::Requirement
+  requirement: &2158728640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -99,10 +121,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2158257580
+  version_requirements: *2158728640
 - !ruby/object:Gem::Dependency
   name: dkastner-moneta
-  requirement: &2158257080 !ruby/object:Gem::Requirement
+  requirement: &2158727540 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -110,10 +132,10 @@ dependencies:
         version: '1.0'
   type: :development
   prerelease: false
-  version_requirements: *2158257080
+  version_requirements: *2158727540
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2158256600 !ruby/object:Gem::Requirement
+  requirement: &2158726640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -121,10 +143,10 @@ dependencies:
         version: 2.4.0
   type: :development
   prerelease: false
-  version_requirements: *2158256600
+  version_requirements: *2158726640
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &2158256100 !ruby/object:Gem::Requirement
+  requirement: &2158725840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -132,10 +154,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *2158256100
+  version_requirements: *2158725840
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2158255580 !ruby/object:Gem::Requirement
+  requirement: &2158724960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -143,10 +165,10 @@ dependencies:
         version: 1.0.1
   type: :development
   prerelease: false
-  version_requirements: *2158255580
+  version_requirements: *2158724960
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &2158255080 !ruby/object:Gem::Requirement
+  requirement: &2158724140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -154,7 +176,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2158255080
+  version_requirements: *2158724140
 description: ! 'Define your permission rules as role- or role group specific permits.
 
   Integrates well with multiple Devise user acounts.
@@ -220,6 +242,7 @@ files:
 - lib/cantango/configuration/adapters.rb
 - lib/cantango/configuration/autoload.rb
 - lib/cantango/configuration/categories.rb
+- lib/cantango/configuration/debug.rb
 - lib/cantango/configuration/engines.rb
 - lib/cantango/configuration/engines/cache.rb
 - lib/cantango/configuration/engines/engine.rb
@@ -423,7 +446,6 @@ files:
 - spec/active_record/scenarios/user_accounts/permits/user_account_permit.rb
 - spec/active_record/scenarios/user_accounts/user_account_spec.rb
 - spec/active_record/spec_helper.rb
-- spec/cantango/README.textile
 - spec/cantango/ability/cache/key_spec.rb
 - spec/cantango/ability/cache/kompiler_spec.rb
 - spec/cantango/ability/cache/reader_compile_spec.rb
@@ -449,6 +471,7 @@ files:
 - spec/cantango/configuration/adapter_spec.rb
 - spec/cantango/configuration/autoload_spec.rb
 - spec/cantango/configuration/categories_spec.rb
+- spec/cantango/configuration/debug_spec.rb
 - spec/cantango/configuration/engines/cache_spec.rb
 - spec/cantango/configuration/engines/engine_shared.rb
 - spec/cantango/configuration/engines/permission_spec.rb
@@ -797,7 +820,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2626615460253562025
+      hash: -2544503821884776922
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -806,7 +829,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.8
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: CanCan extension with role oriented permission management and more

data/spec/cantango/README.textile

@@ -1,3 +0,0 @@
-h1. README
-
-This folder is for creating specs to test the internals of CanTango.