passpartu 0.5.0 → 0.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd628d50b6e52acefe4f503c5ada9cec0b224b70be8791fa07f8c5586f93def4
-  data.tar.gz: 5314cf52de8c7cf581768ed8842edb1164b3a57c9aa56456a5ed8e5f0dbfd1e9
+  metadata.gz: 34188ab985989f3022e6fdcefa8ebdae5140e954e3e92ae59483cf29e523b30d
+  data.tar.gz: 8268980e9fe35799d4409205d902691c9a7127e33f1a8638138d82a53612a01a
 SHA512:
-  metadata.gz: 7ddafd099269680b9f05dbe140fdd9ebae94eff8072e81073cd5db3840bc8d87d4a8171db637de242df0f19c16043123972f9a8b518228d2e2712aab6559385c
-  data.tar.gz: 3f3cab407da0abde8da14764df233c625020d12f8c0d631912d6d009c90bc6fb69d23024aa7d272dc3247009824160df64b816561ec05be43d0fc630b5687d7d
+  metadata.gz: 97826c98b5cb98587b30fe29bedb5c7e8c20ee6e2de9c76f3d7ab198ba5fd25e5cb7b68f2b4848f8b50e6447ca4463eebf3988e3339931c91dd87ddc01a0b9a1
+  data.tar.gz: 5383f59ecb8aca48eb483670cb051428c529845891c26e5f45534cb550e4db761cde0f6a894945b695314c5f418ea2a33fe10333598c64cd7e5ee51d3df4ac49

data/README.md

@@ -1,6 +1,6 @@
-# Passpartu
+# Passpartu v0.5.5 - [changelog](https://github.com/coaxsoft/passpartu/blob/master/CHANGELOG.md)
 
-Passpartu makes policies great again (works awesome with Pundit).
+Passpartu makes policies great again (works awesome with [Pundit](https://rubygems.org/gems/pundit)).
 
 Instead of this:
 ```ruby
@@ -31,11 +31,22 @@ NOTE: Your `User` model must respond to `role` method that returns a string or a
 Keep all your policies in one place.
 Create `./config/passpartu.yml` and start writing your policies.
 
-#### Example
+#### Example of `passpartu.yml` 
 ```yml
 # ./config/passpartu.yml
+manager: &manager
+  order:
+    create: true
+    edit: true
+    delete: false
+  product:
+    create: true
+    edit: true
+    delete: false
 
+# yaml files supports inheritance!
 admin:
+  <<: *manager
   post:
     create: false
     update: true
@@ -51,25 +62,17 @@ admin:
   items:  
     crud: true
     delete: false
-manager:
-  order:
-    create: true
-    edit: true
-    delete: false
-  product:
-    create: true
-    edit: true
-    delete: false
-
 ```
-#### Crud
+
+## Features
+#### CRUD
 It's possible to use `crud` key to set values for `create`, `read`, `update`, `delete` at once.
 `create`, `read`, `update`, `delete` has higher priority than `crud`
 In case `crud: true` and `delete: false` - result `false` 
 
 
-#### Except
-It's possible to exclude role from checks
+#### Skip (except)
+It's possible to exclude roles from checks
 ```ruby
     user_admin.can?(:orders, :edit) # check policy for admin and returns true if policy true
     user_admin.can?(:orders, :edit, except: :admin) # returns false because user is admin and we excluded admin
@@ -82,6 +85,15 @@ It's possible to give an array as except attribute
   user_manager.can?(:orders, :edit, except: [:admin, :manager]) # returns false
 ```
 
+`skip` alias to `except`
+
+Note: `expect` has higher priority than `skip`. Do not use both.
+```ruby
+  user_agent.can?(:orders, :edit, except: [:admin, :manager]) { user_agent.orders.include?(order) }
+  # equals to 
+  user_agent.can?(:orders, :edit, skip: [:admin, :manager]) { user_agent.orders.include?(order) }
+```
+
 #### Per role methods
 Check user roles AND policy rule
 ```ruby

data/lib/passpartu/patcher.rb

@@ -11,13 +11,13 @@ module Passpartu
 
     def call
       klass.class_eval do
-        define_method('can?') do |*keys, except: nil, &block|
-          Passpartu::BlockVerify.call(role, keys, except: except, &block)
+        define_method('can?') do |*keys, except: nil, skip: nil, &block|
+          Passpartu::BlockVerify.call(role, keys, except: except, skip: skip, &block)
         end
 
         Passpartu.policy.keys.each do |policy_role|
-          define_method("#{policy_role}_can?") do |*keys, except: nil, &block|
-            role.to_s == policy_role && Passpartu::BlockVerify.call(role, keys, except: except, &block)
+          define_method("#{policy_role}_can?") do |*keys, except: nil, skip: nil, &block|
+            role.to_s == policy_role && Passpartu::BlockVerify.call(role, keys, except: except, skip: skip, &block)
           end
         end
       end

data/lib/passpartu/verify.rb

@@ -3,15 +3,17 @@ module Passpartu
     CRUD_KEY = 'crud'.freeze
 
     attr_reader :role, :keys, :result, :except, :block
-    def initialize(role, keys, except, block)
+    def initialize(role, keys, except, skip, block)
+      exclusion = except || skip # alias
+
       @role = role.to_s
       @keys = keys.map(&:to_s)
-      @except = Array(except).map(&:to_s) if present?(except)
+      @except = Array(exclusion).map(&:to_s) if present?(exclusion)
       @block = block
     end
 
-    def self.call(role, keys, except: nil, &block)
-      new(role, keys, except, block).call
+    def self.call(role, keys, except: nil, skip: nil, &block)
+      new(role, keys, except, skip, block).call
     end
 
     def call

data/lib/passpartu/version.rb

@@ -1,3 +1,3 @@
 module Passpartu
-  VERSION = '0.5.0'.freeze
+  VERSION = '0.5.5'.freeze
 end

data/passpartu.gemspec

@@ -17,8 +17,8 @@ Gem::Specification.new do |spec|
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
-  # if spec.respond_to?(:metadata)
   #   spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+  # if spec.respond_to?(:metadata)
 
   #   spec.metadata["homepage_uri"] = spec.homepage
   #   spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: passpartu
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.5
 platform: ruby
 authors:
 - OrestF
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-03-20 00:00:00.000000000 Z
+date: 2019-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -90,7 +90,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.3
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Passpartu makes policies great again