contextually 0.0.1 → 0.1

data/README.rdoc

@@ -6,17 +6,79 @@
 
 Contextually is a gem for running Rails controller tests under different user contexts in a convenient way. So you can test your authorization without much effort.
 
-== Features/Problems:
+== Synopsis:
 
-* FIX (list of features or problems)
+Somewhere sensible (like your spec helper file), define your contexts like this:
 
-== Synopsis:
+    Contextually.define do
+      roles :user, :visitor, :monkey
 
-  FIX (code sample of usage)
+      group :user, :monkey, :as => :member
+      group :visitor, :monkey, :as => :idiot
 
-== Install:
+      before :user do
+        controller.stub!(:current_user).and_return(:user)
+      end
+      before :visitor do
+        controller.stub!(:current_user).and_return(nil)
+      end
+      before :monkey do
+        controller.stub!(:current_user).and_return(:monkey)
+      end
+
+      deny_access_to :visitor do
+        it("should deny access") { should redirect_to(new_session_url) }
+      end
+      deny_access do
+        it("should deny access") { should redirect_to(root_url) }
+      end
+    end
+
+Then use them in your controller specs like this:
+
+    describe TestsController do
+      as :user, :get => :index do
+        it { should respond_with(:success) }
+      end
+
+      as :visitor, :get => :index do
+        it("should deny access") { should redirect_to(new_session_url) }
+      end
+
+      as :visitor, :monkey, :user, :get => :show do
+        it { should respond_with(:success) }
+      end
+  
+      as :visitor, :monkey, :user, "GET /test" do
+        describe :get => :show do
+          it { should respond_with(:success) }
+        end
+      end
+
+      as :visitor, :monkey, :user do
+        describe :get => :show do
+          it { should respond_with(:success) }
+        end
+      end
 
+      only_as :user, :get => :index do
+        it { should respond_with(:success) }
+      end
   
+      deny_access_to :monkey, :visitor, :get => :index
+
+      deny_access_to :idiot, :get => :index
+
+      only_as :member, :get => :foo do
+        it { should respond_with(:success) }
+      end
+    end
+
+== Install:
+
+Contextually is hosted on Gemcutter.org only. Add this to your Rails test environment:
+
+    config.gem "contextually"
 
 == License:
 

data/lib/contextually.rb

@@ -1,8 +1,8 @@
 module Contextually
-  VERSION = '0.0.1'
+  VERSION = '0.1'
   
   class UndefinedContext < StandardError; end
 end
 
 require 'contextually/example_extension'
-require 'contextually/definition'
+require 'contextually/definition'

data/lib/contextually/definition.rb

@@ -18,6 +18,10 @@ module Contextually
     def before(name, &block)
       Contextually.roles[name].before = block
     end
+
+    def before_all(&block)
+      Contextually.before_all = block
+    end
   
     def deny_access_to(name, &block)
       Contextually.roles[name].deny_access = block
@@ -29,7 +33,7 @@ module Contextually
   end
   
   class << self
-    attr_accessor :roles, :deny_access_to_all
+    attr_accessor :roles, :deny_access_to_all, :before_all
     
     def groups
       @groups ||= {}
@@ -54,4 +58,4 @@ module Contextually
       Contextually::Definition.define(&block)
     end
   end
-end
+end

data/lib/contextually/example_extension.rb

@@ -2,16 +2,14 @@ module Contextually
   module ExampleExtension
     def only_as(*args, &block)
       as(*args, &block)
-      roles, params = extract_params(args)
-      deny_params = Contextually.roles.keys - roles
-      deny_params.push(params)
-      deny_access_to(*deny_params)
+      only_allow_access_to(*args)
     end
   
     def as(*args, &block)
       roles, params = extract_params(args)
       roles.each do |role|
         context "as #{role}" do
+          before(&Contextually.before_all) if Contextually.before_all
           before(&Contextually.before(role))
           describe(params.dup, &block)
         end
@@ -24,6 +22,7 @@ module Contextually
         block = Contextually.deny_access(role)
         if block
           context "as #{role}" do
+            before(&Contextually.before_all) if Contextually.before_all
             before(&Contextually.before(role))
             describe(params.dup, &block)
           end
@@ -32,6 +31,13 @@ module Contextually
         end
       end
     end
+
+    def only_allow_access_to(*args)
+      roles, params = extract_params(args)
+      deny_params = Contextually.roles.keys - roles
+      deny_params.push(params)
+      deny_access_to(*deny_params)
+    end
   
   private
 
@@ -48,4 +54,4 @@ module Contextually
   end
 end
 
-Spec::Rails::Example::ControllerExampleGroup.send(:extend, Contextually::ExampleExtension) if defined?(Spec)
+Spec::Rails::Example::ControllerExampleGroup.send(:extend, Contextually::ExampleExtension) if defined?(Spec)

data/spec/contextually_spec.rb

@@ -6,6 +6,10 @@ Contextually.define do
   group :user, :monkey, :as => :member
   group :visitor, :monkey, :as => :idiot
 
+  before_all do
+    controller.stub!(:global_before).and_return(true)
+  end
+
   before :user do
     controller.stub!(:current_user).and_return(:user)
   end
@@ -34,6 +38,7 @@ end
 
 class TestsController < ApplicationController
   def index
+    raise "global before not run" unless global_before
     if not current_user
       redirect_to new_session_url
     elsif not current_user == :user
@@ -98,5 +103,9 @@ describe TestsController, :type => :controller do
       it { should respond_with(:success) }
     end
   end
+
+  context "with only_allow_access_to" do
+    only_allow_access_to :user, :get => :index
+  end
 end
 

data/spec/spec_spec.rb

@@ -73,4 +73,10 @@ TestsController with groups as monkey responding to #GET foo
 - should respond with success
 
 TestsController with groups as visitor responding to #GET foo
-- should deny access
+- should deny access
+
+TestsController with only_allow_access_to as visitor responding to #GET index
+- should deny access
+
+TestsController with only_allow_access_to as monkey responding to #GET index
+- should deny access

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: contextually
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: "0.1"
 platform: ruby
 authors: 
 - Jonas Nicklas
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-16 00:00:00 +02:00
+date: 2009-10-18 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency