Release v0.0.1

Author: liluo

.gitignore

@@ -27,9 +27,11 @@ build/
 
 # for a library or gem, you might want to ignore these files since the code is
 # intended to run in multiple environments; otherwise, check them in:
-# Gemfile.lock
-# .ruby-version
-# .ruby-gemset
+Gemfile.lock
+.ruby-version
+.ruby-gemset
 
 # unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
 .rvmrc
+
+.DS_Store

.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+
+rvm:
+  - 1.9.2
+  - 2.1.6
+  - 2.2.2

CHANGES.md

@@ -0,0 +1,5 @@
+## IPIP Changelog
+
+#### v0.0.1 [2015-09-27]
+
+- Release first version.

Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

README.md

@@ -1,2 +1,56 @@
-# ipip
-IP search based on IPIP.net
+# IPIP
+
+[![Gem Version](https://badge.fury.io/rb/ipip.svg)](http://badge.fury.io/rb/ipip)
+[![Build Status](https://travis-ci.org/liluo/ipip.svg?branch=master)](https://travis-ci.org/liluo/ipip)
+
+IP search based on [IPIP.net](http://ipip.net/)
+
+### Getting Started
+
+Install the gem:
+
+```
+gem install ipip
+```
+
+Then use it in your application:
+
+```
+require 'ipip'
+
+                                # => Format: "国家\t省份或直辖市\t地区或城市\t学校或单位"
+
+IPIP.find('127.0.0.1')          # => "本机地址\t本机地址\t\t"
+
+IPIP.find('211.147.4.49')       # => "中国\t北京\t北京\t"
+
+IPIP.find('202.195.161.30')     # => "中国\t江苏\t镇江\t江苏大学"
+
+IPIP.find('www.douban.com')     # => "中国\t北京\t北京\t"
+```
+
+You can try running `ipip [ip | domain]`:
+
+```
+$ ipip 202.195.161.30
+Location for 202.195.161.30: 中国       江苏    镇江    江苏大学
+
+$ ipip douban.com
+Location for douban.com: 中国   北京    北京
+```
+
+### Contributing
+
+* Fork the repository.
+* Create a topic branch.
+* Implement your feature or bug fix.
+* Add, commit, and push your changes.
+* Submit a pull request.
+
+### ChangeLog
+
+[ChangeLog](CHANGES.md)
+
+### License
+
+Released under the [MIT license](LICENSE).

Rakefile

@@ -0,0 +1,5 @@
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

bin/ipip

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# ipip - IP location search based on ipip.net.
+#   usage: ipip [ip | domain]
+#
+
+require 'socket'
+require 'ipip'
+
+if ip = ARGV[0]
+  location = IPIP.find(ip)
+  puts "Location for #{ip}: #{location}"
+else
+  abort "usage: ipip [ip | domain]"
+end

ipip.gemspec

@@ -11,4 +11,8 @@ Gem::Specification.new do |gem|
   gem.summary       = %q{ IP search based on ipip.net }
 
   gem.files         = Dir['lib/**/*']
+  gem.executables   = ['ipip']
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
 end

lib/ipip.rb

@@ -1,4 +1,18 @@
 require 'ipip/version'
+require 'ipip/ipv4_database'
 
 module IPIP
+
+  class << IPIP
+
+    def find(ip)
+      ipv4_database.find(ip)
+    end
+
+    def ipv4_database(data_file=nil)
+      @ipv4_database ||= IPv4Database.new(data_file)
+    end
+
+  end
+
 end