temping 1.1.0 → 1.2.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009-2010 John Pignata
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,49 +1,93 @@
 # Temping
 
-Temping is used to create temporary table-backed ActiveRecord models for use in tests.
+## Description
+
+Temping allows you to create arbitrary ActiveRecord models backed by a temporary SQL table for use in tests.
+
+Use cases for this include:
+
+* Testing a module that extends an ActiveRecord::Base-derived model without depending on a concrete Class in your application that's subject to change or disappear
+* Tests for ActiveRecord extending plug-ins that must be tested against an ActiveRecord::Base-derived Class
+
+Temping will use your existing database connection. If one does not exist, it will create and connect to an in-memory SQLite3 instance.
+
+As we're using temporary tables all data will be dropped when the database connection is terminated.
+
+## Examples
+
+The basic setup of a model involves calling _create_model_ with a symbol that represents the plural table name of the model you wish to create. By default, this will create a temporary table with an _id_ column.
 
     include Temping
     
-    before(:all) do
-      create_model :posts do
-        with_columns do |table|
-          table.string :headline
-          table.text :body
-          table.integer :view_count
-        end
-
-        validates_presence_of :headline
-        
-        def popular?
-          view_count > 100
-        end
-      end
-    end
+    create_model :dogs
+    
+    Dog.create => #<Dog id: 1>
+    
+Additional database columns can be specified via the _with_columns_ method which uses Rails migration syntax:
+
+    include Temping
     
-    describe "#popular" do
-      context "when a post is view_count over 100 times" do
-        it "returns true" do
-          post = Post.create! do |p|
-            p.headline = "Headline"
-            p.view_count = 200
-          end
-          
-          post.should be_popular
-        end
+    create_model :dogs do
+      with_columns do |t|
+        t.string :name
+        t.integer :age, :weight
       end
-        
     end
     
-This is especially useful if testing an ActiveRecord plugin or a module used in a Rails application to decouple your module's tests from a concrete implementation.
-  
+    Dog.create => #<Dog id: 1, name: nil, age: nil, weight: nil>
+    
+When a block is passed to _create_model_, it is evaluated in the context of the ActiveRecord class. This means anything you do in an ActiveRecord model can be accomplished in the block including method definitions, validations, module includes, etc.
+
     include Temping
     
-    before(:all) do
-      create_model :posts do
-        include HasArticles
+    create_model :dogs do
+      include Duckish
+
+      with_columns do |t|
+        t.string :name
+        t.integer :age, :weight
+      end
+      
+      validates_presence_of :name
+      
+      def quack
+        "arf!"
       end
     end
     
-    describe "HasArticles tests"...
+    Dog.create! => ActiveRecord::RecordInvalid: Validation failed: Name can't be blank
+    codey = Dog.create!(:name => 'Codey')
+    codey.quack => "arf!"
     
-By default, temping will use whichever connection ActiveRecord::Base has defined. If none exists, it'll use an in-memory SQLite3 instance.
+## Installation
+
+    jp@populuxe:~$ gem install temping
+
+## Bugs, Features, Feedback
+
+Tickets can be submitted by via GitHub issues.
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009-2010 John Pignata
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

data/lib/temping.rb

@@ -9,12 +9,10 @@ module Temping
   end
   
   def create_model(model_name, &block)    
-    if eval("defined?(#{model_name.to_s.classify})")
-      raise ModelAlreadyDefined, "Constant #{model_name.to_s.classify} is already defined"
+    unless eval("defined?(#{model_name.to_s.classify})")
+      factory = ModelFactory.new(model_name, &block)
+      factory.klass
     end
-
-    factory = ModelFactory.new(model_name, &block)
-    factory.klass
   end
 
   class ModelFactory

data/spec/temping_spec.rb

@@ -10,7 +10,7 @@ describe Temping do
     end
 
     it "evals all statements passed in through a block" do
-      votes = create_model :votes do
+      create_model :votes do
         with_columns do |table|
           table.string :voter
         end
@@ -25,8 +25,8 @@ describe Temping do
       vote.should be_valid
     end
     
-    it "raises ModelAlreadyDefined if a const is already defined" do
-      lambda { 2.times { create_model :dogs }}.should raise_error(Temping::ModelAlreadyDefined)
+    it "silently skip initialization if a const is already defined" do
+      lambda { 2.times { create_model :dogs }}.should_not raise_error(Temping::ModelAlreadyDefined)
     end
     
     describe ".with_columns" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: temping
 version: !ruby/object:Gem::Version 
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors: 
 - John Pignata
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-17 00:00:00 -05:00
+date: 2009-12-30 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -39,9 +39,11 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
+- LICENSE
 - README.md
 files: 
 - .gitignore
+- LICENSE
 - README.md
 - Rakefile
 - VERSION