anise 0.2.1 → 0.2.2

data/MANIFEST

@@ -1,18 +1,17 @@
-MANIFEST
+lib
+meta
 test
-test/test_attribute.rb
-test/test_annotator.rb
-test/suite.rb
-test/test_annotator_toplevel.rb
-test/test_annotations.rb
-test/test_attribute_toplevel.rb
-test/test_anise.rb
-test/test_anise_toplevel.rb
-test/test_annotations_toplevel.rb
+MANIFEST
 RELEASE
 README
 HISTORY
-meta
+VERSION
+COPYING
+lib/anise
+lib/anise.rb
+lib/anise/attribute.rb
+lib/anise/annotation.rb
+lib/anise/annotator.rb
 meta/require
 meta/created
 meta/homepage
@@ -21,11 +20,12 @@ meta/abstract
 meta/license
 meta/authors
 meta/contact
-lib
-lib/anise
-lib/anise/attribute.rb
-lib/anise/annotation.rb
-lib/anise/annotator.rb
-lib/anise.rb
-VERSION
-COPYING
+test/test_attribute.rb
+test/test_annotator.rb
+test/suite.rb
+test/test_annotator_toplevel.rb
+test/test_annotations.rb
+test/test_attribute_toplevel.rb
+test/test_anise.rb
+test/test_anise_toplevel.rb
+test/test_annotations_toplevel.rb

data/RELEASE

@@ -1,6 +1,4 @@
-= Anise 0.2.0 hits the streets.
-
-This is the first public release of Anise.
+= Anise 0.2.2 hits the streets.
 
 Anise is a spin off the the Facets annotations.rb library.
 It includes the Annotations functionality, and adds
@@ -9,8 +7,7 @@ annotations on the fly.
 
 ### 0.2.0 // 2008-09-23
 
-2 Major Enhancments
+1 Major Enhancments
 
-  * All parts of lib are now modules and not core extensions.
-  * Names of modules are more consistant.
+  * #ann! will auto-prime any referenced annotation if it does not yet exist.
 

data/VERSION

@@ -1 +1 @@
-anise 0.2.1 beta (2008-09-27)
+anise 0.2.2 beta (2009-02-11)

data/lib/anise/annotation.rb

@@ -37,7 +37,7 @@ module Anise
   #       instance_variables.each do |iv|
   #         if validator = self.class.ann(iv)[:valid]
   #           value = instance_variable_get(iv)
-  #           unless validator.call(vale)
+  #           unless validator.call(value)
   #             raise "Invalid value #{value} for #{iv}"
   #           end
   #         end
@@ -50,11 +50,11 @@ module Anise
   #   class X
   #     include Anise::Annotation
   #
-  #     ann self, :valid => lambda{ |x| x.is_a?(Integer) }
+  #     ann self, :valid => lambda{ |x| x.is_a?(Enumerable) }
   #   end
   #
   # Altough annotations are arbitrary they are tied to the class or
-  # module they are defined within.
+  # module they are defined against.
   #
   #--
   # TODO: By using a global variable rather the definining a class
@@ -111,7 +111,7 @@ module Anise
 
     # Set or read annotations.
     #
-    def ann( ref, keys_or_class=nil, keys=nil )
+    def ann(ref, keys_or_class=nil, keys=nil)
       return annotation(ref) unless keys_or_class or keys
 
       if Class === keys_or_class
@@ -136,9 +136,11 @@ module Anise
     # it first must be duplicated, otherwise the change may effect annotations
     # in the class or module's ancestors.
     #
-    def ann!( ref, keys_or_class=nil, keys=nil )
+    def ann!(ref, keys_or_class=nil, keys=nil)
       #return annotation(ref) unless keys_or_class or keys
-      return annotations[ref] unless keys_or_class or keys
+      unless keys_or_class or keys
+        return annotations[ref] ||= {}
+      end
 
       if Class === keys_or_class
         keys ||= {}
@@ -154,7 +156,12 @@ module Anise
         annotations[ref].update(keys)
       else
         key = keys.to_sym
-        annotations[ref][key] = annotation(ref)[key].dup
+        annotations[ref] ||= {}
+        begin
+          annotations[ref][key] = annotation(ref)[key].dup
+        rescue TypeError
+          annotations[ref][key] = annotation(ref)[key]
+        end
       end
     end
 
@@ -163,4 +170,4 @@ module Anise
 end
 
 # 2006-11-07 trans  Created this ultra-concise version of annotations.
-# Copyright (c) 2005, 2008 TigerOps
+# Copyright (c) 2005, 2008 TigerOps

data/lib/anise/annotator.rb

@@ -3,8 +3,8 @@ module Anise
 
   # = Annotator
   #
-  # Annotator allows for the creation of dynamic method
-  # annotations which attach to the next method defined.
+  # Annotator allows for the creation of dynamic <i>method
+  # annotations</i> which attach to the next method defined.
   #
   #   require 'anise/annotator'
   #
@@ -22,9 +22,16 @@ module Anise
   #
   #   X.ann(:see, :doc) #=> "See what I mean?"
   #
-  #--
-  # TODO: Thread safety of @pending_annotations.
-  #++
+  # This idiom of annotator before definition was popularized by
+  # Rake's desc/task pair. Annotator makes it very easy to add
+  # similar capabilites to any program.
+  #
+  # The library uses the #method_added callback, so be sure to
+  # respect good practices of calling +super+ if you need to override
+  # this method while using Annotator.
+  #
+  # TODO: Ensure thread safety of the internal <code>@pending_annotations</code> variable.
+  #
   module Annotator
 
     def self.append_features(base)

data/lib/anise/attribute.rb

@@ -8,8 +8,8 @@ module Anise
   # This framework modifies the major attr_* methods to allow easy
   # addition of annotations. It modifies the built in attribute methods
   # (attr, attr_reader, attr_writer and attr_accessor), to allow
-  # annotations to added to them directly rather than requireing a
-  # separate #ann statement.
+  # annotations to be added to them directly rather than requiring
+  # a separate #ann statement.
   #
   #   require 'anise/attribute'
   #
@@ -22,7 +22,7 @@ module Anise
   # See annotation.rb for more information.
   #
   # NOTE: This library was designed to be backward compatible with
-  #      the standard versions of the same methods.
+  #       the standard versions of the same methods.
   #
   module Attribute
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: anise
 version: !ruby/object:Gem::Version 
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors: 
 - tigerops-community@rubyforge.org
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-31 00:00:00 -04:00
+date: 2009-02-11 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency