unidom-authorization 1.6.8 → 1.6.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ff9f8b52affaacbf3946c01061e4102bec04468b
-  data.tar.gz: 1c49adc7c942820c0462623ebce4579d07dab579
+  metadata.gz: 994100e1608a14874fe229bd1e7fc01d14a3a3ea
+  data.tar.gz: 1f61900ac12296b2b0ea670e4ac6b8b1db0fb369
 SHA512:
-  metadata.gz: 8c43d6c7f8714f3580dd3f033e6026897fc5479ecee46852c10de99e018c3ffcd9f882493671730a32d60580c8f4c3d1e6cba03006b2908a7c039984971ef29a
-  data.tar.gz: 36df0efd33ee7e4ea3c77a0ec88c3cbe99bf59df7e0523384f362d12ff10a71f47bbe1d95239e93a726fad64f7f0a239f8846b90e1c4a3b09b6e64ad2611d8f9
+  metadata.gz: f6ccc25c14df6fea53f8ab442e4f5bc95fcb50f1e45d561252929bfddfb9f7092912559eb60be58398b069f93a913c097dca4de3573c7019b32fd16792a161a4
+  data.tar.gz: fc678376a6f47aca5449b3ed0841fe64d3019ff25ea66b6ede20144ab07f1a3a5899e4ea23a6931a91b1c8ba764b3fdb4226d7343c668e26662bebaa2d9f6616

data/README.md

@@ -218,5 +218,31 @@ describe Unidom::Authorization::Permission, type: :model do
 
   end
 
+end
+
+# spec/models/unidom/authorization/authorizing_spec.rb
+describe Unidom::Authorization::Authorizing, type: :model do
+
+  before :each do
+  end
+
+  after :each do
+  end
+
+  context do
+
+    model_attributes = {
+      authorizer_id:   SecureRandom.uuid,
+      authorizer_type: 'Unidom::Authorization::Authorizer::Mock',
+      authorized_id:   SecureRandom.uuid,
+      authorized_type: 'Unidom::Authorization::Authorized::Mock',
+      permission_id:   SecureRandom.uuid
+    }
+    authorizer_class_list = [ Unidom::Visitor::User, Unidom::Party::Person ]
+
+    it_behaves_like 'Unidom::Authorization::Authorizing', model_attributes, authorizer_class_list, [ {}, { name: 'Tim' } ]
+
+  end
+
 end
 ```

data/app/models/unidom/authorization/concerns/as_authorized.rb

@@ -14,6 +14,8 @@ module Unidom::Authorization::Concerns::AsAuthorized
     # 将本参与者或访问者，授予指定的权限 permission ， by 是授权者， at 是授权时间，缺省为当前时间。如：
     # 假设 selected_person 对应的类已经 include Unidom::Authorization::Concerns::AsAuthorized 。
     # selected_person.is_authorized! permission, by: current_person
+    # # or
+    # selected_person.is_authorized! permission, by: current_person, at: Time.now
     def is_authorized!(permission: nil, by: nil, at: Time.now)
 
       assert_present! :permission, permission
@@ -24,6 +26,12 @@ module Unidom::Authorization::Concerns::AsAuthorized
 
     end
 
+    ##
+    # 判断本参与者或访问者，在给定的时间 at 是否拥有给定的权限 permission 。如：
+    # 假设 selected_person 对应的类已经 include Unidom::Authorization::Concerns::AsAuthorized 。
+    # selected_person.is_authorized? permission
+    # # or
+    # selected_person.is_authorized? permission, at: Time.now
     def is_authorized?(permission: nil, at: Time.now)
 
       assert_present! :permission, permission

data/app/models/unidom/authorization/concerns/as_permission.rb

@@ -30,6 +30,12 @@ module Unidom::Authorization::Concerns::AsPermission
 
     end
 
+    ##
+    # 判断当前权限，在给定的时间 at 是否授权给指定的参与者或访问者 authorized 。如：
+    # 假设 selected_person 对应的类已经 include Unidom::Authorization::Concerns::AsAuthorized 。
+    # permission.authorize? selected_person
+    # # or
+    # permission.authorize? selected_person, at: Time.now
     def authorize?(authorized, at: Time.now)
 
       assert_present! :authorized, authorized

data/lib/rspec/models/unidom/authorization/authorizing_shared_examples.rb

@@ -0,0 +1,19 @@
+shared_examples 'Unidom::Authorization::Authorizing' do |model_attributes, authorizer_class_list, authorizer_attributes_list|
+
+  before :each do
+  end
+
+  after :each do
+  end
+
+  context do
+
+    authorizer_class_list.each_with_index do |authorizer_class, index|
+      it_behaves_like 'belongs_to', model_attributes, :authorizer, authorizer_class, authorizer_attributes_list[index]
+    end
+
+    it_behaves_like 'polymorphic scope', model_attributes, :authorized_by, :authorizer, authorizer_class_list
+
+  end
+
+end

data/lib/rspec/models/unidom/authorization/permission_spec.rb

@@ -23,7 +23,8 @@ describe Unidom::Authorization::Permission, type: :model do
     it_behaves_like 'scope', :path_is, [
       { attributes_collection: [ model_attributes ], count_diff: 1, args: [ model_attributes[:path]           ] },
       { attributes_collection: [ model_attributes ], count_diff: 0, args: [ "/#{model_attributes[:path]}"     ] },
-      { attributes_collection: [ model_attributes ], count_diff: 0, args: [ "#{model_attributes[:path]}.html" ] } ]
+      { attributes_collection: [ model_attributes ], count_diff: 0, args: [ "#{model_attributes[:path]}.html" ] }
+    ]
 
   end
 

data/lib/unidom/authorization/rspec_shared_examples.rb

@@ -1,3 +1,4 @@
 require 'rspec/models/unidom/authorization/concerns/as_authorized_shared_examples'
 require 'rspec/models/unidom/authorization/concerns/as_permission_shared_examples'
+require 'rspec/models/unidom/authorization/authorizing_shared_examples'
 require 'rspec/models/unidom/authorization/permission_shared_examples'

data/lib/unidom/authorization/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Authorization
-    VERSION = '1.6.8'.freeze
+    VERSION = '1.6.9'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-authorization
 version: !ruby/object:Gem::Version
-  version: 1.6.8
+  version: 1.6.9
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-17 00:00:00.000000000 Z
+date: 2017-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -52,6 +52,7 @@ files:
 - config/routes.rb
 - db/migrate/20000401000000_create_unidom_permissions.rb
 - db/migrate/20000402000000_create_unidom_authorizings.rb
+- lib/rspec/models/unidom/authorization/authorizing_shared_examples.rb
 - lib/rspec/models/unidom/authorization/authorizing_spec.rb
 - lib/rspec/models/unidom/authorization/concerns/as_authorized_shared_examples.rb
 - lib/rspec/models/unidom/authorization/concerns/as_permission_shared_examples.rb