progne_tapera 0.3 → 0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c572ea05d76868e7f16a643e20a9a3c6eb36820d
-  data.tar.gz: 01d125c24cb51e1d29545b4e78fff1f61d37b384
+  metadata.gz: 0f5f7b1c2bd253288fb395a9689477afd48296fc
+  data.tar.gz: 8b8222d20691909a97a1c0dcb62d85d7a3233964
 SHA512:
-  metadata.gz: 79a1a9ac26aad3ab40885b50a5589c4dcdb64a6d97e0bae01d934a36a74d8f526aa4762d057c2ad2231c0d0503e60d343633af2a6fd3b27f98e4d433da407d54
-  data.tar.gz: 6d0de604532c59caf306a4d715113a0a4989757c395d52fbe92577e6f9efbdbb52f70ccdc4ca1d72ff1c29ea521f9bada4a6fdb1b979dc77673d9934e9d0955f
+  metadata.gz: 1663219296095eb5c07acc5c7118e7517057b7a086adcd6826c19a20fe8fa0a8f605afdaaf06d2086f5c87c67bf71e0794a78f92539032a4ab9c9eea5593a1bc
+  data.tar.gz: 4e4c9d42fbe51f7deaa27c8cca6695d6c6dcdd2373aa6c7a477da860f5304db9e4c24c5a72c061a65c1544a5c7c62cc66402b588fc0cca92ae2336050101edb8

data/CHANGELOG.md

@@ -7,10 +7,13 @@
 4. Enum Code concern
 
 ## v0.1.1
-1. Improve the Ruby Gem Specification to depend on Rails v4.2
+1. Improved the Ruby Gem Specification to depend on [rails](https://github.com/rails/rails) v4.2
 
 ## v0.2
-1. Improve the Enum Config concern to support the customized enum i18n name
+1. Improved the Enum Config concern to support the customized enum i18n name
 
 ## v0.3
-1. Improve the Enum Config concern to support the overloaded enum i18n name
+1. Improved the Enum Config concern to support the overloaded enum i18n name
+
+## v0.4
+1. Improve the Enum List concern to add the .``lookup`` method

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    progne_tapera (0.2)
+    progne_tapera (0.3)
       rails (>= 4.2)
 
 GEM

data/README.md

@@ -37,11 +37,13 @@ Or install it yourself as:
 ## Usage
 
 config/initializers/enum.rb
+
 ```ruby
 Unidom::Common::YamlHelper.load_enum config: Rails.configuration, root: Rails.root
 ```
 
 config/enum.yml
+
 ```yaml
 enum:
 
@@ -63,6 +65,7 @@ enum:
 ```
 
 config/locales/enum.zh-CN.yml
+
 ```yaml
 'zh-CN':
   enum:
@@ -78,6 +81,7 @@ config/locales/enum.zh-CN.yml
 ```
 
 app/types/gender.rb
+
 ```ruby
 class Gender < ActiveRecord::Type::Value
 
@@ -89,6 +93,7 @@ end
 ```
 
 app/types/ethnicity.rb
+
 ```ruby
 class Ethnicity < ActiveRecord::Type::Value
 
@@ -97,10 +102,21 @@ class Ethnicity < ActiveRecord::Type::Value
   enum :china_ethnicity
   # 用 :china_ethnicity 指定的 i18n 资源。
 
+  module ItemMethods
+
+    def major?
+      'HA'==code
+    end
+    # Ethnicity::HAN.major? returns true
+    # Ethnicity::MONGEL.major? returns false
+
+  end
+
 end
 ```
 
 app/types/ethnicity.rb
+
 ```ruby
 class Ethnicity < ActiveRecord::Type::Value
 
@@ -113,6 +129,7 @@ end
 ```
 
 app/types/ethnicity.rb
+
 ```ruby
 class Ethnicity < ActiveRecord::Type::Value
 
@@ -125,11 +142,21 @@ end
 ```
 
 在某处需要调用民族 (Ethnicity) 枚举型的代码中：
+
 ```ruby
 Ethnicity::HAN.code           # 'HA'
 Ethnicity::HAN.localized_name # '汉'
 ```
 
+在使用枚举型的模型中：（如 app/models/person.rb）
+
+```ruby
+class Person < ActiveRecord::Base
+  code :ethnicity, Ethnicity
+  # The :ethnicity above implies the Person model has the :ethnicity_code field.
+end
+```
+
 
 
 ## Include the Concerns
@@ -152,9 +179,18 @@ The Enum List concern do the following tasks for the includer automatically:
 7. Define the .all method as: ``all``  
 8. Define the .selected method as: ``selected(&block)``  
 9. Define the .each method as: ``each(&block)``  
-10. Define the .form_options method as: ``form_options(&block)``  
-11. Define the .deserialize method as: ``deserialize(value)``  
-12. Define the .serialize method as: ``serialize(value)``
+10. Define the .lookup method as: ``lookup(code)``
+11. Define the .form_options method as: ``form_options(&block)``  
+12. Define the .deserialize method as: ``deserialize(value)``  
+13. Define the .serialize method as: ``serialize(value)``
+
+```ruby
+gender = Gender.lookup '1' # Lookup the gender per code
+gender.name                # male
+
+Gender.form_options        # { '男' => '1', '女' => '2', '未指定' => '9' }
+# It's useful for the HTML select options
+```
 
 ### Enum Config concern
 
@@ -176,7 +212,7 @@ config/locales/enum.zh-CN.yml
 ```ruby
 # Overload the i18n resources of the Ethnicity enum code
 Ethnicity.class_eval do
-  overload_enum_i18n :ethnicity_overloaded
+  overload_enum_i18n :china_ethnicity_overloaded
 end
 ```
 

data/ROADMAP.md

@@ -7,10 +7,13 @@
 4. Enum Code concern
 
 ## v0.1.1
-1. Improve the Ruby Gem Specification to depend on Rails v4.2
+1. Improve the Ruby Gem Specification to depend on [rails](https://github.com/rails/rails) v4.2
 
 ## v0.2
 1. Improve the Enum Config concern to support the customized enum i18n name
 
 ## v0.3
 1. Improve the Enum Config concern to support the overloaded enum i18n name
+
+## v0.4
+1. Improve the Enum List concern to add the .``lookup`` method

data/lib/progne_tapera/enum_list.rb

@@ -57,6 +57,11 @@ module ProgneTapera::EnumList
       all.each &block
     end
 
+    # Lookup
+    def lookup(code)
+      select { |item| item.code==code }.first
+    end
+
     # Form Option
     def form_options(&block)
       items = block_given? ? selected(&block) : selected

data/lib/progne_tapera/version.rb

@@ -1,3 +1,3 @@
 module ProgneTapera
-  VERSION = '0.3'
+  VERSION = '0.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: progne_tapera
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: '0.4'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-21 00:00:00.000000000 Z
+date: 2016-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails