obsidian 0.0.3 → 0.0.4

data/Manifest.txt

@@ -2,12 +2,15 @@ History.txt
 LICENSE
 Manifest.txt
 README.rdoc
+README.txt
 Rakefile
 lib/obsidian.rb
+lib/obsidian/rails/helper_test.rb
 lib/obsidian/rails/model_update_tracker.rb
 lib/obsidian/spec.rb
 lib/obsidian/spec/map_spec_helper.rb
 lib/obsidian/spec/set_spec_helper.rb
+obsidian.gemspec
 test/obsidian_test.rb
 test/test_helper.rb
 test/units/obsidian/rails/model_update_tracker_test.rb

data/README.txt

@@ -0,0 +1,96 @@
+= Obsidian
+
+== DESCRIPTION
+
+Obsidian. It's metastable. 
+
+In the tangible world, obsidian is a naturally-occurring glass that is metastable at the earth's
+surface. It's commonly found within the margins of rhyolitic lava flows, where cooling of the lava is
+rapid. [1] In the slightly less tangible world of programming, <b>Obsidian</b> is home to chunks of
+Ruby code that we've found helpful. These bits of code are often found at the bottom of a mountain of
+yak hair, the occasionally-occurring product of simplifying various tasks.
+
+  1 http://en.wikipedia.org/wiki/Obsidian
+
+== FEATURES
+
+=== Model Update Tracker
+This library allows you to functionally test updates to models with clearer and more focused intent.
+It forces you to have a better understanding of how your objects interact and lets you demonstrate 
+that knowledge by specifying it in your tests.  For example, consider the following test which asserts
+that the code block persists an Asset record.  
+
+  assert_difference Asset :count do
+    post :create, :asset => {}
+  end
+
+Is it okay if the code block also persists a Location record? An AssetOwner record? Some other record?
+Chances are that the developer knows the answer to this question, but the test fails to capture that
+knowledge. Side effects matter, and our tests should adequately validate that the desired side effects
+(and <i>only</i> the desired side effects) are taking place. In the example below, assert_models_created
+allows us to validate that an Asset is created <i>and</i> that no other objects are inadvertently
+persisted.
+
+  assert_models_created(Asset) do
+    post :create, :asset => {}
+  end
+
+If the code block happened to create records other than just an Asset, a friendly test failure would let
+you know right away.
+
+Suppose, on the other hand, that you expect the creation of an Asset to <i>also</i> produce an AssetOwner
+and a Location. This is where you exercise your deep domain knowledge muscles and make your new
+Obsidian-powered test express and validate your intent.
+
+  assert_models_created(Asset, AssetOwner, Location) do
+    post: create, :asset => {}
+  end
+
+Now, if your code block fails to create the expected records, the above test would fail stating that it
+expected more to happen. If future changes to your code cause things to fall out of place, this test will
+catch that regression where the original assert_difference may not. In addition to assert_models_created,
+Model Update Tracker provides a whole host of other methods that provide similar functionality for
+asserting behavior related to updates, deletes, or even validating that nothing happened.
+
+* assert_models_created(models)
+* assert_models_updated(models)
+* assert_models_destroyed(models)
+* assert_no_models_created
+* assert_no_models_destroyed
+* assert_no_models_updated
+
+== INSTALL
+
+  sudo gem install obsidian
+
+== URLS
+
+* Log bugs, issues, and suggestions on Trac: http://opensource.thinkrelevance.com/wiki/obsidian
+* View Source: http://github.com/relevance/obsidian/tree/master
+* Git clone Source: git://github.com/relevance/obsidian.git
+* RDocs: http://thinkrelevance.rubyforge.org/obsidian/
+
+== LICENSE
+
+(The MIT License)
+
+Copyright (c) 2008 Relevance, Inc. - http://thinkrelevance.com
+
+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/lib/obsidian.rb

@@ -1,3 +1,3 @@
 module Obsidian
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end

data/lib/obsidian/rails/helper_test.rb

@@ -0,0 +1,22 @@
+require 'test/unit'
+
+module Obsidian::Rails    
+  module HelperTest
+    # include all the fun dependancies needed to test helpers
+    def helper_test helper_under_test = nil
+      include ActionView::Helpers::CaptureHelper
+      include ActionView::Helpers::DateHelper
+      include ActionView::Helpers::UrlHelper 
+      include ActionView::Helpers::TextHelper
+      include ActionView::Helpers::AssetTagHelper
+      include ActionView::Helpers::TagHelper
+      include ActionView::Helpers::FormOptionsHelper
+      include ActionView::Helpers::FormTagHelper
+      include ApplicationHelper
+      include helper_under_test if helper_under_test
+    end
+    
+  end
+end
+
+Test::Unit::TestCase.extend Obsidian::Rails::HelperTest

data/obsidian.gemspec

@@ -0,0 +1,34 @@
+(in /Users/rsanheim/src/relevance/runcoderun/vendor/gems/obsidian-0.0.4)
+Gem::Specification.new do |s|
+  s.name = %q{obsidian}
+  s.version = "0.0.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Relevance"]
+  s.date = %q{2008-07-09}
+  s.description = %q{It's metastable}
+  s.email = %q{opensource@thinkrelevance.com}
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+  s.files = ["History.txt", "LICENSE", "Manifest.txt", "README.rdoc", "README.txt", "Rakefile", "lib/obsidian.rb", "lib/obsidian/rails/helper_test.rb", "lib/obsidian/rails/model_update_tracker.rb", "lib/obsidian/spec.rb", "lib/obsidian/spec/map_spec_helper.rb", "lib/obsidian/spec/set_spec_helper.rb", "test/obsidian_test.rb", "test/test_helper.rb", "test/units/obsidian/rails/model_update_tracker_test.rb", "test/units/obsidian/spec/map_spec_helper_test.rb", "test/units/obsidian/spec/set_spec_helper_test.rb", "test/units/obsidian/spec_test.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://opensource.thinkrelevance.com}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{thinkrelevance}
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{It's metastable}
+  s.test_files = ["test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      s.add_development_dependency(%q<hoe>, [">= 1.7.0"])
+    else
+      s.add_dependency(%q<hoe>, [">= 1.7.0"])
+    end
+  else
+    s.add_dependency(%q<hoe>, [">= 1.7.0"])
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: obsidian
 version: !ruby/object:Gem::Version 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Relevance
@@ -9,17 +9,18 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-04-11 00:00:00 -04:00
+date: 2008-07-09 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: hoe
+  type: :development
   version_requirement: 
   version_requirements: !ruby/object:Gem::Requirement 
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.5.1
+        version: 1.7.0
     version: 
 description: It's metastable
 email: opensource@thinkrelevance.com
@@ -30,17 +31,21 @@ extensions: []
 extra_rdoc_files: 
 - History.txt
 - Manifest.txt
+- README.txt
 files: 
 - History.txt
 - LICENSE
 - Manifest.txt
 - README.rdoc
+- README.txt
 - Rakefile
 - lib/obsidian.rb
+- lib/obsidian/rails/helper_test.rb
 - lib/obsidian/rails/model_update_tracker.rb
 - lib/obsidian/spec.rb
 - lib/obsidian/spec/map_spec_helper.rb
 - lib/obsidian/spec/set_spec_helper.rb
+- obsidian.gemspec
 - test/obsidian_test.rb
 - test/test_helper.rb
 - test/units/obsidian/rails/model_update_tracker_test.rb
@@ -70,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: thinkrelevance
-rubygems_version: 1.1.1
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 summary: It's metastable