walruz 0.0.8 → 0.0.9

data/CHANGELOG

@@ -1,15 +1,26 @@
+* 0.0.9 (Aug 24, 2009) Policies deserve some love too
+* Renamed the Walruz::Manager.check_authorization to
+Walruz::Manager.check_action_authorization
+* Added a new method Walruz::Manager.check_policy_authorization to be used on
+the 'satisfies' methods.
+* Moved the Walruz::Manager::QueryAuthorization extension from Walruz::Manager class
+to Walruz main module
+* Added a Walruz.version method that tells which version of Walruz you are
+using
+
+
 * 0.0.8 (Aug 21, 2009) The anonymous who
-* New class <tt>Walruz::Manager</tt> will handle all the authorization
+* New class Walruz::Manager will handle all the authorization
 invocation that was in Walruz::Actor and Walruz::Subject before
-* New module <tt>Walruz::Memoize</tt> that provides memoization methods to
-cache the result of the <tt>can?</tt>, <tt>authorize</tt>, <tt>satisfies?</tt>
-and <tt>satisfies</tt> methods in the Actor model
+* New module Walruz::Memoize that provides memoization methods to
+cache the result of the can?, authorize, satisfies?
+and satisfies methods in the Actor model
 * Added the Walruz::Policy#halt method to stop execution of policies
 authorizations (even if they are in a composite policy), and return false with
-an error message.
+an error message (given on the halt invocation).
 
 * 0.0.7 (July 23, 2009)
-* New +Array#only_authorized_for+ method for filtering arrays of _subjects_
-* Added the +satisfy+ on the +Walruz::Actor+ module
+* New Array#only_authorized_for method for filtering arrays of subjects
+* Added the satisfy on the Walruz::Actor module
 * Changed documentation from rDoc to YARD
 * Documented all the modules of the gem

data/Rakefile

@@ -16,7 +16,7 @@ begin
   end
   
   Jeweler::RubyforgeTasks.new do |rubyforge|
-    rubyforge.doc_task = "yard"
+    rubyforge.doc_task = "yardoc"
   end
   
 rescue LoadError
@@ -39,6 +39,12 @@ end
 
 task :default => :spec
 
+require 'yard'
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+end
+
+
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
   if File.exist?('VERSION.yml')

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 0
-:patch: 8
+:patch: 9

data/lib/walruz/manager.rb

@@ -9,11 +9,11 @@ module Walruz
     module AuthorizationQuery
 
       def can?(actor, action, subject)
-        Walruz::Manager.check_authorization(actor, action, subject)[0]
+        Walruz::Manager.check_action_authorization(actor, action, subject)[0]
       end
 
       def authorize!(actor, action, subject)
-        result = Walruz::Manager.check_authorization(actor, action, subject)
+        result = Walruz::Manager.check_action_authorization(actor, action, subject)
         if result[0]
           result[1]
         else
@@ -24,29 +24,22 @@ module Walruz
       end
 
       def authorize(actor, action, subject)
-        result = Walruz::Manager.check_authorization(actor, action, subject)
+        result = Walruz::Manager.check_action_authorization(actor, action, subject)
         result[0] ? result[1] : nil
       end
 
       def satisfies?(actor, policy_label, subject)
-        policy_clz = Walruz.fetch_policy(policy_label)
-        result     = policy_clz.return_policy.new.safe_authorized?(actor, subject)
+        result = Walruz::Manager.check_policy_authorization(actor, policy_label, subject)
         result[0]
       end
 
       def satisfies(actor, policy_label, subject)
-        policy_clz = Walruz.fetch_policy(policy_label)
-        result     = policy_clz.return_policy.new.safe_authorized?(actor, subject)
+        result = Walruz::Manager.check_policy_authorization(actor, policy_label, subject)
         result[0] ? result[1] : nil
       end
 
     end
 
-    extend AuthorizationQuery
-    class << self
-      include Memoization
-      walruz_memoize :can?, :authorize, :satisfies?, :satisfies
-    end
 
     #
     # core method used on all the actor methods:
@@ -54,8 +47,8 @@ module Walruz
     # authorize!
     # authorize
     # :private:
-    def self.check_authorization(actor, action, subject)
-      check_authorization_action_is_declared_on_subject(subject, action)
+    def self.check_action_authorization(actor, action, subject)
+      check_action_authorization_is_declared_on_subject(subject, action)
       action = if subject.class._walruz_policies.key?(:default)
                 subject.class._walruz_policies.key?(action) ? action : :default
               else
@@ -73,14 +66,27 @@ module Walruz
                               new.
                               safe_authorized?(actor, subject)
       rescue PolicyHalted => e
-        result = [false, {:error_message => e.message}]
+        result = [false, {:error_message => e.message }]
       end
+
       result
     end
 
+    def self.check_policy_authorization(actor, policy_label, subject)
+      policy_clz = Walruz.fetch_policy(policy_label)
+      
+      begin
+        result = policy_clz.return_policy.new.safe_authorized?(actor, subject)
+      rescue PolicyHalted => e
+        result = [false, { :error_message => e.message }]
+      end
+
+      result 
+    end
+
     private
 
-    def self.check_authorization_action_is_declared_on_subject(subject, action) 
+    def self.check_action_authorization_is_declared_on_subject(subject, action) 
       if subject.class._walruz_policies.nil?
         message =<<-BEGIN
 You need to invoke `check_authorizations :#{action} => Policies::SomePolicy` on the #{subject.class.name} class

data/lib/walruz.rb

@@ -48,6 +48,12 @@ module Walruz
   autoload :Utils,   base_path + '/walruz/utils'
   
 
+  def self.version
+    require "yaml"
+    version = YAML.load_file(File.dirname(__FILE__) + "/../VERSION.yml") 
+    "%s.%s.%s" % [version[:major], version[:minor], version[:patch]]
+  end
+
   def self.setup
     config = Config.new
     yield config
@@ -89,6 +95,14 @@ module Walruz
     end
     
   end
+
+  # including the Walruz::Manager::AuthorizationQuery methods
+  
+  extend Manager::AuthorizationQuery
+  class << self
+    include Memoization
+    walruz_memoize :can?, :authorize, :satisfies?, :satisfies
+  end
   
 end
 

data/spec/walruz/actor_spec.rb

@@ -68,16 +68,16 @@ describe 'Walruz::Actor' do
   describe '#can?' do
     
     it "should be invoked only the first time and then return a cached solution" do
-      Walruz::Manager.should_receive(:check_authorization).once.and_return([true, {}])
+      Walruz::Manager.should_receive(:check_action_authorization).once.and_return([true, {}])
       Beatle::JOHN.can?(:sing, Song::YELLOW_SUBMARINE, :reload)
       Beatle::JOHN.can?(:sing, Song::YELLOW_SUBMARINE)
     end
     
     it "if a :reload symbol is passed as the third parameter it should not use the cached result" do
-      Walruz::Manager.stub!(:check_authorization).and_return([true, {}])
+      Walruz::Manager.stub!(:check_action_authorization).and_return([true, {}])
       Beatle::JOHN.can?(:sing, Song::ALL_YOU_NEED_IS_LOVE).should be_true
       
-      Walruz::Manager.stub!(:check_authorization).and_return([false, {}])
+      Walruz::Manager.stub!(:check_action_authorization).and_return([false, {}])
       Beatle::JOHN.can?(:sing, Song::ALL_YOU_NEED_IS_LOVE).should be_true
       Beatle::JOHN.can?(:sing, Song::ALL_YOU_NEED_IS_LOVE, :reload).should be_false
     end

data/spec/walruz/manager_spec.rb

@@ -5,7 +5,7 @@ describe Walruz::Manager do
   describe "#check_authorization" do 
 
     it "should invoke the policies associated to an action on a subject performed by an actor" do
-      result = Walruz::Manager.check_authorization(Beatle::JOHN, :sing, Song::ALL_YOU_NEED_IS_LOVE)
+      result = Walruz::Manager.check_action_authorization(Beatle::JOHN, :sing, Song::ALL_YOU_NEED_IS_LOVE)
       result[0].should be_true
     end
 
@@ -13,7 +13,7 @@ describe Walruz::Manager do
 
       it "should raise an Walruz::AuthorizationActionsNotDefined error" do
         lambda do
-          Walruz::Manager.check_authorization(Beatle::JOHN, :talk_with, Beatle::PAUL)
+          Walruz::Manager.check_action_authorization(Beatle::JOHN, :talk_with, Beatle::PAUL)
         end.should raise_error(Walruz::AuthorizationActionsNotDefined)
       end
 

data/spec/walruz/walruz_spec.rb

@@ -6,7 +6,7 @@ describe Walruz do
     Walruz.should respond_to(:policies)
   end
   
-  describe '#policies' do
+  describe '.policies' do
     
     it "should return all the policies created that have a label" do
       Walruz.policies.should_not be_nil
@@ -17,7 +17,7 @@ describe Walruz do
     
   end
   
-  describe "#fetch_policy" do
+  describe ".fetch_policy" do
     
     it "should grab the policy if this is registered" do
       Walruz.fetch_policy(:in_colaboration).should == AuthorInColaborationPolicy
@@ -31,4 +31,13 @@ describe Walruz do
     
   end
 
-end
+  describe ".version" do
+
+    it "should return a string representing the current version" do
+      version = YAML.load_file(File.dirname(__FILE__) + "/../../VERSION.yml")
+      Walruz.version.should == "#{version[:major]}.#{version[:minor]}.#{version[:patch]}"
+    end
+
+  end
+
+end

data/walruz.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{walruz}
-  s.version = "0.0.8"
+  s.version = "0.0.9"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Roman Gonzalez"]
-  s.date = %q{2009-08-21}
+  s.date = %q{2009-08-24}
   s.email = %q{roman@noomi.com}
   s.extra_rdoc_files = [
     "LICENSE",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: walruz
 version: !ruby/object:Gem::Version 
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors: 
 - Roman Gonzalez
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-08-21 00:00:00 -07:00
+date: 2009-08-24 00:00:00 -07:00
 default_executable: 
 dependencies: []