rails-acu 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7a7d60b156e3659b6855ebf7aaf31408b27d7cca
-  data.tar.gz: 3348325c341c48d2a4a24019882caca888f44d49
+  metadata.gz: 1b2563936934989850c0e722493a76812b1fd6b6
+  data.tar.gz: 1614f918ac20a0428122766f4d87009ef1ebffe5
 SHA512:
-  metadata.gz: ab06cba37ec9e9ee51a7f8c7d339e1d98906f4abb6521d616132411322c3de435017a51faeb816ac22a2a6af64d6473a9d3362e51c2d500d4e3ddd7bd4ebc261
-  data.tar.gz: 54381599563969a2a81af8f4d8a92e853f0667b4b30fe34aed5f7fb3e8cea53da2b517cbf6eb62750007ebd736824eda5419c81acefece4a5266fefbd6aba511
+  metadata.gz: f13538958c6e64044bb04110c14bcfe6059bd844b82e7e0d80f84a7ca259015f0530c9e5b303347bd7224c236ad56adf4bcfd914d25c1e6839a3d17346d78ee2
+  data.tar.gz: 176d26a870e35eb5ab33485811ccebf63d9ebc211c9a4913995efe0e734b15dea86cec662600a4262ff6834f7fb7cadff6c933e1bce197723881eab430bd8b7c

data/Gemfile.lock

@@ -7,7 +7,7 @@ GIT
 PATH
   remote: .
   specs:
-    rails-acu (2.1.0)
+    rails-acu (2.2.0)
       rails (~> 5.0.0, >= 5.0.0)
 
 GEM
@@ -63,8 +63,8 @@ GEM
       warden (~> 1.2.3)
     diff-lcs (1.3)
     erubis (2.7.0)
-    globalid (0.3.7)
-      activesupport (>= 4.1.0)
+    globalid (0.4.0)
+      activesupport (>= 4.2.0)
     i18n (0.8.1)
     jquery-rails (4.3.1)
       rails-dom-testing (>= 1, < 3)

data/README.md

@@ -112,7 +112,7 @@ The method `Acu::Monitor.gaurd` accepts a hashed list of agruments named `by`, p
 
 ### Some handy helpers
 Although you can define a binary allow/deny access rule in the `acu_rules.rb` file but there will be some gray area that neither you can allow _full access_ to the resource nor _no access_.<br />
-for those situations you allow the entities to get access but limits their operations in the action/view/layout with the `acu_is?` and `acu_as` helpers, here is some usage example of them:
+For those situations you allow the entities to get access but limits their operations in the action/view/layout with the `acu_is?`, `acu_as` and `acu_except` helpers, here is some usage example of them:
 
 ```ruby
 # return true if the entity `:admin`'s block in `whois :admin` return true, otherwise false
@@ -128,6 +128,11 @@ end
 acu_as [:admin, :client] do
   puts 'You are either `admin` or `client`'
 end
+
+# DO NOT executes the block if current user identified as either `:guest`
+acu_except [:guest] do 
+  puts 'Except `:guest`s anyone else can execute this code'
+end
 ```
 
 ### Configurations
@@ -214,6 +219,26 @@ class Acu::Errors::MissingController < MissingData
 class Acu::Errors::MissingNamespace < MissingData
 ```
 
+## Known contributions subjects to work on 
+
+### Implementing to overriding the rules in inner loops:
+Consider we have to give the everyone to access the default namespace except `:profile` controller which will only allow by signed in users, although there are tools provided
+for this purpose, such as `except` and `only` tags on `controller` and `namespace` but it would be nice if there are such a command like `override` which its skeleton has been
+defined in the `Acu::Rules.override` which enables the previously defined rule to be overrided, the following pseudo-example removes the `allow :everyone` rule from the controller
+`profile`:
+
+```ruby
+  # config/initializers/acu_rules.rb
+  [...]
+  namespace do
+    allow :everyone
+    controller :profiles do
+      override :everyone
+      allow :signed_in
+    end
+  end
+  [...]
+```
 
 
 ## Contributing

data/lib/acu/helpers/helpers.rb

@@ -6,4 +6,8 @@ end
 
 def acu_as symbol
   yield if acu_is? symbol
+end
+
+def acu_except symbol
+  yield if not acu_is? symbol
 end

data/lib/acu/rules.rb

@@ -97,6 +97,10 @@ module Acu
         op *symbol, @DENY_SYMBOL, on
       end
 
+      def override *symbol, with:, on: []
+        raise Exception.new('not implemented!');
+      end
+
       ################### end of ops ####################
 
       protected

data/lib/acu/version.rb

@@ -1,3 +1,3 @@
 module Acu
-  VERSION = '2.1.0'
+  VERSION = '2.2.0'
 end

data/spec/dummy/spec/controllers/home_controller_spec.rb

@@ -526,7 +526,7 @@ RSpec.describe HomeController, type: :controller do
       expect(acu_is? :everyone).to be true
       expect(acu_is? :client).to be false
     end
-    it "acu_do" do
+    it "acu_as" do
       Acu::Rules.define do
         whois :everyone { true }
         whois :client { false }
@@ -544,6 +544,24 @@ RSpec.describe HomeController, type: :controller do
         expect(acu_is? :everyone).to be true
       end
     end
+    it "acu_except" do
+      Acu::Rules.define do
+        whois :everyone { true }
+        whois :client { false }
+      end
+      acu_except :everyone do
+        # an invalid syntax, this should never run
+        expect(true).not_to be true
+      end
+      acu_except :client do
+        # a valid syntax
+        expect(true).to be true
+      end
+      # no-one gets through
+      acu_except [:client, :everyone] do
+        expect(true).not_to be true
+      end
+    end
   end
   context 'caching' do
     it '[Rails.cache]' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-acu
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Dariush Hasanpour
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-02 00:00:00.000000000 Z
+date: 2017-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails