stringex 1.3.1 → 1.3.2

data/Rakefile

@@ -21,189 +21,189 @@ begin
       README.rdoc
       stringex.gemspec
       lib/stringex.rb
-      lib/lucky_sneaks/acts_as_url.rb
-      lib/lucky_sneaks/string_extensions.rb
-      lib/lucky_sneaks/unidecoder.rb
-      lib/lucky_sneaks/unidecoder_data/x00.yml
-      lib/lucky_sneaks/unidecoder_data/x01.yml
-      lib/lucky_sneaks/unidecoder_data/x02.yml
-      lib/lucky_sneaks/unidecoder_data/x03.yml
-      lib/lucky_sneaks/unidecoder_data/x04.yml
-      lib/lucky_sneaks/unidecoder_data/x05.yml
-      lib/lucky_sneaks/unidecoder_data/x06.yml
-      lib/lucky_sneaks/unidecoder_data/x07.yml
-      lib/lucky_sneaks/unidecoder_data/x09.yml
-      lib/lucky_sneaks/unidecoder_data/x0a.yml
-      lib/lucky_sneaks/unidecoder_data/x0b.yml
-      lib/lucky_sneaks/unidecoder_data/x0c.yml
-      lib/lucky_sneaks/unidecoder_data/x0d.yml
-      lib/lucky_sneaks/unidecoder_data/x0e.yml
-      lib/lucky_sneaks/unidecoder_data/x0f.yml
-      lib/lucky_sneaks/unidecoder_data/x10.yml
-      lib/lucky_sneaks/unidecoder_data/x11.yml
-      lib/lucky_sneaks/unidecoder_data/x12.yml
-      lib/lucky_sneaks/unidecoder_data/x13.yml
-      lib/lucky_sneaks/unidecoder_data/x14.yml
-      lib/lucky_sneaks/unidecoder_data/x15.yml
-      lib/lucky_sneaks/unidecoder_data/x16.yml
-      lib/lucky_sneaks/unidecoder_data/x17.yml
-      lib/lucky_sneaks/unidecoder_data/x18.yml
-      lib/lucky_sneaks/unidecoder_data/x1e.yml
-      lib/lucky_sneaks/unidecoder_data/x1f.yml
-      lib/lucky_sneaks/unidecoder_data/x20.yml
-      lib/lucky_sneaks/unidecoder_data/x21.yml
-      lib/lucky_sneaks/unidecoder_data/x22.yml
-      lib/lucky_sneaks/unidecoder_data/x23.yml
-      lib/lucky_sneaks/unidecoder_data/x24.yml
-      lib/lucky_sneaks/unidecoder_data/x25.yml
-      lib/lucky_sneaks/unidecoder_data/x26.yml
-      lib/lucky_sneaks/unidecoder_data/x27.yml
-      lib/lucky_sneaks/unidecoder_data/x28.yml
-      lib/lucky_sneaks/unidecoder_data/x2e.yml
-      lib/lucky_sneaks/unidecoder_data/x2f.yml
-      lib/lucky_sneaks/unidecoder_data/x30.yml
-      lib/lucky_sneaks/unidecoder_data/x31.yml
-      lib/lucky_sneaks/unidecoder_data/x32.yml
-      lib/lucky_sneaks/unidecoder_data/x33.yml
-      lib/lucky_sneaks/unidecoder_data/x4d.yml
-      lib/lucky_sneaks/unidecoder_data/x4e.yml
-      lib/lucky_sneaks/unidecoder_data/x4f.yml
-      lib/lucky_sneaks/unidecoder_data/x50.yml
-      lib/lucky_sneaks/unidecoder_data/x51.yml
-      lib/lucky_sneaks/unidecoder_data/x52.yml
-      lib/lucky_sneaks/unidecoder_data/x53.yml
-      lib/lucky_sneaks/unidecoder_data/x54.yml
-      lib/lucky_sneaks/unidecoder_data/x55.yml
-      lib/lucky_sneaks/unidecoder_data/x56.yml
-      lib/lucky_sneaks/unidecoder_data/x57.yml
-      lib/lucky_sneaks/unidecoder_data/x58.yml
-      lib/lucky_sneaks/unidecoder_data/x59.yml
-      lib/lucky_sneaks/unidecoder_data/x5a.yml
-      lib/lucky_sneaks/unidecoder_data/x5b.yml
-      lib/lucky_sneaks/unidecoder_data/x5c.yml
-      lib/lucky_sneaks/unidecoder_data/x5d.yml
-      lib/lucky_sneaks/unidecoder_data/x5e.yml
-      lib/lucky_sneaks/unidecoder_data/x5f.yml
-      lib/lucky_sneaks/unidecoder_data/x60.yml
-      lib/lucky_sneaks/unidecoder_data/x61.yml
-      lib/lucky_sneaks/unidecoder_data/x62.yml
-      lib/lucky_sneaks/unidecoder_data/x63.yml
-      lib/lucky_sneaks/unidecoder_data/x64.yml
-      lib/lucky_sneaks/unidecoder_data/x65.yml
-      lib/lucky_sneaks/unidecoder_data/x66.yml
-      lib/lucky_sneaks/unidecoder_data/x67.yml
-      lib/lucky_sneaks/unidecoder_data/x68.yml
-      lib/lucky_sneaks/unidecoder_data/x69.yml
-      lib/lucky_sneaks/unidecoder_data/x6a.yml
-      lib/lucky_sneaks/unidecoder_data/x6b.yml
-      lib/lucky_sneaks/unidecoder_data/x6c.yml
-      lib/lucky_sneaks/unidecoder_data/x6d.yml
-      lib/lucky_sneaks/unidecoder_data/x6e.yml
-      lib/lucky_sneaks/unidecoder_data/x6f.yml
-      lib/lucky_sneaks/unidecoder_data/x70.yml
-      lib/lucky_sneaks/unidecoder_data/x71.yml
-      lib/lucky_sneaks/unidecoder_data/x72.yml
-      lib/lucky_sneaks/unidecoder_data/x73.yml
-      lib/lucky_sneaks/unidecoder_data/x74.yml
-      lib/lucky_sneaks/unidecoder_data/x75.yml
-      lib/lucky_sneaks/unidecoder_data/x76.yml
-      lib/lucky_sneaks/unidecoder_data/x77.yml
-      lib/lucky_sneaks/unidecoder_data/x78.yml
-      lib/lucky_sneaks/unidecoder_data/x79.yml
-      lib/lucky_sneaks/unidecoder_data/x7a.yml
-      lib/lucky_sneaks/unidecoder_data/x7b.yml
-      lib/lucky_sneaks/unidecoder_data/x7c.yml
-      lib/lucky_sneaks/unidecoder_data/x7d.yml
-      lib/lucky_sneaks/unidecoder_data/x7e.yml
-      lib/lucky_sneaks/unidecoder_data/x7f.yml
-      lib/lucky_sneaks/unidecoder_data/x80.yml
-      lib/lucky_sneaks/unidecoder_data/x81.yml
-      lib/lucky_sneaks/unidecoder_data/x82.yml
-      lib/lucky_sneaks/unidecoder_data/x83.yml
-      lib/lucky_sneaks/unidecoder_data/x84.yml
-      lib/lucky_sneaks/unidecoder_data/x85.yml
-      lib/lucky_sneaks/unidecoder_data/x86.yml
-      lib/lucky_sneaks/unidecoder_data/x87.yml
-      lib/lucky_sneaks/unidecoder_data/x88.yml
-      lib/lucky_sneaks/unidecoder_data/x89.yml
-      lib/lucky_sneaks/unidecoder_data/x8a.yml
-      lib/lucky_sneaks/unidecoder_data/x8b.yml
-      lib/lucky_sneaks/unidecoder_data/x8c.yml
-      lib/lucky_sneaks/unidecoder_data/x8d.yml
-      lib/lucky_sneaks/unidecoder_data/x8e.yml
-      lib/lucky_sneaks/unidecoder_data/x8f.yml
-      lib/lucky_sneaks/unidecoder_data/x90.yml
-      lib/lucky_sneaks/unidecoder_data/x91.yml
-      lib/lucky_sneaks/unidecoder_data/x92.yml
-      lib/lucky_sneaks/unidecoder_data/x93.yml
-      lib/lucky_sneaks/unidecoder_data/x94.yml
-      lib/lucky_sneaks/unidecoder_data/x95.yml
-      lib/lucky_sneaks/unidecoder_data/x96.yml
-      lib/lucky_sneaks/unidecoder_data/x97.yml
-      lib/lucky_sneaks/unidecoder_data/x98.yml
-      lib/lucky_sneaks/unidecoder_data/x99.yml
-      lib/lucky_sneaks/unidecoder_data/x9a.yml
-      lib/lucky_sneaks/unidecoder_data/x9b.yml
-      lib/lucky_sneaks/unidecoder_data/x9c.yml
-      lib/lucky_sneaks/unidecoder_data/x9d.yml
-      lib/lucky_sneaks/unidecoder_data/x9e.yml
-      lib/lucky_sneaks/unidecoder_data/x9f.yml
-      lib/lucky_sneaks/unidecoder_data/xa0.yml
-      lib/lucky_sneaks/unidecoder_data/xa1.yml
-      lib/lucky_sneaks/unidecoder_data/xa2.yml
-      lib/lucky_sneaks/unidecoder_data/xa3.yml
-      lib/lucky_sneaks/unidecoder_data/xa4.yml
-      lib/lucky_sneaks/unidecoder_data/xac.yml
-      lib/lucky_sneaks/unidecoder_data/xad.yml
-      lib/lucky_sneaks/unidecoder_data/xae.yml
-      lib/lucky_sneaks/unidecoder_data/xaf.yml
-      lib/lucky_sneaks/unidecoder_data/xb0.yml
-      lib/lucky_sneaks/unidecoder_data/xb1.yml
-      lib/lucky_sneaks/unidecoder_data/xb2.yml
-      lib/lucky_sneaks/unidecoder_data/xb3.yml
-      lib/lucky_sneaks/unidecoder_data/xb4.yml
-      lib/lucky_sneaks/unidecoder_data/xb5.yml
-      lib/lucky_sneaks/unidecoder_data/xb6.yml
-      lib/lucky_sneaks/unidecoder_data/xb7.yml
-      lib/lucky_sneaks/unidecoder_data/xb8.yml
-      lib/lucky_sneaks/unidecoder_data/xb9.yml
-      lib/lucky_sneaks/unidecoder_data/xba.yml
-      lib/lucky_sneaks/unidecoder_data/xbb.yml
-      lib/lucky_sneaks/unidecoder_data/xbc.yml
-      lib/lucky_sneaks/unidecoder_data/xbd.yml
-      lib/lucky_sneaks/unidecoder_data/xbe.yml
-      lib/lucky_sneaks/unidecoder_data/xbf.yml
-      lib/lucky_sneaks/unidecoder_data/xc0.yml
-      lib/lucky_sneaks/unidecoder_data/xc1.yml
-      lib/lucky_sneaks/unidecoder_data/xc2.yml
-      lib/lucky_sneaks/unidecoder_data/xc3.yml
-      lib/lucky_sneaks/unidecoder_data/xc4.yml
-      lib/lucky_sneaks/unidecoder_data/xc5.yml
-      lib/lucky_sneaks/unidecoder_data/xc6.yml
-      lib/lucky_sneaks/unidecoder_data/xc7.yml
-      lib/lucky_sneaks/unidecoder_data/xc8.yml
-      lib/lucky_sneaks/unidecoder_data/xc9.yml
-      lib/lucky_sneaks/unidecoder_data/xca.yml
-      lib/lucky_sneaks/unidecoder_data/xcb.yml
-      lib/lucky_sneaks/unidecoder_data/xcc.yml
-      lib/lucky_sneaks/unidecoder_data/xcd.yml
-      lib/lucky_sneaks/unidecoder_data/xce.yml
-      lib/lucky_sneaks/unidecoder_data/xcf.yml
-      lib/lucky_sneaks/unidecoder_data/xd0.yml
-      lib/lucky_sneaks/unidecoder_data/xd1.yml
-      lib/lucky_sneaks/unidecoder_data/xd2.yml
-      lib/lucky_sneaks/unidecoder_data/xd3.yml
-      lib/lucky_sneaks/unidecoder_data/xd4.yml
-      lib/lucky_sneaks/unidecoder_data/xd5.yml
-      lib/lucky_sneaks/unidecoder_data/xd6.yml
-      lib/lucky_sneaks/unidecoder_data/xd7.yml
-      lib/lucky_sneaks/unidecoder_data/xf9.yml
-      lib/lucky_sneaks/unidecoder_data/xfa.yml
-      lib/lucky_sneaks/unidecoder_data/xfb.yml
-      lib/lucky_sneaks/unidecoder_data/xfc.yml
-      lib/lucky_sneaks/unidecoder_data/xfd.yml
-      lib/lucky_sneaks/unidecoder_data/xfe.yml
-      lib/lucky_sneaks/unidecoder_data/xff.yml
+      lib/stringex/acts_as_url.rb
+      lib/stringex/string_extensions.rb
+      lib/stringex/unidecoder.rb
+      lib/stringex/unidecoder_data/x00.yml
+      lib/stringex/unidecoder_data/x01.yml
+      lib/stringex/unidecoder_data/x02.yml
+      lib/stringex/unidecoder_data/x03.yml
+      lib/stringex/unidecoder_data/x04.yml
+      lib/stringex/unidecoder_data/x05.yml
+      lib/stringex/unidecoder_data/x06.yml
+      lib/stringex/unidecoder_data/x07.yml
+      lib/stringex/unidecoder_data/x09.yml
+      lib/stringex/unidecoder_data/x0a.yml
+      lib/stringex/unidecoder_data/x0b.yml
+      lib/stringex/unidecoder_data/x0c.yml
+      lib/stringex/unidecoder_data/x0d.yml
+      lib/stringex/unidecoder_data/x0e.yml
+      lib/stringex/unidecoder_data/x0f.yml
+      lib/stringex/unidecoder_data/x10.yml
+      lib/stringex/unidecoder_data/x11.yml
+      lib/stringex/unidecoder_data/x12.yml
+      lib/stringex/unidecoder_data/x13.yml
+      lib/stringex/unidecoder_data/x14.yml
+      lib/stringex/unidecoder_data/x15.yml
+      lib/stringex/unidecoder_data/x16.yml
+      lib/stringex/unidecoder_data/x17.yml
+      lib/stringex/unidecoder_data/x18.yml
+      lib/stringex/unidecoder_data/x1e.yml
+      lib/stringex/unidecoder_data/x1f.yml
+      lib/stringex/unidecoder_data/x20.yml
+      lib/stringex/unidecoder_data/x21.yml
+      lib/stringex/unidecoder_data/x22.yml
+      lib/stringex/unidecoder_data/x23.yml
+      lib/stringex/unidecoder_data/x24.yml
+      lib/stringex/unidecoder_data/x25.yml
+      lib/stringex/unidecoder_data/x26.yml
+      lib/stringex/unidecoder_data/x27.yml
+      lib/stringex/unidecoder_data/x28.yml
+      lib/stringex/unidecoder_data/x2e.yml
+      lib/stringex/unidecoder_data/x2f.yml
+      lib/stringex/unidecoder_data/x30.yml
+      lib/stringex/unidecoder_data/x31.yml
+      lib/stringex/unidecoder_data/x32.yml
+      lib/stringex/unidecoder_data/x33.yml
+      lib/stringex/unidecoder_data/x4d.yml
+      lib/stringex/unidecoder_data/x4e.yml
+      lib/stringex/unidecoder_data/x4f.yml
+      lib/stringex/unidecoder_data/x50.yml
+      lib/stringex/unidecoder_data/x51.yml
+      lib/stringex/unidecoder_data/x52.yml
+      lib/stringex/unidecoder_data/x53.yml
+      lib/stringex/unidecoder_data/x54.yml
+      lib/stringex/unidecoder_data/x55.yml
+      lib/stringex/unidecoder_data/x56.yml
+      lib/stringex/unidecoder_data/x57.yml
+      lib/stringex/unidecoder_data/x58.yml
+      lib/stringex/unidecoder_data/x59.yml
+      lib/stringex/unidecoder_data/x5a.yml
+      lib/stringex/unidecoder_data/x5b.yml
+      lib/stringex/unidecoder_data/x5c.yml
+      lib/stringex/unidecoder_data/x5d.yml
+      lib/stringex/unidecoder_data/x5e.yml
+      lib/stringex/unidecoder_data/x5f.yml
+      lib/stringex/unidecoder_data/x60.yml
+      lib/stringex/unidecoder_data/x61.yml
+      lib/stringex/unidecoder_data/x62.yml
+      lib/stringex/unidecoder_data/x63.yml
+      lib/stringex/unidecoder_data/x64.yml
+      lib/stringex/unidecoder_data/x65.yml
+      lib/stringex/unidecoder_data/x66.yml
+      lib/stringex/unidecoder_data/x67.yml
+      lib/stringex/unidecoder_data/x68.yml
+      lib/stringex/unidecoder_data/x69.yml
+      lib/stringex/unidecoder_data/x6a.yml
+      lib/stringex/unidecoder_data/x6b.yml
+      lib/stringex/unidecoder_data/x6c.yml
+      lib/stringex/unidecoder_data/x6d.yml
+      lib/stringex/unidecoder_data/x6e.yml
+      lib/stringex/unidecoder_data/x6f.yml
+      lib/stringex/unidecoder_data/x70.yml
+      lib/stringex/unidecoder_data/x71.yml
+      lib/stringex/unidecoder_data/x72.yml
+      lib/stringex/unidecoder_data/x73.yml
+      lib/stringex/unidecoder_data/x74.yml
+      lib/stringex/unidecoder_data/x75.yml
+      lib/stringex/unidecoder_data/x76.yml
+      lib/stringex/unidecoder_data/x77.yml
+      lib/stringex/unidecoder_data/x78.yml
+      lib/stringex/unidecoder_data/x79.yml
+      lib/stringex/unidecoder_data/x7a.yml
+      lib/stringex/unidecoder_data/x7b.yml
+      lib/stringex/unidecoder_data/x7c.yml
+      lib/stringex/unidecoder_data/x7d.yml
+      lib/stringex/unidecoder_data/x7e.yml
+      lib/stringex/unidecoder_data/x7f.yml
+      lib/stringex/unidecoder_data/x80.yml
+      lib/stringex/unidecoder_data/x81.yml
+      lib/stringex/unidecoder_data/x82.yml
+      lib/stringex/unidecoder_data/x83.yml
+      lib/stringex/unidecoder_data/x84.yml
+      lib/stringex/unidecoder_data/x85.yml
+      lib/stringex/unidecoder_data/x86.yml
+      lib/stringex/unidecoder_data/x87.yml
+      lib/stringex/unidecoder_data/x88.yml
+      lib/stringex/unidecoder_data/x89.yml
+      lib/stringex/unidecoder_data/x8a.yml
+      lib/stringex/unidecoder_data/x8b.yml
+      lib/stringex/unidecoder_data/x8c.yml
+      lib/stringex/unidecoder_data/x8d.yml
+      lib/stringex/unidecoder_data/x8e.yml
+      lib/stringex/unidecoder_data/x8f.yml
+      lib/stringex/unidecoder_data/x90.yml
+      lib/stringex/unidecoder_data/x91.yml
+      lib/stringex/unidecoder_data/x92.yml
+      lib/stringex/unidecoder_data/x93.yml
+      lib/stringex/unidecoder_data/x94.yml
+      lib/stringex/unidecoder_data/x95.yml
+      lib/stringex/unidecoder_data/x96.yml
+      lib/stringex/unidecoder_data/x97.yml
+      lib/stringex/unidecoder_data/x98.yml
+      lib/stringex/unidecoder_data/x99.yml
+      lib/stringex/unidecoder_data/x9a.yml
+      lib/stringex/unidecoder_data/x9b.yml
+      lib/stringex/unidecoder_data/x9c.yml
+      lib/stringex/unidecoder_data/x9d.yml
+      lib/stringex/unidecoder_data/x9e.yml
+      lib/stringex/unidecoder_data/x9f.yml
+      lib/stringex/unidecoder_data/xa0.yml
+      lib/stringex/unidecoder_data/xa1.yml
+      lib/stringex/unidecoder_data/xa2.yml
+      lib/stringex/unidecoder_data/xa3.yml
+      lib/stringex/unidecoder_data/xa4.yml
+      lib/stringex/unidecoder_data/xac.yml
+      lib/stringex/unidecoder_data/xad.yml
+      lib/stringex/unidecoder_data/xae.yml
+      lib/stringex/unidecoder_data/xaf.yml
+      lib/stringex/unidecoder_data/xb0.yml
+      lib/stringex/unidecoder_data/xb1.yml
+      lib/stringex/unidecoder_data/xb2.yml
+      lib/stringex/unidecoder_data/xb3.yml
+      lib/stringex/unidecoder_data/xb4.yml
+      lib/stringex/unidecoder_data/xb5.yml
+      lib/stringex/unidecoder_data/xb6.yml
+      lib/stringex/unidecoder_data/xb7.yml
+      lib/stringex/unidecoder_data/xb8.yml
+      lib/stringex/unidecoder_data/xb9.yml
+      lib/stringex/unidecoder_data/xba.yml
+      lib/stringex/unidecoder_data/xbb.yml
+      lib/stringex/unidecoder_data/xbc.yml
+      lib/stringex/unidecoder_data/xbd.yml
+      lib/stringex/unidecoder_data/xbe.yml
+      lib/stringex/unidecoder_data/xbf.yml
+      lib/stringex/unidecoder_data/xc0.yml
+      lib/stringex/unidecoder_data/xc1.yml
+      lib/stringex/unidecoder_data/xc2.yml
+      lib/stringex/unidecoder_data/xc3.yml
+      lib/stringex/unidecoder_data/xc4.yml
+      lib/stringex/unidecoder_data/xc5.yml
+      lib/stringex/unidecoder_data/xc6.yml
+      lib/stringex/unidecoder_data/xc7.yml
+      lib/stringex/unidecoder_data/xc8.yml
+      lib/stringex/unidecoder_data/xc9.yml
+      lib/stringex/unidecoder_data/xca.yml
+      lib/stringex/unidecoder_data/xcb.yml
+      lib/stringex/unidecoder_data/xcc.yml
+      lib/stringex/unidecoder_data/xcd.yml
+      lib/stringex/unidecoder_data/xce.yml
+      lib/stringex/unidecoder_data/xcf.yml
+      lib/stringex/unidecoder_data/xd0.yml
+      lib/stringex/unidecoder_data/xd1.yml
+      lib/stringex/unidecoder_data/xd2.yml
+      lib/stringex/unidecoder_data/xd3.yml
+      lib/stringex/unidecoder_data/xd4.yml
+      lib/stringex/unidecoder_data/xd5.yml
+      lib/stringex/unidecoder_data/xd6.yml
+      lib/stringex/unidecoder_data/xd7.yml
+      lib/stringex/unidecoder_data/xf9.yml
+      lib/stringex/unidecoder_data/xfa.yml
+      lib/stringex/unidecoder_data/xfb.yml
+      lib/stringex/unidecoder_data/xfc.yml
+      lib/stringex/unidecoder_data/xfd.yml
+      lib/stringex/unidecoder_data/xfe.yml
+      lib/stringex/unidecoder_data/xff.yml
     }
     gem.test_files       = %w{
       test/acts_as_url_test.rb
@@ -212,7 +212,7 @@ begin
     }
     gem.rdoc_options     = %w{--main README.rdoc --charset utf-8 --line-numbers}
     gem.extra_rdoc_files =  %w{MIT-LICENSE README.rdoc}
