0.01
The project is in a healthy, maintained state
Address Composer formats address components using worldwide regions formatting templates
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

~> 2.2
~> 0.14
~> 13.0
~> 3.10

Runtime

~> 1.1
 Project Readme

Address Composer

Based on an amazing work of OpenCage Data who collected so many international formats of postal addresses, this is a Ruby implementation of that formatter.

The goal of this gem is processing the output of ruby_postal

Installation

Add this line to your application's Gemfile:

gem 'address_composer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install address_composer

Usage

require "address_composer"

address_components = {
  "house_number" => 301,
  "road" => "Hamilton Avenue",
  "neighbourhood" => "Crescent Park",
  "city" => "Palo Alto",
  "postcode" => 94303,
  "county" => "Santa Clara County",
  "state" => "California",
  "country" => "United States of America",
  "country_code" => "US"
}

puts AddressComposer.compose(address_components)

301 Hamilton Avenue
Palo Alto, CA 94303
United States of America

Development

After checking out the repo, run git submodule init and git submodule update to fetch all the data from the submodule project and check out the mapped commit.

Then, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/mirubiri/address_composer

Many thanks to these implementations: