whereabouts 0.5.3 → 0.5.4

data/README.markdown

@@ -1,5 +1,4 @@
-Whereabouts
-===========
+# Whereabouts
 
 Whereabouts is a Rails plugin that generates a polymorphic address model
 to be associated to ActiveRecord models. 
@@ -16,11 +15,15 @@ Run migrations
     
     rake db:migrate
 
+If you have the [Ruby Geocoder](http://www.rubygeocoder.com) specified in
+your project's Gemfile, adding {:geocode => true} to the has_whereabouts
+definition will automatically geocode and populate the latitude and
+longitude fields for the record.
 
-Examples
-=======
+# Examples
+
+## Basic use:  
 
-    # Basic use:  
     class Thing < ActiveRecord::Base
       has_whereabouts
     end
@@ -28,7 +31,8 @@ Examples
     t = Thing.new
     t.build_address
 
-    # Multiple addresses on same model:  
+## Multiple addresses on same model:  
+
     class Foo < ActiveRecord::Base
       has_whereabouts :shipping_address
       has_whereabouts :mailing_address
@@ -38,6 +42,26 @@ Examples
     f.build_shipping_address
     f.build_mailing_address
 
+## Validating Presence of Attributes
+
+    # Add :validate => [] to the option
+    # hash on the call to has_whereabouts.
+    # Options available in the array are
+    # :line1, :line2, :city, :state, :zip
+    class Thing < ActiveRecord::Base
+      has_whereabouts :location, {:validate => [:city, :state, :zip]}
+    end
+
+## Automatic Geocoding
+
+    # Must have Ruby Geocoder installed 
+    # and configured.  Will populate the
+    # latitude and longitude attributes
+    # on the Address
+    class Thing < ActiveRecord::Base
+      has_whereabouts :location, {:geocode => true}
+    end
+
 Contributing to whereabouts
 =========
  
@@ -50,5 +74,4 @@ Contributing to whereabouts
   * Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
 
 Copyright (c) 2011 [Nicholas Fine](http://ndfine.com), released under the MIT license  
-v0.5.1
 

data/VERSION

@@ -1 +1 @@
-0.5.3
+0.5.4

data/lib/whereabouts_methods.rb

@@ -1,46 +1,4 @@
-# **Whereabouts** is a Rails plugin that generates a polymorphic, inheritable
-# Address model.  Install it as a Rails plugin (Rails 3.x+ required)  
-#
-#     rails plugin install http://github.com/yrgoldteeth/whereabouts.git
-#
-# The most simple use case creates a has_one relationship with
-# a generic Address: 
-#
-#     class Foo < ActiveRecord::Base
-#       has_whereabouts
-#     end
-#     
-#     f = Foo.new
-#     f.build_address
-#
-# Also, a model can have any number of different inherited types of Addresses,
-# i.e. shipping address and mailing address  
-#
-#     class Foo < ActiveRecord::Base
-#       has_whereabouts :shipping
-#       has_whereabouts :mailing
-#     end
-#     
-#     f = Foo.new
-#     f.build_shipping
-#     f.build_mailing
-#
-# If you have the [Ruby Geocoder](http://www.rubygeocoder.com) specified in
-# your project's Gemfile, adding {:geocode => true} to the has_whereabouts
-# definition will automatically geocode and populate the latitude and
-# longitude fields for the record.
-#
-#     class Foo < ActiveRecord::Base
-#       has_whereabouts :shipping, {:geocode => true}
-#     end
-#
-# You can see the source on [github](https://github.com/yrgoldteeth/whereabouts), and
-# this page was generated with the wonderful
-# [rocco](http://rtomayko.github.com/rocco/) documentation generator.  
-
-# Hey, that's [me](http://ndfine.com)
 module Yrgoldteeth
-  # **Whereabouts**
   module Has
     module Whereabouts
 
@@ -49,7 +7,6 @@ module Yrgoldteeth
         base.extend ClassMethods
       end
 
-      # **ClassMethods**
       module ClassMethods
         # Accepts a symbol that will define the inherited 
         # type of Address.  Defaults to the parent class.

data/whereabouts.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{whereabouts}
-  s.version = "0.5.3"
+  s.version = "0.5.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nicholas Fine"]
-  s.date = %q{2011-07-13}
+  s.date = %q{2011-07-23}
   s.description = %q{Rails plugin for adding associated addresses to Active Record Models}
   s.email = %q{nicholas.fine@gmail.com}
   s.extra_rdoc_files = [

metadata

@@ -2,7 +2,7 @@
 name: whereabouts
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors: 
 - Nicholas Fine
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-13 00:00:00 -05:00
+date: 2011-07-23 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -118,7 +118,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 245214195
+      hash: -40591267
       segments: 
       - 0
       version: "0"