ip2country 0.0.1 → 0.0.2

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2006 Matthew Harris
+
+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/README

@@ -0,0 +1,21 @@
+== Author
+The ip2country library for Ruby was written by Matthew Harris with many
+contributions by the Ruby community.
+
+== Synopsis
+This library provides a "IP to country" lookup mechanism for checking remote
+IP addresses against WebHosting.Info ip-to-country database to determine the
+IP's regional origin.
+
+== Usage
+  require 'rubygems'
+  require 'ip2country'
+
+  ip2c = IP2Country.new
+  ip   = '58.77.42.37'
+
+  if country = ip2c.lookup(ip)
+    puts "#{ip} belongs is located in: #{country.name} (#{country.cc})"
+  else
+    puts "The region for #{ip} could not be determined."
+  end

data/lib/ip2country.rb

@@ -3,7 +3,14 @@ require 'ip2country/country'
 
 # IP2Country is used to lookup a host IP from a specified user ip2country database
 # and determine their regional location.
+#
+#   "This script uses the IP-to-Country Database
+#    provided by WebHosting.Info (http://www.webhosting.info),
+#    available from http://ip-to-country.webhosting.info."
+#
 class IP2Country
+  attr_reader :db_file, :db
+
   # Initialize IP2Country instance using a specified database. If no database is
   # provided, then it will attempt to use the default one packaged with this
   # library.
@@ -15,7 +22,7 @@ class IP2Country
   # Lookup a host IP to figure out their region. If successful, an IP2Country::Country
   # instance will be returned, else nil.
   def lookup(ip)
-    long   = ip2long(ip)
+    long   = ip2long(ip.to_s)
     result = @db.execute("SELECT country_code2, country_code3, country_name FROM ip2country WHERE ip_from <= #{long} AND ip_to >= #{long}")[0]
     Country.new(*result) if result
   end

metadata

@@ -3,7 +3,7 @@ rubygems_version: 0.9.0
 specification_version: 1
 name: ip2country
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 date: 2007-05-01 00:00:00 +09:00
 summary: IP2Country library for Ruby
 require_paths: 
@@ -34,12 +34,15 @@ files:
 - lib/ip2country/country.rb
 - lib/ip2country/ip2country.db
 - bin/ip2c.updatedb
+- LICENSE
+- README
 test_files: []
 
-rdoc_options: []
-
-extra_rdoc_files: []
-
+rdoc_options: 
+- --main
+- README
+extra_rdoc_files: 
+- README
 executables: 
 - ip2c.updatedb
 extensions: []