dr_nic_magic_models 0.9.0 → 0.9.1

data/History.txt

@@ -1,10 +1,19 @@
+*** 0.9.1 / 2007-4-11
+
++ 1 minor enhancement:
+    + ActiveRecord::Base includes all the magic model functionality via the MagicModel module
+    + Existing ARs can get magic validation via #generate_validations call
+    + Website tutorial works :D
+			
 *** 0.9.0 / 2007-4-9
 
 + 1 major enhancement:
         + Support for dynamic loading of classes again
 + 2 new DB supported:
         + Tests run on sqlite (no fk support)
-				+ Tests run on postgresql (fk support)
+        + Tests run on postgresql (fk support)
+            + Including FK bug fix
 + Many fixes that I've lost track of
 + History.txt to keep track of changes like these
 + Using Hoe for Rakefile
++ Use modules to specify common table prefixes

data/Manifest.txt

@@ -43,6 +43,7 @@ test/invisible_model_access_test.rb
 test/invisible_model_assoc_test.rb
 test/invisible_model_classes_test.rb
 test/magic_module_test.rb
+test/test_existing_model.rb
 website/index.html
 website/index.txt
 website/javascripts/rounded_corners_lite.inc.js

data/README

@@ -1,7 +1,6 @@
 See http://magicmodels.rubyforge.org/dr_nic_magic_models for pretty README
 
 Ugly README (from website/index.txt in Textile format):
-
 h1. Dr Nic's Magic Models
 
 If you've used Ruby on Rails you'll have written at least one model class like this:
@@ -70,10 +69,10 @@ Your application is now blessed with magical mystery.
 
 h2. David Copperfield eat your Ruby-crusted heart out
 
-Let's demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app:
+Let's demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app (example uses sqlite3, but use your favourite databas):
 
 <pre syntax="ruby">
-rails magic_show
+rails magic_show -d sqlite3
 cd magic_show
 ruby script/generate model Person
 ruby script/generate model Group
@@ -114,18 +113,12 @@ and <code>003_create_memberships.rb</code> with:
     end
 </pre>
 
-Now create your database. For MySql:
-<pre>
-mysqladmin -u root create magic_show_development
-mysqladmin -u root create magic_show_test
-</pre>
-
 And run your migrations to create the three tables:
 <pre>
-rake migrate
+rake db:migrate
 </pre>
 
-h2. And now for some "woofle dust":http://en.wikipedia.org/wiki/List_of_conjuring_terms ...
+h3. And now for some "woofle dust":http://en.wikipedia.org/wiki/List_of_conjuring_terms ...
 
 At the end of <code>config/environment.rb</code> add the following line:
 
@@ -146,6 +139,20 @@ end
 
 Nothing suspicious here. We have no validations and no associations. Just some plain old model classes.
 
+UPDATE: To turn on magic validations, you now need to invoke <code>generate_validations</code> on defined classes. So, update your model classes:
+
+<pre syntax="ruby">
+class Person < ActiveRecord::Base
+  generate_validations
+end
+class Group < ActiveRecord::Base
+  generate_validations
+end
+class Membership < ActiveRecord::Base
+  generate_validations
+end
+</pre>
+
 For this trick, we'll need an ordinary console session. Any old one lying around the house will do.
 
 <pre>
@@ -156,22 +163,24 @@ Now a normal model class is valid until you explicitly add <code>validates_xxx</
 With Dr Nic's Magic Models:
 
 <pre syntax="ruby">
->> person = Person.new
+person = Person.new
 => #<Person:0x393e0f8 @attributes={"lastname"=>"", "firstname"=>"", "email"=>""}, @new_record=true>
->> person.valid?
+person.valid?
 => false
->> person.errors
-=> <ActiveRecord::Errors:0x3938b18 @errors={"firstname"=>["can't be blank"], 
-"lastname"=>["can't be blank"], "email"=>["can't be blank"]}, 
-@base=<Person:0x393e0f8 @errors=<ActiveRecord::Errors:0x3938b18 ...>, 
-@attributes={"lastname"=>"", "firstname"=>"", "email"=>""}, @new_record=true>>
+person.errors
+=> #<ActiveRecord::Errors:0x3537b38 @errors={
+	"firstname"=>["can't be blank", "is too long (maximum is 255 characters)"], 
+	"lastname"=>["can't be blank", "is too long (maximum is 255 characters)"], 
+	"email"=>["can't be blank", "is too long (maximum is 255 characters)"]},
+	 @base=#<Person:0x3538bf0 @errors=#<ActiveRecord::Errors:0x3537b38 ...>, @new_record=true, 
+		@attributes={"lastname"=>nil, "firstname"=>nil, "email"=>nil}>>
 </pre>
 
-*Kapoow!* Instant validation!
+*Kapoow!* Instant validation! (NOTE: not as instant as it used to be - remember - you need to call <code>generate_validations</code> on each class as required)
 
 Because you specified the three columns as <code>:null => false</code>,
-your ActiveRecord models will now automatically generated <code>validates_presence_of</code>
-for each non-null field.
+your ActiveRecord models will now automagically generated <code>validates_presence_of</code> 
+for each non-null field, plus several other validations (since version 0.8.0).
 
 Ok, we're just warming up.
 
@@ -181,15 +190,15 @@ demonstrated above) to have the brilliantly simple support that Rails/ActiveReco
 Let's just watch what Dr Nic's Magic Models can do without any effort at all...
 
 <pre syntax="ruby">
->> person = Person.create(:firstname => "Nic", :lastname => "Williams", :email => "drnicwilliams@gmail.com")
->> group = Group.create(:name => "Magic Models Forum", :description => "http://groups.google.com/magicmodels")
->> membership = Membership.create(:person_id => person, :group_id => group)
->> person.memberships.length
+person = Person.create(:firstname => "Nic", :lastname => "Williams", :email => "drnicwilliams@gmail.com")
+group = Group.create(:name => "Magic Models Forum", :description => "http://groups.google.com/magicmodels")
+membership = Membership.create(:person => person, :group => group)
+person.memberships.length
 => 1
->> membership.person
+membership.person
 => <Person:0x38898e8 @attributes={"lastname"=>"Williams", "firstname"=>"Nic", 
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>
->> group.memberships
+group.memberships
 => [<Membership:0x3c8cd70 @attributes={"group_id"=>"1", "id"=>"1", "person_id"=>"1"}>]
 </pre>
 
@@ -204,7 +213,7 @@ The final association trick is a ripper. Automatic generation of <code>has_many
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>]
 </pre>
 
-h2. Drum roll...
+h3. Drum roll...
 
 Ladies and gentlemen. For my final feat of magical mastery, I'll ask you to do
 something you've never done before. This illusion is akin to the "floating lady":http://www.toytent.com/Posters/985.html
@@ -215,6 +224,8 @@ Exit your console session.
 DELETE your three model classes: <code>person.rb, group.rb, and membership.rb</code> from the 
 <code>app/models</code> folder. (You can always get them back via the model generator... be fearless!)
 
+<pre>rm app/models/*.rb</pre>
+
 Re-launch your console.
 
 *drums are still rolling...*
@@ -229,19 +240,34 @@ Be prepared to applaud loudly...
 You applaud loudly, but watch for more...
 
 <pre syntax="ruby">
+>> Person.new.valid?
+=> false
 >> person = Person.find(1)
 => <Person:0x3958930 @attributes={"lastname"=>"Williams", "firstname"=>"Nic", 
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>
+>> person.valid?
+=> true
 >> person.memberships
 => [<Membership:0x393a000 @attributes={"group_id"=>"1", "id"=>"1", "person_id"=>"1"}>]
 >> person.groups
 => [<Group:0x390df60 @attributes={"name"=>"Magic Models Forum", "id"=>"1", "description"=>nil}>]
 </pre>
 
-h2. Tada!
+h3. Tada!
 
 The end.
 
+h3. Use modules to scope your magic
+
+Only want to pick up tables starting with <code>blog_</code>?
+
+<pre syntax="ruby">module Blog
+  magic_module :table_name_prefix => 'blog_'
+end
+
+Blog::Post.table_name #	=> 'blog_posts'
+</pre>
+
 h2. Dr Nic's Blog
 
 "http://www.drnicwilliams.com":http://www.drnicwilliams.com - for future announcements and

data/lib/dr_nic_magic_models/magic_model.rb

@@ -53,9 +53,11 @@ module DrNicMagicModels::MagicModel
         rescue NotImplementedError 
           nil
         end
-      if not fkc.nil? and fkc.length > 0
+      if !fkc.nil? && fkc.length > 0
         foreign_key = fkc.first.foreign_key
-        options = {:dependent => :destroy, :foreign_key => fkc.first.foreign_key, :class_name => self.class.class_name(fkc.first.reference_table)}
+        options = {:dependent => :destroy, 
+          :foreign_key => fkc.first.foreign_key, 
+          :class_name => self.class.class_name(fkc.first.reference_table)}
       else
         foreign_key = self.class.columns.select {|column| column.name == method.to_s.foreign_key}.first
       end

data/lib/dr_nic_magic_models/version.rb

@@ -2,7 +2,7 @@ module DrNicMagicModels #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 9
-    TINY  = 0 
+    TINY  = 1
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/lib/dr_nic_magic_models.rb

@@ -28,4 +28,7 @@ require 'connection_adapters/postgresql_adapter'
 # load the schema
 # TODO - add this to README - DrNicMagicModels::Schema.load_schema(true)
 
-
+class ActiveRecord::Base
+  include DrNicMagicModels::MagicModel
+  extend DrNicMagicModels::Validations
+end

data/lib/module.rb

@@ -13,21 +13,21 @@ class Module
     superklass = @magic_schema.superklass || ActiveRecord::Base
     klass = create_class(class_id, superklass) do
       set_table_name table_name
-      include DrNicMagicModels::MagicModel
-      extend DrNicMagicModels::Validations
+      # include DrNicMagicModels::MagicModel
+      # extend DrNicMagicModels::Validations
     end
     klass.generate_validations # need to call this AFTER the class name has been assigned
     @magic_schema.inflector.post_class_creation klass
     klass
   end
   
-  def magic_module(table_name_prefix)
-    self.instance_variable_set "@table_name_prefix", table_name_prefix
+  def magic_module(options)
+    self.instance_variable_set "@table_name_prefix", options[:table_name_prefix] if options[:table_name_prefix]
   end
 
   private
   def create_class(class_name, superclass, &block)
     klass = Class.new superclass, &block
-    Object.const_set class_name, klass
+    self.const_set class_name, klass
   end
 end

data/test/magic_module_test.rb

@@ -1,7 +1,7 @@
 require 'abstract_unit'
 
 module MagicGroup
-  magic_module 'group_'
+  magic_module :table_name_prefix => 'group_'
 end
 
 class MagicModuleTest < Test::Unit::TestCase

data/test/test_existing_model.rb

@@ -0,0 +1,20 @@
+require 'abstract_unit'
+require 'pp'
+
+module TestBed
+  class Group < ActiveRecord::Base
+    generate_validations
+  end
+end
+
+class TestExistingModel < Test::Unit::TestCase
+  # fixtures :fun_users, :groups, :group_memberships, :group_tag
+  
+  def setup
+    create_fixtures :fun_users, :groups, :group_memberships, :group_tag
+  end
+  
+  def test_valid
+    assert(!TestBed::Group.new.valid?)
+  end
+end

data/website/index.html

@@ -32,12 +32,13 @@
 </head>
 <body>
 <div id="main">
+	<p><a href="/">&#x21A9; More Magic</a></p>
 
+	  <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/magicmodels"; return false'>
+	    Get Version
+	    <a id="version_num" href="http://rubyforge.org/projects/magicmodels" class="numbers"></a>
+	  </div>
     <h1>Dr Nic&#8217;s Magic Models</h1>
-    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/magicmodels"; return false'>
-      Get Version
-      <a id="version_num" href="http://rubyforge.org/projects/magicmodels" class="numbers"></a>
-    </div>
     <p>If you&#8217;ve used Ruby on Rails you&#8217;ll have written at least one model class like this:</p>
 
 
@@ -120,11 +121,11 @@ require 'dr_nic_magic_models'
 	<h2>David Copperfield eat your Ruby-crusted heart out</h2>
 
 
-	<p>Let&#8217;s demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app:</p>
+	<p>Let&#8217;s demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app (example uses sqlite3, but use your favourite databas):</p>
 
 
 	<p><pre class="syntax">
-<span class="ident">rails</span> <span class="ident">magic_show</span>
+<span class="ident">rails</span> <span class="ident">magic_show</span> <span class="punct">-</span><span class="ident">d</span> <span class="ident">sqlite3</span>
 <span class="ident">cd</span> <span class="ident">magic_show</span>
 <span class="ident">ruby</span> <span class="ident">script</span><span class="punct">/</span><span class="ident">generate</span> <span class="ident">model</span> <span class="constant">Person</span>
 <span class="ident">ruby</span> <span class="ident">script</span><span class="punct">/</span><span class="ident">generate</span> <span class="ident">model</span> <span class="constant">Group</span>
@@ -169,18 +170,12 @@ with:
 </pre></p>
 
 
-Now create your database. For MySql:
-<pre>
-mysqladmin -u root create magic_show_development
-mysqladmin -u root create magic_show_test
-</pre>
-
 And run your migrations to create the three tables:
 <pre>
-rake migrate
+rake db:migrate
 </pre>
 
-	<h2>And now for some <a href="http://en.wikipedia.org/wiki/List_of_conjuring_terms">woofle dust</a> ...</h2>
+	<h3>And now for some <a href="http://en.wikipedia.org/wiki/List_of_conjuring_terms">woofle dust</a> ...</h3>
 
 
 	<p>At the end of <code>config/environment.rb</code> add the following line:</p>
@@ -206,6 +201,22 @@ require 'dr_nic_magic_models'
 	<p>Nothing suspicious here. We have no validations and no associations. Just some plain old model classes.</p>
 
 
+	<p><span class="caps">UPDATE</span>: To turn on magic validations, you now need to invoke <code>generate_validations</code> on defined classes. So, update your model classes:</p>
+
+
+	<p><pre class="syntax">
+<span class="keyword">class </span><span class="class">Person</span> <span class="punct">&lt;</span> <span class="constant">ActiveRecord</span><span class="punct">::</span><span class="constant">Base</span>
+  <span class="ident">generate_validations</span>
+<span class="keyword">end</span>
+<span class="keyword">class </span><span class="class">Group</span> <span class="punct">&lt;</span> <span class="constant">ActiveRecord</span><span class="punct">::</span><span class="constant">Base</span>
+  <span class="ident">generate_validations</span>
+<span class="keyword">end</span>
+<span class="keyword">class </span><span class="class">Membership</span> <span class="punct">&lt;</span> <span class="constant">ActiveRecord</span><span class="punct">::</span><span class="constant">Base</span>
+  <span class="ident">generate_validations</span>
+<span class="keyword">end</span>
+</pre></p>
+
+
 	<p>For this trick, we&#8217;ll need an ordinary console session. Any old one lying around the house will do.</p>
 
 
@@ -218,24 +229,26 @@ With Dr Nic&#8217;s Magic Models:</p>
 
 
 	<p><pre class="syntax">
-<span class="punct">&gt;&gt;</span> <span class="ident">person</span> <span class="punct">=</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">new</span>
+<span class="ident">person</span> <span class="punct">=</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">new</span>
 <span class="punct">=&gt;</span> <span class="comment">#&lt;Person:0x393e0f8 @attributes={&quot;lastname&quot;=&gt;&quot;&quot;, &quot;firstname&quot;=&gt;&quot;&quot;, &quot;email&quot;=&gt;&quot;&quot;}, @new_record=true&gt;</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">valid?</span>
+<span class="ident">person</span><span class="punct">.</span><span class="ident">valid?</span>
 <span class="punct">=&gt;</span> <span class="constant">false</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">errors</span>
-<span class="punct">=&gt;</span> <span class="punct">&lt;</span><span class="constant">ActiveRecord</span><span class="punct">::</span><span class="constant">Errors</span><span class="punct">:</span><span class="number">0x3938b18</span> <span class="attribute">@errors</span><span class="punct">={&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;],</span> 
-<span class="punct">&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;],</span> <span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;]},</span> 
-<span class="attribute">@base</span><span class="punct">=&lt;</span><span class="constant">Person</span><span class="punct">:</span><span class="number">0x393e0f8</span> <span class="attribute">@errors</span><span class="punct">=&lt;</span><span class="constant">ActiveRecord</span><span class="punct">::</span><span class="constant">Errors</span><span class="punct">:</span><span class="number">0x3938b18</span> <span class="punct">...&gt;,</span> 
-<span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string"></span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string"></span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;&quot;</span><span class="string"></span><span class="punct">&quot;},</span> <span class="attribute">@new_record</span><span class="punct">=</span><span class="constant">true</span><span class="punct">&gt;&gt;</span>
+<span class="ident">person</span><span class="punct">.</span><span class="ident">errors</span>
+<span class="punct">=&gt;</span> <span class="comment">#&lt;ActiveRecord::Errors:0x3537b38 @errors={</span>
+	<span class="punct">&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">is too long (maximum is 255 characters)</span><span class="punct">&quot;],</span> 
+	<span class="punct">&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">is too long (maximum is 255 characters)</span><span class="punct">&quot;],</span> 
+	<span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;[&quot;</span><span class="string">can't be blank</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">is too long (maximum is 255 characters)</span><span class="punct">&quot;]},</span>
+	 <span class="attribute">@base</span><span class="punct">=</span><span class="comment">#&lt;Person:0x3538bf0 @errors=#&lt;ActiveRecord::Errors:0x3537b38 ...&gt;, @new_record=true, </span>
+		<span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;</span><span class="constant">nil</span><span class="punct">,</span> <span class="punct">&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;</span><span class="constant">nil</span><span class="punct">,</span> <span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;</span><span class="constant">nil</span><span class="punct">}&gt;&gt;</span>
 </pre></p>
 
 
-	<p><strong>Kapoow!</strong> Instant validation!</p>
+	<p><strong>Kapoow!</strong> Instant validation! (NOTE: not as instant as it used to be &#8211; remember &#8211; you need to call <code>generate_validations</code> on each class as required)</p>
 
 
 	<p>Because you specified the three columns as <code>:null =&gt; false</code>,
-your ActiveRecord models will now automatically generated <code>validates_presence_of</code>
-for each non-null field.</p>
+your ActiveRecord models will now automagically generated <code>validates_presence_of</code> 
+for each non-null field, plus several other validations (since version 0.8.0).</p>
 
 
 	<p>Ok, we&#8217;re just warming up.</p>
@@ -249,15 +262,15 @@ demonstrated above) to have the brilliantly simple support that Rails/ActiveReco
 
 
 	<p><pre class="syntax">
-<span class="punct">&gt;&gt;</span> <span class="ident">person</span> <span class="punct">=</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:firstname</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Nic</span><span class="punct">&quot;,</span> <span class="symbol">:lastname</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Williams</span><span class="punct">&quot;,</span> <span class="symbol">:email</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">drnicwilliams@gmail.com</span><span class="punct">&quot;)</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">group</span> <span class="punct">=</span> <span class="constant">Group</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Magic Models Forum</span><span class="punct">&quot;,</span> <span class="symbol">:description</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">http://groups.google.com/magicmodels</span><span class="punct">&quot;)</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">membership</span> <span class="punct">=</span> <span class="constant">Membership</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:person_id</span> <span class="punct">=&gt;</span> <span class="ident">person</span><span class="punct">,</span> <span class="symbol">:group_id</span> <span class="punct">=&gt;</span> <span class="ident">group</span><span class="punct">)</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">memberships</span><span class="punct">.</span><span class="ident">length</span>
+<span class="ident">person</span> <span class="punct">=</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:firstname</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Nic</span><span class="punct">&quot;,</span> <span class="symbol">:lastname</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Williams</span><span class="punct">&quot;,</span> <span class="symbol">:email</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">drnicwilliams@gmail.com</span><span class="punct">&quot;)</span>
+<span class="ident">group</span> <span class="punct">=</span> <span class="constant">Group</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:name</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">Magic Models Forum</span><span class="punct">&quot;,</span> <span class="symbol">:description</span> <span class="punct">=&gt;</span> <span class="punct">&quot;</span><span class="string">http://groups.google.com/magicmodels</span><span class="punct">&quot;)</span>
+<span class="ident">membership</span> <span class="punct">=</span> <span class="constant">Membership</span><span class="punct">.</span><span class="ident">create</span><span class="punct">(</span><span class="symbol">:person</span> <span class="punct">=&gt;</span> <span class="ident">person</span><span class="punct">,</span> <span class="symbol">:group</span> <span class="punct">=&gt;</span> <span class="ident">group</span><span class="punct">)</span>
+<span class="ident">person</span><span class="punct">.</span><span class="ident">memberships</span><span class="punct">.</span><span class="ident">length</span>
 <span class="punct">=&gt;</span> <span class="number">1</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">membership</span><span class="punct">.</span><span class="ident">person</span>
+<span class="ident">membership</span><span class="punct">.</span><span class="ident">person</span>
 <span class="punct">=&gt;</span> <span class="punct">&lt;</span><span class="constant">Person</span><span class="punct">:</span><span class="number">0x38898e8</span> <span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">Williams</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">Nic</span><span class="punct">&quot;,</span> 
 <span class="punct">&quot;</span><span class="string">id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">drnicwilliams@gmail.com</span><span class="punct">&quot;}&gt;</span>
-<span class="punct">&gt;&gt;</span> <span class="ident">group</span><span class="punct">.</span><span class="ident">memberships</span>
+<span class="ident">group</span><span class="punct">.</span><span class="ident">memberships</span>
 <span class="punct">=&gt;</span> <span class="punct">[&lt;</span><span class="constant">Membership</span><span class="punct">:</span><span class="number">0x3c8cd70</span> <span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">group_id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">person_id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;}&gt;]</span>
 </pre></p>
 
@@ -274,7 +287,7 @@ demonstrated above) to have the brilliantly simple support that Rails/ActiveReco
 </pre></p>
 
 
-	<h2>Drum roll&#8230;</h2>
+	<h3>Drum roll&#8230;</h3>
 
 
 	<p>Ladies and gentlemen. For my final feat of magical mastery, I&#8217;ll ask you to do
@@ -288,6 +301,8 @@ illusion that has been passed down through generations of magicians.</p>
 <span class="caps">DELETE</span> your three model classes: <code>person.rb, group.rb, and membership.rb</code> from the 
 <code>app/models</code> folder. (You can always get them back via the model generator&#8230; be fearless!)
 
+<pre>rm app/models/*.rb</pre>
+
 	<p>Re-launch your console.</p>
 
 
@@ -307,9 +322,13 @@ illusion that has been passed down through generations of magicians.</p>
 
 
 	<p><pre class="syntax">
+<span class="punct">&gt;&gt;</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">new</span><span class="punct">.</span><span class="ident">valid?</span>
+<span class="punct">=&gt;</span> <span class="constant">false</span>
 <span class="punct">&gt;&gt;</span> <span class="ident">person</span> <span class="punct">=</span> <span class="constant">Person</span><span class="punct">.</span><span class="ident">find</span><span class="punct">(</span><span class="number">1</span><span class="punct">)</span>
 <span class="punct">=&gt;</span> <span class="punct">&lt;</span><span class="constant">Person</span><span class="punct">:</span><span class="number">0x3958930</span> <span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">lastname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">Williams</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">firstname</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">Nic</span><span class="punct">&quot;,</span> 
 <span class="punct">&quot;</span><span class="string">id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">email</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">drnicwilliams@gmail.com</span><span class="punct">&quot;}&gt;</span>
+<span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">valid?</span>
+<span class="punct">=&gt;</span> <span class="constant">true</span>
 <span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">memberships</span>
 <span class="punct">=&gt;</span> <span class="punct">[&lt;</span><span class="constant">Membership</span><span class="punct">:</span><span class="number">0x393a000</span> <span class="attribute">@attributes</span><span class="punct">={&quot;</span><span class="string">group_id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;,</span> <span class="punct">&quot;</span><span class="string">person_id</span><span class="punct">&quot;=&gt;&quot;</span><span class="string">1</span><span class="punct">&quot;}&gt;]</span>
 <span class="punct">&gt;&gt;</span> <span class="ident">person</span><span class="punct">.</span><span class="ident">groups</span>
@@ -317,12 +336,26 @@ illusion that has been passed down through generations of magicians.</p>
 </pre></p>
 
 
-	<h2>Tada!</h2>
+	<h3>Tada!</h3>
 
 
 	<p>The end.</p>
 
 
+	<h3>Use modules to scope your magic</h3>
+
+
+	<p>Only want to pick up tables starting with <code>blog_</code>?</p>
+
+
+	<p><pre class="syntax"><span class="keyword">module </span><span class="module">Blog</span>
+  <span class="ident">magic_module</span> <span class="symbol">:table_name_prefix</span> <span class="punct">=&gt;</span> <span class="punct">'</span><span class="string">blog_</span><span class="punct">'</span>
+<span class="keyword">end</span>
+
+<span class="constant">Blog</span><span class="punct">::</span><span class="constant">Post</span><span class="punct">.</span><span class="ident">table_name</span> <span class="comment">#	=&gt; 'blog_posts'</span>
+</pre></p>
+
+
 	<h2>Dr Nic&#8217;s Blog</h2>
 
 
@@ -357,7 +390,7 @@ other stories and things.</p>
 	<p>Comments are welcome. Send an email to <a href="mailto:drnicwilliams@gmail.com">Dr Nic Williams</a>
 or via his blog at <a href="http://www.drnicwilliams.com">http://www.drnicwilliams.com</a></p>
     <p class="coda">
-      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 9th April 2007<br>
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 11th April 2007<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -66,10 +66,10 @@ Your application is now blessed with magical mystery.
 
 h2. David Copperfield eat your Ruby-crusted heart out
 
-Let's demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app:
+Let's demonstrate the magical mystery in all its full-stage glory. Create a Ruby on Rails app (example uses sqlite3, but use your favourite databas):
 
 <pre syntax="ruby">
-rails magic_show
+rails magic_show -d sqlite3
 cd magic_show
 ruby script/generate model Person
 ruby script/generate model Group
@@ -110,18 +110,12 @@ and <code>003_create_memberships.rb</code> with:
     end
 </pre>
 
-Now create your database. For MySql:
-<pre>
-mysqladmin -u root create magic_show_development
-mysqladmin -u root create magic_show_test
-</pre>
-
 And run your migrations to create the three tables:
 <pre>
-rake migrate
+rake db:migrate
 </pre>
 
-h2. And now for some "woofle dust":http://en.wikipedia.org/wiki/List_of_conjuring_terms ...
+h3. And now for some "woofle dust":http://en.wikipedia.org/wiki/List_of_conjuring_terms ...
 
 At the end of <code>config/environment.rb</code> add the following line:
 
@@ -142,6 +136,20 @@ end
 
 Nothing suspicious here. We have no validations and no associations. Just some plain old model classes.
 
+UPDATE: To turn on magic validations, you now need to invoke <code>generate_validations</code> on defined classes. So, update your model classes:
+
+<pre syntax="ruby">
+class Person < ActiveRecord::Base
+  generate_validations
+end
+class Group < ActiveRecord::Base
+  generate_validations
+end
+class Membership < ActiveRecord::Base
+  generate_validations
+end
+</pre>
+
 For this trick, we'll need an ordinary console session. Any old one lying around the house will do.
 
 <pre>
@@ -152,22 +160,24 @@ Now a normal model class is valid until you explicitly add <code>validates_xxx</
 With Dr Nic's Magic Models:
 
 <pre syntax="ruby">
->> person = Person.new
+person = Person.new
 => #<Person:0x393e0f8 @attributes={"lastname"=>"", "firstname"=>"", "email"=>""}, @new_record=true>
->> person.valid?
+person.valid?
 => false
->> person.errors
-=> <ActiveRecord::Errors:0x3938b18 @errors={"firstname"=>["can't be blank"], 
-"lastname"=>["can't be blank"], "email"=>["can't be blank"]}, 
-@base=<Person:0x393e0f8 @errors=<ActiveRecord::Errors:0x3938b18 ...>, 
-@attributes={"lastname"=>"", "firstname"=>"", "email"=>""}, @new_record=true>>
+person.errors
+=> #<ActiveRecord::Errors:0x3537b38 @errors={
+	"firstname"=>["can't be blank", "is too long (maximum is 255 characters)"], 
+	"lastname"=>["can't be blank", "is too long (maximum is 255 characters)"], 
+	"email"=>["can't be blank", "is too long (maximum is 255 characters)"]},
+	 @base=#<Person:0x3538bf0 @errors=#<ActiveRecord::Errors:0x3537b38 ...>, @new_record=true, 
+		@attributes={"lastname"=>nil, "firstname"=>nil, "email"=>nil}>>
 </pre>
 
-*Kapoow!* Instant validation!
+*Kapoow!* Instant validation! (NOTE: not as instant as it used to be - remember - you need to call <code>generate_validations</code> on each class as required)
 
 Because you specified the three columns as <code>:null => false</code>,
-your ActiveRecord models will now automatically generated <code>validates_presence_of</code>
-for each non-null field.
+your ActiveRecord models will now automagically generated <code>validates_presence_of</code> 
+for each non-null field, plus several other validations (since version 0.8.0).
 
 Ok, we're just warming up.
 
@@ -177,15 +187,15 @@ demonstrated above) to have the brilliantly simple support that Rails/ActiveReco
 Let's just watch what Dr Nic's Magic Models can do without any effort at all...
 
 <pre syntax="ruby">
->> person = Person.create(:firstname => "Nic", :lastname => "Williams", :email => "drnicwilliams@gmail.com")
->> group = Group.create(:name => "Magic Models Forum", :description => "http://groups.google.com/magicmodels")
->> membership = Membership.create(:person_id => person, :group_id => group)
->> person.memberships.length
+person = Person.create(:firstname => "Nic", :lastname => "Williams", :email => "drnicwilliams@gmail.com")
+group = Group.create(:name => "Magic Models Forum", :description => "http://groups.google.com/magicmodels")
+membership = Membership.create(:person => person, :group => group)
+person.memberships.length
 => 1
->> membership.person
+membership.person
 => <Person:0x38898e8 @attributes={"lastname"=>"Williams", "firstname"=>"Nic", 
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>
->> group.memberships
+group.memberships
 => [<Membership:0x3c8cd70 @attributes={"group_id"=>"1", "id"=>"1", "person_id"=>"1"}>]
 </pre>
 
@@ -200,7 +210,7 @@ The final association trick is a ripper. Automatic generation of <code>has_many
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>]
 </pre>
 
-h2. Drum roll...
+h3. Drum roll...
 
 Ladies and gentlemen. For my final feat of magical mastery, I'll ask you to do
 something you've never done before. This illusion is akin to the "floating lady":http://www.toytent.com/Posters/985.html
@@ -211,6 +221,8 @@ Exit your console session.
 DELETE your three model classes: <code>person.rb, group.rb, and membership.rb</code> from the 
 <code>app/models</code> folder. (You can always get them back via the model generator... be fearless!)
 
+<pre>rm app/models/*.rb</pre>
+
 Re-launch your console.
 
 *drums are still rolling...*
@@ -225,19 +237,34 @@ Be prepared to applaud loudly...
 You applaud loudly, but watch for more...
 
 <pre syntax="ruby">
+>> Person.new.valid?
+=> false
 >> person = Person.find(1)
 => <Person:0x3958930 @attributes={"lastname"=>"Williams", "firstname"=>"Nic", 
 "id"=>"1", "email"=>"drnicwilliams@gmail.com"}>
+>> person.valid?
+=> true
 >> person.memberships
 => [<Membership:0x393a000 @attributes={"group_id"=>"1", "id"=>"1", "person_id"=>"1"}>]
 >> person.groups
 => [<Group:0x390df60 @attributes={"name"=>"Magic Models Forum", "id"=>"1", "description"=>nil}>]
 </pre>
 
-h2. Tada!
+h3. Tada!
 
 The end.
 
+h3. Use modules to scope your magic
+
+Only want to pick up tables starting with <code>blog_</code>?
+
+<pre syntax="ruby">module Blog
+  magic_module :table_name_prefix => 'blog_'
+end
+
+Blog::Post.table_name #	=> 'blog_posts'
+</pre>
+
 h2. Dr Nic's Blog
 
 "http://www.drnicwilliams.com":http://www.drnicwilliams.com - for future announcements and

data/website/stylesheets/screen.css

@@ -37,7 +37,7 @@ blockquote {
 }
 
 #main {
-  width: 40em;
+  width: 55em;
   padding: 0;
   margin: 0 auto;
 }

data/website/template.rhtml

@@ -32,12 +32,13 @@
 </head>
 <body>
 <div id="main">
+	<p><a href="/">&#x21A9; More Magic</a></p>
 
+	  <div id="version" class="clickable" onclick='document.location = "<%= download %>"; return false'>
+	    Get Version
+	    <a id="version_num" href="<%= download %>" class="numbers"></a>
+	  </div>
     <h1><%= title %></h1>
-    <div id="version" class="clickable" onclick='document.location = "<%= download %>"; return false'>
-      Get Version
-      <a id="version_num" href="<%= download %>" class="numbers"></a>
-    </div>
     <%= body %>
     <p class="coda">
       <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, <%= modified.pretty %><br>

data/website/version-raw.js

@@ -1,3 +1,3 @@
 // Version JS file
-var version = "0.9.0";
+var version = "0.9.1";
 MagicAnnouncement.show('magicmodels', version);

data/website/version.js

@@ -1,4 +1,4 @@
 // Version JS file
-var version = "0.9.0";
+var version = "0.9.1";
 
 document.write(" - " + version);

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.2
 specification_version: 1
 name: dr_nic_magic_models
 version: !ruby/object:Gem::Version 
-  version: 0.9.0
-date: 2007-04-09 00:00:00 +02:00
+  version: 0.9.1
+date: 2007-04-11 00:00:00 +02:00
 summary: Dr Nic's Magic Models - Invisible validations, assocations and Active Record models themselves!
 require_paths: 
 - lib
@@ -74,6 +74,7 @@ files:
 - test/invisible_model_assoc_test.rb
 - test/invisible_model_classes_test.rb
 - test/magic_module_test.rb
+- test/test_existing_model.rb
 - website/index.html
 - website/index.txt
 - website/javascripts/rounded_corners_lite.inc.js
@@ -84,8 +85,8 @@ files:
 - website/version-raw.txt
 - website/version.js
 - website/version.txt
-test_files: []
-
+test_files: 
+- test/test_existing_model.rb
 rdoc_options: []
 
 extra_rdoc_files: []