transaction-simple 1.2.0 → 1.3.0

data/tests/testall.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+#--
+# Ruwiki
+#   Copyright � 2002 - 2003, Digikata and HaloStatue
+#   Alan Chen (alan@digikata.com)
+#   Austin Ziegler (ruwiki@halostatue.ca)
+#
+# Licensed under the same terms as Ruby.
+#
+# $Id: testall.rb,v 1.1 2005/05/05 16:16:49 austin Exp $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+
+$stderr.puts "Checking for test cases:"
+Dir['tc_*.rb'].each do |testcase|
+  $stderr.puts "\t#{testcase}"
+  load testcase
+end
+$stderr.puts " "

metadata

@@ -1,18 +1,20 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.1
+rubygems_version: 0.8.10
 specification_version: 1
 name: transaction-simple
 version: !ruby/object:Gem::Version 
-  version: 1.2.0
-date: 2004-11-03
+  version: 1.3.0
+date: 2005-05-05
 summary: Simple object transaction support for Ruby.
 require_paths: 
   - lib
-author: Austin Ziegler
 email: transaction-simple@halostatue.ca
 homepage: http://rubyforge.org/projects/trans-simple
 rubyforge_project: trans-simple
-description: ''
+description: "Transaction::Simple provides a generic way to add active transaction support to
+  objects. The transaction methods added by this module will work with most
+  objects, excluding those that cannot be Marshal-ed (bindings, procedure objects,
+  IO instances, or singleton objects)."
 autorequire: transaction/simple
 default_executable: 
 bindir: bin
@@ -25,6 +27,8 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
         version: 1.8.1
   version: 
 platform: ruby
+authors: 
+  - Austin Ziegler
 files: 
   - Changelog
   - Install
@@ -33,22 +37,29 @@ files:
   - Readme
   - tests
   - lib/transaction
+  - lib/transaction/simple
   - lib/transaction/simple.rb
-  - tests/tests.rb
-  - README
-  - ChangeLog
+  - lib/transaction/simple/group.rb
+  - lib/transaction/simple/threadsafe
+  - lib/transaction/simple/threadsafe.rb
+  - lib/transaction/simple/threadsafe/group.rb
+  - tests/tc_transaction_simple.rb
+  - tests/tc_transaction_simple_group.rb
+  - tests/tc_transaction_simple_threadsafe.rb
+  - tests/testall.rb
 test_files: 
-  - tests/tests.rb
+  - tests/tc_transaction_simple.rb
+  - tests/tc_transaction_simple_group.rb
+  - tests/tc_transaction_simple_threadsafe.rb
 rdoc_options: 
   - "--title"
-  - "Transaction::Simple -- Simple object transaction support"
+  - "Transaction::Simple -- Active Object Transaction Support for Ruby"
   - "--main"
   - Transaction::Simple
   - "--line-numbers"
 extra_rdoc_files: 
-  - README
-  - ChangeLog
-  - Install
+  - Readme
+  - Changelog
 executables: []
 extensions: []
 requirements: []

data/ChangeLog

@@ -1,20 +0,0 @@
-$Id: Changelog,v 1.2 2004/09/14 18:46:15 austin Exp $
-
-== Transaction::Simple 1.2.0
-* Added a RubyGem.
-* Added a block form of Transaction::Simple.
-
-== Transaction::Simple 1.1.1
-* Cleaned up some documentation.
-
-== Transaction::Simple 1.1
-* Added Transaction::Simple::ThreadSafe for truly atomic and thread-safe
-  transactions.
-* Fixed the description of Transaction::Simple to note that it is *not* atomic
-  because it is not necessarily thread-safe.
-* Added support for named transactions. Named transactions can be used to make
-  checkpoints that can be committed, aborted, or rewound without explicitly
-  committing, aborting, or rewinding the intervening transactions.
-
-== Transaction::Simple 1.0
-* Created. Initial release.

data/README

