easy_model 1.0.2 → 1.0.3

data/README.rdoc

@@ -1,34 +1,81 @@
 = easy_model
 
-データベースに依存しないモデルの基本クラスや, ActiveRecord と同じ型変換を行う属性定義メソッドを提供します.
+データベースに関連付かないモデルの基本クラスや,
+代入時に ActiveRecord と同じ型変換が行われる属性を定義する機能を提供します.
 
-== データベースに依存しないモデル
+== データベースに関連付かないモデル, 属性
 
-EasyModel::Base クラスを継承することでデータベースに依存しないモデルを手軽に作成できます.
-column メソッドを利用することで, ActiveRecord と同じ型変換が行われる属性を定義することができます.
-例として, 会員のログイン情報を保持するモデルは以下のように定義することができます.
+Rails3 ではネーミングルールやバリデーションを扱う機能がモジュール分けされているため,
+それらのモジュールを再利用することでデータベースに関連付かないモデルを作成することができます.
+コーディング自体は簡単ですが, いくつもあるモジュールを include するコードを何度も書くことは手間です.
+
+EasyModel::Base はデータベースに関連付かないモデルの基本クラスです.
+以下のように EasyModel::Base を継承すれば, そのような手間を省くことができます.
+
+    #
+    # ログインフォーム.
+    #
+    class LoginForm < EasyModel::Base
+
+      ...
+
+    end
+
+属性を定義する場合は, 以下のように attr_accessor ではなく column メソッドを利用すると便利です.
+column メソッドを利用すると, 属性の型とデフォルト値を指定することができます.
 
     #
-    # 会員ログインフォーム.
+    # ログインフォーム.
     #
-    class UserLoginForm < EasyModel::Base
+    class LoginForm < EasyModel::Base
 
       # 会員番号.
       column :member_no, :integer
-      validates :member_no, :presence => true
+
+      validates :member_no,
+                :presence     => true,
+                :numericality => {:only_integer => true}
 
       # パスワード.
       column :password, :string
-      validates :password, :presence => true
+
+      validates :password,
+                :presence => true
 
       # ログイン状態を保持する (デフォルトは true).
       column :remember, :boolean, :default => true
 
     end
 
+column メソッドで定義した属性は, 代入時に ActiveRecord と同様の型変換が行われます.
+
+    login_form = LoginForm.new(:member_no => '1234567',
+                               :password  => 'PASSWORD',
+                               :remember  => 'false')
+
+    login_form.member_no                  # => 1234567
+    login_form.member_no_before_type_cast # => '1234567'
+    login_form.password                   # => 'PASSWORD'
+    login_form.password_before_type_cast  # => 'PASSWORD'
+    login_form.remember                   # => false
+    login_form.remember_before_type_cast  # => 'false'
+
+データベースのテーブルに関連付いているモデルでも column メソッドを利用したい場合は,
+EasyModel::Column モジュールを include します.
+
+    class User < ActiveRecord::Base
+
+      include EasyModel::Column
+
+      column ...
+
+    end
+
+
+
 == 検索フォーム
 
-検索フォームを表すモデルを作成する場合は, EasyModel::SearchForm を継承すると便利です.
+検索フォームを表すモデルを作成する場合は, EasyModel::SearchForm を利用すると便利です.
 EasyModel::SearchForm は EasyModel::Base に検索用に便利な機能を追加したクラスです.
 EasyModel::SearchForm を継承したクラスは ActiveRecord::Relation を返す scoped メソッドを定義する必要があります.
 
@@ -42,8 +89,9 @@ EasyModel::SearchForm を継承したクラスは ActiveRecord::Relation を返
       # 会員名.
       column :name, :string
 
-      # 会員ステータス.
+      # ステータス.
       column :status, :integer
+
       validates :status, :inclusion => [1, 2, 3]
 
       #
@@ -56,7 +104,7 @@ EasyModel::SearchForm を継承したクラスは ActiveRecord::Relation を返
         scoped = scoped.where(:name => name) if self.name.present?
         scoped = scoped.where(:status => status) if self.status.present?
 
-        # 検索条件を含む scope
+        # 検索条件を含む scope を返す.
         scoped
       end
 

data/VERSION

@@ -1 +1 @@
-1.0.2
+1.0.3

data/easy_model.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "easy_model"
-  s.version = "1.0.2"
+  s.version = "1.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["SUZUKI Kei"]
-  s.date = "2012-07-28"
+  s.date = "2012-07-30"
   s.description = "\u{30c7}\u{30fc}\u{30bf}\u{30d9}\u{30fc}\u{30b9}\u{306b}\u{4f9d}\u{5b58}\u{3057}\u{306a}\u{3044}\u{30e2}\u{30c7}\u{30eb}\u{306e}\u{57fa}\u{672c}\u{30af}\u{30e9}\u{30b9}\u{3084}, ActiveRecord \u{3068}\u{540c}\u{3058}\u{578b}\u{5909}\u{63db}\u{3092}\u{884c}\u{3046}\u{5c5e}\u{6027}\u{5b9a}\u{7fa9}\u{30e1}\u{30bd}\u{30c3}\u{30c9}\u{3092}\u{63d0}\u{4f9b}\u{3057}\u{307e}\u{3059}."
   s.email = "info-techscore@synergy101.jp"
   s.extra_rdoc_files = [

data/lib/easy_model/column.rb

@@ -40,8 +40,14 @@ module EasyModel::Column::ClassMethods
   def column(name, type, options={})
     ActiveRecord::ConnectionAdapters::Column.new(name, options[:default], type, true).tap do |column|
       define_method("#{name}=") do |value|
+        value = nil if column.number? and value.kind_of?(String) and value.blank?
+        instance_variable_set("@#{name}_before_type_cast", value)
         instance_variable_set("@#{name}", column.type_cast(value))
       end
+      define_method("#{name}_before_type_cast") do
+        instance_variable_set("@#{name}_before_type_cast", column.default) unless instance_variable_defined?("@#{name}_before_type_cast")
+        instance_variable_get("@#{name}_before_type_cast")
+      end
       define_method(name) do
         instance_variable_set("@#{name}", column.default) unless instance_variable_defined?("@#{name}")
         instance_variable_get("@#{name}")

data/test/easy_model/test_column.rb

@@ -7,7 +7,36 @@ class EasyModel::TestColumn < Test::Unit::TestCase
   def test_has_column_method
     model = Class.new
     model.send(:include, EasyModel::Column)
+    model.send(:column, :integer_column, :integer)
     assert model.protected_methods.include?(:column)
+
+    object = model.new
+    assert object.respond_to?(:integer_column)
+    assert object.respond_to?(:integer_column=)
+    assert object.respond_to?(:integer_column_before_type_cast)
+  end
+
+  def test_before_type_cast
+    model = Class.new
+    model.send(:include, EasyModel::Column)
+    model.send(:column, :integer_column, :integer)
+    object = model.new
+
+    object.integer_column = ''
+    assert_nil object.integer_column
+    assert_nil object.integer_column_before_type_cast
+
+    object.integer_column = '777'
+    assert_equal 777, object.integer_column
+    assert_equal '777', object.integer_column_before_type_cast
+
+    object.integer_column = true
+    assert_equal 1, object.integer_column
+    assert_equal true, object.integer_column_before_type_cast
+
+    object.integer_column = false
+    assert_equal 0, object.integer_column
+    assert_equal false, object.integer_column_before_type_cast
   end
 
   def test_string_column

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easy_model
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-28 00:00:00.000000000 Z
+date: 2012-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
-  requirement: &74044560 !ruby/object:Gem::Requirement
+  requirement: &71228770 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *74044560
+  version_requirements: *71228770
 - !ruby/object:Gem::Dependency
   name: activerecord
-  requirement: &74044160 !ruby/object:Gem::Requirement
+  requirement: &71228330 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *74044160
+  version_requirements: *71228330
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &74043530 !ruby/object:Gem::Requirement
+  requirement: &71227660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '3.12'
   type: :development
   prerelease: false
-  version_requirements: *74043530
+  version_requirements: *71227660
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &74042540 !ruby/object:Gem::Requirement
+  requirement: &71226630 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *74042540
+  version_requirements: *71226630
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &74041700 !ruby/object:Gem::Requirement
+  requirement: &71225660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: 1.8.4
   type: :development
   prerelease: false
-  version_requirements: *74041700
+  version_requirements: *71225660
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &74038960 !ruby/object:Gem::Requirement
+  requirement: &71224630 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,7 +76,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *74038960
+  version_requirements: *71224630
 description: データベースに依存しないモデルの基本クラスや, ActiveRecord と同じ型変換を行う属性定義メソッドを提供します.
 email: info-techscore@synergy101.jp
 executables: []
@@ -114,7 +114,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -297077907
+      hash: -442526499
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: