china_region_fu 0.0.1 → 0.0.2

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Xuhao
+
+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,94 @@
+# ChinaRegionFu
+
+ChinaRegionFu provide the region data of china.You will got complete chian region data after use this gem.
+       
+
+## Installation
+
+Put 'gem china_region_fu' to your Gemfile:
+
+    gem china_region_fu
+
+Run bundler command to install the gem:
+
+    bundle install
+
+After you install the gem, you need run the generator:
+
+    rails g china_region_fu:install
+   
+   It will:
+   * Generate `db/migrate/<timestamp>create_china_region_tables.rb` migrate file to your app, `provinces`, `cities`, `districts` table is used for store the regions.
+   * Copy regions.yml to config/ directory.
+   * Run `rake db:migrate`.
+   * Run `rake region:import`.
+
+   Now you have there ActiveRecord modules: `Province`, `City`, `District`.
+   
+   Run with `rails g` for get generator list.
+
+If you want to customize the region modules you can run the generator:
+
+    rails g china_region_fu:mvc
+
+   This will create:
+   
+    create  app/models/province.rb
+    create  app/models/city.rb
+    create  app/models/district.rb
+
+   So you can do what you want to do in this files.
+   
+## Usage
+
+#### Model
+
+    a = Province.last
+    a.name                # => "台湾省"
+    a.cities.map(&:name)  # => ["嘉义市", "台南市", "新竹市", "台中市", "基隆市", "台北市"]
+    
+    Province.first.districts.map(&:name) # => ["延庆县", "密云县", "平谷区", ...]
+    
+    c = City.last
+    c.name                # => "酒泉市"
+    c.zip_code            # => "735000"
+    c.pinyin              # => "jiuquan"
+    c.pinyin_abbr         # => "jq"
+    c.districts.map(&:name) # => ["敦煌市", "玉门市", "阿克塞哈萨克族自治县", "肃北蒙古族自治县", "安西县", ...]
+    c.brothers.map(&:name)  # => ["甘南藏族自治州", "临夏回族自治州", "陇南市", ...]
+    
+#### View
+
+    <%= form_for(@post) do |f| %>
+      <div class="field">
+        <%= f.label :province, '选择地区：' %><br />
+        
+        # FormBuilder
+        # <%= f.region_select :city %>
+        # <%= f.region_select [:province, :city, :district] %>
+        # <%= f.region_select [:province, :city] %>
+        # <%= f.region_select [:city, :district] %>
+        # <%= f.region_select [:province, :district] %>
+        
+        # FormHelper
+        # <%= region_select :post, :province %>
+        # <%= region_select :post, [:province, :city, :district] %>
+        # ...
+        
+      </div>
+    <% end %>
+    
+  Online example: [医院之家](http://www.yihub.com/ "医院").
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+ChinaRegionFu is released under the MIT license.
+

data/Rakefile

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

data/app/controllers/china_region_fu/fetch_options_controller.rb

@@ -0,0 +1,22 @@
+module ChinaRegionFu
+  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")
+        self.response_body = regions.to_json
+      else
+        self.response_body = [].to_json
+      end
+    end
+    
+    
+    private
+    
+    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

@@ -3,8 +3,7 @@ class City < ActiveRecord::Base
   attr_accessible :name, :province_id, :level, :zip_code, :pinyin, :pinyin_abbr
   
   belongs_to :province
-  has_many :districts, :dependent => :destroy
-  has_many :hospitals, :dependent => :nullify
+  has_many :districts, dependent: :destroy
 
   def short_name
     @short_name ||= name.gsub(/市|自治州|地区|特别行政区/,'')

data/app/models/district.rb

@@ -3,7 +3,7 @@ class District < ActiveRecord::Base
   attr_accessible :name, :city_id, :pinyin, :pinyin_abbr
   
 	belongs_to :city
-	has_many :hospitals, :dependent => :nullify
+	belongs_to :province
 
 	def short_name
 		@short_name ||= name.gsub(/区|县|市|自治县/,'')

data/app/models/province.rb

@@ -2,7 +2,6 @@
 class Province < ActiveRecord::Base
   attr_accessible :name, :pinyin, :pinyin_abbr
   
-	has_many :cities, :dependent => :destroy
-	has_many :districts, :through => :cities
-	has_many :hospitals, :dependent => :nullify
+	has_many :cities, dependent: :destroy
+	has_many :districts, through: :cities
 end

data/china_region_fu.gemspec

@@ -1,20 +1,17 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "china_region_fu/version"
+require File.expand_path('../lib/china_region_fu/version', __FILE__)
 
-Gem::Specification.new do |s|
-  s.name        = "china_region_fu"
-  s.version     = ChinaRegionFu::VERSION
-  s.authors     = ["xuhao"]
-  s.email       = ["xuhao@rubyfans.com"]
-  s.homepage    = ""
-  s.summary     = %q{china region}
-  s.description = %q{china region}
+Gem::Specification.new do |gem|
+  gem.authors       = ["Xuhao"]
+  gem.email         = ["xuhao@rubyfans.com"]
+  gem.description   = %q{China region Ruby on rails interface}
+  gem.summary       = %q{China region Ruby on rails interface}
+  gem.homepage      = "http://rubyfans.com"
 
-  s.rubyforge_project = "china_region_fu"
-
-  s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths = ["lib"]
+  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_region_fu"
+  gem.require_paths = ["lib"]
+  gem.version       = ChinaRegionFu::VERSION
 end

data/config/routes.rb

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

data/lib/china_region_fu/helper.rb

@@ -0,0 +1,79 @@
+# -*- encoding: utf-8 -*-
+module ChinaRegionFu
+  module Helper
+    
+    module FormHelper
+      def region_select(object, methods, options = {}, html_options = {})
+        html_options[:class] ? (html_options[:class].prepend('region_select ')) : (html_options[:class] = 'region_select')
+        
+        output = ''
+        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)
+              options[:prompt] = region_prompt(klass)
+              html_options[:data] ? (html_options[:data][:region_klass] = "#{method.to_s}") : (html_options[:data] = { region_klass: "#{method.to_s}" })
+              if next_method
+                html_options[:data].merge!(region_target: "#{object}_#{next_method.to_s}_id", region_target_kalss: next_method.to_s)
+              else
+                html_options[:data].delete(:region_target)
+                html_options[:data].delete(:region_target_kalss)
+              end
+              
+              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(%~
+          $(function(){
+            $('body').on('change', '.region_select', function(event) {
+              var self, target, targetDom;
+              self = $(event.currentTarget);
+              target = self.data('region-target');
+              targetDom = $('#' + target);
+              if (targetDom.size() > 0) {
+                $.getJSON('/china_region_fu/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>");
+                  });
+                })
+              }
+            });
+          })
+        ~)
+        output.html_safe
+      end
+    
+    
+      private
+        
+      def region_prompt(klass)
+        human_name = klass.model_name.human
+        "请选择#{human_name}"
+      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, ChinaRegionFu::Helper::FormHelper
+ActionView::Helpers::FormBuilder.send :include, ChinaRegionFu::Helper::FormBuilder

data/lib/china_region_fu/version.rb

@@ -1,3 +1,3 @@
 module ChinaRegionFu
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/china_region_fu.rb

@@ -1,8 +1,8 @@
+require "china_region_fu/version"
 require 'china_region_fu/engine' if defined? Rails
 
 module ChinaRegionFu
   YAML_FILE = File.expand_path('../../config/regions.yml', __FILE__)
 end
 
-
-require "china_region_fu/version"
+require 'china_region_fu/helper'

data/lib/generators/china_region_fu/install/templates/migration.rb

@@ -1,45 +1,48 @@
 class CreateChinaRegionTables < ActiveRecord::Migration
-  def self.up
-    create_table :provinces do |t|
-      t.string :name
-      t.string :pinyin
-      t.string :pinyin_abbr
-      t.timestamps
+  def change
+    unless table_exists? 'provinces'
+      create_table :provinces do |t|
+        t.string :name
+        t.string :pinyin
+        t.string :pinyin_abbr
+        t.timestamps
+      end
+      
+      add_index :provinces, :name
+      add_index :provinces, :pinyin
+      add_index :provinces, :pinyin_abbr
     end
-    create_table :cities do |t|
-      t.string :name
-      t.integer :province_id
-      t.integer :level
-      t.string :zip_code
-      t.string :pinyin
-      t.string :pinyin_abbr
-      t.timestamps
-    end    
-    create_table :districts do |t|
-      t.string :name
-      t.integer :city_id
-      t.string :pinyin
-      t.string :pinyin_abbr
-      t.timestamps
+    
+    unless table_exists? 'cities'
+      create_table :cities do |t|
+        t.string :name
+        t.integer :province_id
+        t.integer :level
+        t.string :zip_code
+        t.string :pinyin
+        t.string :pinyin_abbr
+        t.timestamps
+      end
+      add_index :cities, :name
+      add_index :cities, :province_id
+      add_index :cities, :level
+      add_index :cities, :zip_code
+      add_index :cities, :pinyin
+      add_index :cities, :pinyin_abbr
+    end
+    
+    unless table_exists? 'districts'  
+      create_table :districts do |t|
+        t.string :name
+        t.integer :city_id
+        t.string :pinyin
+        t.string :pinyin_abbr
+        t.timestamps
+      end
+      add_index :districts, :name
+      add_index :districts, :city_id
+      add_index :districts, :pinyin
+      add_index :districts, :pinyin_abbr
     end