-    gem.version = "1.3.1"
+    gem.version = "1.3.2"
   end
 
   Jeweler::GemcutterTasks.new

data/lib/stringex/acts_as_url.rb

@@ -0,0 +1,107 @@
+# encoding: UTF-8
+module Stringex
+  module ActsAsUrl # :nodoc:
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    module ClassMethods # :doc:
+      # Creates a callback to automatically create an url-friendly representation
+      # of the <tt>attribute</tt> argument. Example:
+      #
+      #   act_as_url :title
+      #
+      # will use the string contents of the <tt>title</tt> attribute
+      # to create the permalink. <strong>Note:</strong> you can also use a non-database-backed
+      # method to supply the string contents for the permalink. Just use that method's name
+      # as the argument as you would an attribute.
+      #
+      # The default attribute <tt>acts_as_url</tt> uses to save the permalink is <tt>url</tt>
+      # but this can be changed in the options hash. Available options are:
+      #
+      # <tt>:url_attribute</tt>:: The name of the attribute to use for storing the generated url string.
+      #                           Default is <tt>:url</tt>
+      # <tt>:scope</tt>:: The name of model attribute to scope unique urls to. There is no default here.
+      # <tt>:only_when_blank</tt>:: If true, the url generation will only happen when <tt>:url_attribute</tt> is
+      #                             blank. Default is false (meaning url generation will happen always)
+      # <tt>:sync_url</tt>:: If set to true, the url field will be updated when changes are made to the
+      #                      attribute it is based on. Default is false.
+      def acts_as_url(attribute, options = {})
+        cattr_accessor :attribute_to_urlify
+        cattr_accessor :scope_for_url
+        cattr_accessor :url_attribute # The attribute on the DB
+        cattr_accessor :only_when_blank
+        cattr_accessor :duplicate_count_separator
+        cattr_accessor :allow_slash
+
+        if options[:sync_url]
+          before_validation(:ensure_unique_url)
+        else
+          if defined?(ActiveModel::Callbacks)
+            before_validation(:ensure_unique_url, :on => :create)
+          else
+            before_validation_on_create(:ensure_unique_url)
+          end
+        end
+
+        self.attribute_to_urlify = attribute
+        self.scope_for_url = options[:scope]
+        self.url_attribute = options[:url_attribute] || "url"
+        self.only_when_blank = options[:only_when_blank] || false
+        self.duplicate_count_separator = options[:duplicate_count_separator] || "-"
+        self.allow_slash = options[:allow_slash] || false
+
+        class_eval <<-"END"
+          def #{url_attribute}
+            if !new_record? && errors[attribute_to_urlify].present?
+              self.class.find(id).send(url_attribute)
+            else
+              read_attribute(url_attribute)
+            end
+          end
+        END
+      end
+
+      # Initialize the url fields for the records that need it. Designed for people who add
+      # <tt>acts_as_url</tt> support once there's already development/production data they'd
+      # like to keep around.
+      #
+      # Note: This method can get very expensive, very fast. If you're planning on using this
+      # on a large selection, you will get much better results writing your own version with
+      # using pagination.
+      def initialize_urls
+        find(:all, :conditions => {self.url_attribute => nil}).each do |instance|
+          instance.send :ensure_unique_url
+          instance.save
+        end
+      end
+    end
+
+  private
+
+    def ensure_unique_url
+      url_attribute = self.class.url_attribute
+      separator = self.class.duplicate_count_separator
+      base_url = self.send(url_attribute)
+      base_url = self.send(self.class.attribute_to_urlify).to_s.to_url(:allow_slash => self.allow_slash) if base_url.blank? || !self.only_when_blank
+      conditions = ["#{url_attribute} LIKE ?", base_url+'%']
+      unless new_record?
+        conditions.first << " and id != ?"
+        conditions << id
+      end
+      if self.class.scope_for_url
+        conditions.first << " and #{self.class.scope_for_url} = ?"
+        conditions << send(self.class.scope_for_url)
+      end
+      url_owners = self.class.find(:all, :conditions => conditions)
+      write_attribute url_attribute, base_url
+      if url_owners.any?{|owner| owner.send(url_attribute) == base_url}
+        n = 1
+        while url_owners.any?{|owner| owner.send(url_attribute) == "#{base_url}#{separator}#{n}"}
+          n = n.succ
+        end
+        write_attribute url_attribute, "#{base_url}#{separator}#{n}"
+      end
+    end
+  end
+end