focus 0.1.0

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2009 John Nunemaker (for initial structure)
+Copyright (c) 2009 Mark G.
+
+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.rdoc

@@ -0,0 +1,83 @@
+= focus
+
+A simple interface to the www.hostip.info API.
+
+= HostIP.info
+
+hostip.info is a "Community Geotarget IP Project" and provides a simple API
+to transform an "IP Address" into a location (including Country, City, and
+coordinates).
+
+No API key or sign-up is required to use the service.
+
+hostip.info does request that if a lot of databases lookups are being done
+that you download the entire database from them instead.
+
+= dependencies
+
+- [HTTParty](http://github.com/jnunemaker/httparty/tree/master)
+  [version used=0.3.1]
+- fakeweb [version used=1.2.0] [NOTE: only needed to run tests]
+
+= example
+
+== from the command line
+
+ # focus 209.85.171.100
+
+== from a ruby script
+
+ require 'rubygems'
+ require 'focus'
+ 
+ focus = Focus.new("209.85.171.100")
+ 
+ puts focus.location.coordinates
+
+== from a rails application
+
+=== in config/environment
+ 
+ require 'focus'
+ 
+=== in your controller
+ 
+ @focus = Focus.new("209.85.171.100")
+ 
+=== in your view
+
+ @focus.location.coordinates
+
+== from a rails application with caching
+
+Using caching is highly advised if possible.  The ip_address to location
+conversion doesn't normally change over time (if ever) so why continuously
+query it?
+
+Assumption: caching is already enabled and working.
+
+=== in config/environment
+ 
+ require 'focus'
+ 
+=== in your controller
+ 
+ ip_address = "209.85.171.100"
+ @focus = Rails.cache.fetch(Spotlight.key(ip_address), :expires_in => 1.weeks) do
+   Focus.new(ip_address)
+ end
+ 
+=== in your view
+
+ @focus.location.coordinates
+
+= credits
+
+Other then the code written by [me](http://github.com/attack) and the code
+created by ['jeweler'](http://github.com/technicalpickles/jeweler/tree/master)
+for making and maintaining gems, there is strong influence from
+[jnunemaker](http://github.com/jnunemaker) and the gem google-weather.
+
+== Copyright
+
+Copyright (c) 2009 Mark G. See LICENSE for details.

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 0
+:minor: 1
+:patch: 0

data/bin/focus

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+ 
+require File.dirname(__FILE__) + '/../lib/focus'
+#require 'rubygems'
+#require 'attack-focus'
+ 
+if ARGV.size == 0
+  puts 'Focus [Powered by hostip.info]'
+  puts 'USAGE: focus [ip_address]'
+  puts 'EXAMPLES:'
+  puts ' focus 209.85.171.100'
+  exit
+end
+ 
+focus = Focus.new(ARGV[0])
+
+puts "location -- name: #{focus.location.name}, latitude: #{focus.location.latitude}, longitude: #{focus.location.longitude}"
+puts "country  -- name: #{focus.country.name}, code: #{focus.country.code}"

data/lib/focus.rb

@@ -0,0 +1,60 @@
+require 'rubygems'
+gem 'jnunemaker-httparty'
+require 'httparty'
+
+require File.dirname(__FILE__) + '/focus/data'
+require File.dirname(__FILE__) + '/focus/country'
+require File.dirname(__FILE__) + '/focus/location'
+ 
+class Focus
+  include HTTParty
+  base_uri "api.hostip.info"
+
+  attr_reader :ip
+    
+  def initialize(ip_address)
+    raise unless Focus.valid?(ip_address)
+    @ip = ip_address
+    self.locate
+    self
+  end
+
+  # generate a key from the ip_address
+  def self.key(ip_address, prefix="focus")
+    raise unless self.valid?(ip_address)
+    segments = [prefix]
+    # this ip_address does not need to be encoded as it is a valid
+    # ip_address and only contains key-friendly chars
+    segments << ip_address
+    segments.join('-')
+  end
+
+  def country
+    @country ||= Country.new(@result)
+  end
+
+  def location
+    @location ||= Location.new(@result)
+  end
+  
+  protected
+  
+  # actually query HostIP.info with the 'IP address'
+  def locate
+    @result ||= self.class.get(
+      "/",
+      :query => {:ip => @ip},
+      :format => :xml
+    )['HostipLookupResultSet']['gml:featureMember']
+  end
+  
+  # validate an ip_address
+  # regular expression from http://www.ruby-forum.com/topic/62553
+  def self.valid?(ip_address)
+    return false unless ip_address.is_a?(String)
+    regexp = Regexp.new(/(?:25[0-5]|(?:2[0-4]|1\d|[1-9])?\d)(?:\.(?:25[0-5]|(?:2[0-4]|1\d|[1-9])?\d)){3}/)
+    return false unless regexp =~ ip_address
+    return true
+  end
+  
+end

data/lib/focus/country.rb

@@ -0,0 +1,21 @@
+class Focus
+  class Country < Data
+
+    def name
+      begin
+        return @data['Hostip']['countryName']
+      rescue
+        return nil
+      end
+    end
+
+    def code
+      begin
+        return @data['Hostip']['countryAbbrev']
+      rescue
+        return nil
+      end
+    end
+
+  end
+end

data/lib/focus/data.rb

@@ -0,0 +1,10 @@
+class Focus
+  class Data
+    attr_reader :data
+
+    def initialize(data)
+      @data = data
+    end
+
+  end
+end

data/lib/focus/location.rb

@@ -0,0 +1,31 @@
+class Focus
+  class Location < Data
+  
+    def name
+      begin
+        return @data['Hostip']['gml:name']
+      rescue
+        return nil
+      end
+    end
+    
+    def coordinates
+      begin
+        return @data['Hostip']['ipLocation']['gml:PointProperty']['gml:Point']['gml:coordinates']
+      rescue
+        return nil
+      end
+    end
+  
+    def longitude
+      return unless self.coordinates
+      self.coordinates.split(',')[0].to_f
+    end
+  
+    def latitude
+      return unless self.coordinates
+      self.coordinates.split(',')[1].to_f
+    end
+  
+  end
+end

data/spec/fixtures/199_246_67_211.xml

@@ -0,0 +1 @@
+<HostipLookupResultSet xsi:schemaLocation='http://www.hostip.info/api/hostip-1.0.0.xsd' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:gml='http://www.opengis.net/gml' version='1.0.0' xmlns='http://www.hostip.info/api'><gml:description>This is the Hostip Lookup Service</gml:description><gml:name>hostip</gml:name><gml:boundedBy><gml:Null>inapplicable</gml:Null></gml:boundedBy><gml:featureMember><Hostip><gml:name>TORONTO, ON</gml:name><countryName>CANADA</countryName><countryAbbrev>CA</countryAbbrev><!-- Co-ordinates are available as lng,lat --><ipLocation><gml:PointProperty><gml:Point srsName='http://www.opengis.net/gml/srs/epsg.xml#4326'><gml:coordinates>-79.3833,43.65</gml:coordinates></gml:Point></gml:PointProperty></ipLocation></Hostip></gml:featureMember></HostipLookupResultSet>

data/spec/focus_spec.rb

@@ -0,0 +1,191 @@
+require 'spec_helper'
+
+describe "Initialization" do
+  
+  before(:each) do
+    FakeWeb.register_uri(:get, 
+      "http://api.hostip.info/?ip=199.246.67.211",
+      :string => File.read(File.join(File.dirname(__FILE__), 
+        'fixtures', 
+        '199_246_67_211.xml')
+      )
+    )
+  end
+  
+  it "should require an ip address" do
+    lambda { Focus.new }.should raise_error
+      
+    Focus.new("199.246.67.211").ip.should == "199.246.67.211"
+  end
+  
+  it "should require a proper ip address" do
+    lambda { Focus.new(199) }.should raise_error
+    lambda { Focus.new(199.246) }.should raise_error
+    lambda { Focus.new({:test => "test"}) }.should raise_error
+    lambda { Focus.new(["test"]) }.should raise_error
+    lambda { Focus.new("199") }.should raise_error
+    lambda { Focus.new("199.246") }.should raise_error
+    lambda { Focus.new("199.246.67") }.should raise_error
+    lambda { Focus.new("aaa.246.67.211") }.should raise_error
+    lambda { Focus.new("199.aaa.67.211") }.should raise_error
+    lambda { Focus.new("199.246.aaa.211") }.should raise_error
+    lambda { Focus.new("199.246.67.aaa") }.should raise_error
+    lambda { Focus.new("") }.should raise_error
+    lambda { Focus.new(" ") }.should raise_error
+    lambda { Focus.new("aaa") }.should raise_error
+    
+    # sanity check
+    lambda { Focus.new("199.246.67.211") }.should_not raise_error
+  end
+    
+end
+
+describe "Focus" do
+  
+  it "should create an ip based key" do
+    Focus.key("199.246.67.211").should == "focus-199.246.67.211"
+  end
+    
+  it "should create an ip based key with defined prefix" do
+    Focus.key("199.246.67.211", "alternate").should == "alternate-199.246.67.211"
+  end
+
+end
+
+describe "Data" do
+  
+  it "should require data" do
+    lambda { Focus::Data.new }.should raise_error
+      
+    data = {'foo' => {'data' => 'bar'}}
+    Focus::Data.new(data).data.should == data
+  end
+  
+end
+
+describe "Location" do
+  
+  it "should require data" do
+    lambda { Focus::Location.new }.should raise_error
+      
+    data = {'foo' => {'data' => 'bar'}}
+    Focus::Location.new(data).data.should == data
+  end
+  
+  it "should return nil when the data does not exist" do
+    data = {}
+    location = Focus::Location.new(data)
+    location.should_not be_nil
+    
+    location.name.should be_nil
+    location.coordinates.should be_nil
+    location.longitude.should be_nil
+    location.latitude.should be_nil
+  end
+  
+  # @data['Hostip']['gml:name']
+  it "should respond to name" do
+    data = {'Hostip' => {'gml:name' => "test_name"}}
+    location = Focus::Location.new(data)
+    location.should_not be_nil
+    
+    location.name.should == "test_name"
+  end
+  
+  # @data['Hostip']['ipLocation']['gml:PointProperty']['gml:Point']['gml:coordinates']
+  it "should respond to coordinates" do
+    data = {'Hostip' => {'ipLocation' => {'gml:PointProperty' => {'gml:Point' => {'gml:coordinates' => "-79.3833,43.65"}}}}}
+    location = Focus::Location.new(data)
+    location.should_not be_nil
+    
+    location.coordinates.should == "-79.3833,43.65"
+  end
+  
+  # @data['Hostip']['ipLocation']['gml:PointProperty']['gml:Point']['gml:coordinates']
+  it "should respond to longitude" do
+    data = {'Hostip' => {'ipLocation' => {'gml:PointProperty' => {'gml:Point' => {'gml:coordinates' => "-79.3833,43.65"}}}}}
+    location = Focus::Location.new(data)
+    location.should_not be_nil
+    
+    location.longitude.should == -79.3833
+  end
+
+  # @data['Hostip']['ipLocation']['gml:PointProperty']['gml:Point']['gml:coordinates']
+  it "should respond to latitude" do
+    data = {'Hostip' => {'ipLocation' => {'gml:PointProperty' => {'gml:Point' => {'gml:coordinates' => "-79.3833,43.65"}}}}}
+    location = Focus::Location.new(data)
+    location.should_not be_nil
+    
+    location.latitude.should == 43.65
+  end
+  
+end
+  
+describe "Country" do
+
+  it "should require data" do
+    lambda { Focus::Country.new }.should raise_error
+
+    data = {'foo' => {'data' => 'bar'}}
+    Focus::Country.new(data).data.should == data
+  end
+
+  it "should return nil when the data does not exist" do
+    data = {}
+    country = Focus::Country.new(data)
+    country.should_not be_nil
+
+    country.name.should be_nil
+    country.code.should be_nil
+  end
+
+  # @data['Hostip']['countryName']
+  it "should respond to name" do
+    data = {'Hostip' => {'countryName' => "test_name"}}
+    country = Focus::Country.new(data)
+    country.should_not be_nil
+
+    country.name.should == "test_name"
+  end
+
+  # @data['Hostip']['countryAbbrev']
+  it "should respond to coordinates" do
+    data = {'Hostip' => {'countryAbbrev' => "CA"}}
+    country = Focus::Country.new(data)
+    country.should_not be_nil
+
+    country.code.should == "CA"
+  end
+
+end
+
+describe "Fetching" do
+  
+  before(:each) do
+    FakeWeb.register_uri(:get, 
+      "http://api.hostip.info/?ip=199.246.67.211",
+      :string => File.read(File.join(File.dirname(__FILE__), 
+        'fixtures', 
+        '199_246_67_211.xml')
+      )
+    )
+    @focus = Focus.new("199.246.67.211")
+  end
+  
+  it "should have location information" do
+    @focus.location.should_not be_nil
+    location = @focus.location
+    location.name.should == 'TORONTO, ON'
+    location.coordinates.should == '-79.3833,43.65'
+    location.longitude.should == -79.3833
+    location.latitude.should == 43.65
+  end
+  
+  it "should have country information" do
+    @focus.country.should_not be_nil
+    country = @focus.country
+    country.name.should == 'CANADA'
+    country.code.should == 'CA'
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'spec'
+require 'fakeweb'
+
+FakeWeb.allow_net_connect = false
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'focus'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: focus
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Mark G
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-18 00:00:00 -06:00
+default_executable: focus
+dependencies: []
+
+description: 
+email: focus@attackcorp.com
+executables: 
+- focus
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- README.rdoc
+- VERSION.yml
+- bin/focus
+- lib/focus
+- lib/focus/country.rb
+- lib/focus/data.rb
+- lib/focus/location.rb
+- lib/focus.rb
+- spec/fixtures
+- spec/fixtures/199_246_67_211.xml
+- spec/focus_spec.rb
+- spec/spec_helper.rb
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/attack/focus
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+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: []
+
+rubyforge_project: focus
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: []
+