china_regions 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+doc

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in lean.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) 2013 Encore
+
+MIT License
+
+ChinaRegions is released under the MIT license.

data/README.md

@@ -0,0 +1,46 @@
+# ChinaRegions
+
+中国省份，城市，地区［地级市］. 紧支持 Ruby on Rails 程序.
+       
+
+## How to use it
+
+添加一下代码到你的 Gemfile:
+
+gem 'china_regions',    :git => 'git://github.com/encoreshao/china_regions.git'
+
+bundle install
+
+执行:
+
+    rails g china_regions:install
+   
+   随后你可以看到控制台:
+   * 复制 数据源cities 到 config 目录.  config/cities.yml
+   * 创建 migration 文件到db/migrate 目录 db/migrate/create_china_regions_tables.rb
+   * 执行 `rake db:migrate` 添加三张表(provinces, cities, districts).
+   * 执行 `rake china_regions:import` 导入数据.
+
+
+此时 你可能需要添加三个model[`Province`, `City`, `District`]到你应用中:
+    
+    你可以执行 `rails g` 查看到 generator LIST.
+
+    执行 rails g china_regions:regions models
+
+   查看 app/models:
+   
+    create  app/models/province.rb
+    create  app/models/city.rb
+    create  app/models/district.rb
+   
+
+## Contributing
+
+Thank you for XuHao
+
+
+## License
+
+ChinaRegions is released under the MIT license.
+

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'

data/app/controllers/china_regions/fetch_options_controller.rb

@@ -0,0 +1,30 @@
+module ChinaRegions
+  class FetchOptionsController < ::ActionController::Metal
+    
+    def index
+      if params_valid?(params) and parent_klass = params[:parent_klass].classify.safe_constantize.find(params[:parent_id])
+        table_name = params[:klass].tableize
+        regions = parent_klass.__send__(table_name).select("#{table_name}.id, #{table_name}.name")
+        if has_level_column?(params[:klass])
+          regions = regions.order('level ASC')
+        else
+          regions = regions.order('name ASC')
+        end
+        self.response_body = regions.to_json
+      else
+        self.response_body = [].to_json
+      end
+    end
+    
+  
+    protected  
+      def has_level_column?(klass_name)
+        klass_name.classify.safe_constantize.try(:column_names).to_a.include?('level')
+      end
+      
+      def params_valid?(params)
+        params[:klass].present? and params[:parent_klass] =~ /^province|city$/i and params[:parent_id].present?
+      end
+      
+  end
+end

data/app/models/city.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+class City < ActiveRecord::Base
+  
+  attr_accessible :name, :province_id, :level, :zip_code, :name_en, :name_abbr
+  
+  belongs_to :province
+  has_many :districts, dependent: :destroy
+
+  scope :with_province, ->(province) { where(province_id: province) }
+
+  def short_name
+    @short_name ||= name.gsub(/市|自治州|地区|特别行政区/, '')
+  end
+
+  def siblings
+    @siblings ||= scoped.with_province(self.province_id)
+  end
+
+end

data/app/models/district.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+class District < ActiveRecord::Base
+	
+  attr_accessible :name, :city_id, :name_en, :name_abbr
+  
+	belongs_to :city
+	belongs_to :province
+
+	scope :with_city, ->(city) { where(city_id: city) }
+
+	def short_name
+		@short_name ||= name.gsub(/区|县|市|自治县/, '')
+	end
+	
+	def siblings
+		@siblings ||= scoped.with_city(self.city_id)
+	end
+	
+end

data/app/models/province.rb

@@ -0,0 +1 @@
+

data/china_regions.gemspec

