unidom-category 1.5.4 → 1.5.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7388581cb56b65f5dfcc15ef3dcf6d5b72222e2c
-  data.tar.gz: 6724a0d4670f5b15859c0bce6734998054aff417
+  metadata.gz: 3cf9e49d71c90a9c481326d894c7732dd9d11448
+  data.tar.gz: 90fa319d17a4d5f8c2839195efe789004a16aa41
 SHA512:
-  metadata.gz: 01edeb37121ae0ab666556da562305beda1bff30d0d4bd14e98df689284246600d8915ad973f3d4df849351a1effac93addf21683d0b4e212f0373cbb4ac54d5
-  data.tar.gz: 502c136c531bfe9d127179ee67c940b612a9243f5ed185aea34d3efc49b7b8de836b046604539a1620ebc0af11af66621e5fe60d725101f8dd41231e7126f132
+  metadata.gz: 7e1523a1109f18d34975673eb6b0389e01a22d5070c835193d3ef48efdd630648511a3b4d378cd66efe1673d16af83b7456eb9f93ed9dae2e7d8a34bfc8e5dcd
+  data.tar.gz: 29701235a9a5351867cfe96b8f19176286169f72c475b82e028b809d54455233bc45ee034d98b9ebabd3cdc1835d9600a6198afd03ac4b9ae8f7e0604b1df717

data/README.md

@@ -1,6 +1,8 @@
 # Unidom Category 类别领域模型引擎
 
