unidom-certificate 2.1 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 364da9418346c3ba8762a9ef20f57b8e997ae1a5
-  data.tar.gz: b8b8e9dcf061908f5a5c8a19eb2a0c56b36aa46c
+  metadata.gz: dd70eeabf4ae48d02909c4530a68f2fccb3d63bd
+  data.tar.gz: 12af2197e143c187cfa930b44fa38d7ffe5c9bff
 SHA512:
-  metadata.gz: 647d837db97b0993e9cb6e5a9698470acda03692f39efdf031b14ef7078ddc2777be687c53a8ceec583d3b2d4e38868634507455d5cae31fce484f5bcb140ed1
-  data.tar.gz: 5fb4eec191e06ede9d7af3b22eaebcbc7c4c857f40c89119734e7f87f51a7c23f5a7d32aa0db02eadf3d046c4281dd76a89a2d3f5e6e7c47f04b487d4499709d
+  metadata.gz: 94dd5fb13696c9572e269120a2e3c5000dc0babaf7f70d828ad2321c48702bc5a4428f9fb6cc11519e5477622eeff23683b7f25a085c45709779270d7b10daa0
+  data.tar.gz: 4b1dd04d8e254be707db42d6c29d3d0884e5d4d324fbaa4fba78cf5af38596f62b125a924a3150e5039054a988a6f3a5d873d9d7fe5024b1f41e5f3a6f20ca70

data/README.md

@@ -87,6 +87,8 @@ end
 
 ## RSpec examples
 
+### RSpec example manifest (run automatically)
+
 ```ruby
 # spec/models/unidom_spec.rb
 require 'unidom/certificate/models_rspec'
@@ -97,3 +99,87 @@ require 'unidom/certificate/types_rspec'
 # spec/validators/unidom_spec.rb
 require 'unidom/certificate/validators_rspec'
 ```
+
+### RSpec shared examples (to be integrated)
+
+```ruby
+# The Unidom::Certificate::China::BusinessLicense model, & the Unidom::Certificate::China::IdentityCard model already include the Unidom::Certificate::Concerns::AsCertification concern
+
+# app/models/your_certification.rb
+class YourCertification < ApplicationRecord
+
+  include Unidom::Common::Concerns::ModelExtension
+  include Unidom::Certificate::Concerns::AsCertification
+
+end
+
+# lib/unidom.rb
+def initialize_unidom
+
+  Unidom::Party::Company.class_eval do
+    include Unidom::Certificate::Concerns::AsCertificated
+  end
+
+  Unidom::Party::Person.class_eval do
+    include Unidom::Certificate::Concerns::AsCertificated
+  end
+
+  Unidom::Party::Shop.class_eval do
+    include Unidom::Certificate::Concerns::AsCertificated
+  end
+
+end
+
+# spec/rails_helper.rb
+require 'unidom'
+initialize_unidom
+
+# spec/support/unidom_rspec_shared_examples.rb
+require 'unidom/certificate/rspec_shared_examples'
+
+# spec/models/unidom/party/company_spec.rb
+describe Unidom::Party::Company, type: :model do
+
+  model_attribtues = {
+    name: 'Tesla'
+  }
+
+  it_behaves_like 'Unidom::Certificate::Concerns::AsCertificated', model_attribtues
+
+end
+
+# spec/models/unidom/party/person_spec.rb
+describe Unidom::Party::Person, type: :model do
+
+  model_attribtues = {
+    name: 'Tim'
+  }
+
+  it_behaves_like 'Unidom::Certificate::Concerns::AsCertificated', model_attribtues
+
+end
+
+# spec/models/unidom/party/shop_spec.rb
+describe Unidom::Party::Shop, type: :model do
+
+  model_attribtues = {
+    name: 'WalMart'
+  }
+
+  it_behaves_like 'Unidom::Certificate::Concerns::AsCertificated', model_attribtues
+
+end
+
+# spec/models/your_certification_spec.rb
+describe YourCertification, type: :model do
+
+  model_attribtues = {
+    name:          'Your Certification Name',
+    serial_number: '12345678',
+    issued_on:     '2020-01-01'
+  }
+
+  it_behaves_like 'Unidom::Certificate::Concerns::AsCertification', model_attribtues
+
+end
+```

data/app/models/unidom/certificate/certificating.rb

@@ -19,9 +19,8 @@ class Unidom::Certificate::Certificating < Unidom::Certificate::ApplicationRecor
   # 由认证者 certificator 用证书 certification 去认证的人或者机构 certificated ，认证时间是： opened_at。
   def self.certificate!(certification: nil, certificated: nil, certificator: nil, opened_at: Time.now)
     assert_present! :certification, certification
-    #raise ArgumentError.new('The certification argument is required.') if certification.blank?
-    raise ArgumentError.new('The certificated argument is required.' ) if certificated.blank?
-    raise ArgumentError.new('The opened_at argument is required.'    ) if opened_at.blank?
+    assert_present! :certificated,  certificated
+    assert_present! :opened_at,     opened_at
 
     attributes = { opened_at: opened_at }
     if certificator.present?

data/app/models/unidom/certificate/concerns/as_certification.rb

@@ -4,6 +4,7 @@
 module Unidom::Certificate::Concerns::AsCertification
 
   extend ActiveSupport::Concern
+  include Unidom::Common::Concerns::ArgumentValidation
 
   included do |includer|
 
@@ -14,7 +15,8 @@ module Unidom::Certificate::Concerns::AsCertification
     # 如：mcse.certificate! person, by: bill_gates, at: Time.now
     def certificate!(certificated, by: nil, at: Time.now)
 
-      raise ArgumentError.new('The certificated argument is required.') if certificated.blank?
+      assert_present! :certificated, certificated
+      #raise ArgumentError.new('The certificated argument is required.') if certificated.blank?
       raise ArgumentError.new('The by argument is required.'          ) if by.blank?
       raise ArgumentError.new('The at argument is required.'          ) if at.blank?
 

data/lib/rspec/models/unidom/certificate/concerns/as_certificated_shared_examples.rb

@@ -0,0 +1,23 @@
+shared_examples 'Unidom::Certificate::Concerns::AsCertificated' do |model_attributes|
+
+  context do
+
+    certificating_1_attribtues = {
+        certificator_id:    SecureRandom.uuid,
+        certificator_type:  'Unidom::Certificate::Certificator::Mock',
+        certification_id:   SecureRandom.uuid,
+        certification_type: 'Unidom::Certificate::Certification::Mock'
+      }
+
+    certificating_2_attribtues = {
+        certificator_id:    SecureRandom.uuid,
+        certificator_type:  'Unidom::Certificate::Certificator::Mock',
+        certification_id:   SecureRandom.uuid,
+        certification_type: 'Unidom::Certificate::Certification::Mock'
+      }
+
+    it_behaves_like 'has_many', model_attributes, :certificatings, Unidom::Certificate::Certificating, [ certificating_1_attribtues, certificating_2_attribtues ]
+
+  end
+
+end

data/lib/rspec/models/unidom/certificate/concerns/as_certification_shared_examples.rb

@@ -0,0 +1,23 @@
+shared_examples 'Unidom::Certificate::Concerns::AsCertification' do |model_attributes|
+
+  context do
+
+    certificating_1_attribtues = {
+        certificator_id:   SecureRandom.uuid,
+        certificator_type: 'Unidom::Certificate::Certificator::Mock',
+        certificated_id:   SecureRandom.uuid,
+        certificated_type: 'Unidom::Certificate::Certificated::Mock'
+      }
+
+    certificating_2_attribtues = {
+        certificator_id:   SecureRandom.uuid,
+        certificator_type: 'Unidom::Certificate::Certificator::Mock',
+        certificated_id:   SecureRandom.uuid,
+        certificated_type: 'Unidom::Certificate::Certificated::Mock'
+      }
+
+    it_behaves_like 'has_many', model_attributes, :certificatings, Unidom::Certificate::Certificating, [ certificating_1_attribtues, certificating_2_attribtues ]
+
+  end
+
+end

data/lib/unidom/certificate/rspec_shared_examples.rb

@@ -0,0 +1,2 @@
+require 'rspec/models/unidom/certificate/concerns/as_certificated_shared_examples'
+require 'rspec/models/unidom/certificate/concerns/as_certification_shared_examples'

data/lib/unidom/certificate/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Certificate
-    VERSION = '2.1'.freeze
+    VERSION = '2.1.1'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-certificate
 version: !ruby/object:Gem::Version
-  version: '2.1'
+  version: 2.1.1
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-28 00:00:00.000000000 Z
+date: 2017-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -51,10 +51,13 @@ files:
 - config/routes.rb
 - db/migrate/20010201000000_create_unidom_certificatings.rb
 - lib/rspec/models/unidom/certificate/certificating_spec.rb
+- lib/rspec/models/unidom/certificate/concerns/as_certificated_shared_examples.rb
+- lib/rspec/models/unidom/certificate/concerns/as_certification_shared_examples.rb
 - lib/tasks/certificate_tasks.rake
 - lib/unidom/certificate.rb
 - lib/unidom/certificate/engine.rb
 - lib/unidom/certificate/models_rspec.rb
+- lib/unidom/certificate/rspec_shared_examples.rb
 - lib/unidom/certificate/types_rspec.rb
 - lib/unidom/certificate/validators_rspec.rb
 - lib/unidom/certificate/version.rb