allowy 0.1.2 → 0.1.3

data/README.md

@@ -31,7 +31,7 @@ So I decided to put up allowy to solve those issue for me.
 Add it to your Rails application's `Gemfile`:
 
 ```ruby
-gem 'alowy'
+gem 'allowy'
 ```
 
 Then `bundle install`.
@@ -93,7 +93,7 @@ If you want to change the context in Rails then just override it in the controll
 ```ruby
 class PagesController < ApplicationController
   def allowy_context
-    {realy: 'anything', can_be: 'here', event: params}
+    {realy: 'anything', can_be: 'here', even: params}
   end
 end
 ```
@@ -217,8 +217,28 @@ describe PagesController do
     post(:create).should be_success
   end
 end
+
+```
+
+But if you don't want to stub the context because you access its `can?`, `cannot?` or `authorize!` methods
+(allwing permission delegation) then you can simply mix the `Allowy::Context` in:
+
+```ruby
+class ControllerLikeContext
+  include Alllowy::Context
+  attr_accessor :current_user
+
+  def initialize(user)
+    @current_user = user
+  end
+end
+
+# Then you can simply instantiate it to check the permissions:
+ControllerLikeContext.new(that_user).should be_able_to :edit, Blog
+ControllerLikeContext.new(this_user).should_not be_able_to :edit, Blog
 ```
 
+
 # Development
 
 

data/lib/allowy.rb

@@ -4,6 +4,7 @@ require 'active_support/inflector'
 require "allowy/version"
 require "allowy/access_control"
 require "allowy/registry"
+require "allowy/context"
 require "allowy/controller_extensions"
 
 module Allowy

data/lib/allowy/context.rb

@@ -0,0 +1,48 @@
+module Allowy
+
+  # This module provides the default and common context to for checking the permissions.
+  # It is mixed into the Controller in Rails by default and provides an wasy way to reuse it
+  # in other parts of the application (in RSpec or Cucumber) without needint a controller.
+  # For example, you can use this code in your Cucumber features:
+  #
+  #   @example
+  #   class CustomContext
+  #     include Allowy::Context
+  #     attr_accessor :current_user
+  #
+  #     def initialize(user)
+  #       @current_user = user
+  #     end
+  #
+  # And the you can easily check the permissions simply using something like:
+  #
+  #   @example
+  #   CustomContext.new(that_user).should be_able_to :create, Blog
+  module Context
+    extend ActiveSupport::Concern
+
+    module InstanceMethods
+
+      def allowy_context
+        self
+      end
+
+      def current_allowy
+        @current_allowy ||= ::Allowy::Registry.new(allowy_context)
+      end
+
+      def can?(action, subject, *args)
+        current_allowy.access_control_for!(subject).can?(action, subject, *args)
+      end
+
+      def cannot?(*args)
+        current_allowy.access_control_for!(subject).cannot?(action, subject, *args)
+      end
+
+      def authorize!(action, subject, *args)
+        current_allowy.access_control_for!(subject).authorize!(action, subject, *args)
+      end
+    end
+  end
+
+end

data/lib/allowy/controller_extensions.rb

@@ -3,32 +3,9 @@ module Allowy
   module ControllerExtensions
     extend ActiveSupport::Concern
     included do
+      include ::Allowy::Context
       helper_method :can?, :cannot?
     end
-
-    module InstanceMethods
-
-      def allowy_context
-        self
-      end
-
-      def current_allowy
-        @current_allowy ||= ::Allowy::Registry.new(allowy_context)
-      end
-
-      def can?(action, subject, *args)
-        current_allowy.access_control_for!(subject).can?(action, subject, *args)
-      end
-
-      def cannot?(*args)
-        current_allowy.access_control_for!(subject).cannot?(action, subject, *args)
-      end
-
-      def authorize!(action, subject, *args)
-        current_allowy.access_control_for!(subject).authorize!(action, subject, *args)
-      end
-    end
-
   end
 end
 

data/lib/allowy/version.rb

@@ -1,3 +1,3 @@
 module Allowy
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/spec/context_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+module Allowy
+  module Context
+    extend ActiveSupport::Concern
+
+    module InstanceMethods
+
+      def allowy_context
+        self
+      end
+
+      def current_allowy
+        @current_allowy ||= ::Allowy::Registry.new(allowy_context)
+      end
+
+      def can?(action, subject, *args)
+        current_allowy.access_control_for!(subject).can?(action, subject, *args)
+      end
+
+      def cannot?(*args)
+        current_allowy.access_control_for!(subject).cannot?(action, subject, *args)
+      end
+
+      def authorize!(action, subject, *args)
+        current_allowy.access_control_for!(subject).authorize!(action, subject, *args)
+      end
+    end
+  end
+
+  class SampleContext
+    include Context
+  end
+
+  describe Context do
+
+    subject { SampleContext.new }
+    let(:access) { stub }
+
+    it "should create a registry" do
+      Registry.should_receive(:new).with(subject)
+      subject.current_allowy
+    end
+
+    it "should be able to check using can?" do
+      subject.current_allowy.should_receive(:access_control_for!).with(123).and_return access
+      access.should_receive(:can?).with(:edit, 123)
+      subject.can?(:edit, 123)
+    end
+
+    it "should call authorize!" do
+      access.should_receive(:authorize!).with :edit, 123
+      subject.current_allowy.stub(:access_control_for! => access)
+      subject.authorize! :edit, 123
+    end
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: allowy
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-18 00:00:00.000000000 Z
+date: 2012-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &70180722742160 !ruby/object:Gem::Requirement
+  requirement: &70143292970420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70180722742160
+  version_requirements: *70143292970420
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70180722741040 !ruby/object:Gem::Requirement
+  requirement: &70143292969800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70180722741040
+  version_requirements: *70143292969800
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70180722740180 !ruby/object:Gem::Requirement
+  requirement: &70143292969140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70180722740180
+  version_requirements: *70143292969140
 - !ruby/object:Gem::Dependency
   name: pry
-  requirement: &70180722739280 !ruby/object:Gem::Requirement
+  requirement: &70143292968580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70180722739280
+  version_requirements: *70143292968580
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &70180722738300 !ruby/object:Gem::Requirement
+  requirement: &70143292967960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70180722738300
+  version_requirements: *70143292967960
 - !ruby/object:Gem::Dependency
   name: guard-rspec
-  requirement: &70180722737260 !ruby/object:Gem::Requirement
+  requirement: &70143292967200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +76,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70180722737260
+  version_requirements: *70143292967200
 description: Allowy provides CanCan-like way of checking permission but doesn't enforce
   a tight DSL giving you more control
 email:
@@ -94,12 +94,14 @@ files:
 - allowy.gemspec
 - lib/allowy.rb
 - lib/allowy/access_control.rb
+- lib/allowy/context.rb
 - lib/allowy/controller_extensions.rb
 - lib/allowy/matchers.rb
 - lib/allowy/registry.rb
 - lib/allowy/rspec.rb
 - lib/allowy/version.rb
 - spec/access_control_spec.rb
+- spec/context_spec.rb
 - spec/registry_spec.rb
 - spec/spec_helper.rb
 homepage: ''
@@ -128,6 +130,7 @@ specification_version: 3
 summary: Authorization with simplicity and explicitness in mind
 test_files:
 - spec/access_control_spec.rb
+- spec/context_spec.rb
 - spec/registry_spec.rb
 - spec/spec_helper.rb
 has_rdoc: