district_cn 1.0.0

data/.gitignore

@@ -0,0 +1,21 @@
+# Ignore bundler config
+/.bundle
+
+# Ignore the default SQLite database.
+*.sqlite3
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+/public/assets
+/public/uploads
+/public/uploads/*.*
+/config/database.yml
+*.swp
+.DS_Store
+.DS_Store?
+Gemfile.lock
+/doc/TODO
+/spec/dummy/log/*.log
+/spec/dummy/tmp/
+/.idea

data/.rspec

@@ -0,0 +1 @@
+--drb  --color -f n

data/Gemfile

@@ -0,0 +1,4 @@
+source 'http://ruby.taobao.org/'
+
+# Specify your gem's dependencies in district_cn.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 kehao
+
+MIT License
+
+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,116 @@
+[![Gem Version](https://badge.fury.io/rb/area_cn.png)](http://badge.fury.io/rb/area_cn)
+# DistrictCn
+
+地区码查询
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'district_cn'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install district_cn
+
+## Usage
+### DistrictCn::Code
+
+```ruby
+# new
+DistrictCn.Code(331002) # or DistrictCn::Code.new(331002)
+
+# Instance methods 
+code = DistrictCn.code(331000)
+=> #<DistrictCn::Code:0x007fd5c48e3590 @value=331000, @id="331000"> 
+code.value                     #=> 331000   #原始输入的地区码
+code.id                        #=> "331000" #code.value.to_s
+code.name                      #=> "台州市"
+code.area_name(default = "-")  #=> "浙江省-台州市"
+
+code.province?                 #=> false
+code.province                  #=> {:text=>"浙江省",:children=>{...}}
+code.province_id               #=> "330000"
+code.province_name             #=> "浙江省"
+
+code.city?                     #=> true
+code.city                      #=> {:text=>"台州市",:children=>{...}}
+code.city_id                   #=> "331000"
+code.city_name                 #=> "台州市"
+
+code.district?                 #=> false
+code.district                  #=> nil
+code.district_id               #=> nil
+code.district_name             #=> nil
+
+code.children
+#=>[["黄岩区", "331003"],
+#   ["椒江区", "331002"],
+#   ["临海市", "331082"],
+#   ["路桥区", "331004"],
+#   ["三门县", "331022"],
+#   ["市辖区", "331001"],
+#   ["天台县", "331023"],
+#   ["温岭市", "331081"],
+#   ["仙居县", "331024"],
+#   ["玉环县", "331021"]]
+
+id.as_options
+# => 返回生成select需要的数据
+```
+### DistrictCn
+```ruby
+codes = DistrictCn.search("浙江")
+#=> [#<DistrictCn::Code:0x007fd5c483f990 @value="330000", @id="330000">]
+codes.first.name
+#=> "浙江省"
+
+DistrictCn.tree #树状结构数据
+DistrictCn.list #数据列表
+```
+## 使用act_as_area_field 简化调用
+```ruby
+#company.rb
+class Company < ActiveRecord::Base
+  attr_accessor :region_code
+  attr_accessible :region_code
+
+  act_as_area_field :region_code #增加这一行
+  validates :region_code, presence: true
+end
+```
+```ruby
+company = Company.new
+company.region_code = 331002
+#不使用act_as_area_field
+company.region_code 
+#=> 331002
+District::Cn.code(company.region_code).name
+#=> "椒江区"
+
+#使用act_as_area_field
+company.region_code 
+#返回District::Cn::code对像
+#=> #<District::Cn::code:0x007fb7a4c0e960 @value=331002, @id="331002">
+company.region_code.name
+#=> "椒江区"
+```
+
+
+
+## Test
+```ruby
+rake spec
+```
+
+## Contributing
+
+1. Fork it
+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 new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec

data/district_cn.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'district_cn/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "district_cn"
+  spec.version       = DistrictCn::VERSION
+  spec.authors       = ["kehao"]
+  spec.email         = ["kehao.qiu@gmail.com"]
+  spec.description   = %q{地区码查询}
+  spec.summary       = %q{地区码查询}
+#  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "activerecord", '>= 3.2.13'
+  spec.add_development_dependency "sqlite3"
+
+  spec.add_dependency 'activesupport', '>= 3.2.13'
+  spec.add_dependency 'json', '>= 1.7.5'
+end