db_reference 0.0.2 → 0.0.3

data/Rakefile

@@ -35,12 +35,45 @@ PKG_FILES = FileList[
 
 spec = Gem::Specification.new do |s|
   s.name = "db_reference"
-  s.version = "0.0.2"
+  s.version = "0.0.3"
   s.author = "Cam Fowler"
   s.email = "cameron.fowler@abletech.co.nz"
   s.homepage = "http://www.abletech.co.nz/"
   s.platform = Gem::Platform::RUBY
   s.summary = "Loads files from db/reference/"
+  s.description = """
+Reference
+=========
+
+Used for creating a predefined set of models, similar to db:seed, but will not repopulate if entries already exist.
+
+Place references in 'db/reference/'
+References will be loaded in ascending order, so if an order is desired, prepend 000, 001, 002... etc to the filename.
+
+Run with:
+  rake reference:load
+
+Example
+=======
+
+The below example ensures that there are 6 locations existing in the database after running the 'rake reference:load'
+
+
+# db/schema.rb
+create_table 'locations', :force => true do |t|
+  t.string 'name', :null => false
+end
+
+
+# db/reference/000_locations.rb
+Location.update_or_create :id => 1, :name => 'Wellington City'
+Location.update_or_create :id => 2, :name => 'Lower Hutt'
+Location.update_or_create :id => 3, :name => 'Kapiti Coast'
+Location.update_or_create :id => 4, :name => 'Porirua'
+Location.update_or_create :id => 5, :name => 'Upper Hutt'
+Location.update_or_create :id => 6, :name => 'Wairarapa'
+
+  """
   s.files = PKG_FILES.to_a
   s.require_path = "lib"
   s.has_rdoc = false

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: db_reference
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Cam Fowler
@@ -19,7 +19,26 @@ date: 2010-12-20 00:00:00 +13:00
 default_executable: 
 dependencies: []
 
-description: 
+description: "\n\
+  Reference\n\
+  =========\n\n\
+  Used for creating a predefined set of models, similar to db:seed, but will not repopulate if entries already exist.\n\n\
+  Place references in 'db/reference/'\n\
+  References will be loaded in ascending order, so if an order is desired, prepend 000, 001, 002... etc to the filename.\n\n\
+  Run with:\n  rake reference:load\n\n\
+  Example\n\
+  =======\n\n\
+  The below example ensures that there are 6 locations existing in the database after running the 'rake reference:load'\n\n\n\
+  # db/schema.rb\n\
+  create_table 'locations', :force => true do |t|\n  t.string 'name', :null => false\n\
+  end\n\n\n\
+  # db/reference/000_locations.rb\n\
+  Location.update_or_create :id => 1, :name => 'Wellington City'\n\
+  Location.update_or_create :id => 2, :name => 'Lower Hutt'\n\
+  Location.update_or_create :id => 3, :name => 'Kapiti Coast'\n\
+  Location.update_or_create :id => 4, :name => 'Porirua'\n\
+  Location.update_or_create :id => 5, :name => 'Upper Hutt'\n\
+  Location.update_or_create :id => 6, :name => 'Wairarapa'\n\n  "
 email: cameron.fowler@abletech.co.nz
 executables: []