+[![Documentation](http://img.shields.io/badge/docs-rdoc.info-blue.svg)](http://www.rubydoc.info/gems/unidom-category/frames)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](http://opensource.org/licenses/MIT)
+
 [![Gem Version](https://badge.fury.io/rb/unidom-category.svg)](https://badge.fury.io/rb/unidom-category)
 [![Dependency Status](https://gemnasium.com/badges/github.com/topbitdu/unidom-category.svg)](https://gemnasium.com/github.com/topbitdu/unidom-category)
 
@@ -58,31 +60,47 @@ include Unidom::Category::Concerns::AsDescendantCategory
 
 ### As Category concern
 
-The As Category concern do the following tasks for the includer automatically:  
-1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Category::Categorizing'``  
-2. Define the #categorize! method as: ``categorize!(categorized, at: Time.now, primary: true)``  
+The As Category concern do the following tasks for the includer automatically:
+1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Category::Categorizing'``
+2. Define the #categorize! method as: ``categorize!(categorized, at: Time.now, primary: true)``
 3. Define the #categorize? method as: ``categorize?(categorized, at: Time.now, primary: true)``
 
 ### As Categorized concern
 
-The As Categorized concern do the following tasks for the includer automatically:  
-1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Unidom::Category::Categorizing', as: :categorized``  
-2. Define the has_many :categories macro as: ``has_many :categories, through: :categorizings, source: :category``  
-3. Define the #is_categorized! method as: ``is_categorized!(into: nil, at: Time.now, primary: true)``  
+The As Categorized concern do the following tasks for the includer automatically:
+1. Define the has_many :categorizings macro as: ``has_many :categorizings, class_name: 'Unidom::Category::Categorizing', as: :categorized``
+2. Define the has_many :categories macro as: ``has_many :categories, through: :categorizings, source: :category``
+3. Define the #is_categorized! method as: ``is_categorized!(into: nil, at: Time.now, primary: true)``
 4. Define the #is_categorized? method as: ``is_categorized?(into: nil, at: Time.now, primary: true)``
 
 ### As Ancestor Category concern
 
-The As Ancestor Category concern do the following tasks for the includer automatically:  
-1. Define the has_many :descendant_category_rollups macro as: ``has_many :descendant_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :ancestor_category_id, source: :ancestor_category``  
-2. Define the has_many :descendant_categories macro as: ``has_many :descendant_categories, class_name: 'Unidom::Category::Category', through: :descendant_category_rollups``  
-3. Define the #roll_up! method as: ``roll_up!(it, at: Time.now, primary: true)``  
+The As Ancestor Category concern do the following tasks for the includer automatically:
+1. Define the has_many :descendant_category_rollups macro as: ``has_many :descendant_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :ancestor_category_id, source: :ancestor_category``
+2. Define the has_many :descendant_categories macro as: ``has_many :descendant_categories, class_name: 'Unidom::Category::Category', through: :descendant_category_rollups``
+3. Define the #roll_up! method as: ``roll_up!(it, at: Time.now, primary: true)``
 4. Define the #roll_up? method as: ``roll_up?(it, at: Time.now, primary: true)``
 
 ### As Descendant Category concern
 
-The As Descendant Category concern do the following tasks for the includer automatically:  
-1. Define the has_many :ancestor_category_rollups macro as: ``has_many :ancestor_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :descendant_category_id, source: :descendant_category``  
-2. Define the has_many :ancestor_categories macro as: ``has_many :ancestor_categories, class_name: 'Unidom::Category::Category', through: :ancestor_category_rollups``  
-3. Define the #is_rolled_up! as: ``is_rolled_up!(it, at: Time.now, primary: true)``  
+The As Descendant Category concern do the following tasks for the includer automatically:
+1. Define the has_many :ancestor_category_rollups macro as: ``has_many :ancestor_category_rollups, class_name: 'Unidom::Category::CategoryRollup', foreign_key: :descendant_category_id, source: :descendant_category``
+2. Define the has_many :ancestor_categories macro as: ``has_many :ancestor_categories, class_name: 'Unidom::Category::Category', through: :ancestor_category_rollups``
+3. Define the #is_rolled_up! as: ``is_rolled_up!(it, at: Time.now, primary: true)``
 4. Define the #is_rolled_up? as: ``is_rolled_up?(it, at: Time.now, primary: true)``
+
+
+
+## Disable the Model & Migration
+
+If you only need the app components other than models, the migrations should be neglected, and the models should not be loaded.
+```ruby
+# config/initializers/unidom.rb
+Unidom::Common.configure do |options|
+
+  options[:neglected_namespaces] = %w{
+    Unidom::Category
+  }
+
+end
+```

data/app/controllers/unidom/category/application_controller.rb

@@ -1,3 +1,6 @@
+##
+# Application controller 是模块内所有控制器的基类。
+
 class Unidom::Category::ApplicationController < ActionController::Base
   protect_from_forgery with: :exception
 end

data/app/jobs/unidom/category/application_job.rb

@@ -1,2 +1,5 @@
+##
+# Application job 是模块内所有异步任务的基类。
+
 class Unidom::Category::ApplicationJob < ActiveJob::Base
 end

data/app/mailers/unidom/category/application_mailer.rb

@@ -1,3 +1,6 @@
+##
+# Application mailer 是模块内所有电子邮件发送类的基类。
+
 class Unidom::Category::ApplicationMailer < ActionMailer::Base
   default from: 'from@example.com'
   layout 'mailer'

data/app/models/unidom/category/application_record.rb

@@ -1,3 +1,6 @@
+##
+# Application record 是模块内所有模型的抽象基类。
+
 class Unidom::Category::ApplicationRecord < ActiveRecord::Base
   self.abstract_class = true
 end

data/app/models/unidom/category/categorizing.rb

@@ -13,12 +13,8 @@ class Unidom::Category::Categorizing < Unidom::Category::ApplicationRecord
   scope :category_is,    ->(category)    { where category_id: to_id(category) }
   scope :categorized_is, ->(categorized) { where categorized: categorized     }
 
-  #def self.categorize!(category, categorized, opened_at = Time.now)
-  #  self.categorized_is(categorized).category_is(category).valid_at.alive.first_or_create! elemental: true, opened_at: opened_at
-  #end
-
   def self.categorize!(categorized, into: nil, at: Time.now)
     categorized_is(categorized).category_is(into).valid_at.alive.first_or_create! elemental: true, opened_at: at
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Categorizing'

data/app/models/unidom/category/category.rb

@@ -19,4 +19,4 @@ class Unidom::Category::Category < Unidom::Category::ApplicationRecord
   scope :code_length_is,     ->(length) { where 'LENGTH(code) = :code_length',  code_length:       length     }
   scope :code_starting_with, ->(prefix) { where 'code LIKE :prefix_expression', prefix_expression: prefix+'%' }
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::Category'

data/app/models/unidom/category/category_rollup.rb

@@ -29,8 +29,11 @@ class Unidom::Category::CategoryRollup < Unidom::Category::ApplicationRecord
     end
   }
 
+  ##
+  # 将 it 归为 into 的下级分类，时间是 at ，缺省为当前时间。如：
+  # Unidom::Category::CategoryRollup.roll_up! moto, into: vehicle
   def self.roll_up!(it, into: nil, at: Time.now)
     self.descendant_category_is(it).ancestor_category_is(into).valid_at(now: at).alive.first_or_create! opened_at: at
   end
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryRollup'

data/app/models/unidom/category/category_scheme.rb

@@ -15,4 +15,4 @@ class Unidom::Category::CategoryScheme < Unidom::Category::ApplicationRecord
 
   scope :owned_by, ->(owner) { where owner: owner }
 
-end
+end unless Unidom::Common::Neglection.namespace_neglected? 'Unidom::Category::CategoryScheme'

data/lib/unidom/category/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Category
-    VERSION = '1.5.4'.freeze
+    VERSION = '1.5.5'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-category
 version: !ruby/object:Gem::Version
-  version: 1.5.4
+  version: 1.5.5
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-03 00:00:00.000000000 Z
+date: 2017-01-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.9'
 description: Unidom (UNIfied Domain Object Model) is a series of domain model engines.
   The Category domain model engine includes Category and its relative models. Unidom
   (统一领域对象模型)是一系列的领域模型引擎。类别领域模型引擎包括类别及其相关的模型。