not_naughty 0.3.1 → 0.4

data/CHANGELOG

@@ -1,3 +1,7 @@
+=== 0.4 (2008-02-18)
+* completed documentation
+* added spec for :each in Builder::ValidationDelegator
+
 === 0.3.1 (2008-02-14)
 * fixed missing require
 

data/README

@@ -1,36 +1,11 @@
 = NotNaughty - The Validation Framework
 
-<b>Features:</b>
-* API compatible to Sequel as plugin (see Sequel::Plugins::NotNaughty for
-  details):
+NotNaughty extends your ruby Project with a highly custumizable validation API.
 
-   class User < Sequel::Model
-     is :not_naughty
-     validates { presence_of :username and length_of :username, :within => 4..16 }
-     has_validations? # => true
-     
-     # ...
-   end
-
-* Syntactical Sugar with Builder methods:
-
-   validates(:username, :password) {length :minimum => 6}
-   validates(:password) {confirmed and complexity :level => :high}
-   validates(:if => :necessary?) {bunchyness_of :crap}
+== Features
 
-* Beautiful error messages:
+<b>Easy to adapt:</b>
 
-   validates_presence_of :person,
-     :message => '#{"%s".humanize} is gone missing.'
-
-* Conditional Validations:
-
-   validates(:if => :necessary?) {...}
-   validates(:unless => proc {|obj| obj.vip?}) {...}
-
-* Easy to adapt and to extent:
-
-  _adapt_
    require 'rubygems'
    require 'not_naughty'
    Person = Struct.new(:name) do
@@ -44,7 +19,8 @@
    Person.new('Foo').clone # goes *boom* with NotNaughty::ValidationException
    Person.new('Foo').dup # => false
 
-  _extend_
+<b>Easy to extent:</b>
+
    class BunchynessValidation < NotNaughty::Validation
      def initialize(opts, attributes)
        __message = opts[:message] || '#{"%s".humanize} is not bunchy.'
@@ -59,4 +35,34 @@
      validates_bunchyness_of :bunchy_item
    end
 
+<b>Syntactical Sugar with Builder methods:</b>
+
+   validates(:username, :password) {length :minimum => 6}
+   validates(:password) {confirmed and complexity :level => :high}
+   validates(:if => :necessary?) {bunchyness_of :crap}
+
+<b>Beautiful error messages:</b>
+
+   validates_presence_of :person,
+     :message => '#{"%s".humanize} is gone missing.'
+
+<b>Conditional Validations:</b>
+
+   validates(:if => :necessary?) {...}
+   validates(:unless => proc {|obj| obj.vip?}) {...}
+
+<b>API compatible to Ruby-Sequel[http://code.google.com/p/ruby-sequel/] as plugin:</b>
+
+   class User < Sequel::Model
+     is :not_naughty
+     validates { presence_of :username and length_of :username, :within => 4..16 }
+     has_validations? # => true
+
+     # ...
+   end
+
+See Sequel::Plugins::NotNaughty for details...
+
+== Copying
+
 :include: COPYING

data/Rakefile

@@ -9,7 +9,7 @@ include FileUtils
 # Configuration
 ##############################################################################
 NAME = "not_naughty"
-VERS = "0.3.1"
+VERS = "0.4"
 CLEAN.include ["**/.*.sw?", "pkg/*", ".config", "doc/*", "coverage/*"]
 RDOC_OPTS = [
   "--quiet", 

data/lib/not_naughty/validations/acceptance_validation.rb

@@ -1,21 +1,28 @@
 module NotNaughty
   
-  # == Validates acceptance of obj's attribute against a fixed value.
+  # == Validates acceptance of obj's attribute against a fixed value via <tt>:eql?</tt> call.
   #
   # Unless the validation succeeds an error hash (:attribute => :message)
   # is added to the obj's instance of Errors.
   #
   # <b>Options:</b>
-  # <tt>:accept</tt>::   object that that'll check via a <tt>:match</tt> call
+  # <tt>:accept</tt>::  object to check against (via :eql?)
   # <tt>:message</tt>:: see NotNaughty::Errors for details
   # <tt>:if</tt>::      see NotNaughty::Validation::Condition for details
   # <tt>:unless</tt>::  see NotNaughty::Validation::Condition for details
   #
   # <b>Example:</b>
   #
-  #   obj = 'abc'
-  #   def obj.errors() @errors ||= NotNauthy::Errors.new end
+  #   invalid = 'abc'
+  #   valid = '1'
+  #   def invalid.errors() @errors ||= NotNauthy::Errors.new end
+  #   def valid.errors() @errors ||= NotNauthy::Errors.new end
   #
+  #   AcceptanceValidation.new({}, :to_s).call invalid, :to_s, 'abc'
+  #   invalid.errors.on(:to_s).any? # => true
+  #
+  #   AcceptanceValidation.new({}, :to_s).call valid, :to_s, '1'
+  #   valid.errors.on(:to_s).any? # => false
   class AcceptanceValidation < Validation
     
     def initialize(opts, attributes)

data/lib/not_naughty/validations/confirmation_validation.rb

@@ -1,6 +1,6 @@
 module NotNaughty
   
-  # == Validates confirmaton of obj's attribute via <tt>:eql?</tt> method against the _appropiate_ confirmation attribute.
+  # == Validates confirmaton of obj's attribute via <tt>:eql?</tt> call against the _appropiate_ confirmation attribute.
   #
   # Unless the validation succeeds an error hash (:attribute => :message)
   # is added to the obj's instance of Errors.
@@ -22,7 +22,7 @@ module NotNaughty
     
     def initialize(opts, attributes) #:nodoc:
       __message = opts[:message] || '#{"%s".humanize} could not be confirmed.'  
-
+      
       if opts[:allow_blank] or opts[:allow_nil]
         __allow = if opts[:allow_blank] then :blank? else :nil? end
         super opts, attributes do |o, a, v|

data/lib/sequel_not_naughty.rb

@@ -15,25 +15,41 @@ module Sequel #:nodoc:
     #     is :not_naughty
     #   end
     #
-    # <b>To turn off before_validate and after_validate hooks:</b>
+    # ---
+    #
+    # <b>Options:</b>
+    #
+    # <i>To turn off before_validate and after_validate hooks:</i>
     #
     #   class User < Sequel::Model
     #     is :not_naughty, :without => :hooks
     #   end
     #
-    # <b>To turn off raised Exceptions if validation before save fails:</b>
+    # <i>To turn off raised Exceptions if validation before save fails:</i>
     #
     #   class User < Sequel::Model
     #     # save on invalid users will return false
     #     is :not_naughty, :without => :exceptions
     #   end
     #
-    # <b>To combine those:</b>
+    # <i>To combine those:</i>
     #
     #   class User < Sequel::Model
     #     is :not_naughty, :without => [:exceptions, :hooks]
     #   end
     #
+    # ---
+    #
+    # <b>API compatibility:</b>
+    #
+    # The validates_length_of method does only one check per attribute.
+    # If you want to check minimum and maximum length with different error
+    # messages you need to write 2 validations:
+    # 
+    #   validates_length_of :name, :minimum => 4
+    #   validates_length_of :name, :maximum => 12
+    #
+    # Except the example above the Plugin should be 100% API compatible.
     class NotNaughty < NotNaughty::Validator
       
       # Applies plugin to a Sequel::Model.

data/spec/builder_spec.rb

@@ -61,6 +61,17 @@ describe subject::Builder do
     
     pending 'expect a block'
   end
+  it "should support :each in validates block" do
+    @validatable.validator = mock 'Validator'
+    @validatable.validator.
+      should_receive(:add_validation).
+      with(:a, :b, {})
+    @validatable.validates do
+      each(:a, :b) {|o, a, v|}
+    end
+    
+    pending 'expect a block'
+  end
   it "should raise a NoMethodError is builder method does not exist" do
     lambda { @validatable.validates() { bunch_of :holy_crap } }.
     should raise_error(NoMethodError)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: not_naughty
 version: !ruby/object:Gem::Version 
-  version: 0.3.1
+  version: "0.4"
 platform: ruby
 authors: 
 - "Florian A\xC3\x9Fmann"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-02-14 00:00:00 +01:00
+date: 2008-02-18 00:00:00 +01:00
 default_executable: 
 dependencies: []