Skip to content
Demonstrates a reference implementation for handling countries, regions, and addresses
Ruby
Find file
Latest commit d677f97 Aug 6, 2011 @obrie obrie Integrate Travis CI
Failed to load latest commit information.
app/models Fix Region / Country models failing to load in Ruby 1.9+ due to chara… Feb 27, 2010
generators/has_addresses Add a generator for db migrations Feb 28, 2010
lib Move gem specification to gemspec and remove gemspec rake task Aug 6, 2011
test Fix test_helper getting loaded multiple times Mar 7, 2010
.gitignore Ignore generated gems Aug 6, 2011
.travis.yml Integrate Travis CI Aug 6, 2011
CHANGELOG.rdoc
Gemfile Add Gemfile Aug 6, 2011
LICENSE
README.rdoc Integrate Travis CI Aug 6, 2011
Rakefile Move gem specification to gemspec and remove gemspec rake task Aug 6, 2011
has_addresses.gemspec Add missing dependencies to gemspec Aug 6, 2011
init.rb Initial release Jul 22, 2007

README.rdoc

has_addresses

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

Resources

API

Bugs

Development

Testing

Source

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

Mailing List

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.

Installation

has_addresses requires additional database tables to work. You can generate a migration for these tables like so:

script/generate has_addresses

Then simply migrate your database:

rake db:migrate

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

Something went wrong with that request. Please try again.