active_nomad 0.0.2 → 0.0.3

data/CHANGELOG

@@ -1,3 +1,7 @@
+== 0.0.3 2010-09-29
+
+ * Don't open unnecessary database transactions on save.
+
 == 0.0.2 2010-09-28
 
  * Rename to Active Nomad.

data/README.markdown

@@ -6,8 +6,8 @@ ActiveRecord objects with a customizable persistence strategy.
 
 Sometimes you want an Active Record object that does not live in the database.
 Perhaps it never needs to be persisted, or you'd like to store it in a cookie,
-or a file, but it would still be handy to have ActiveRecord's ability to cast
-values, run validations, or fire callbacks.
+or some other store, but it would still be handy to have ActiveRecord's ability
+to cast values, run validations, or fire callbacks.
 
 Ideally, the persistence strategy would be pluggable. With Active Nomad, it is!
 
@@ -41,6 +41,32 @@ Things to note:
  * You may alternatively override `persist` in a subclass if you
    don't want to register a proc for every instance.
 
+## Transactions
+
+In addition to customizing persistence, you can also customize
+transaction semantics by overriding the `transaction` class method in
+a base class. Example:
+
+    class RedisNomad < ActiveNomad::Base
+      def self.transaction
+        redis.multi
+        begin
+          yield
+          redis.exec
+        rescue Exception => e
+          redis.discard
+          raise
+        end
+      end
+
+      def self.redis
+        @redis ||= Redis.new
+      end
+    end
+
+`ActiveNomad::Base.transaction` simply calls the given block with no
+real transaction semantics.
+
 ## Notes
 
 Only ActiveRecord 2.3 compatible. ActiveRecord 3.0 has a more modular

data/lib/active_nomad/version.rb

@@ -1,5 +1,5 @@
 module ActiveNomad
-  VERSION = [0, 0, 2]
+  VERSION = [0, 0, 3]
 
   class << VERSION
     include Comparable

data/lib/active_nomad.rb

@@ -27,6 +27,9 @@ module ActiveNomad
       end.compact.sort.join('&')
     end
 
+    #
+    # Recreate an object from a serialized string.
+    #
     def self.deserialize(string)
       params = string ? CGI.parse(string.strip) : {}
       instance = new
@@ -54,7 +57,7 @@ module ActiveNomad
 
     private
 
-    class FakeAdapter < ActiveRecord::ConnectionAdapters::AbstractAdapter
+    class FakeAdapter < ActiveRecord::ConnectionAdapters::AbstractAdapter # :nodoc:
       def native_database_types
         @native_database_types ||= Hash.new{|h,k| h[k] = k.to_s}
       end
@@ -79,16 +82,25 @@ module ActiveNomad
         reset_column_information
       end
 
-      def columns
+      def columns # :nodoc:
         @columns ||= []
       end
 
-      # Reset everything, except the column information
-      def reset_column_information
+      def reset_column_information # :nodoc:
+        # Reset everything, except the column information.
         columns = @columns
         super
         @columns = columns
       end
+
+      #
+      # Override to provide custom transaction semantics.
+      #
+      # The default #transaction simply yields to the given block.
+      #
+      def transaction
+        yield
+      end
     end
 
     self.abstract_class = true

data/spec/spec_helper.rb

@@ -1,4 +1 @@
 require 'active_nomad'
-
-# TODO: This should not be necessary - we're not stubbing out enough.
-ActiveRecord::Base.establish_connection(:adapter => "sqlite3", :database => ":memory:")

data/spec/unit/active_nomad_spec.rb

@@ -235,4 +235,28 @@ describe ActiveNomad::Base do
     it_should_roundtrip :boolean, true
     it_should_roundtrip :boolean, false
   end
+
+  describe ".transaction" do
+    before do
+      @class = Class.new(ActiveNomad::Base) do
+        cattr_accessor :transaction_called
+        def self.transaction
+          self.transaction_called = true
+        end
+      end
+    end
+
+    it "should be overridable to provide custom transaction semantics" do
+      instance = @class.new
+      instance.transaction{}
+      instance.transaction_called.should be_true
+    end
+
+    it "should be called by #save" do
+      instance = @class.new
+      instance.transaction_called.should be_false
+      instance.save
+      instance.transaction_called.should be_true
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: active_nomad
 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: 
 - George Ogata
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-28 00:00:00 -04:00
+date: 2010-09-29 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency