has_addresses 0.0.2 → 0.5.0

data/test/unit/region_test.rb

@@ -1,101 +1,144 @@
 require "#{File.dirname(__FILE__)}/../test_helper"
 
-unless ENV['LIVE']
-  Region::ISO_3166_2_URL = "#{RAILS_ROOT}/../files/iso_3166_2.xml"
-end
-
-class RegionTest < Test::Unit::TestCase
-  fixtures :countries, :regions, :addresses
-  
-  def test_should_download_and_parse_regions_from_iso_standard
-    regions = Region.download_all
-    assert_instance_of Array, regions
-    assert !regions.empty?
+class RegionByDefaultTest < ActiveRecord::TestCase
+  def setup
+    @region = Region.new
   end
   
-  def test_bootstrap_should_remove_existing_records
-    region = Region.create(:name => 'Test', :country_id => 840, :abbreviation => 'TE')
-    assert !region.new_record?
-    Region.bootstrap
-    assert_nil Region.find_by_name('Test')
+  def test_should_not_have_a_country
+    assert_nil @region.country_id
   end
   
-  def test_bootstrap_should_insert_downloaded_regions
-    Region.bootstrap
-    assert Region.count > 1
+  def test_should_not_have_a_group
+    assert_nil @region.group
   end
   
-  def test_bootstrap_should_return_true_if_successful
-    assert Region.bootstrap
+  def test_should_not_have_a_name
+    assert_nil @region.name
   end
   
-  def test_should_use_default_path_for_created_fixture
-    Region.create_fixtures
-    assert File.exists?("#{RAILS_ROOT}/db/bootstrap/regions.yml")
+  def test_should_not_have_an_abbreviation
+    assert_nil @region.abbreviation
   end
   
-  def test_should_allow_custom_path_for_created_fixture
-    Region.create_fixtures('db/bootstrap/the_regions.yml')
-    assert File.exists?("#{RAILS_ROOT}/db/bootstrap/the_regions.yml")
+  def test_should_use_id_for_abbreviation_if_not_specified
+    region = Region.new(:id => 1005)
+    assert_equal '005', region.abbreviation
+    
+    region = Region.new(:id => 1052)
+    assert_equal '052', region.abbreviation
+    
+    region = Region.new(:id => 1523)
+    assert_equal '523', region.abbreviation
+    
+    region = Region.new(:id => 15234)
+    assert_equal '234', region.abbreviation
   end
   
-  def test_created_fixture_should_load_into_table
-    Region.create_fixtures
-    Fixtures.create_fixtures("#{RAILS_ROOT}/db/bootstrap", 'regions')
-    assert Region.count > 1
+  def test_should_not_use_id_for_abbreviation_if_specified
+    region = Region.new(:id => 1005, :abbreviation => 'CA')
+    assert_equal 'CA', region.abbreviation
   end
   
-  def test_should_be_valid
-    assert_valid regions(:california)
+  def test_should_use_country_and_abbreviation_for_code_if_not_specified
+    region = Region.new(:country => create_country(:alpha_2_code => 'US'), :abbreviation => 'CA')
+    assert_equal 'US-CA', region.code
   end
   
-  def test_should_require_name
-    assert_invalid regions(:california), :name, nil
+  def test_should_use_country_and_abbreviation_for_code_if_specified
+    region = Region.new(:country => create_country(:alpha_2_code => 'US'), :abbreviation => 'CA', :code => 'US--CA')
+    assert_equal 'US-CA', region.code
+  end
+end
+
+class RegionTest < ActiveRecord::TestCase
+  def test_should_be_valid_with_a_set_of_valid_attributes
+    region = new_region
+    assert region.valid?
   end
   
-  def test_should_restrict_name_length
-    assert_invalid regions(:california), :name, 'C', 'C' * 81
-    assert_valid regions(:california), :name, 'Ca', 'C' * 80
+  def test_should_require_a_code
+    region = new_region
+    region.code = nil
+    assert !region.valid?
+    assert region.errors.invalid?(:code)
   end
   
-  def test_should_require_unique_name_per_country
-    region = regions(:california).clone
-    assert_invalid region, :name
+  def test_should_require_a_unique_code
+    country = create_country
+    
+    region = new_region(:country => country)
+    region.code = 'US-CA'
+    region.save!
     
-    region.country = countries(:canada)
-    assert_valid region, :name
+    region = new_region(:country => country)
+    region.code = 'US-CA'
+    assert !region.valid?
+    assert region.errors.invalid?(:code)
   end
   
-  def test_should_require_abbreviation
-    assert_invalid regions(:california), :abbreviation, nil
+  def test_should_require_a_name
+    region = new_region(:name => nil)
+    assert !region.valid?
+    assert region.errors.invalid?(:name)
   end
   
-  def test_should_restrict_abbreviation_length
-    assert_invalid regions(:california), :abbreviation, '', 'C' * 6
-    assert_valid regions(:california), :abbreviation, 'CA', 'C' * 5
+  def test_should_require_a_country
+    region = new_region(:country => nil)
+    assert !region.valid?
+    assert region.errors.invalid?(:country_id)
   end
   
-  def test_should_require_unique_abbreviation_per_country
-    region = regions(:california).clone
-    assert_invalid region, :abbreviation
+  def test_should_require_an_abbreviation
+    region = new_region(:abbreviation => nil)
+    assert !region.valid?
+    assert region.errors.invalid?(:abbreviation)
+  end
+  
+  def test_should_not_allow_abbrevations_shorter_than_1_or_longer_than_5_characters
+    region = new_region(:abbreviation => '')
+    assert !region.valid?
+    assert region.errors.invalid?(:abbreviation)
+    
+    region.abbreviation += 'a'
+    assert region.valid?
     
-    region.country = countries(:canada)
-    assert_valid region, :abbreviation
+    region.abbreviation += 'aaaa'
+    assert region.valid?
+    
+    region.abbreviation += 'a'
+    assert !region.valid?
+    assert region.errors.invalid?(:abbreviation)
   end
   
-  def test_should_belong_to_a_country
-    assert_equal countries(:united_states), regions(:california).country
+  def test_should_not_require_a_group
+    region = new_region(:group => nil)
+    assert region.valid?
   end
   
-  def test_should_have_many_addresses
-    assert_equal [addresses(:in_known_region), addresses(:google_headquarters), addresses(:google_sales)], regions(:california).addresses
+  def test_should_use_code_for_stringification
+    region = new_region(:country => create_country(:alpha_2_code => 'US'), :abbreviation => 'CA')
+    assert_equal 'US-CA', region.to_s
+  end
+end
+
+class RegionAfterBeingCreatedTest < ActiveRecord::TestCase
+  def setup
+    @region = create_region
   end
   
-  def test_should_use_name_for_stringification
-    assert_equal 'California', regions(:california).to_s
+  def test_should_not_have_any_addresses
+    assert_equal 0, @region.addresses.size
+  end
+end
+
+class RegionWithAddressesTest < ActiveRecord::TestCase
+  def setup
+    @region = create_region
+    @address = create_address(:region => @region)
   end
   
-  def teardown
-    FileUtils.rmtree("#{RAILS_ROOT}/db/bootstrap")
+  def test_should_have_addresses
+    assert_equal [@address], @region.addresses
   end
 end

metadata

@@ -1,33 +1,35 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
 name: has_addresses
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
-date: 2007-09-26 00:00:00 -04:00
-summary: Adds a base skeleton for handling countries, regions, and addresses.
-require_paths: 
-- lib
-email: info@pluginaweek.org
-homepage: http://www.pluginaweek.org
-rubyforge_project: 
-description: 
-autorequire: has_addresses
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 0.5.0
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
-- Aaron Pfeifer, Neil Abraham
+- Aaron Pfeifer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-30 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: enumerate_by
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.0
+    version: 
+description: 
+email: aaron@pluginaweek.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
 files: 
 - app/models
 - app/models/country.rb
