whyvalidationssuckin96 1.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,22 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+.yardoc

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 gabrielg
+
+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

@@ -0,0 +1,121 @@
+# WhyValidationsSuckIn96
+
+## Description
+
+WhyValidationsSuckIn96 is a library for adding validation support to objects. It aims to have a very minimal 'surface
+area', API-wise, and to be as easily testable as possible. It has no external dependencies unless you wish to use the
+ActiveRecord integration, in which case you clearly need ActiveRecord installed.
+
+## Documentation
+
+See 'doc/index.html' for details, or [check the GitHub Pages site for the project](http://thumblemonks.github.com/whyvalidationssuckin96).
+
+## Install
+
+gem install 'whyvalidationssuckin96'
+
+## Basic Usage
+
+Require 'whyvalidationssuckin96' and include the WhyValidationsSuckIn96::ValidationSupport module into your class:
+    
+    require 'whyvalidationssuckin96'
+    
+    class Song
+      attr_accessor :title, :artist
+      include WhyValidationsSuckIn96::ValidationSupport
+    end
+
+Define your validations or call pre-existing validation macros inside a validation setup block:
+
+    require 'whyvalidationssuckin96'
+
+    class Song
+      attr_accessor :title, :artist, :year
+      include WhyValidationsSuckIn96::ValidationSupport
+      
+      setup_validations do
+        validate :no_eighties_crap do
+          if %w[BonJovi Dokken].include?(validatable.artist)
+            fail
+          else
+            pass
+          end
+        end
+        
+        validates_presence_of :title, :artist
+        validates_numericality_of :year
+      end
+    end
+
+Check instances of your class for validity and inspect the failed validations:
+
+    song = Song.new
+    song.valid?
+    song.invalid?
+    song.failed_validations
+    song.passed_validations
+    song.all_validations
+    
+Easily inspect and test for the presence of validations on your class:
+
+    Song.validation_collection.detect do |(klass, opts)|
+      klass.is_a?(WhyValidationsSuckIn96::ValidatesPresence)
+    end
+    
+Create your own reusable and testable validations:
+
+    require 'whyvalidationssuckin96/skippable_validation'
+    require 'whyvalidationssuckin96/attribute_based_validation'
+
+    class ValidatesPrimaryColour < WhyValidationsSuckIn96::Validation
+      include WhyValidationsSuckIn96::SkippableValidation
+      include WhyValidationsSuckIn96::AttributeBasedValidation
+    
+      DefaultOptions = {:message => "is not a valid color"}
+      ValidColours = %w[red green blue]
+      
+      def validate
+        super
+        if ValidColours.include?(attribute_value)
+          pass
+        else
+          fail
+        end
+      end
+      
+    end # ValidatesPrimaryColour
+
+    WhyValidationsSuckIn96::ValidationBuilder.register_macro :validates_primary_colour_of, ValidatesPrimaryColour
+  
+## ActiveRecord Integration
+
+WhyValidationsSuckIn96 features ActiveRecord support. The caveat is that it violently tears out the existing 
+validation API so anything that uses that will break. The good news is that what it replaces the existing validation
+code with works as expected with features such as callbacks and preventing saves to the database when objects are 
+invalid. All the standard ActiveRecord validation macros are available, and most have the same API to use when
+setting them up.
+
+To use the ActiveRecord support:
+
+    require 'whyvalidationssuckin96/rails/active_record'
+    
+Then you can define validations as expected in your model classes:
+
+    class Song < ActiveRecord::Base
+      setup_validations do
+        validates_uniqueness_of :title, :scope => :artist
+      end  
+    end
+    
+## Contributing
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with Rakefile or VERSION.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request.
+
+## Copying
+
+Copyright (c) 2009 gabrielg/thumblemonks. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "whyvalidationssuckin96"
+    gem.summary = %Q{An alternative implementation of object validations.}
+    gem.description = %Q{A library for setting up model validations, such as in ActiveRecord.}
+    gem.email = "gabriel.gironda@gmail.com"
+    gem.homepage = "http://github.com/thumblemonks/whyvalidationssuckin96"
+    gem.authors = ["gabrielg", "douglasmeyer"]
+    gem.add_development_dependency "riot", ">= 0"
+    gem.add_development_dependency "yard", ">= 0"
+    gem.add_development_dependency "activerecord", ">= 2.3.0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test_non_rails) do |test|
+  test.libs << 'lib' << 'test'
+  test.test_files = FileList['test/**/*_test.rb'].exclude("test/rails/**/*_test.rb")
+  test.verbose = true
+end
+
+Rake::TestTask.new(:test_rails) do |test|
+  test.libs << 'lib' << 'test'
+  test.test_files = FileList["test/rails/**/*_test.rb"]
+  test.verbose = true
+end
+
+task :test => [:check_dependencies, :test_non_rails, :test_rails]
+task :default => :test
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/doc/ActiveRecord/RecordInvalid.html

@@ -0,0 +1,258 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Class: ActiveRecord::RecordInvalid</title>
+<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="../_index.html">Index (R)</a> &raquo; 
+    <a href="../ActiveRecord.html" title="ActiveRecord">ActiveRecord</a>
+     &raquo; 
+    <span class="title">RecordInvalid</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Class: ActiveRecord::RecordInvalid 
+  
+  
+</h1>
+
+<dl class="box">
+  
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName">ActiveRecordError</span>
+      
+        <ul class="fullTree">
+          <li><a href="../Object.html" title="Object">Object</a></li>
+          
+            <li class="next">ActiveRecordError</li>
+          
+            <li class="next">ActiveRecord::RecordInvalid</li>
+          
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      
+      </dd>
+    
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/whyvalidationssuckin96/rails/active_record.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+    <p>
+RecordInvalid
+</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+</div>
+
+  
+  <h2>Instance Attribute Summary</h2>
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#record-instance_method" title="#record (instance method)">- (Object) <strong>record</strong> </a>
+    
+
+    
+  </span>
+  
+  
+    <span class="note title readonly">readonly</span>
+    
+  
+  
+  
+  
+
+  
+    <span class="summary_desc">
+Returns the value of attribute record.
+
+</span>
+  
+</li>
+
+    
+  </ul>
+
+
+  <h2>Instance Method Summary</h2>
+
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#initialize-instance_method" title="#initialize (instance method)">- (RecordInvalid) <strong>initialize</strong>(record) </a>
+    
+
+    
+  </span>
+  
+    <span class="note title constructor">constructor</span>
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc">
+A new instance of RecordInvalid.
+
+</span>
+  
+</li>
+
+    
+  </ul>
+
+  <div id="constructor_details" class="method_details_list">
+  <h2>Constructor Details</h2>
+  
+    <div class="method_details first">
+  <p class="signature first" id="initialize-instance_method">
+  
+    - (<tt><a href="" title="RecordInvalid">RecordInvalid</a></tt>) <strong>initialize</strong>(record) 
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+A new instance of RecordInvalid
+</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+87
+88
+89
+90</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/whyvalidationssuckin96/rails/active_record.rb', line 87</span>
+
+<span class='def def kw'>def</span> <span class='initialize identifier id'>initialize</span><span class='lparen token'>(</span><span class='record identifier id'>record</span><span class='rparen token'>)</span>
+  <span class='@record ivar id'>@record</span> <span class='assign token'>=</span> <span class='record identifier id'>record</span>
+  <span class='super super kw'>super</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+  
+</div>
+
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
+    
+      
+      <span id=""></span>
+      <span id="record-instance_method"></span>
+      <div class="method_details first">
+  <p class="signature first" id="record-instance_method">
+  
+    - (<tt><a href="../Object.html" title="Object">Object</a></tt>) <strong>record</strong>  <span class="extras">(readonly)</span>
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Returns the value of attribute record
+</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+86
+87
+88</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/whyvalidationssuckin96/rails/active_record.rb', line 86</span>
+
+<span class='def def kw'>def</span> <span class='record identifier id'>record</span>
+  <span class='@record ivar id'>@record</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+
+</div>
+    
+    <div id="footer">
+  Generated on Sun Dec 20 19:49:47 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.5.2 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>

data/doc/ActiveRecord.html

@@ -0,0 +1,93 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Module: ActiveRecord</title>
+<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="_index.html">Index (A)</a> &raquo; 
+    
+    
+    <span class="title">ActiveRecord</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Module: ActiveRecord 
+  
+  
+</h1>
+
+<dl class="box">
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r1 last">Defined in:</dt>
+    <dd class="r1 last">lib/whyvalidationssuckin96/rails/active_record.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+    <p>
+ActiveRecord
+</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+</div><h2>Defined Under Namespace</h2>
+<p class="children">
+   
+    
+   
+    
+      <strong class="classes">Classes:</strong> <a href="ActiveRecord/RecordInvalid.html" title="RecordInvalid">RecordInvalid</a>
+    
+  
+</p>
+
+
+
+
+</div>
+    
+    <div id="footer">
+  Generated on Sun Dec 20 19:49:46 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.5.2 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>

data/doc/FalseClass.html

@@ -0,0 +1,87 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Class: FalseClass</title>
+<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="_index.html">Index (F)</a> &raquo; 
+    
+    
+    <span class="title">FalseClass</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Class: FalseClass 
+  
+  
+</h1>
+
+<dl class="box">
+  
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName"><a href="Object.html" title="Object">Object</a></span>
+      
+        <ul class="fullTree">
+          <li><a href="Object.html" title="Object">Object</a></li>
+          
+            <li class="next">FalseClass</li>
+          
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      
+      </dd>
+    
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/whyvalidationssuckin96/ext/blank.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+
+
+
+
+</div>
+    
+    <div id="footer">
+  Generated on Sun Dec 20 19:49:46 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.5.2 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>