0
@@ -1,2 +1,3 @@
0
 pkg
0
 coverage
0
+doc

0
@@ -1,3 +1,9 @@
0
+== 0.0.2 2009-04-??
0
+
0
+* Enhancements
0
+  * Better documentation
0
+  * Modify String class directly instead of using a mix-in
0
+
0
 == 0.0.1 2008-04-08
0
 
0
 * 1 major enhancement:

0
@@ -1,5 +1,4 @@
0
-ConstantCache
0
-===============
0
+= Constant Cache
0
 
0
 When your database has tables that store lookup data, there is a tendency 
0
 to provide those values as constants in the model.  If you have an
0
@@ -21,21 +20,19 @@ The constants are stored as integer values and need to match up exactly
0
 with the data that's in the table (not necessarily a bad thing), but this
0
 solution forces you to write code like this:
0
 
0
-Account.new(:username => 'preagan', :status => AccountStatus.find(AccountStatus::PENDING))
0
+  Account.new(:username => 'preagan', :status => AccountStatus.find(AccountStatus::PENDING))
0
 
0
 This requires multiple calls to find and obfuscates the code a bit.  Since classes
0
 in Ruby are executable code, we can cache the objects from the database at runtime
0
 and use them in your application.
0
 
0
-Installation
0
-============
0
+== Installation
0
 
0
 This code is packaged as a gem, so simply use the `gem` command to install:
0
 
0
   gem install constant_cache
0
 
0
-Example
0
-=======
0
+== Example
0
 
0
 "Out of the box," the constant_cache gem assumes that you want to use the 'name' column to generate
0
 constants from a column called 'name' in your database table.  Assuming this schema:
0
@@ -72,4 +69,9 @@ well:
0
     caches_constants :limit => 16
0
   end
0
 
0
-Copyright (c) 2007 Patrick Reagan of Viget Labs (patrick.reagan@viget.com), released under the MIT license
0
+== Acknowlegements
0
+
0
+Thanks to Dave Thomas for inspiring me to write this during his Metaprogramming talk at a Rails Edge 
0
+conference in early 2007.
0
+
0
+Copyright (c) 2007 Patrick Reagan of Viget Labs (mailto:patrick.reagan@viget.com), released under the MIT license

0
@@ -26,8 +26,7 @@ spec = Gem::Specification.new do |s|
0
   s.add_dependency('activesupport', '>= 2.0.2')
0
   
0
   s.require_path = 'lib'
0
-  s.autorequire = GEM
0
-  s.files = %w(MIT-LICENSE README Rakefile HISTORY) + Dir.glob("{lib,spec}/**/*")
0
+  s.files = %w(MIT-LICENSE README  Rakefile HISTORY) + Dir.glob("{lib,spec}/**/*")
0
 end
0
 
0
 Rake::GemPackageTask.new(spec) do |pkg|

0
@@ -1,6 +1,5 @@
0
-require 'constant_cache/format'
0
+require 'constant_cache/core_ext'
0
 require 'constant_cache/cache_methods'
0
 
0
-String.send(:include, ConstantCache::Format)
0
 ActiveRecord::Base.send(:extend, ConstantCache::CacheMethods::ClassMethods)
0
 ActiveRecord::Base.send(:include, ConstantCache::CacheMethods::InstanceMethods)
0
\ No newline at end of file

0
@@ -1,15 +1,48 @@
0
 module ConstantCache
0
+
0
+  CHARACTER_LIMIT = 64
0
   
0
+  # 
0
+  # Generated constant conflicts with an existing constant
0
+  #
0
   class DuplicateConstantError < StandardError; end
0
-  class InvalidLimitError < StandardError; end
0
+  class InvalidLimitError < StandardError #:nodoc:
0
+  end
0
   
0
-  module CacheMethods
0
+  module CacheMethods #:nodoc:
0
 
0
     module ClassMethods
