New persistence/adapter language.

Author: =

CHANGELOG.md

@@ -1,3 +1,7 @@
+## Jan 16 2012 - v0.1.0
+
+* Migrated over to new persistence/adapter terminology
+
 ## Jan 12 2012 - v0.0.4
 
 * Bluff calls are stricter now to give us more control in the bluff definitions. A bluff call accepts a single hash argument and default block values can no longer be defined in the block signatures.

README.md

@@ -86,7 +86,7 @@ Feel free to use them or huck em to the curb and just work directly with the att
 
 ```
 User.bluff  # returns an unsaved instance -- could also use Bluff.user
-User.bluff! # returns a saved instance -- could also use Bluff.user!
+User.bluff! # the "bang bluff" -- returns a persisted/saved instance, could also use Bluff.user!
 User.bluff({:name => 'Ryan'}) # supply overrides/defaults in the attributes hash
 ```
 

lib/bluff/builder.rb

@@ -3,8 +3,8 @@
 require 'active_support/core_ext/array/conversions'
 require 'active_support/core_ext/hash/indifferent_access'
 
-require 'bluff/support/backend'
-require 'bluff/support/backend/active_record'
+require 'bluff/support/persistence/base'
+require 'bluff/support/persistence/active_record'
 
 module Bluff
   module Builder
@@ -97,7 +97,7 @@ def define_bluff(field, &block)
       def define_bluff_bang(field)
         define_singleton_method "#{field}!" do |*arguments|
           send(field, *arguments).tap do |record|
-            Bluff::Support::Backend.save!(record, field)
+            Bluff::Support.persist(record, {:as => field})
           end
         end
       end

lib/bluff/support/backend.rb

@@ -3,14 +3,14 @@ class Base
   end
 end
 
-module Bluff::Support::ActiveRecord
-  class Backend
+module Bluff::Support::Persistence
+  class ActiveRecordAdapter
     class << self
-      def accepts?(record)
+      def persists?(record)
         record.is_a?(ActiveRecord::Base)
       end
 
-      def save!(record)
+      def persist(record)
         ActiveRecord::Base.transaction do
           record.class.reflect_on_all_associations(:belongs_to).each do |reflection|
             association = record.send(reflection.name)
@@ -22,6 +22,6 @@ def save!(record)
       end
     end
 
-    Bluff::Support::Backend.register(self)
+    Bluff::Support::Persistence::Base.register(self)
   end
 end

lib/bluff/support/backend/active_record.rb lib/bluff/support/persistence/active_record.rb

@@ -0,0 +1,31 @@
+module Bluff
+  module Support
+    module Persistence
+      class Base
+        @@adapters = []
+    
+        class << self
+          def register(adapter)
+            @@adapters << adapter
+          end
+      
+          def persist(record, options = {})
+            adapters = @@adapters.select {|adapter| adapter.persists?(record)}
+        
+            if adapters.empty?
+              raise "#{options[:as] || record.class} is not persistable (#{record})"
+            else
+              # should first try to persist new associations
+              adapters.first.persist(record)
+            end
+          end
+        end
+      end
+    end
+    
+    # just looks a little cleaner in use
+    def self.persist(record, options = {})
+      Persistence::Base.persist(record, options)
+    end
+  end
+end

lib/bluff/support/persistence/base.rb

@@ -11,6 +11,6 @@
 
 module Bluff
   module Support
-    # autoload
+    # autoload bluffs for rspec
   end
 end

lib/bluff/support/support.rb

@@ -1,3 +1,3 @@
 module Bluff
-  VERSION = "0.0.4"
+  VERSION = "0.1.0"
 end

lib/bluff/version.rb

@@ -86,7 +86,7 @@ class TransientClass
         end
 
         Bluff.for(:transient_class) { TransientClass.new }
-        lambda{ Bluff.transient_class! }.should raise_error(RuntimeError, /cannot be bang bluffed/)
+        lambda{ Bluff.transient_class! }.should raise_error(RuntimeError, /transient_class is not persistable/)
       end
     end
 

spec/models/api_spec.rb

@@ -12,18 +12,18 @@ def new_record?
   end
 end
 
-module Bluff::Support::BluffableClass
-  class Backend
+module Bluff::Support::Persistence
+  class BluffableClassAdapter
     class << self
-      def accepts?(record)
+      def persists?(record)
         record.is_a?(BluffableClass)
       end
 
-      def save!(record)
+      def persist(record)
         record.save
       end
     end
-
-    Bluff::Support::Backend.register(self)
+  
+    Bluff::Support::Persistence::Base.register(self)
   end
 end