wideopenspaces-wicked 0.2.0 → 0.3.1

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
-:minor: 2
-:patch: 0
+:minor: 3
+:patch: 1
 :major: 0

data/lib/wicked.rb

@@ -7,63 +7,77 @@ module Wicked
   # Got it? Wicked Good!
   module Good
     
-    # Aliases for 'andand'
-    #     if phone = user.et.number; .... ; end
+    # Alias for 'andand' that reads like 'if user and number' 
+    #     if user.et.number...
     alias_method :et, :andand       # Latin for 'and'
 
-    #     if phone = user.ask.number ....
+    # Alias for 'andand' that reads like 'if user, ask its number' 
+    #     if user.ask.number...
     alias_method :ask, :andand
     
     # Alias for andand that's meaningful when checking booleans; 
     # this is the positive version of aint.
     #     "don't fix it" unless it.is.broken?
-    # Returns nil if 'it' is broken, so this is safer than:
-    #     "don't fix it" unless it.broken?
-    alias_method :is, :andand       
+    alias_method :is, :andand  
+    
+    # :nodoc:
+    alias_method :aintnot, :andand   
     
     # Guarded method negation in the style of andand
     # Returns the logical opposite of the method invoked on the receiver
-    #    receiver.aint.method
-    # Traps NoMethodError and returns nil if receiver is nil 
-    # or the method does not exist on the receiver. 
+    # Returns nil if receiver is nil or doesn't have method. 
     #
-    #     [].aint.empty?
-    #     => false
-    #     [].aint.nil?
-    #     => true
-    #     it.aint.broken?
-    #     => false
+    #     [].aint.empty?  => false
+    #     [].aint.nil?    => true
+    #     it.aint.broken? => false
     #
-    # Don't be a doofus, use this wisely, on boolean methods only
-    # if you know what's good for you.
-
+    # Don't be a doofus, use this wisely, on boolean methods only if you know what's good for you.
     def aint(p = nil)
       NotReturningMe.new(self) 
     end
     
     # A funny byproduct of using aint...
-    # But before you get confused, read it as 'is not nothing, which should be true except for nil)
+    # nil.aint_nothin? => false
     def aint_nothin?
       self.aint.nil?
     end
-    # See? You can laugh...
     alias_method :aint_it_somethin?, :aint_nothin?
     
-    # Ok, so here goes - true if nothing, like nil
+    # nil.is_nothin? => true
     def is_nothin?
       !self.is.nil?
     end
     
-    # A few stylistic variations on aint
+    # A few stylistic variations on aint for the grammatically uncreative ;)
+    # --   
+    # 'andnot' is probably the closest analogue to 'andand'  (and Ruby's 
+    # syntax - && !), unless you want to write out 'andandnot' :)
+    alias_method :andnot, :aint
+    
     alias_method :isnt, :aint
     alias_method :is_not, :aint
-    alias_method :notnot, :aint
+    # Removed #notnot in favor of #andnot
+    
+    # Just in case you can't keep your fingers off the Gs
+    alias_method :aint_nothing?, :aint_nothin?
+    alias_method :is_nothing?, :is_nothin?
     
-    # Hehe
-    alias_method :aintnot, :andand
-    # As in 'User, eh? Wot's yer number?'
-    #     if phone = user.eh?.number; .... ; end
-    alias_method :eh?, :andand
+    
+    
+    # Are you reading my notes? Well, cool!
+    # I wrote this for my personal site -- jacob-stetser.com -- and thought
+    # it might be useful to other people, so I extracted it!
+    
+    # Here's a few real-world uses:
+    # [Create or find a user, assign to 'user' and check if new record all in one line]
+    #    if (user = User.find_or_initialize_by_email(self.author_email)).is.new_record? ... end
+    # 
+    # [Safely simplify chained expressions] from:
+    #    if @current_user and role = @current_user.role and role.admin?
+    # to:
+    #    if @current_user.ask.role.is.admin? 
+    #
+    # Wicked Sweet. Ciao!
   end
   
 end

metadata

@@ -1,7 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: wideopenspaces-wicked
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  hash: 17
+  prerelease: 
+  segments: 
+  - 0
+  - 3
+  - 1
+  version: 0.3.1
 platform: ruby
 authors: 
 - Jacob Stetser
@@ -9,18 +15,24 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-01 00:00:00 -08:00
-default_executable: 
+date: 2009-02-01 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: andand
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 1
+        - 3
+        - 1
         version: 1.3.1
-    version: 
+  type: :runtime
+  version_requirements: *id001
 description: "Wicked Good extensions to Object in the vein of #andand"
 email: jake@wideopenspac.es
 executables: []
@@ -34,8 +46,9 @@ files:
 - lib/wicked.rb
 - test/test_helper.rb
 - test/wicked_test.rb
-has_rdoc: true
 homepage: http://github.com/wideopenspaces/wicked
+licenses: []
+
 post_install_message: 
 rdoc_options: 
 - --inline-source
@@ -43,21 +56,27 @@ rdoc_options:
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.2.0
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 2
 summary: "Wicked Good extensions to Object in the vein of #andand"