addresslogic_rails 0.0.2

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+doc/*
+.idea

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in addresslogic_rails.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,73 @@
+= Address Logic
+
+This is a simple library that takes away the annoyances of displaying addresses in a view. Since various parts of an address can sometimes be optional, such as "street2", displaying addresses was not fun:
+
+== Example ERB use
+
+  <%= address.street1 %>
+  <br />
+  <% if !address.street2.blank? %>
+    <%= address.street2 %>
+  <% end %>
+  <br />
+  <%= "#{address.city}, #{address.state} #{address.zip}" %>
+  <br />
+  <%= address.country %>
+
+That's just ugly. Instead, you can do this with Address Logic:
+
+  <%= address.address_parts.join("<br />") %>
+
+== Example HAML use
+
+  # some HAML view
+  = address.street1
+  %br
+  - if !address.street2.blank?
+    = address.street2
+    %br
+  == #{address.city}, #{address.state} #{address.zip}
+  %br
+  = address.country
+
+That's just ugly. Instead, you can do this with Address Logic:
+
+  = address.address_parts.join("<br />")
+
+Or, what about a single line address?
+
+  = address.address_parts.join(", ")
+
+Maybe you only want city and state:
+
+  = address.address_parts(:only => [:city, :state]).join(", ")
+
+Granted the above is probably easier without using AddressLogic, but it will purge any blank items in the address, so if city or state are optional then it would be cleaner to use AddressLogic.
+
+== Install and use
+
+Install from rubyforge/gemcutter
+
+  $ sudo gem install addresslogic_rails
+
+
+Then just include the AddressLogic module into any class of your choice. All that it assumes is that you have the street1, street2, city, state, zip, country (optional) methods.
+
+  class Address
+    apply_addresslogic
+  end
+
+You can specify the fields too:
+
+  class Address
+    apply_addresslogic :fields => [:street1, :street2, :city, [:state, :zip], :country]
+  end
+
+== Helpful links
+
+*       <b>Documentation:</b> (Coming soon)
+
+
+== Authors / Copyright
+*       Copyright (c) 2009 Ben Johnson of [Binary Logic](http://www.binarylogic.com), released under the MIT license
+*       This release (c) 2011 Mike Simkins of [G7OBS Software](http://software.g7obs.com), released under the MIT license

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/addresslogic_rails.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "addresslogic_rails/version"
+
+Gem::Specification.new do |s|
+  s.name        = "addresslogic_rails"
+  s.version     = AddresslogicRails::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Mike Simkins", "Ben Johnson"]
+  s.email       = ["software@g7obs.com"]
+  s.homepage    = ""
+  s.summary     = %q{AddressLogic for Rails 3}
+  s.description = %q{This is a gem port of binary logics 'addresslogic' to Rails 3 and a Gem}
+
+  s.rubyforge_project = "addresslogicr3"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/addresslogic_rails.rb

@@ -0,0 +1,70 @@
+module AddresslogicRails
+  def self.included(base)
+    base.extend ClassMethods
+  end
+  
+  module ClassMethods
+    attr_accessor :addresslogic_options
+    
+    # Mixes in useful methods for handling addresses.
+    #
+    # === Options
+    #
+    # * <tt>fields:</tt> array of fields (default: [:street1, :street2, [:city, [:state, :zip]], :country])
+    # * <tt>namespace:</tt> prefixes fields names with this, great for use with composed_of in ActiveRecord.
+    def apply_addresslogic(options = {})
+      n = options[:namespace]
+      options[:fields] ||= [
+        "#{n}street1".to_sym,
+        "#{n}street2".to_sym,
+        ["#{n}city".to_sym, ["#{n}state".to_sym, "#{n}zip".to_sym]],
+        "#{n}country".to_sym
+      ]
+      self.addresslogic_options = options
+      
+      include AddresslogicRails::InstanceMethods
+    end
+  end
+  
+  module InstanceMethods
+    # Returns the parts of an address in an array. Example:
+    #
+    #   ["Street1", "Street2", "City", "State Zip", "Country"]
+    #
+    # This makes displaying addresses on your view pretty simple:
+    #
+    #   address.address_parts.join("<br />")
+    #
+    # === Options
+    #
+    # * <tt>only:</tt> fields you want included in the result
+    # * <tt>except:</tt> any fields you want excluded from the result
+    def address_parts(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      options[:only] = [options[:only]] if options[:only] && !options[:only].is_a?(Array)
+      options[:except] = [options[:except]] if options[:except] && !options[:except].is_a?(Array)
+      fields = args[0] || self.class.addresslogic_options[:fields]
+      level = args[1] || 0
+      
+      parts = []
+      fields.each do |field|
+        if field.is_a?(Array)
+          has_sub_array = field.find { |item| item.is_a?(Array) }
+          separator = has_sub_array ? ", " : " "
+          sub_parts = address_parts(field, level + 1, options).join(separator)
+          next if sub_parts.empty?
+          parts << sub_parts
+        else
+          next if !respond_to?(field)
+          value = send(field)
+          next if value.to_s.strip == "" || (options[:only] && !options[:only].include?(field)) || (options[:except] && options[:except].include?(field))
+          parts << value
+        end
+      end
+      
+      parts
+    end
+  end
+end
+
+Object.send(:include, AddresslogicRails)

data/lib/addresslogic_rails/version.rb

@@ -0,0 +1,3 @@
+module AddresslogicRails
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification 
+name: addresslogic_rails
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 2
+  version: 0.0.2
+platform: ruby
+authors: 
+- Mike Simkins
+- Ben Johnson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-22 00:00:00 +00:00
+default_executable: 
+dependencies: []
+
+description: This is a gem port of binary logics 'addresslogic' to Rails 3 and a Gem
+email: 
+- software@g7obs.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- addresslogic_rails.gemspec
+- lib/addresslogic_rails.rb
+- lib/addresslogic_rails/version.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: addresslogicr3
+rubygems_version: 1.6.0
+signing_key: 
+specification_version: 3
+summary: AddressLogic for Rails 3
+test_files: []
+