@@ -35,53 +37,60 @@ files:
 - app/models/address.rb
 - db/migrate
 - db/migrate/001_create_countries.rb
-- db/migrate/003_create_addresses.rb
 - db/migrate/002_create_regions.rb
+- db/migrate/003_create_addresses.rb
 - lib/has_addresses.rb
-- tasks/has_addresses_tasks.rake
+- test/factory.rb
 - test/test_helper.rb
-- test/fixtures
-- test/app_root
+- test/functional
+- test/functional/has_addresses_test.rb
 - test/unit
-- test/files
-- test/fixtures/regions.yml
-- test/fixtures/companies.yml
-- test/fixtures/addresses.yml
-- test/fixtures/countries.yml
-- test/app_root/config
-- test/app_root/app
+- test/unit/address_test.rb
+- test/unit/region_test.rb
+- test/unit/country_test.rb
+- test/app_root
 - test/app_root/db
+- test/app_root/db/migrate
+- test/app_root/db/migrate/002_migrate_has_addresses_to_version_3.rb
+- test/app_root/db/migrate/001_create_companies.rb
+- test/app_root/config
 - test/app_root/config/environment.rb
+- test/app_root/app
 - test/app_root/app/models
 - test/app_root/app/models/company.rb
-- test/app_root/db/migrate
-- test/app_root/db/migrate/001_create_companies.rb
-- test/app_root/db/migrate/002_add_address_kinds.rb
-- test/unit/country_test.rb
-- test/unit/region_test.rb
-- test/unit/has_addresses_test.rb
-- test/unit/address_test.rb
-- test/files/iso_3166.xml
-- test/files/iso_3166_2.xml
-- CHANGELOG
+- CHANGELOG.rdoc
 - init.rb
-- MIT-LICENSE
+- LICENSE
 - Rakefile
-- README
-test_files: 
-- test/unit/country_test.rb
-- test/unit/region_test.rb
-- test/unit/has_addresses_test.rb
-- test/unit/address_test.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://www.pluginaweek.org
+post_install_message: 
 rdoc_options: []
 
-extra_rdoc_files: []
-
-executables: []
-
-extensions: []
-
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: []
-
+rubyforge_project: pluginaweek
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Demonstrates a reference implementation for handling countries, regions, and addresses.
+test_files: 
+- test/functional/has_addresses_test.rb
+- test/unit/address_test.rb
+- test/unit/region_test.rb
+- test/unit/country_test.rb

data/CHANGELOG

@@ -1,23 +0,0 @@
-*SVN*
-
-*0.0.2* (September 26th, 2007)
-
-* Move test fixtures out of the test application root directory
-
-*0.0.1* (August 21st, 2007)
-
-* Add documentation
-
-* Add descriptive output for rake tasks
-
-* Remove dependency on has_association_helper
-
-* Remove default bootstrap files in favor of creating new ones through the bootstrap tasks
-
-* Add tests for rake tests
-
-* Fix not allowing single character abbreviations for regions
-
-* Add countries:create_fixtures, countries:bootstrap, regions:create_fixtures, and regions:bootstrap files
-
-* Refactor Rake code into Country/Region classes

data/README

