six 0.1.1 → 0.2.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7b040bab565e465f27226c607722a50a933afdd8063ff7adb199651357cf7e2e
+  data.tar.gz: 04d532eff125a67d1cbc0120c1ed8dd3d526ddc152fcd98defa4f314a6f3ba06
+SHA512:
+  metadata.gz: 63340b25f2f0c0bd751a6de758c77a6858526431706c6d57de02906f6a31ca0da0290eb1940b7590a0cbd5225cfe012bbf1db29078a521de39f250e0f9b749a6
+  data.tar.gz: 5c83df574dd1e722bcdd6dc0ac4054a60af5cfe0fedcc5aa9e6777c2a2cdf7796da7f992546abd79cdabeb065f95e943a0ab98220cef0e79cbe6c1542cb13a14

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Dmitriy Zaporozhets
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/lib/six.rb

@@ -11,64 +11,96 @@ class Six
     end
   end
 
+  class InitializeArgumentError < StandardError
+    def message
+      "Six.new require hash as pack argument in format {:name_of_pack => PackRules.new}"
+    end
+  end
+
   attr_reader :rules_packs
   attr_reader :current_rule_pack
 
-  def initialize()
+  # Initialize ability object
+  #
+  # == Parameters:
+  # packs::
+  #   A Hash or rules to add with initializtion
+  #
+  # == Returns:
+  # self
+  #
+  def initialize(packs={})
+    raise InitializeArgumentError.new unless packs.kind_of?(Hash)
+
     @rules_packs = {}
     @current_rule_pack = nil
+
+    packs.each { |key, pack| add_pack!(key, pack) }
   end
 
-  # Set current pack from stored packs by key 
-  # 
+  # Set current pack from stored packs by key
+  #
   # == Parameters:
   # name::
-  #   A Symbol declaring the key name of stored pack 
-  # 
+  #   A Symbol declaring the key name of stored pack
+  #
   # == Returns:
-  # self or false 
-  # 
-  def use(name)
+  # self or false
+  #
+  def use_pack(name)
     if pack_exist?(name)
       @current_rule_pack = name.to_sym
       self
     end
   end
 
-  # Same as use but raise exception if no pack found 
-  def use!(name)
-    use(name) ? self : raise_no_such_pack
+  # Same as use but raise exception if no pack found
+  def use_pack!(name)
+    use_pack(name) ? self : raise_no_such_pack
   end
 
-  # Add pack to authorization class 
-  # 
+  # Add pack to authorization class
+  #
   # == Parameters:
   # name::
-  #   A Symbol declaring the key name of stored pack 
+  #   A Symbol declaring the key name of stored pack
   # pack::
-  #   Any kind of object responding to allowed method 
-  # 
+  #   Any kind of object responding to allowed method
+  #
   # == Returns:
-  # true or false 
-  # 
+  # true or false
+  #
   def add_pack(name, pack)
     rules_packs[name.to_sym] = pack if valid_rules_object?(pack)
   end
 
-  # Same as add_pack but raise exception if pack is invalid 
+  # Same as add_pack but raise exception if pack is invalid
   def add_pack!(name, pack)
     add_pack(name, pack) || raise_incorrect_pack_object
   end
 
-  # Remove pack from authorization class 
-  # 
+  # Add pack to authorization class w/o key
+  #
+  # == Parameters:
+  # pack::
+  #   Any kind of object responding to allowed method
+  #
+  # == Returns:
+  # true or raise exception
+  #
+  def <<(pack)
+    add_pack!(pack.object_id.to_s, pack)
+  end
+
+  # Remove pack from authorization class
+  #
   # == Parameters:
   # name::
-  #   A Symbol declaring the key name of stored pack 
-  # 
+  #   A Symbol declaring the key name of stored pack
+  #
   # == Returns:
-  # true or false 
-  # 
+  # true or false
+  #
   def remove_pack(name)
     if pack_exist?(name)
       @current_rule_pack = nil if rules_packs[name.to_sym] == @current_rule_pack
@@ -81,61 +113,61 @@ class Six
     remove_pack(name) || raise_no_such_pack
   end
 
-  # Check if object for rule pack is valid 
-  # 
+  # Check if object for rule pack is valid
+  #
   # == Parameters:
   # pack::
-  #   Any kind of object responding to allowed method 
-  # 
+  #   Any kind of object responding to allowed method
+  #
   # == Returns:
-  # true or false 
-  # 
+  # true or false
+  #
   def valid_rules_object?(object)
-    object.respond_to?(:allowed) &&
-      object.send(:allowed, nil, nil).kind_of?(Array)
-  rescue 
-    false
+    object.respond_to?(:allowed)
   end
 
-  # Check if authorization class has pack with such name 
-  # 
+  # Check if authorization class has pack with such name
+  #
   # == Parameters:
   # name::
-  #   A Symbol declaring the key name of stored pack 
-  # 
+  #   A Symbol declaring the key name of stored pack
+  #
   # == Returns:
-  # true or false 
-  # 
+  # true or false
+  #
   def pack_exist?(name)
     rules_packs.has_key?(name.to_sym)
   end
 
   # Check if authorization class allow access for object to subject
-  # using selected pack or all stored. 
-  # Basically this method 
+  # using selected pack or all stored.
+  # Basically this method
   # 1. send :allowed for every stored object in packs and pass object & subject
   # 2. check if any of results include allowed action
-  # 
+  #
   # == Parameters:
   # action::
-  #   Action name to check for access 
+  #   Action name to check for access
   # object::
-  #   object trying to access resource 
+  #   object trying to access resource
   # subject::
   #   resource
-  # 
+  #
   # == Returns:
-  # true or false 
-  # 
-  def allowed?(action, object, subject)
-    if current_rule_pack
-      rules_packs[current_rule_pack].allowed(object, subject).include?(action)
-    else 
-      rules_packs.values.map { |rp| rp.allowed(object, subject) }.flatten.include?(action)
+  # true or false
+  #
+  def allowed?(object, actions, subject)
+    # if multiple actions passed
+    # check all actions to be allowed
+    if actions.respond_to?(:each)
+      actions.all? { |action| action_included?(object, action, subject) }
+    else
+      # single action check
+      action_included?(object, actions, subject)
     end
   end
 
-  # Reset current used rule pack so auth class use 
+  # Reset current used rule pack so auth class use
   # global allowed? for new request
   def reset_use
     @current_rule_pack = nil
@@ -143,6 +175,14 @@ class Six
 
   protected
 
+  def action_included?(object, action, subject)
+    if current_rule_pack
+      rules_packs[current_rule_pack].allowed(object, subject).include?(action)
+    else
+      rules_packs.values.map { |rp| rp.allowed(object, subject) }.flatten.include?(action)
+    end
+  end
+
   def raise_no_such_pack
     raise Six::NoPackError.new
   end
@@ -153,6 +193,8 @@ class Six
 
   # shotcuts for long methods
 
+  alias_method :use, :use_pack
+  alias_method :use!, :use_pack!
   alias_method :add, :add_pack
   alias_method :add!, :add_pack!
   alias_method :remove, :remove_pack

metadata

@@ -1,45 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: six
 version: !ruby/object:Gem::Version
-  version: 0.1.1
-  prerelease: 
+  version: 0.2.2
 platform: ruby
 authors:
 - Dmitriy Zaporozhets
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2011-08-24 00:00:00.000000000Z
+date: 2021-03-04 00:00:00.000000000 Z
 dependencies: []
-description: Very simple authorization gem
+description: A simple authorization gem
 email: dmitriy.zaporozhets@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - lib/six.rb
-homepage: https://github.com/randx/six
-licenses: []
-post_install_message: 
+homepage: https://gitlab.com/dzaporozhets/six
+licenses:
+- MIT
+metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.6
-signing_key: 
-specification_version: 3
+rubygems_version: 3.2.1
+signing_key:
+specification_version: 4
 summary: six
 test_files: []