alexrabarts-tld 0.2.0

data/History.txt

@@ -0,0 +1,15 @@
+=== 0.2.0 / 2008-11-25
+
+* ISO 3166-1 alpha-3 country codes made available
+
+=== 0.1.1 / 2008-11-25
+
+Bug fixes:
+
+* US-based .gov and .mil TLDs now return USD as their currency
+* .com no longer returns the currency for Comoros
+
+=== 0.1.0 / 2008-11-20
+
+* Initial release
+

data/Manifest.txt

@@ -0,0 +1,22 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/tld.rb
+lib/tld/alpha3.rb
+lib/tld/cc_tld.rb
+lib/tld/currency.rb
+lib/tld/generic_tld.rb
+lib/tld/infrastructure_tld.rb
+lib/tld/name.rb
+lib/tld/pseudo_tld.rb
+lib/tld/reserved_tld.rb
+lib/tld/retired_tld.rb
+lib/tld/sponsored_tld.rb
+lib/tld/tld.rb
+rakelib/cultivate.rake
+rakelib/tld.rake
+rakelib/tld.rb
+rakelib/tld.rb.erb
+test/test_tld.rb
+tld.gemspec

data/README.txt

@@ -0,0 +1,66 @@
+= TLD
+
+== DESCRIPTION:
+
+Provides meta information for Internet Top Level Domains (TLDs) such as a
+descriptive name, associated currency code and the TLD category.
+
+== SYNOPSIS:
+
+  # Find a descriptive name
+  TLD.find('au').name  # => "Australia"
+  TLD.find('biz').name # => "Business"
+
+  # Find the TLD category (country code, generic, infrastructure, pseudo,
+  # reserved, retired or sponsored)
+  TLD.find('au').type  # => :cc
+  TLD.find('biz').type # => :generic
+
+  # Find the ISO 4217 currency code for a ccTld
+  TLD.find('au').currency # => 'AUD'
+
+  # Find the ISO 3166-1 alpha-3 country code for a ccTld
+  TLD.find('uk').alpha3 # => 'GBR'
+
+  # Search with a hostname or URL
+  TLD.find('foo.com.au').name            # => "Australia"
+  TLD.find('http://foo.com.au/bar').name # => "Australia"
+
+== REQUIREMENTS:
+
+iso_country_codes gem (see http://github.com/alexrabarts/iso_country_codes)
+
+== INSTALL:
+
+* Via git:
+
+    git clone git://github.com/alexrabarts/tld.git
+
+* Via gem:
+
+    gem install alexrabarts-tld -s http://gems.github.com
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Stateless Systems (http://statelesssystems.com)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/tld.rb'
+
+Hoe.new('tld', TLD::VERSION) do |p|
+  # p.rubyforge_name = 'TLDx' # if different than lowercase project name
+  p.developer('Alex Rabarts', 'alexrabarts@gmail.com')
+  p.extra_deps = [
+    ['alexrabarts-iso_country_codes']
+  ]
+end
+
+# Load extra rake tasks.
+tasks_path = File.join(File.dirname(__FILE__), 'rakelib')
+rake_files = Dir["#{tasks_path}/*.rake"]
+rake_files.each{|rake_file| load rake_file}
+
+# vim: syntax=Ruby

data/lib/tld/alpha3.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'iso_country_codes'
+
+class TLD
+  class Alpha3
+    class << self
+      def find(klass)
+        tld = klass.tld
+        return tld.match(/^\w\w$/) ? IsoCountryCodes.find(TLD::MAP[tld.to_sym] || tld).alpha3 : nil
+      end
+    end
+  end
+end