@@ -1,122 +0,0 @@
-= has_addresses
-
-+has_addresses+ adds a base skeleton for handling countries, regions, and
-addresses.
-
-== Resources
-
-API
-
-* http://api.pluginaweek.org/has_addresses
-
-Wiki
-
-* http://wiki.pluginaweek.org/Has_addresses
-
-Announcement
-
-* http://www.pluginaweek.org
-
-Source
-
-* http://svn.pluginaweek.org/trunk/plugins/active_record/has/has_addresses
-
-Development
-
-* http://dev.pluginaweek.org/browser/trunk/plugins/active_record/has/has_addresses
-
-== 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 and follows the standard U.S. format.
-
-== Usage
-
-=== Running migrations
-
-To migrate the tables required for this plugin, you can either run the
-migration from the command line like so:
-
-  rake db:migrate:plugins PLUGIN=has_addresses
-
-or (more ideally) generate a migration file that will integrate into your main
-application's migration path:
-
-  ruby script/generate plugin_migration has_addresses
-
-=== Bootstrapping the database
-
-+has_addresses+ comes bundled with tasks for bootstrapping the countries and
-regions table based on the ISO 3166 and ISO 3166-2 standard.  You can bootstrap
-the database using built-in rake tasks or by creating fixtures which contain the
-bootstrap data.
-
-To bootstrap country/region data into the current database schema:
-
-  $ rake countries:bootstrap
-  (in /my/project)
-  Downloading ISO 3166 data...
-  Parsing countries...
-  Loading countries into database...
-  Done!
-  
-  $ rake regions:bootstrap
-  Downloading ISO 3166 data...
-  Parsing countries...
-  Downloading ISO 3166-2 data...
-  Parsing regions...
-  Loading regions into database...
-  Done!
-
-To create fixtures for the country/region bootstrap data:
-
-  $ rake countries:create_fixtures
-  (in /my/project)
-  Downloading ISO 3166 data...
-  Parsing countries...
-  Saving countries to /my/project/config/../db/bootstrap/countries.yml...
-  Done!
-  
-  $ rake regions:create_fixtures
-  (in /my/project)
-  Downloading ISO 3166 data...
-  Parsing countries...
-  Downloading ISO 3166-2 data...
-  Parsing regions...
-  Saving regions to /my/project/config/../db/bootstrap/regions.yml...
-  Done!
-
-== Testing
-
-Before you can run any tests, the following gems must be installed:
-* plugin_test_helper[http://wiki.pluginaweek.org/Plugin_test_helper]
-* dry_validity_assertions[http://wiki.pluginaweek.org/Dry_validity_assertions]
-
-Since the rake tasks for installing TinyMCE and updating the configuration
-options are part of the unit tests, already-downloaded files are included with
-the plugin.  If you want to perform a "live" test which actually downloads the
-files off the Internet (rather than using the local versions), you must set
-the LIVE environment variable to true.  For example,
-
-  rake test LIVE=true
-
-== Dependencies
-
-This plugin is a plugin+.  That means that it contains a slice of an
-application, such as models and migrations.  To test or use a plugin+, you
-must have the following plugins/gems installed:
-* plugin_dependencies[http://wiki.pluginaweek.org/Plugin_dependencies]
-* loaded_plugins[http://wiki.pluginaweek.org/Loaded_plugins]
-* appable_plugins[http://wiki.pluginaweek.org/Appable_plugins]
-* plugin_migrations[http://wiki.pluginaweek.org/Plugin_migrations]
-
-Instead of installing each individual plugin+ feature, you can install them all
-at once using the plugins+[http://wiki.pluginaweek.org/Plugins_plus] meta package,
-which contains all additional features.

data/tasks/has_addresses_tasks.rake

@@ -1,23 +0,0 @@
-namespace :countries do
-  desc 'Generates a new fixtures file for the countries table'
-  task :create_fixtures => :environment do
-    Country.create_fixtures(ENV['OUTPUT'])
-  end
-  
-  desc 'Bootstraps the countries table with the latest ISO 3166 standard'
-  task :bootstrap => :environment do
-    Country.bootstrap
-  end
-end
-
-namespace :regions do
-  desc 'Generates a new fixtures file for the regions table'
-  task :create_fixtures => :environment do
-    Region.create_fixtures(ENV['OUTPUT'])
-  end
-  
-  desc 'Bootstraps the regions table with the latest ISO 3166-2 standard'
-  task :bootstrap => :environment do
-    Region.bootstrap
-  end
-end

data/test/app_root/db/migrate/002_add_address_kinds.rb

@@ -1,9 +0,0 @@
-class AddAddressKinds < ActiveRecord::Migration
-  def self.up
-    add_column :addresses, :kind, :string
-  end
-  
-  def self.down
-    remove_column :addresses, :kind
-  end
-end