-    add_index :districts, :name
-    add_index :districts, :city_id
-    add_index :districts, :pinyin
-    add_index :districts, :pinyin_abbr
-    add_index :cities, :name
-    add_index :cities, :province_id
-    add_index :cities, :level
-    add_index :cities, :zip_code
-    add_index :cities, :pinyin
-    add_index :cities, :pinyin_abbr
-    add_index :provinces, :name
-    add_index :provinces, :pinyin
-    add_index :provinces, :pinyin_abbr
-  end
-
-
-  def self.down
-    drop_table :provinces, :cities, :districts
   end
-
-end
+end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: china_region_fu
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
-- xuhao
+- Xuhao
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-06-06 00:00:00.000000000 Z
+date: 2012-06-13 00:00:00.000000000 Z
 dependencies: []
-description: china region
+description: China region Ruby on rails interface
 email:
 - xuhao@rubyfans.com
 executables: []
@@ -20,14 +20,18 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - Gemfile
-- README.rdoc
+- LICENSE
+- README.md
 - Rakefile
+- app/controllers/china_region_fu/fetch_options_controller.rb
 - app/models/city.rb
 - app/models/district.rb
 - app/models/province.rb
 - china_region_fu.gemspec
+- config/routes.rb
 - lib/china_region_fu.rb
 - lib/china_region_fu/engine.rb
+- lib/china_region_fu/helper.rb
 - lib/china_region_fu/version.rb
 - lib/generators/china_region_fu/install/USAGE
 - lib/generators/china_region_fu/install/install_generator.rb
@@ -36,7 +40,7 @@ files:
 - lib/generators/china_region_fu/mvc/USAGE
 - lib/generators/china_region_fu/mvc/mvc_generator.rb
 - lib/tasks/region.rake
-homepage: ''
+homepage: http://rubyfans.com
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -55,9 +59,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: china_region_fu
+rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: china region
+summary: China region Ruby on rails interface
 test_files: []

data/README.rdoc

@@ -1,62 +0,0 @@
-= ChinaRegionFu
-
-ChinaRegionFu include the region data of china,and region CURD actions.Got ChinaRegionFu it means you got
-a powerfull region controller system about china.
-       
-
-== Getting Started
-
-1. Put 'gem china_region_fu' to your Gemfile:
-
-    gem china_region_fu
-
-2. Run bundler command to install the gem:
-
-    bundle install
-
-3. After you install the gem, you need run the generator:
-
-    rails g china_region_fu:install
-   
-   It will:
-   * Generate <em>db/migrate/<timestamp>create_china_region_tables.rb</em> migrate file to your app, *_china_regions_* table is used for store the regions.
-   * Copy regions.yml to config/ directory.
-   * Run "rake db:migrate".
-   * Run "rake region:import".
-
-   Now you have there ActiveRecord modules: <b>Province, City, District</b>.
-   
-   Run with <em>rails g</em> for get generator list.
-
-4. If you want to customize the region modules you can run the generator:
-    rails g china_region_fu:mvc
-
-   This will create:
-   
-    create  app/models/province.rb
-    create  app/models/city.rb
-    create  app/models/district.rb
-
-   So you can do what you want to do in this files.
-   
-5. Examples
-
-    a = Province.last
-    a.name                # => "台湾省"
-    a.cities.map(&:name)  # => ["嘉义市", "台南市", "新竹市", "台中市", "基隆市", "台北市"]
-    
-    Province.first.districts.map(&:name) # => ["延庆县", "密云县", "平谷区", ...]
-    
-    c = City.last
-    c.name                # => "酒泉市"
-    c.districts.map(&:name) # => ["敦煌市", "玉门市", "阿克塞哈萨克族自治县", "肃北蒙古族自治县", "安西县", ...]
-    c.brothers.map(&:name)  # => ["甘南藏族自治州", "临夏回族自治州", "陇南市", ...]
-
-== Contributing
-
-Xuhao <{rubyfans.com}[http://www.rubyfans.com]>.
-
-== License
-
-ChinaRegionFu is released under the MIT license.
-