easy_geoip 0.1.0

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+0.1.0 / 2015-08-03
+------
+First release of EasyGeoIP.
+
+Supports the three following free IP lookup services:
+* [Teilize](https://www.telize.com)
+* [Freegeoip](https://www.freegeoip.net)
+* [Nekudo](http://geoip.nekudo.com)

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing
+
+1. Fork it ( https://github.com/gchan/easy_geoip/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Testing
+
+Run `bundle exec rake test` to manually launch specs.
+
+Run `bin/guard` to automatically launch specs when files are modified.
+
+Run `rake rubocop` to analyze code for style offenses.

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Gordon Chan
+
+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.md

@@ -0,0 +1,201 @@
+# EasyGeoip
+[![Gem Version](https://badge.fury.io/rb/easy_geoip.svg)](http://badge.fury.io/rb/easy_geoip) [![Dependency Status](https://gemnasium.com/gchan/easy_geoip.svg)](https://gemnasium.com/gchan/easy_geoip) ![License](https://img.shields.io/badge/license-MIT-blue.svg)
+
+[![Build Status](https://travis-ci.org/gchan/easy_geoip.svg?branch=master)](https://travis-ci.org/gchan/easy_geoip) [![Coverage Status](https://coveralls.io/repos/gchan/easy_geoip/badge.svg?branch=master)](https://coveralls.io/r/gchan/easy_geoip?branch=master) [![Code Climate](https://codeclimate.com/github/gchan/easy_geoip/badges/gpa.svg)](https://codeclimate.com/github/gchan/easy_geoip)
+
+A common Ruby interface to retrieve IP-based [geolocation](https://en.wikipedia.org/wiki/Geolocation) information from various free and open source IP geolocation services.
+
+No database downloads, no registration, no API keys, ~~no~~ [minimal](https://github.com/gchan/easy_geoip/blob/master/easy_geoip.gemspec#L27) dependencies. *Easy!*
+
+![Easy!](https://github.com/gchan/easy_geoip/blob/master/easy.gif)
+
+#### Quick Example
+
+```ruby
+EasyGeoIP.query("8.8.8.8")
+
+=> #<EasyGeoIP::GeoData:0x007f91b9512960
+ @city="Mountain View",
+ @continent_code="NA",
+ @country="United States",
+ @country_code="US",
+ @ip="8.8.8.8",
+ @isp="Google Inc.",
+ @latitude=37.386,
+ @longitude=-122.0838,
+ @postal_code="94040",
+ @region="California",
+ @region_code="CA",
+ @time_zone="America/Los_Angeles">
+
+# IPv6 is also supported
+EasyGeoIP.query("2001:4860:4860::8888")
+```
+
+See the 'Usage' section for more information.
+
+## IP Geolocation Services
+
+EasyGeoIP currently supports the geolocation services listed below. All these services are free, open source, and require no registration or authentication.
+
+Regardless of which service is used, geolocation information is returned in the same format for ease of use. See the `EasyGeoIP::GeoData` section below for more information.
+
+#### Telize (Default) `:telize`
+* **HTTPS**: Yes
+* **Limits**: None
+* **Open Source License**: MIT
+* **GitHub Project**: https://www.github.com/fcambus/telize
+* **Homepage**: https://www.telize.com
+
+#### Freegeoip `:freegeoip`
+* **HTTPS**: Yes
+* **Limits**: 10,000 queries per hour
+* **Open Source License**: BSD 3-clause
+* **GitHub Project**: https://www.github.com/fiorix/freegeoip
+* **Homepage**: https://www.freegeoip.net
+
+#### Nekudo `:nekudo`
+* **HTTPS**: No
+* **Limits**: None, but fair use policy applies
+* **Open Source License**: BSD 3-clause
+* **GitHub Project**: https://www.github.com/nekudo/shiny_geoip
+* **Homepage**: http://geoip.nekudo.com
+
+All of the above services use data provided by [MaxMind](http://www.maxmind.com).
+
+### Reliability
+
+The services listed above are free, require no registration, and supported by volunteer developers. It it generally understood that such services are traditionally more likely to experience downtime or disruption.
+
+If IP geolocation is mission-critical in your application, consider using a paid service to mitigate the risk of downtime and disruption.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'easy_geoip'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install easy_geoip
+
+
+#### Supported Ruby versions
+EasyGeoIP supports MRI Ruby 1.9+ and the JRuby and Rubinius equivalent. The specific Ruby versions we build and test on can be found at [TravisCI](https://travis-ci.org/gchan/easy_geoip).
+
+## Usage
+
+#### Configuration
+
+EasyGeoIP supports a few free IP geolocation services; the default is [Telize](https://www.telize.com) but EasyGeoIP can easily be configured to use another service.
+
+```ruby
+# The default geolocation service is Telize
+EasyGeoIP.api_service
+=> :telize
+
+# Variable assignment
+EasyGeoIP.api_service = :nekudo
+
+# Calling `.configure` with Hash argument
+EasyGeoIP.configure(api_service: :freegeoip)
+
+# Calling `.configure` with a block
+EasyGeoIP.configure do |config|
+  config.api_service = :telize
+end
+```
+
+#### Querying IPs - One Method to Rule Them All
+
+Use the `query` method to retrieve geolocation information for a specified IPv4 or IPv6 address. An instance of `EasyGeoIP::GeoData` is returned.
+
+```ruby
+EasyGeoIP.query("8.8.8.8")
+
+# `EasyGeoIP::GeoData` object is returned
+=> #<EasyGeoIP::GeoData:0x007f91b9512960
+ @city="Mountain View",
+ @continent_code="NA",
+ @country="United States",
+ @country_code="US",
+ @ip="8.8.8.8",
+ @isp="Google Inc.",
+ @latitude=37.386,
+ @longitude=-122.0838,
+ @postal_code="94040",
+ @region="California",
+ @region_code="CA",
+ @time_zone="America/Los_Angeles">
+```
+
+**Bonus** - Pass in `nil`, an empty string or no arguments and the default geolocation service, [Telize](https://www.telize.com) will return the geolocation information for your IP address!
+
+```ruby
+EasyGeoIP.query(nil)
+EasyGeoIP.query("")
+EasyGeoIP.query
+```
+
+#### EasyGeoIP::GeoData
+
+Regardless of which service you use, geolocation information is returned as a `EasyGeoIP::GeoData` object where its attributes are easily accessible. Calling `#to_hash` returns all information as a `Hash`.
+
+```ruby
+geo_data = EasyGeoIP.query("8.8.8.8")
+
+geo_data.city           # => "Mountain View"
+geo_data.continent_code # => "NA"
+geo_data.country        # => "United States"
+geo_data.country_code   # => "US"
+geo_data.ip             # => "8.8.8.8"
+geo_data.isp            # => "Google Inc."
+geo_data.latitude       # => 37.386
+geo_data.longitude      # => -122.0838
+geo_data.postal_code    # => "94040"
+geo_data.region         # => "California"
+geo_data.region_code    # => "CA"
+geo_data.time_zone      # => "America/Los_Angeles"
+
+# Return a Hash of all attributes
+geo_data.to_hash
+
+=> {:ip=>"8.8.8.8",
+ :country=>"United States",
+ :country_code=>"US",
+ :city=>"Mountain View",
+ :region=>"California",
+ :region_code=>"CA",
+ :postal_code=>"94040",
+ :continent_code=>"NA",
+ :latitude=>37.386,
+ :longitude=>-122.0838,
+ :time_zone=>"America/Los_Angeles",
+ :isp=>"Google Inc."}
+```
+
+#### Errors
+
+In addition to the usual Ruby errors and exceptions, EasyGeoIP can raise the following errors:
+
+* `EasyGeoIP::Error::ClientError`
+* `EasyGeoIP::Error::ConnectionFailed`
+* `EasyGeoIP::Error::TimeoutError`
+* `EasyGeoIP::Error::ResourceNotFound`
+* `EasyGeoIP::Error::ParsingError`
+
+All of the above error classes inherit `EasyGeoIP::Error::ClientError`, `EasyGeoIP::Error`, and `StandardError`.
+
+## Contributing & Development
+
+Please view [CONTRIBUTING.md](https://github.com/gchan/easy_geoip/blob/master/CONTRIBUTING.md) for contributing and development information.
+
+## License
+
+EasyGeoIP is Copyright (c) 2015 Gordon Chan and is released under the MIT License. It is free software, and may be redistributed under the terms specified in the LICENSE file.

data/easy_geoip.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "easy_geoip/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "easy_geoip"
+  spec.version       = EasyGeoIP::VERSION
+  spec.authors       = ["Gordon Chan"]
+  spec.email         = ["developer.gordon@gmail.com"]
+
+  spec.summary       = "A small, simple, and easy IP geolocation client."
+  spec.description   = "A common Ruby interface for various free IP geolocation
+    services. Small, simple and easy to use."
+  spec.homepage      = "https://www.github.com/gchan/easy_geoip"
+  spec.license       = "MIT"
+
+  spec.files         = Dir["lib/**/*.rb"] +
+    %w(CHANGELOG.md LICENSE README.md CONTRIBUTING.md CODE_OF_CONDUCT.md
+       easy_geoip.gemspec)
+  spec.bindir        = "bin"
+  spec.require_paths = ["lib"]
+  spec.platform      = Gem::Platform::RUBY
+
+  spec.required_ruby_version = ">= 1.9.3"
+
+  spec.add_runtime_dependency "faraday", "~> 0.9.1"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "pry", "~> 0.10.1"
+
+  spec.add_development_dependency "minitest", "~> 5.7.0"
+  spec.add_development_dependency "mocha", "~> 1.1.0"
+  spec.add_development_dependency "minitest-profile", "~> 0.0.2"
+  spec.add_development_dependency "minitest-reporters", "~> 1.0.19"
+  spec.add_development_dependency "guard", "~> 2.13.0"
+  spec.add_development_dependency "guard-minitest", "~> 2.4.4"
+
+  spec.add_development_dependency "vcr", "~> 2.9.3"
+  spec.add_development_dependency "webmock", "~> 1.21.0"
+  spec.add_development_dependency "multi_json", "~> 1.11.0"
+  spec.add_development_dependency "simplecov", "~> 0.10.0"
+  spec.add_development_dependency "rubocop", "~> 0.32.1"
+  spec.add_development_dependency "coveralls", "~> 0.8.2"
+  spec.add_development_dependency "codeclimate-test-reporter", "~> 0.4.7"
+end

data/lib/easy_geoip.rb

@@ -0,0 +1,35 @@
+require "easy_geoip/version"
+require "easy_geoip/apis"
+
+module EasyGeoIP
+  extend self
+
+  attr_accessor :api_service
+
+  def configure(settings = {}, &block)
+    apply_configuration(settings)
+
+    yield self if block
+    true
+  end
+
+  def query(ip)
+    api.query(ip)
+  end
+
+  def api_service
+    @api_service || :telize
+  end
+
+  private
+
+  def api
+    API.const_get(api_service.capitalize)
+  end
+
+  def apply_configuration(settings)
+    settings.each do |attr, value|
+      send("#{attr}=", value)
+    end
+  end
+end

data/lib/easy_geoip/api/freegeoip.rb

@@ -0,0 +1,30 @@
+require "easy_geoip/api/query"
+
+module EasyGeoIP
+  module API
+    module Freegeoip
+      extend Query
+
+      private
+
+      def self.url(ip)
+        "https://freegeoip.net/json/#{ip}"
+      end
+
+      def self.standardize_geodata(json)
+        {
+          ip:            json["ip"],
+          country:       json["country_name"],
+          country_code:  json["country_code"],
+          city:          json["city"],
+          region:        json["region_name"],
+          region_code:   json["region_code"],
+          postal_code:   json["zip_code"],
+          latitude:      json["latitude"],
+          longitude:     json["longitude"],
+          time_zone:     json["time_zone"]
+        }
+      end
+    end
+  end
+end

data/lib/easy_geoip/api/nekudo.rb

@@ -0,0 +1,27 @@
+require "easy_geoip/api/query"
+
+module EasyGeoIP
+  module API
+    module Nekudo
+      extend Query
+
+      private
+
+      def self.url(ip)
+        "http://geoip.nekudo.com/api/#{ip}"
+      end
+
+      def self.standardize_geodata(json)
+        {
+          ip:            json["ip"],
+          country:       json["country"]["name"],
+          country_code:  json["country"]["code"],
+          city:          json["city"],
+          latitude:      json["location"]["latitude"],
+          longitude:     json["location"]["longitude"],
+          time_zone:     json["location"]["time_zone"]
+        }
+      end
+    end
+  end
+end

data/lib/easy_geoip/api/query.rb

@@ -0,0 +1,16 @@
+require "easy_geoip/client"
+require "easy_geoip/geo_data"
+
+module EasyGeoIP
+  module API
+    module Query
+      def query(ip = "")
+        url      = url(ip)
+        json     = EasyGeoIP::Client.get_json(url)
+        geo_data = standardize_geodata(json)
+
+        EasyGeoIP::GeoData.new(geo_data)
+      end
+    end
+  end
+end

data/lib/easy_geoip/api/telize.rb

@@ -0,0 +1,32 @@
+require "easy_geoip/api/query"
+
+module EasyGeoIP
+  module API
+    module Telize
+      extend Query
+
+      private
+
+      def self.url(ip)
+        "https://www.telize.com/geoip/#{ip}"
+      end
+
+      def self.standardize_geodata(json)
+        {
+          ip:             json["ip"],
+          country:        json["country"],
+          country_code:   json["country_code"],
+          city:           json["city"],
+          region:         json["region"],
+          region_code:    json["region_code"],
+          postal_code:    json["postal_code"],
+          continent_code: json["continent_code"],
+          latitude:       json["latitude"],
+          longitude:      json["longitude"],
+          time_zone:      json["timezone"],
+          isp:            json["isp"]
+        }
+      end
+    end
+  end
+end

data/lib/easy_geoip/apis.rb

@@ -0,0 +1,3 @@
+require "easy_geoip/api/telize"
+require "easy_geoip/api/freegeoip"
+require "easy_geoip/api/nekudo"

data/lib/easy_geoip/client.rb

@@ -0,0 +1,40 @@
+require "faraday"
+require "json"
+require "easy_geoip/error"
+
+module EasyGeoIP
+  module Client
+    def self.get(*args, &block)
+      connection.get(*args, &block)
+    rescue Faraday::ClientError => error
+      handle_error(error)
+    end
+
+    def self.get_json(*args, &block)
+      body = get(*args, &block).body
+      JSON.parse(body)
+    end
+
+    private
+
+    def self.connection
+      @connection ||= Faraday::Connection.new do |connection|
+        connection.adapter Faraday.default_adapter
+        connection.use Faraday::Response::RaiseError
+      end
+    end
+
+    def self.handle_error(error)
+      case error
+      when Faraday::ConnectionFailed
+        raise EasyGeoIP::Error::ConnectionFailed.new error
+      when Faraday::ResourceNotFound
+        raise EasyGeoIP::Error::ResourceNotFound.new error
+      when Faraday::TimeoutError
+        raise EasyGeoIP::Error::TimeoutError.new error
+      else # Faraday::ClientError
+        raise EasyGeoIP::Error::ClientError.new error
+      end
+    end
+  end
+end

data/lib/easy_geoip/error.rb

@@ -0,0 +1,15 @@
+module EasyGeoIP
+  class Error < StandardError
+    # Generic Client Error
+    ClientError = Class.new(Error)
+
+    # ConnectionFailed from Faraday
+    ConnectionFailed = Class.new(ClientError)
+
+    # TimeoutError from Faraday
+    TimeoutError = Class.new(ClientError)
+
+    # ResourceNotFound from Faraday
+    ResourceNotFound = Class.new(ClientError)
+  end
+end

data/lib/easy_geoip/geo_data.rb

@@ -0,0 +1,39 @@
+module EasyGeoIP
+  class GeoData
+    attr_reader :ip, :country, :country_code, :city, :region, :region_code,
+                :postal_code, :continent_code, :latitude, :longitude,
+                :time_zone, :isp
+
+    def initialize(attributes = {})
+      @ip             = attributes[:ip]
+      @country        = attributes[:country]
+      @country_code   = attributes[:country_code]
+      @city           = attributes[:city]
+      @region         = attributes[:region]
+      @region_code    = attributes[:region_code]
+      @postal_code    = attributes[:postal_code]
+      @continent_code = attributes[:continent_code]
+      @latitude       = attributes[:latitude]
+      @longitude      = attributes[:longitude]
+      @time_zone      = attributes[:time_zone]
+      @isp            = attributes[:isp]
+    end
+
+    def to_hash
+      {
+        ip:             ip,
+        country:        country,
+        country_code:   country_code,
+        city:           city,
+        region:         region,
+        region_code:    region_code,
+        postal_code:    postal_code,
+        continent_code: continent_code,
+        latitude:       latitude,
+        longitude:      longitude,
+        time_zone:      time_zone,
+        isp:            isp
+      }
+    end
+  end
+end

data/lib/easy_geoip/version.rb

@@ -0,0 +1,3 @@
+module EasyGeoIP
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,335 @@
+--- !ruby/object:Gem::Specification
+name: easy_geoip
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Gordon Chan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.1
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 5.7.0
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: minitest-profile
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.19
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.19
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.13.0
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.4
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.11.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.7
+description: ! "A common Ruby interface for various free IP geolocation\n    services.
+  Small, simple and easy to use."
+email:
+- developer.gordon@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/easy_geoip/api/freegeoip.rb
+- lib/easy_geoip/api/nekudo.rb
+- lib/easy_geoip/api/query.rb
+- lib/easy_geoip/api/telize.rb
+- lib/easy_geoip/apis.rb
+- lib/easy_geoip/client.rb
+- lib/easy_geoip/error.rb
+- lib/easy_geoip/geo_data.rb
+- lib/easy_geoip/version.rb
+- lib/easy_geoip.rb
+- CHANGELOG.md
+- LICENSE
+- README.md
+- CONTRIBUTING.md
+- CODE_OF_CONDUCT.md
+- easy_geoip.gemspec
+homepage: https://www.github.com/gchan/easy_geoip
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23.2
+signing_key: 
+specification_version: 3
+summary: A small, simple, and easy IP geolocation client.
+test_files: []