unidom-category 1.0 → 1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 655a4fd3e168dccb141486694c27d97cebbcf45b
-  data.tar.gz: e49a6fa4c16e13327124a8988367063ecc5dd99f
+  metadata.gz: e41e4d7a1eeed5e84e2fd0cda7254154d4f0b3e8
+  data.tar.gz: cbd399798cdcf795b4a06a6b5b531056dc47aa0a
 SHA512:
-  metadata.gz: 70c9cc82bd5a4dc1c6056cf9d74e6a9185eac24d82565a65d07522983d5317780b7c28b56caaadb3664eb2858b19ec7279c533023b771f6d30531b52a9e3d0df
-  data.tar.gz: 165ecd5a0169d009807a2e3d7a567dc6297cc015670821e2f01935cc1ed900bd18353fe69071147cade904c1be7062823303f6c3d27327034c21ba1c675806f4
+  metadata.gz: 107829d2a32ade295954b14eb752dc3330a362c0fb4489a283599aab99a41649e5252476b4c373256afe1bfa248232f9aadc0d1eb1426cf4421838f6f1ed4300
+  data.tar.gz: e7512d4c70d4a17194c887933689477b895fea5e7d11db676c24f419345a4f970f7fab2e6e2f957037038b9dcb0435ee6f520aa17b373f02259245f29e0c7009

data/README.md

@@ -23,8 +23,21 @@ The migration versions start with 200003.
 
 ## Call the Model
 ```ruby
-Unidom::Category::Category.coded_as('x1').scheme_is(scheme).valid_at.alive.first
+@category = Unidom::Category::Category.coded_as('x1').scheme_is(scheme).valid_at.alive.first
 Unidom::Category::Categorizing.categorize! product, into: category, at: Time.now
 
 Unidom::Category::CategoryRollup.roll_up! child_category, into: parent_category, at: Time.now
+
+# Add the @product into the @category.
+@category.categorize! @product, primary: true
 ```
+
+## Include the Concerns
+```ruby
+include Unidom::Category::Concerns::AsCategorized
+```
+
+### 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``

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

@@ -23,4 +23,10 @@ class Unidom::Category::Category < ActiveRecord::Base
   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+'%' }
 
+  def categorize!(categorized, primary: false, at: Time.now)
+    raise ArgumentError('The categorized argument is required.') if categorized.blank?
+    raise ArgumentError('The at argument is required.'         ) if at.blank?
+    categorizings.create! categorized: categorized, elemental: primary, opened_at: at
+  end
+
 end

data/lib/unidom/category/version.rb

@@ -1,5 +1,5 @@
 module Unidom
   module Category
-    VERSION = '1.0'.freeze
+    VERSION = '1.1'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unidom-category
 version: !ruby/object:Gem::Version
-  version: '1.0'
+  version: '1.1'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-15 00:00:00.000000000 Z
+date: 2016-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: unidom-common