public
Description: Demonstrates a reference implementation for handling countries, regions, and addresses
Homepage: http://www.pluginaweek.org
Clone URL: git://github.com/pluginaweek/has_addresses.git
name age message
file .gitignore Fri Jul 04 15:48:04 -0700 2008 Ignore test/app_root/script [obrie]
file CHANGELOG.rdoc Fri May 01 18:02:32 -0700 2009 Tag 0.5.1 release [obrie]
file LICENSE Thu Apr 30 19:00:36 -0700 2009 Replace acts_as_enumeration with enumerate_by A... [obrie]
file README.rdoc Fri May 01 17:59:14 -0700 2009 Update to enumerate_by 0.4.1's #fast_bootstrap ... [obrie]
file Rakefile Tue Jun 09 20:32:06 -0700 2009 Add gemspec [obrie]
directory app/ Fri May 01 17:59:14 -0700 2009 Update to enumerate_by 0.4.1's #fast_bootstrap ... [obrie]
directory db/ Thu Apr 30 19:00:36 -0700 2009 Replace acts_as_enumeration with enumerate_by A... [obrie]
file has_addresses.gemspec Tue Jun 09 20:32:06 -0700 2009 Add gemspec [obrie]
file init.rb Sun Jul 22 13:00:39 -0700 2007 Initial release [obrie]
directory lib/ Thu Apr 30 19:00:36 -0700 2009 Replace acts_as_enumeration with enumerate_by A... [obrie]
directory test/ Fri May 01 17:59:14 -0700 2009 Update to enumerate_by 0.4.1's #fast_bootstrap ... [obrie]
README.rdoc

has_addresses

has_addresses demonstrates a reference implementation for handling countries, regions, and addresses.

Resources

API

Bugs

Development

Source

  • git://github.com/pluginaweek/has_addresses.git

Description

Countries, regions, and addresses are all simple models whose data and functionality should be able to be standardized across multiple applications. has_addresses adds support for countries and regions based on the ISO 3166 and ISO 3166-2 standard. The data for these standards is obtained through the open-source Debian package, iso-codes.

Along with the simple Country and Region models, addresses can be defined and integrated based on the data in these models. Addresses are minimalistic in terms of the type of data required.

Usage

Note that this is a reference implementation and, most likely, should be modified for your own usage.

Example

  address = Address.new(
    :street_1 => '1600 Amphitheatre Parkway',
    :city => 'Mountain View',
    :region => 'US-CA',
    :postal_code => '94043'
  )
  address.single_line # => "1600 Amphitheatre Parkway, Mountain View, California  94043, United States"

Testing

Before you can run any tests, the following gem must be installed:

To run against a specific version of Rails:

  rake test RAILS_FRAMEWORK_ROOT=/path/to/rails

Dependencies