@@ -1,110 +0,0 @@
-Transaction::Simple for Ruby
-  Simple object transaction support for Ruby
-
-Introduction
-------------
-Transaction::Simple provides a generic way to add active transactional support
-to objects. The transaction methods added by this module will work with most
-objects, excluding those that cannot be Marshal-ed (bindings, procedure
-objects, IO instances, or singleton objects).
-
-The transactions supported by Transaction::Simple are not backend transaction;
-that is, they have nothing to do with any sort of data store. They are "live"
-transactions occurring in memory and in the object itself. This is to allow
-"test" changes to be made to an object before making the changes permanent.
-
-Transaction::Simple can handle an "infinite" number of transactional levels
-(limited only by memory). If I open two transactions, commit the first, but
-abort the second, the object will revert to the original version.
-
-Transaction::Simple supports "named" transactions, so that multiple levels of
-transactions can be committed, aborted, or rewound by referring to the
-appropriate name of the transaction. Names may be any object except nil.
-
-Copyright:    Copyright � 2003 by Austin Ziegler
-Version:      1.11
-Licence:      MIT-Style
-
-Thanks to David Black and Mauricio Fern�ndez for their help with this library.
-
-Usage
------
-  include 'transaction/simple'
-
-  v = "Hello, you."               # => "Hello, you."
-  v.extend(Transaction::Simple)   # => "Hello, you."
-
-  v.start_transaction             # => ... (a Marshal string)
-  v.transaction_open?             # => true
-  v.gsub!(/you/, "world")         # => "Hello, world."
-
-  v.rewind_transaction            # => "Hello, you."
-  v.transaction_open?             # => true
-
-  v.gsub!(/you/, "HAL")           # => "Hello, HAL."
-  v.abort_transaction             # => "Hello, you."
-  v.transaction_open?             # => false
-
-  v.start_transaction             # => ... (a Marshal string)
-  v.start_transaction             # => ... (a Marshal string)
-
-  v.transaction_open?             # => true
-  v.gsub!(/you/, "HAL")           # => "Hello, HAL."
-
-  v.commit_transaction            # => "Hello, HAL."
-  v.transaction_open?             # => true
-  v.abort_transaction             # => "Hello, you."
-  v.transaction_open?             # => false
-
-Named Transaction Usage
------------------------
-  v = "Hello, you."               # => "Hello, you."
-  v.extend(Transaction::Simple)   # => "Hello, you."
-
-  v.start_transaction(:first)     # => ... (a Marshal string)
-  v.transaction_open?             # => true
-  v.transaction_open?(:first)     # => true
-  v.transaction_open?(:second)    # => false
-  v.gsub!(/you/, "world")         # => "Hello, world."
-
-  v.start_transaction(:second)    # => ... (a Marshal string)
-  v.gsub!(/world/, "HAL")         # => "Hello, HAL."
-  v.rewind_transaction(:first)    # => "Hello, you."
-  v.transaction_open?             # => true
-  v.transaction_open?(:first)     # => true
-  v.transaction_open?(:second)    # => false
-
-  v.gsub!(/you/, "world")         # => "Hello, world."
-  v.start_transaction(:second)    # => ... (a Marshal string)
-  v.gsub!(/world/, "HAL")         # => "Hello, HAL."
-  v.transaction_name              # => :second
-  v.abort_transaction(:first)     # => "Hello, you."
-  v.transaction_open?             # => false
-
-  v.start_transaction(:first)     # => ... (a Marshal string)
-  v.gsub!(/you/, "world")         # => "Hello, world."
-  v.start_transaction(:second)    # => ... (a Marshal string)
-  v.gsub!(/world/, "HAL")         # => "Hello, HAL."
-
-  v.commit_transaction(:first)    # => "Hello, HAL."
-  v.transaction_open?             # => false
-
-Contraindications
------------------
-While Transaction::Simple is very useful, it has some severe limitations that
-must be understood. Transaction::Simple:
-
-* uses Marshal. Thus, any object which cannot be Marshal-ed cannot use
-  Transaction::Simple.
-* does not manage resources. Resources external to the object and its instance
-  variables are not managed at all. However, all instance variables and
-  objects "belonging" to those instance variables are managed. If there are
-  object reference counts to be handled, Transaction::Simple will probably
-  cause problems.
-* is not thread-safe. In the ACID ("atomic, consistent, isolated, durable")
-  test, Transaction::Simple provides C and D, but it is up to the user of
-  Transaction::Simple to provide isolation. Transactions should be considered
-  "critical sections" in multi-threaded applications. Thread safety can be
-  ensured with Transaction::Simple::ThreadSafe.
-* does not maintain Object#__id__ values on rewind or abort. This may change
-  for future versions that will be Ruby 1.8 or better only.