flextures 0.9.5 → 1.0.1

data/README.ja.rdoc

@@ -0,0 +1,113 @@
+= flextures
+
+== Abstruct
+
+このplug-inは、これまで開発中で溜まっていた
+Rails標準のfixtureの不満点を解消するために作成しました
+基本的な操作は単純で次のコマンドで
+それぞれfixtureのロードとダンプを行います
+
+ rake db:flextures:load
+ rake db:flextures:dump
+
+通常のfixtureとの主な違いは次の４点です
+
+1. yamlよりもcsvを優先する
+2. migrationでテーブル構成が変わっても、ロードを停止しないで、カラムの変更点を検知して値を補完する
+3. テーブル名と、fixtureのファイル名を一致させないでも自由なロード＆ダンプが出来る機能
+4. FactoyGirl風の読み込みフィルタで、Fixtureのデータを加工しながら読み込む事が出来る
+
+== インストール方法
+
+RailsのPlug-inとして使われることを想定しています
+gem化されているので、bundlerで次のように記述して、普通にbundle install してください
+
+ gem "flextures"
+
+ちなみに開発環境はruby1.9系、rails3環境を想定しています
+
+== 使い方
+
+=== rakeコマンド
+
+次のコマンドで spec/fixtures/ 以下にあるfixtureのロード＆ダンプを行います
+(ディレクトリは設定ファイルで変更可能)
+
+ rake db:flextures:load
+ rake db:flextures:dump
+
+rake コマンドには以下の様な書式でオプションを指定することができます
+指摘出来るオプションは、ロードとダンプで共通です
+
+テーブル名で吐き出し(Userモデルusers)
+
+ rake db:flextures:dump TABLE=users
+
+Usersモデルのfixture(users.csvか　users.yml)をロードする
+
+ rake db:flextures:load MODEL=User
+
+その他オプションは以下のとおりな感じです:
+
+ TABLE : テーブル名を指定してロード。テーブル名はカンマ切りで複数指定が可能
+ MODEL : モデル名を指定してロード。モデル名はカンマ区切りで複数指定が可能
+ DIR : フィクスチャをロード＆ダンプするディレクトリを指定する
+ FIXTURES : ロード、ダンプをするファイル名をRails標準以外のもので直接指定(Userモデルのusers.csv以外を指定)
+ T : TABLEのエイリアス
+ M : モデル名指定のエイリアス
+ D : ディレクトリ指定のエイリアス
+ F : ファイル名指定のエイリアス
+
+yamlのファイルはロードしたいけどcsvはロードをしたくない
+またはその逆の場合は、以下のコマンドでそれが可能です
+ 
+ rake db:flextures:csvload
+ rake db:flextures:ymlload
+ rake db:flextures:csvdump
+ rake db:flextures:ymldump
+
+通常の load や dump で使えるオプションはこちらでも使用可能です
+
+=== RSpec flexture support
+
+RSpec中でfixtures関数の代わりにfixtureのロード機能を使えます
+基本的な機能は、通常のfixturesと同じですので、fixtures と同じ感覚で使用して下さい
+
+ describe ItemShopController do
+   flextures :users, :items
+
+基本的な違いは、yamlよりcsvを優先する、カラムの変更点を検知して警告を出しながらもロードを行う等ですが
+もう一つ、ハッシュ引数で指定する事で、テーブル名、ファイル名を一致させなくても フィクスチャ を読み込ませることができます
+そのため、すべてのテストケースで依存関係を気にしながら共通のfixtureを使わなくても良い様に出来ます
+
+ describe ItemShopController do
+   flextures :items, :users => :users_for_itmshop # users_for_itemshop.csv をロードする
+
+=== Flextures factory filter
+
+Railsのプロジェクトに config/flextures.factory.rb というファイルを作成して、そこにフィルタを記述することによって
+フィクスチャの読み込み時に、値を加工して読み込む事が可能になっています
+例えば、次の様に記述するとusersテーブルのlast_login_dateの値を、常に現在の時間として設定できます
+
+ Flextures::Factory.define :users do |f| 
+   f.last_login_date = DateTime.now
+ end
+
+テーブルにdefaultとか設定していなくても
+カラムのデータとかを、適当に補完する機能があるので
+Faker等のデータ生成系のライブラリと組み合わせて必要なデータだけ自動生成すると
+今までより若干捗るかもしれません
+
+=== 設定ファイル
+
+config/flextures.config.rb　で設定ファイルを作成すると、データをロード＆ダンプするディレクトリなどの設定を変更できます
+
+ # config/flextures.config.rb
+ module Flextures
+   # test/fixtures/ のフィクスチャを読み出したい場合は吐き出しディレクトリの値を上書きする
+   Config.fixture_load_directory = "test/fixtures/"
+   Config.fixture_dump_directory = "test/fixtures/"
+ end
+
+
+

data/README.rdoc

@@ -2,94 +2,105 @@
 
 == Abstruct
 