0
+      
0
+      #
0
+      # The caches_constants method is the core of the functionality behind this mix-in.  It provides
0
+      # a simple interface to cache the data in the corresponding table as constants on the model:
0
+      #
0
+      #   class Status
0
+      #     caches_constants
0
+      #   end
0
+      # 
0
+      # It makes certain assumptions about your schema: the constant created is based off of a <tt>name</tt>
0
+      # column in the database and long names are truncated to ConstantCache::CHARACTER_LIMIT characters before 
0
+      # being set as constants. If there is a 'Pending' status in the database, you will now have a 
0
+      # Status::PENDING constant that points to an instance of ActiveRecord.
0
+      #
0
+      # Beyond the basics, some configuration is allowed. You can change both the column that is used to generate
0
+      # the constant and the truncation length:
0
+      #
0
+      #   class State
0
+      #     caches_constants :key => :abbreviation, :limit => 2
0
+      #   end
0
+      #
0
+      # This will use the <tt>abbreviation</tt> column to generate constants and will truncate constant names to 2 
0
+      # characters at the maximum.
0
+      #
0
+      # Note: In the event that a generated constant conflicts with an existing constant, a 
0
+      # ConstantCache::DuplicateConstantError is raised.
0
+      #
0
       def caches_constants(additional_options = {})
0
         cattr_accessor :cache_options
0
 
0
-        self.cache_options = {:key => :name, :limit => 64}.merge(additional_options)
0
+        self.cache_options = {:key => :name, :limit => ConstantCache::CHARACTER_LIMIT}.merge(additional_options)
0
         
0
         raise ConstantCache::InvalidLimitError, "Limit of #{self.cache_options[:limit]} is invalid" if self.cache_options[:limit] < 1        
0
         find(:all).each {|model| model.set_instance_as_constant }
0
@@ -18,16 +51,23 @@ module ConstantCache
0
 
0
     module InstanceMethods
0
 
0
-      def constant_name
0
+      def constant_name #:nodoc:
0
         constant_name = self.send(self.class.cache_options[:key].to_sym).constant_name
0
         constant_name = constant_name[0, self.class.cache_options[:limit]] unless constant_name.blank?
0
         constant_name
0
       end
0
+      private :constant_name
0
 
0
+      # 
0
+      # Create a constant on the class that pointing to an instance
0
+      #
0
       def set_instance_as_constant
0
         const = constant_name
0
         if !const.blank?
0
-          raise ConstantCache::DuplicateConstantError, "Constant #{self.class.to_s}::#{const} has already been defined" if self.class.const_defined?(const)
0
+          if self.class.const_defined?(const)
0
+            message = "Constant #{self.class.to_s}::#{const} has already been defined"
0
+            raise ConstantCache::DuplicateConstantError, message
0
+          end
0
           self.class.const_set(const, self) if !const.blank?
0
         end
0
       end

0
@@ -1,9 +1,9 @@
0
 module ConstantCache
0
   
0
-  module VERSION
0
+  module VERSION  #:nodoc:
0
     MAJOR = 0
0
     MINOR = 0
0
-    TINY  = 1
0
+    TINY  = 2
0
     
0
     STRING = [MAJOR, MINOR, TINY].join('.')
0
   end

0
@@ -5,8 +5,6 @@ require 'mocha'
0
 require 'activesupport'
0
 require 'activerecord'
0
 
0
-
0
-
0
 lib_dir = File.join(File.dirname(__FILE__), %w(.. lib constant_cache))
0
 
0
 Dir.glob("#{lib_dir}/*.rb").each {|file| require file }
0
@@ -27,7 +25,6 @@ end
0
 Spec::Runner.configuration.mock_with :mocha
0
 Spec::Runner.configuration.include ConstantCache::SpecHelper
0
 
0
-String.send(:include, ConstantCache::Format)
0
 ActiveRecord::Base.send(:include, ConstantCache::CacheMethods::InstanceMethods)
0
 ActiveRecord::Base.send(:extend, ConstantCache::CacheMethods::ClassMethods)
0