@@ -0,0 +1,19 @@
+# encoding: utf-8
+require File.expand_path('../lib/china_regions/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Encore Shao"]
+  gem.email         = ["encore.shao@gmail.com"]
+  gem.description   = %q{China regions Ruby on rails interface}
+  gem.summary       = %q{China regions Ruby on rails interface}
+  gem.homepage      = "http://github.com/encoreshao"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "china_regions"
+  gem.require_paths = ["lib"]
+  gem.version       = ChinaRegions::VERSION
+  
+  gem.add_dependency 'jquery-rails'
+end

data/config/routes.rb

@@ -0,0 +1,3 @@
+Rails.application.routes.draw do
+  match '/china_regions/fetch_options', to: ChinaRegions::FetchOptionsController.action(:index)
+end

data/lib/china_regions/engine.rb

@@ -0,0 +1,5 @@
+require "rails"
+
+module ChinaRegions
+  class Engine < Rails::Engine;end
+end

data/lib/china_regions/helper.rb

@@ -0,0 +1,101 @@
+# encoding: utf-8
+
+module ChinaRegions
+  module Helper
+    
+    module FormHelper
+      def region_select(object, methods, options = {}, html_options = {})
+        output = ''
+        
+        html_options[:class] ? 
+          (html_options[:class].prepend('region_select ')) : 
+            (html_options[:class] = 'region_select')
+            
+        if Array === methods
+          methods.each_with_index do |method, index|
+            if klass = method.to_s.classify.safe_constantize
+              choices = index == 0 ? klass.all.collect {|p| [ p.name, p.id ] } : []
+              next_method = methods.at(index + 1)
+              
+              set_options(method, options, klass)
+              set_html_options(object, method, html_options, next_method)
+              
+              output << select(object, "#{method.to_s}_id", choices, options = options, html_options = html_options)
+            else
+              raise "Method '#{method}' is not a vaild attribute of #{object}"
+            end
+          end
+        else
+          if klass = methods.to_s.classify.safe_constantize
+            options[:prompt] = region_prompt(klass)
+            output << select(object, methods, klass.all.collect {|p| [ p.name, p.id ] }, options = options, html_options = html_options)
+          else
+            raise "Method '#{method}' is not a vaild attribute of #{object}"
+          end
+        end
+        
+        output << javascript_tag(js_output)
+        output.html_safe
+      end
+    
+    
+      private
+      
+      def set_options(method, options, region_klass)
+        if respond_to?("#{method}_select_prompt")
+          options[:prompt] = __send__("#{method}_select_prompt")
+        else
+          options[:prompt] = region_prompt(region_klass)
+        end
+      end
+      
+      def set_html_options(object, method, html_options, next_region)
+        html_options[:data] ? (html_options[:data][:region_klass] = "#{method.to_s}") : (html_options[:data] = { region_klass: "#{method.to_s}" })
+        if next_region
+          html_options[:data].merge!(region_target: "#{object}_#{next_region.to_s}_id", region_target_kalss: next_region.to_s)
+        else
+          html_options[:data].delete(:region_target)
+          html_options[:data].delete(:region_target_kalss)
+        end
+      end
+        
+      def region_prompt(region_klass)
+        human_name = region_klass.model_name.human
+        "请选择#{human_name}"
+      end
+      
+      def js_output
+        %~
+          $(function(){
+            $('body').on('change', '.region_select', function(event) {
+              var self, targetDom;
+              self = $(event.currentTarget);
+              targetDom = $('#' + self.data('region-target'));
+              if (targetDom.size() > 0) {
+                $.getJSON('/china_regions/fetch_options', {klass: self.data('region-target-kalss'), parent_klass: self.data('region-klass'), parent_id: self.val()}, function(data) {
+                  $('option[value!=""]', targetDom).remove();
+                  $.each(data, function(index, value) {
+                    targetDom.append("<option value='" + value.id + "'>" + value.name + "</option>");
+                  });
+                })
+              }
+            });
+          });
+        ~
+      end
+  
+    end
+    
+    
+    module FormBuilder
+      def region_select(methods, options = {}, html_options = {})
+        @template.region_select(@object_name, methods, options = options, html_options = html_options)
+      end
+    end
+    
+  end
+end
+
+
+ActionView::Base.send :include, ChinaRegions::Helper::FormHelper
+ActionView::Helpers::FormBuilder.send :include, ChinaRegions::Helper::FormBuilder

data/lib/china_regions/version.rb

@@ -0,0 +1,3 @@
+module ChinaRegions
+  VERSION = "0.0.1"
+end

data/lib/china_regions.rb

@@ -0,0 +1,6 @@
+require "china_regions/version"
+require 'china_regions/engine' if defined? Rails
+
+module ChinaRegions;end
+
+require 'china_regions/helper'

data/lib/generators/china_regions/install/install_generator.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+module ChinaRegions
+  class InstallGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+    source_root File.expand_path('../templates', __FILE__)
+
+    def capy_migration_file
+      migration_template "migration.rb", "db/migrate/create_china_regions_tables.rb"
+    end
+    
+    def capy_cities_file
+      copy_file 'cities.yml', 'config/cities.yml'
+    end
+    
+    def execute_migrate
+      rake("db:migrate")
+    end
+    
+    def import_cities_to_database
+      rake('china_regions:import')
+    end
+
+    def self.next_migration_number(dirname)
+      if ActiveRecord::Base.timestamped_migrations
+        Time.now.utc.strftime("%Y%m%d%H%M%S")
+      else
+        "%.3d" % (current_migration_number(dirname) + 1)
+      end
+    end
+  end
+end