-このplug-inは、これまで開発中で溜まっていた
-Rails標準のfixtureの不満点を解消するために作成しました
-基本的な操作は単純で次のコマンドで
-それぞれfixtureのロードとダンプを行います
+This plug-in aim to resolve many problems, durling rails developping about fixtures.
+Basic commands is simple.
+Each commands load or dump fixtures.
 
  rake db:flextures:load
  rake db:flextures:dump
 
-通常のfixtureとの主な違いは次の４点です
+Major different point is four.
 
-1. yamlよりもcsvを優先する
-2. migrationでテーブル構成が変わっても、ロードを停止しないで、カラムの変更点を検知して値を補完する
-3. テーブル名と、fixtureのファイル名を一致させないでも自由なロード＆ダンプが出来る機能
-4. FactoyGirl風の読み込みフィルタで、Fixtureのデータを加工しながら読み込む事が出来る
+1. Fixture file is prefered CSV to YAML.
+2. Don't stop load if table colums are'nt match fixture file's column.
+3. Fixture file name can change if file name is not equal table name. 
+4. Fixture data translate to use filter like factory girl.
 
-== インストール方法
+== How to install
 
-RailsのPlug-inとして使われることを想定しています
-gem化されているので、bundlerで次のように記述して、普通にbundle install してください
+This program is implemented Rails Plug-in.
+You want to install this plug-in.
+Please use bundler.
 
  gem "flextures"
 
-ちなみに開発環境はruby1.9.2、rails3環境を想定しています
+(Development emnvoriment must be ruby1.9 and rails3)
 
-== 使い方
+== How to use
 
-=== rakeコマンド
+=== rake command
 
-次のコマンドでfixturesspec/fixtures/ 以下にあるfixtureのロード＆ダンプを行います
-(ディレクトリは設定ファイルで変更可能)
+load command input fixtures file under "spec/fixtures/".
+(Loading directory can change configuration file)
 
  rake db:flextures:load
  rake db:flextures:dump
 
-rake コマンドには以下の様な書式でオプションを指定することができます
-指摘出来るオプションは、ロードとダンプで共通です
-
-テーブル名で吐き出し(Userモデルusers)
+rake command can set options.
+For example, this option set dump file name.
+(Option dump only "users.csv")
 
  rake db:flextures:dump TABLE=users
 
-Usersモデルのfixture(users.csvか　users.yml)をロードする
+If you use this option load command.
+Option set load file name.
+(loading "users.csv" or "users.yml")
 
  rake db:flextures:load MODEL=User
 
-その他オプションは以下のとおりな感じです:
+Other options...
 
- TABLE : テーブル名を指定してロード。テーブル名はカンマ切りで複数指定が可能
- MODEL : モデル名を指定してロード。モデル名はカンマ区切りで複数指定が可能
- DIR : フィクスチャをロード＆ダンプするディレクトリを指定する
- FILE : ロード、ダンプをするファイル名をRails標準以外のもので直接指定(Userモデルのusers.csv以外を指定)
- T : TABLEのエイリアス
- M : モデル名指定のエイリアス
- D : ディレクトリ指定のエイリアス
- F : ファイル名指定のエイリアス
+ TABLE : set table name
+ MODEL : set model name
+ DIR : set directory name
+ FIXTURES : set fixture file name
+ T : alias TABLE option
+ M : alias MODEL option
+ D : alias DIR option
+ F : alias FIXTURES option
 
-yamlのファイルはロードしたいけどcsvはロードをしたくない
-またはその逆の場合は、以下のコマンドでそれが可能です
+if you only load CSV file or YAML file, next command can load.
  
  rake db:flextures:csvload
  rake db:flextures:ymlload
  rake db:flextures:csvdump
  rake db:flextures:ymldump
 
-通常の load や dump で使えるオプションはこちらでも使用可能です
-
 === RSpec flexture support
 
-RSpec中でfixtures関数の代わりにfixtureのロード機能を使えます
-基本的な機能は、通常のfixturesと同じですので、fixtures と同じ感覚で使用して下さい
+Fixture load function implemented for RSpec.
 
  describe ItemShopController do
    flextures :users, :items
 
-基本的な違いは、yamlよりcsvを優先する、カラムの変更点を検知して警告を出しながらもロードを行う等ですが
-もう一つ、ハッシュ引数で指定する事で、テーブル名、ファイル名を一致させなくても フィクスチャ を読み込ませることができます
-そのため、すべてのテストケースで依存関係を気にしながら共通のfixtureを使わなくても良い様に出来ます
+flexture function can write like a "fixture" function, implemented in RSpec.
+But, "flexture" function ignore columns change.
+
+Flextures function can change load file name.
 
  describe ItemShopController do
-   flextures :items, :users => :users_for_itmshop # users_for_itemshop.csv をロードする
+   flextures :items, :users => :users_for_itmshop # load "users_for_itemshop.csv"
 
 === Flextures factory filter
 
-Railsのプロジェクトに config/flextures.factory.rb というファイルを作成して、そこにフィルタを記述することによって
-フィクスチャの読み込み時に、値を加工して読み込む事が可能になっています
-例えば、次の様に記述するとusersテーブルのlast_login_dateの値を、常に現在の時間として設定できます
+If you create filter file.(File name is "config/flextures.factory.rb")
+Factory filter translate fixture data and set database.
+
+For example, this code set current time to last_login_date column.
 
  Flextures::Factory.define :users do |f| 
    f.last_login_date = DateTime.now
  end
 
+=== Configuration file
+
+Configuration file can change load and dump directory
+(file is confi/flextures.config.rb)
+
+ # config/flextures.config.rb
+ module Flextures
+   # Load and dump directory change "spec/fixtures/" to "test/fixtures/"
+   Config.fixture_load_directory = "test/fixtures/"
+   Config.fixture_dump_directory = "test/fixtures/"
+ end
+

data/VERSION

@@ -1 +1 @@
-0.9.5
+1.0.1

data/flextures.gemspec

@@ -5,15 +5,16 @@
 
 Gem::Specification.new do |s|
   s.name = %q{flextures}
-  s.version = "0.9.5"
+  s.version = "1.0.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["baban"]
-  s.date = %q{2011-11-08}
+  s.date = %q{2011-11-24}
   s.description = %q{load and dump fixtures}
   s.email = %q{babanba.n@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE.txt",
+    "README.ja.rdoc",
     "README.rdoc"
   ]
   s.files = [
@@ -23,6 +24,7 @@ Gem::Specification.new do |s|
     "Gemfile.lock",
     "History.txt",
     "LICENSE.txt",
+    "README.ja.rdoc",
     "README.rdoc",
     "Rakefile",
     "VERSION",

data/lib/flextures.rb

@@ -5,6 +5,6 @@ require 'flextures/flextures_extension_modules'
 require 'flextures/flextures'
 require 'flextures/flextures_factory'
 require 'flextures/flextures_railtie' if defined? Rails
-require 'flextures/rspec_flextures_support'
-require 'flextures/testunit_flextures_support'
+require 'flextures/rspec_flextures_support' if defined? RSpec
+require 'flextures/testunit_flextures_support' if defined? Test::Unit::TestCase
 

data/lib/flextures/flextures.rb

@@ -40,8 +40,8 @@ module Flextures
       table_names = ActiveRecord::Base.connection.tables if ""==table_names
       table_names = table_names.map{ |name| { table: name } }
       table_names = table_names.map{ |option| option.merge dir: ENV["DIR"] } if ENV["DIR"]
-      table_names.first[:file]= ENV["FILE"] if ENV["FILE"] # ファイル名は最初のものしか指定できない
-      table_names.first[:file]= ENV["F"] if ENV["F"]
+      table_names.first[:file] = ENV["FIXTURES"] if ENV["FIXTURES"] # ファイル名は最初のものしか指定できない
+      table_names.first[:file] = ENV["F"] if ENV["F"]
       # read mode だとcsvもyaml存在しないファイルは返さない
       table_names.select! &exist if option[:mode] && option[:mode].to_sym == :read 
       table_names
@@ -53,6 +53,7 @@ module Flextures
     end
   end
   
+  # データを吐き出す処理をまとめる  
   module Dumper
     PARENT = Flextures
 
@@ -103,6 +104,7 @@ module Flextures
     end
   end
 
+  # Dumperと違ってデータの吐き出し処理をまとめたクラス
   module Loader 
     PARENT = Flextures
 
@@ -222,7 +224,6 @@ module Flextures
         h
       }
     end
-
   end
 end
 

data/lib/flextures/testunit_flextures_support.rb

@@ -1,9 +1,9 @@
 # encoding: utf-8
 
 # shouda等へのfixture拡張
-module Test::Unit::TestCase  
-  def flextures *args
-    Flextures::Loader::flextures *args
+class Test::Unit::TestCase  
+  def self.flextures *args
+    setup{ Flextures::Loader::flextures *args }
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flextures
 version: !ruby/object:Gem::Version
-  version: 0.9.5
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-08 00:00:00.000000000 +09:00
+date: 2011-11-24 00:00:00.000000000 +09:00
 default_executable: 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &77137930 !ruby/object:Gem::Requirement
+  requirement: &90095980 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,10 +22,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *77137930
+  version_requirements: *90095980
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &77137690 !ruby/object:Gem::Requirement
+  requirement: &90095740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *77137690
+  version_requirements: *90095740
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &77137450 !ruby/object:Gem::Requirement
+  requirement: &90095500 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: 1.6.4
   type: :development
   prerelease: false
-  version_requirements: *77137450
+  version_requirements: *90095500
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &77137210 !ruby/object:Gem::Requirement
+  requirement: &90095260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -55,13 +55,14 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *77137210
+  version_requirements: *90095260
 description: load and dump fixtures
 email: babanba.n@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE.txt
+- README.ja.rdoc
 - README.rdoc
 files:
 - .document
@@ -70,6 +71,7 @@ files:
 - Gemfile.lock
 - History.txt
 - LICENSE.txt
+- README.ja.rdoc
 - README.rdoc
 - Rakefile
 - VERSION
@@ -101,7 +103,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 13889423
+      hash: -767338093
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: