legacy_data 0.1.9 → 0.1.10

data/README.md

@@ -0,0 +1,88 @@
+# Legacy Data
+
+Getting started on a Rails project with a large existing database can be daunting.  How to you extract all the information that's 
+encoded in the database?  Do you have to understand the entire data model before you get started?  The `models_from_tables` generator 
+in the `legacy_data` gem can help!  This generator looks into your existing database and generates ActiveRecord models based on the 
+information encoded in it.
+
+
+## How to use it
+
+- To generate an ActiveRecord model for each table in the database just type
+
+  `script/generate script/generate models_from_tables`
+
+- If you don't want all tables in the database tell it which table to model
+ 
+  `script/generate script/generate models_from_tables --table-name comments`
+  
+  This uses any foreign_key constraints in the database to spider the database and model the comments table and all associated tables.
+  
+- If you *really* only want the comments table tell it not to follow any foreign_keys
+
+  `script/generate script/generate models_from_tables --table-name comments --skip-associated`
+
+- If you use [factory girl](http://github.com/thoughtbot/factory_girl) it will generate a simple factory for each model it generates
+
+  `script/generate script/generate models_from_tables --table-name comments --with-factories`
+
+(You do need to install the plugin `gem install legacy_data` as long as http://gemcutter.org is one of your gem sources)
+
+### Examples
+
+Several examples come with the gem source in the [examples](http://github.com/alexrothenberg/legacy_data/tree/master/examples/) folder.  These include 
+
+- A simple blog database tested with MySQL and Sqlite3
+- The Drupal 6.14 database tested with MySQL
+- The J2EE Petstore example tested with MySQL, Sqlite3 and Oracle
+
+## What kind of information can it extract from the database?
+
+### Associations
+
+If the database contains foreign_key constraints it uses them to build `has_many` or `belongs_to` associations
+in your ActiveRecord models
+
+### Validation constraints
+
+It will generate the following types of validation constraints in your models
+
+- **validates_uniqueness_of**   - For columns where the database has an index that enforces uniqueness
+- **validates_presence_of**     - When the database column is non-nullable
+- **validates_inclusion_of**    - For non-nullable boolean columns and custom constraints with a SQL rule "flag IN ('Y', 'N')"
+- **validates_numericality_of** - For integer columns (nullable and non-nullable)
+- **custom validation**         - For custom SQL validation rules in the database it puts a placeholder in your model with the original SQL for you to translate into Ruby
+
+###Non-Rails naming conventions
+
+Since the database is existing it's likely that it doesn't follow Rails naming conventions.  Not to worry as the generator will 
+put the non-standard name into the generated models if it needs to.  
+
+What kinds of non-standard names can it generate?
+
+Let's look at a sample output
+
+<pre><code>
+class Post < ActiveRecord::Base
+
+  set_table_name  :tbpost
+  set_primary_key :postid
+  
+  # Relationships
+  has_many :comments, :foreign_key => :postid
+
+  # Constraints
+  validates_presence_of :title, :body
+  
+end
+</code></pre>
+
+- **Class Names**  - It named the model *Post* instead of the Rails convention *Tbpost*. The generator could not do this itself but knowing the conventions will often not apply to legacy databases it pauses after spidering the database giving you a chance to override the table to class name mapping.  It generates a yaml file `app/models/table_mappings.yml` where you can verify or change any class name before  proceeding to generate the models. 
+- **Table Names**  - It overrode the table name since the actual name *tbpost* does not match the Rails naming convention *posts*
+- **Primary Keys** - It overrode the primary key since the actual column *postid* does not match the Rails naming convention *id*
+- **Foreign Keys** - It overrode the foreign key on the comment table to be *postid* instead of the Rails naming convention *id*
+
+
+# Copyright
+
+Copyright (c) 2009 Alex Rothenberg. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-0.1.9
+0.1.10

data/examples/README

@@ -0,0 +1,11 @@
+This directory contains examples showing what the generator can do.  
+The generator is validated against these examples when its functional test suite is run.
+
+There are 3 examples
+
+* A simple blog database tested with MySQL and Sqlite3
+* The Drupal 6.14 database tested with MySQL
+* The J2EE Petstore example tested with MySQL, Sqlite3 and Oracle
+
+They have been tested with MySQL, Sqlite3 and Oracle and the pregenerated output is available in the 
+generated directory with the example and database name part of the subdirectory name.

data/examples/generated/blog_mysql/comment.rb

@@ -1,7 +1,5 @@
 class Comment < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   belongs_to :post, :dependent => :destroy, :foreign_key => :post_id
 

data/examples/generated/blog_mysql/post.rb

@@ -1,7 +1,5 @@
 class Post < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   has_and_belongs_to_many :tags, :association_foreign_key => :tag_id, :foreign_key => :post_id, :join_table => :post_tags
 

data/examples/generated/blog_mysql/tag.rb

@@ -1,7 +1,5 @@
 class Tag < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   has_and_belongs_to_many :posts, :association_foreign_key => :post_id, :foreign_key => :tag_id, :join_table => :post_tags
 

data/examples/generated/blog_sqlite3/comment.rb

@@ -1,7 +1,5 @@
 class Comment < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   
 

data/examples/generated/blog_sqlite3/post.rb

@@ -1,7 +1,5 @@
 class Post < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   
 

data/examples/generated/blog_sqlite3/tag.rb

@@ -1,7 +1,5 @@
 class Tag < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/access.rb

@@ -1,7 +1,7 @@
 class Access < ActiveRecord::Base
   set_table_name  :access
   set_primary_key :aid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/action.rb

@@ -1,7 +1,6 @@
 class Action < ActiveRecord::Base
-  
   set_primary_key :aid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/actions_aid.rb

@@ -1,7 +1,7 @@
 class ActionsAid < ActiveRecord::Base
   set_table_name  :actions_aid
   set_primary_key :aid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/authmap.rb

@@ -1,7 +1,7 @@
 class Authmap < ActiveRecord::Base
   set_table_name  :authmap
   set_primary_key :aid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/batch.rb

@@ -1,7 +1,7 @@
 class Batch < ActiveRecord::Base
   set_table_name  :batch
   set_primary_key :bid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/block.rb

@@ -1,7 +1,6 @@
 class Block < ActiveRecord::Base
-  
   set_primary_key :bid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/blocks_role.rb

@@ -1,7 +1,6 @@
 class BlocksRole < ActiveRecord::Base
-  
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/box.rb

@@ -1,7 +1,6 @@
 class Box < ActiveRecord::Base
-  
   set_primary_key :bid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache.rb

@@ -1,7 +1,7 @@
 class Cache < ActiveRecord::Base
   set_table_name  :cache
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_block.rb

@@ -1,7 +1,7 @@
 class CacheBlock < ActiveRecord::Base
   set_table_name  :cache_block
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_filter.rb

@@ -1,7 +1,7 @@
 class CacheFilter < ActiveRecord::Base
   set_table_name  :cache_filter
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_form.rb

@@ -1,7 +1,7 @@
 class CacheForm < ActiveRecord::Base
   set_table_name  :cache_form
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_menu.rb

@@ -1,7 +1,7 @@
 class CacheMenu < ActiveRecord::Base
   set_table_name  :cache_menu
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_page.rb

@@ -1,7 +1,7 @@
 class CachePage < ActiveRecord::Base
   set_table_name  :cache_page
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/cache_update.rb

@@ -1,7 +1,7 @@
 class CacheUpdate < ActiveRecord::Base
   set_table_name  :cache_update
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/comment.rb

@@ -1,7 +1,6 @@
 class Comment < ActiveRecord::Base
-  
   set_primary_key :cid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/filter.rb

@@ -1,7 +1,6 @@
 class Filter < ActiveRecord::Base
-  
   set_primary_key :fid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/filter_format.rb

@@ -1,7 +1,6 @@
 class FilterFormat < ActiveRecord::Base
-  
   set_primary_key :format
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/flood.rb

@@ -1,7 +1,7 @@
 class Flood < ActiveRecord::Base
   set_table_name  :flood
   set_primary_key :fid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/history.rb

@@ -1,7 +1,7 @@
 class History < ActiveRecord::Base
   set_table_name  :history
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/menu_custom.rb

@@ -1,7 +1,7 @@
 class MenuCustom < ActiveRecord::Base
   set_table_name  :menu_custom
   set_primary_key :menu_name
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/menu_link.rb

@@ -1,7 +1,6 @@
 class MenuLink < ActiveRecord::Base
-  
   set_primary_key :mlid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/menu_router.rb

@@ -1,7 +1,7 @@
 class MenuRouter < ActiveRecord::Base
   set_table_name  :menu_router
   set_primary_key :path
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node.rb

@@ -1,7 +1,7 @@
 class Node < ActiveRecord::Base
   set_table_name  :node
   set_primary_key :nid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node_access.rb

@@ -1,7 +1,7 @@
 class NodeAccess < ActiveRecord::Base
   set_table_name  :node_access
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node_comment_statistic.rb

@@ -1,7 +1,6 @@
 class NodeCommentStatistic < ActiveRecord::Base
-  
   set_primary_key :nid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node_counter.rb

@@ -1,7 +1,7 @@
 class NodeCounter < ActiveRecord::Base
   set_table_name  :node_counter
   set_primary_key :nid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node_revision.rb

@@ -1,7 +1,6 @@
 class NodeRevision < ActiveRecord::Base
-  
   set_primary_key :vid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/node_type.rb

@@ -1,7 +1,7 @@
 class NodeType < ActiveRecord::Base
   set_table_name  :node_type
   set_primary_key :type
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/permission.rb

@@ -1,7 +1,7 @@
 class Permission < ActiveRecord::Base
   set_table_name  :permission
   set_primary_key :pid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/role.rb

@@ -1,7 +1,7 @@
 class Role < ActiveRecord::Base
   set_table_name  :role
   set_primary_key :rid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/session.rb

@@ -1,7 +1,6 @@
 class Session < ActiveRecord::Base
-  
   set_primary_key :sid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/system.rb

@@ -1,7 +1,7 @@
 class System < ActiveRecord::Base
   set_table_name  :system
   set_primary_key :filename
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/term_data.rb

@@ -1,7 +1,7 @@
 class TermData < ActiveRecord::Base
   set_table_name  :term_data
   set_primary_key :tid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/term_hierarchy.rb

@@ -1,7 +1,7 @@
 class TermHierarchy < ActiveRecord::Base
   set_table_name  :term_hierarchy
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/term_node.rb

@@ -1,7 +1,7 @@
 class TermNode < ActiveRecord::Base
   set_table_name  :term_node
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/term_relation.rb

@@ -1,7 +1,7 @@
 class TermRelation < ActiveRecord::Base
   set_table_name  :term_relation
   set_primary_key :trid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/term_synonym.rb

@@ -1,7 +1,7 @@
 class TermSynonym < ActiveRecord::Base
   set_table_name  :term_synonym
   set_primary_key :tsid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/uploaded_files.rb

@@ -1,7 +1,7 @@
 class UploadedFiles < ActiveRecord::Base
   set_table_name  :files
   set_primary_key :fid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/url_alias.rb

@@ -1,7 +1,7 @@
 class UrlAlias < ActiveRecord::Base
   set_table_name  :url_alias
   set_primary_key :pid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/user.rb

@@ -1,7 +1,6 @@
 class User < ActiveRecord::Base
-  
   set_primary_key :uid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/users_role.rb

@@ -1,7 +1,6 @@
 class UsersRole < ActiveRecord::Base
-  
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/variable.rb

@@ -1,7 +1,7 @@
 class Variable < ActiveRecord::Base
   set_table_name  :variable
   set_primary_key :name
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/vocabulary.rb

@@ -1,7 +1,7 @@
 class Vocabulary < ActiveRecord::Base
   set_table_name  :vocabulary
   set_primary_key :vid
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/vocabulary_node_type.rb

@@ -1,7 +1,6 @@
 class VocabularyNodeType < ActiveRecord::Base
-  
   set_primary_key :no_primary_key
-  
+
   # Relationships
   
 

data/examples/generated/drupal_mysql/watchdog.rb

@@ -1,7 +1,7 @@
 class Watchdog < ActiveRecord::Base
   set_table_name  :watchdog
   set_primary_key :wid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/address.rb

@@ -1,7 +1,7 @@
 class Address < ActiveRecord::Base
   set_table_name  :address
   set_primary_key :addressid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/category.rb

@@ -1,7 +1,7 @@
 class Category < ActiveRecord::Base
   set_table_name  :category
   set_primary_key :categoryid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/id_gen.rb

@@ -1,7 +1,7 @@
 class IdGen < ActiveRecord::Base
   set_table_name  :id_gen
   set_primary_key :gen_key
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/item.rb

@@ -1,7 +1,7 @@
 class Item < ActiveRecord::Base
   set_table_name  :item
   set_primary_key :itemid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/product.rb

@@ -1,7 +1,7 @@
 class Product < ActiveRecord::Base
   set_table_name  :product
   set_primary_key :productid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/seller_contact_info.rb

@@ -1,7 +1,7 @@
 class SellerContactInfo < ActiveRecord::Base
   set_table_name  :sellercontactinfo
   set_primary_key :contactinfoid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/tag.rb

@@ -1,7 +1,7 @@
 class Tag < ActiveRecord::Base
   set_table_name  :tag
   set_primary_key :tagid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/tag_item.rb

@@ -1,7 +1,6 @@
 class TagItem < ActiveRecord::Base
   set_table_name  :tag_item
   
-  
   # Relationships
   
 

data/examples/generated/j2ee_petstore_mysql/ziplocation.rb

@@ -1,7 +1,7 @@
 class Ziplocation < ActiveRecord::Base
   set_table_name  :ziplocation
   set_primary_key :zipcode
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_oracle/address.rb

@@ -1,7 +1,7 @@
 class Address < ActiveRecord::Base
   set_table_name  :address
   set_primary_key :addressid
-  
+
   # Relationships
   has_many :items, :foreign_key => :address_addressid
 

data/examples/generated/j2ee_petstore_oracle/category.rb

@@ -1,7 +1,7 @@
 class Category < ActiveRecord::Base
   set_table_name  :category
   set_primary_key :categoryid
-  
+
   # Relationships
   has_many :products, :foreign_key => :categoryid
 

data/examples/generated/j2ee_petstore_oracle/id_gen.rb

@@ -1,7 +1,7 @@
 class IdGen < ActiveRecord::Base
   set_table_name  :id_gen
   set_primary_key :gen_key
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_oracle/item.rb

@@ -1,7 +1,7 @@
 class Item < ActiveRecord::Base
   set_table_name  :item
   set_primary_key :itemid
-  
+
   # Relationships
   belongs_to :address,           :foreign_key => :address_addressid
   belongs_to :product,           :foreign_key => :productid

data/examples/generated/j2ee_petstore_oracle/product.rb

@@ -1,7 +1,7 @@
 class Product < ActiveRecord::Base
   set_table_name  :product
   set_primary_key :productid
-  
+
   # Relationships
   has_many :items, :foreign_key => :productid
   belongs_to :category, :foreign_key => :categoryid

data/examples/generated/j2ee_petstore_oracle/sellercontactinfo.rb

@@ -1,7 +1,7 @@
 class Sellercontactinfo < ActiveRecord::Base
   set_table_name  :sellercontactinfo
   set_primary_key :contactinfoid
-  
+
   # Relationships
   has_many :items, :foreign_key => :contactinfo_contactinfoid
 

data/examples/generated/j2ee_petstore_oracle/tag.rb

@@ -1,7 +1,7 @@
 class Tag < ActiveRecord::Base
   set_table_name  :tag
   set_primary_key :tagid
-  
+
   # Relationships
   has_and_belongs_to_many :items, :association_foreign_key => :itemid, :foreign_key => :tagid, :join_table => :tag_item
 

data/examples/generated/j2ee_petstore_oracle/ziplocation.rb

@@ -1,7 +1,7 @@
 class Ziplocation < ActiveRecord::Base
   set_table_name  :ziplocation
   set_primary_key :zipcode
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/address.rb

@@ -1,7 +1,7 @@
 class Address < ActiveRecord::Base
   set_table_name  :address
   set_primary_key :addressid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/category.rb

@@ -1,7 +1,7 @@
 class Category < ActiveRecord::Base
   set_table_name  :category
   set_primary_key :categoryid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/id_gen.rb

@@ -1,7 +1,7 @@
 class IdGen < ActiveRecord::Base
   set_table_name  :id_gen
   set_primary_key :gen_key
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/item.rb

@@ -1,7 +1,7 @@
 class Item < ActiveRecord::Base
   set_table_name  :item
   set_primary_key :itemid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/product.rb

@@ -1,7 +1,7 @@
 class Product < ActiveRecord::Base
   set_table_name  :product
   set_primary_key :productid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/seller_contact_info.rb

@@ -1,7 +1,7 @@
 class SellerContactInfo < ActiveRecord::Base
   set_table_name  :sellercontactinfo
   set_primary_key :contactinfoid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/tag.rb

@@ -1,7 +1,7 @@
 class Tag < ActiveRecord::Base
   set_table_name  :tag
   set_primary_key :tagid
-  
+
   # Relationships
   
 

data/examples/generated/j2ee_petstore_sqlite3/ziplocation.rb

@@ -1,7 +1,7 @@
 class Ziplocation < ActiveRecord::Base
   set_table_name  :ziplocation
   set_primary_key :zipcode
-  
+
   # Relationships
   
 

data/generators/models_from_tables/templates/model.rb

@@ -1,7 +1,7 @@
 class <%= definition.class_name -%> < ActiveRecord::Base
-  <%= "set_table_name  #{definition.table_name.downcase.to_sym.inspect}" if definition.unconventional_table_name?  %>
-  <%= "set_primary_key #{definition.primary_key.to_sym.inspect}"         if definition.unconventional_primary_key? %>
-  
+<%= "  set_table_name  #{definition.table_name.downcase.to_sym.inspect}\n" if definition.unconventional_table_name?  -%>
+<%= "  set_primary_key #{definition.primary_key.to_sym.inspect}\n"         if definition.unconventional_primary_key? -%>
+
   # Relationships
   <%= definition.relationships_to_s %>
 

data/legacy_data.gemspec

@@ -5,24 +5,25 @@
 
 Gem::Specification.new do |s|
   s.name = %q{legacy_data}
-  s.version = "0.1.9"
+  s.version = "0.1.10"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Alex Rothenberg"]
-  s.date = %q{2009-10-21}
+  s.date = %q{2009-11-05}
   s.description = %q{Create ActiveRecord models from an existing database}
   s.email = %q{alex@alexrothenberg.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc"
+     "README.md"
   ]
   s.files = [
     ".document",
      ".gitignore",
      "LICENSE",
-     "README.rdoc",
+     "README.md",
      "Rakefile",
      "VERSION",
+     "examples/README",
      "examples/blog_migration.rb",
      "examples/create_j2ee_petstore.sql",
      "examples/delete_j2ee_petstore.sql",

data/lib/legacy_data/table_class_name_mapper.rb

@@ -34,7 +34,8 @@ module LegacyData
       save_dictionary
       self.class.log <<-MSG
 Done analyzing the tables.  
-  Please review the class names shown above.  If any do not look correct (for example it did not separate the words with CamelCase) please supply the correct mappings by editing the file #{LegacyData::TableClassNameMapper.dictionary_file_name}.  
+  Automatic class names written to '#{LegacyData::TableClassNameMapper.dictionary_file_name}'
+  Since the database probably does not follow Rails naming conventions you should take a look at the class names and update them in that file. 
   Once you're done hit <enter> to continue generating the models"
       MSG
       gets

data/spec/expected/post.rb

@@ -1,7 +1,5 @@
 class Post < ActiveRecord::Base
-  
-  
-  
+
   # Relationships
   has_many :comments, :foreign_key => :comment_id
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: legacy_data
 version: !ruby/object:Gem::Version 
-  version: 0.1.9
+  version: 0.1.10
 platform: ruby
 authors: 
 - Alex Rothenberg
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-21 00:00:00 -04:00
+date: 2009-11-05 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -50,14 +50,15 @@ extensions: []
 
 extra_rdoc_files: 
 - LICENSE
-- README.rdoc
+- README.md
 files: 
 - .document
 - .gitignore
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
+- examples/README
 - examples/blog_migration.rb
 - examples/create_j2ee_petstore.sql
 - examples/delete_j2ee_petstore.sql

data/README.rdoc

@@ -1,49 +0,0 @@
-= legacy_data
-
-How can you start a rails project on top of a large legacy database ... use the legacy_data plugin.
-
-What if the database doesn't follow Rails/ActiveRecord naming conventions? ... not a problem
-What if there are a lot of tables? ... not a problem
-What about all the information contained in the database already (relationships, constraints, etc) ... they are extracted into your models
-
-Usage: script/generate models_from_tables [options]
-        table-name [ARG] Only generate models for tables starting with
-        table-naming-convention [ARG]
-                                     Naming convention for tables in the database. Only the wildcard is used when generating the model name
-
-Examples:
-* script/generate script/generate models_from_tables --table-naming-convention=tb*
-  Generate a model for each table in the database.  The tables all start with a tb (i.e. table 'tbperson' will generate the model 'person')
-* script/generate script/generate models_from_tables --table-name tbperson 
-  Generate a model for the 'tbperson' table in the database and all associated tables.  has_many and belongs_to will be generated in the models 
-
-== Usage
-
-* Create a new rails project with the admin data plugin
-  rails my_application -m http://gist.github.com/188172.txt
-* Configure your application to connect to your existing Oracle database.  Get the connect connect string from your dba (something like: user/password@server.example.com:1541/sid.world) and edit your config/database.yml
-development:
-  adapter: oracle_enhanced
-  database: my.oracle.server.com:1541/my_database.world
-  username: user_name
-  password: my_secret_password
-* Generate models for all existing tables
-  script/generate models_from_tables
-* Take a look
-  script/server
-  http://localhost:3000/admin_data
- 
-== Note on Patches/Pull Requests
- 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but
-   bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
-
-== Copyright
-
-Copyright (c) 2009 Alex Rothenberg. See LICENSE for details.